The directive record type is used to communicate special directions to XStudio, hence the term "directive". There are six (6) specific directives, each with its own record format.
Base Directive Record Type
The first 7 bytes of a directive record are formatted in three (3) fields, as shown. The remaining 62 bytes differ based on the value of the Directive Type field (bytes 6 & 7).
Bytes |
Len |
Description |
Possible Values |
|---|---|---|---|
01 |
1 |
Record Type |
D = Directive |
02-05 |
4 |
Time in HHMM format |
0000 - 2359 |
06-07 |
2 |
Directive Type |
CR - Close Relay |
08-67 |
60 |
Directive Type dependent |
See individual directive types |
68-69 |
2 |
CR/LF |
Carriage Return/Line Feed |
Total |
69 |
|
|
Close Relay Directive
This type of directive is used to execute an XStudio Action.
Bytes |
Len |
Description |
Possible Values |
|---|---|---|---|
01 |
1 |
Record Type |
D = Directive |
02-05 |
4 |
Time in HHMM format |
0000 - 2359 |
06-07 |
2 |
Directive Type |
CR - Close Relay |
08-11 |
4 |
Relay Number |
0001-9999 |
12-31 |
20 |
<Reserved> |
Blanks |
32-61 |
30 |
Description |
Freeform |
62-67 |
6 |
<Reserved> |
Blanks |
68-69 |
2 |
CR/LF |
Carriage Return/Line Feed |
Total |
69 |
|
|
Load Window Directive
This directive is used to update the XStudio Current Voice session property.
Bytes |
Len |
Description |
Possible Values |
|---|---|---|---|
01 |
1 |
Record Type |
D = Directive |
02-05 |
4 |
Time in HHMM format |
0000 - 2359 |
06-07 |
2 |
Directive Type |
LW - Load Window |
08-11 |
4 |
Relay Number |
99 (Current Voice) |
12-31 |
20 |
<Reserved> |
Blanks |
32-61 |
30 |
Description |
Freeform |
62-67 |
6 |
<Reserved> |
Blanks |
68-69 |
2 |
CR/LF |
Carriage Return/Line Feed |
Total |
69 |
|
|
Load Stopset Directive
These directive types are the most commonly used of the directives. They are used to mark break positions and duration. Note there are three (3) types, all with the same record format.
Bytes |
Len |
Description |
Possible Values |
|---|---|---|---|
01 |
1 |
Record Type |
D = Directive |
02-05 |
4 |
Time in HHMM format |
0000 - 2359 |
06-07 |
2 |
Directive Type |
LP - Load Play Stopset |
08-12 |
5 |
Length in MMMSS |
00000 - 99959 (Right-Justified) |
13-31 |
19 |
<Reserved> |
Blanks |
32-60 |
29 |
Description |
Freeform |
61-67 |
7 |
<Reserved> |
Blanks |
68-69 |
2 |
CR/LF |
Carriage Return/Line Feed |
Total |
69 |
|
|
Play Cart Directive
This directive is used to place an audio item in the log that is not normally scheduled by a music or traffic system.
Bytes |
Len |
Description |
Possible Values |
|---|---|---|---|
01 |
1 |
Record Type |
D = Directive |
02-05 |
4 |
Time in HHMM format |
0000 - 2359 |
06-07 |
2 |
Directive Type |
PC - Play Cart |
08-12 |
5 |
Length in MMMSS |
00000 - 99959 (Right-Justified) |
13-16 |
4 |
Cart Number |
4 alphanumeric characters |
17-20 |
4 |
Commercial Type |
Same as Commercial Record |
21-27 |
7 |
<Reserved> |
Blanks |
28-31 |
4 |
Product Code |
Freeform |
32-60 |
29 |
Description |
Freeform |
61-66 |
6 |
Customer Number |
Freeform |
67 |
1 |
<Reserved> |
Blank |
68-69 |
2 |
CR/LF |
Carriage Return/Line Feed |
Total |
69 |
|
|