Please enable JavaScript to view this site.

ezSuite for XStudio, DCS, & Maestro

Navigation: Appendices > Audit File Specification

Variable Length Segment

Scroll Prev Top Next More

The variable length segment of the audit record includes 6 ASCII fields delimited by a byte having a value of 0xFF (decimal 255). The table below lists the field order and their possible lengths.

Field

Data Type

Description

cartNumber

AnsiChar [ 8 ]

The cart number field. If the transaction involves a cart (audio item), the cart number will be in this field. Otherwise, the field will be empty.

custNum

AnsiChar [ 7 ]

Customer number field. If the transaction involves a log item and a customer number was included in the log, that value appears in this field. Otherwise, the field will be empty.

description

AnsiChar [ 25 ]

Description field. If the transaction involves a cart (audio item), the description of the item appears in this field. If the transaction is of another type, text appearing in this field could be a decoded switcher message or information about an automated function or action.

agencyTapeNum

AnsiChar [ 16 ]

Agency tape number field. If the transaction involved a log item and an agency number was included in the log, that value appears in this field. Otherwise, the field would include raw switcher data for an audio switcher transaction or be empty.

swicherMsg

AnsiChar [ 11 ]

Switcher message field. If the transaction involves an audio switcher, the data in this field represents the switcher command type and result.

windowName

AnsiChar [ 14 ] (Original)
AnsiChar [ 30 ] (dcsTools)

Window name field. Originally 14 characters in length, expanded to 30 for dcsTools products. If the transaction involves an automation function or action, its name appears in this field. For XStudio, if the transaction involves a log item, the unique log record ID appears in this field. Otherwise, the field is empty.

All text stored in the variable length segment of the audit record is ANSI text. This convention has been retained for compatibility across all audio delivery systems that write records described in this document.