Cisco Headend System Release 2.7 User Guide
Overview of the sendPTEA Utility
4031374 Rev B
241
Important Notes About the Text File for the sendPTEA Utility
Note these important points about the text file used by the sendPTEA utility. Refer
to the text file in Example of the Text File Used by the sendPTEA Utility (on page
240) when studying these notes.
to the text file in Example of the Text File Used by the sendPTEA Utility (on page
240) when studying these notes.
You must increment the version field for each revision of the text file. DHCTs
will ignore data in the text file if the file does not contain an updated version
number. The version number must be within the 0 to 255 range. Using a version
number greater than 255 leads to unpredictable results.
Example: VERSION|3|
will ignore data in the text file if the file does not contain an updated version
number. The version number must be within the 0 to 255 range. Using a version
number greater than 255 leads to unpredictable results.
Example: VERSION|3|
#Version must be incremented each time this
file is changed.
DHCTs sometimes fail to retain the data sent by the sendPTEA utility between
reboots. Therefore, you may need to transmit a specific version of the data file
more than once. DHCTs that have already received that version will ignore it,
while DHCTs that have not yet received it will process it.
reboots. Therefore, you may need to transmit a specific version of the data file
more than once. DHCTs that have already received that version will ignore it,
while DHCTs that have not yet received it will process it.
An exclamation point (!) declares a group. The entitlement permissions and
MAC addresses that follow a group declaration belong to the DHCTs in that
group.
MAC addresses that follow a group declaration belong to the DHCTs in that
group.
The first group listed in the text file always pertains to the global group, and this
group's entitlements are used by all DHCTs.
Important: The global group must be present in any data file used by the
sendPTEA utility.
Example: !Global #The first group is always the global group.
group's entitlements are used by all DHCTs.
Important: The global group must be present in any data file used by the
sendPTEA utility.
Example: !Global #The first group is always the global group.
The actual names of the groups are for the convenience of the operator and are
ignored by the utility.
ignored by the utility.
Declare MAC addresses in the following format:
MAC|FF:11:22:33:44:55|
Important: Use capital letters for the higher range of hexadecimal numbers.
MAC|FF:11:22:33:44:55|
Important: Use capital letters for the higher range of hexadecimal numbers.
The first field following the declaration of the global group or the list of MAC
addresses represents the type of entitlement (enabled or disabled) followed by
the name of the entitlement (C2K, TELN, etc.). The last field represents the
duration of the entitlement, in minutes.
Note: A duration of "0" represents no end time.
addresses represents the type of entitlement (enabled or disabled) followed by
the name of the entitlement (C2K, TELN, etc.). The last field represents the
duration of the entitlement, in minutes.
Note: A duration of "0" represents no end time.
Comments are marked by "#". Comments can either begin a line or follow a line,
and are ignored by the utility.
and are ignored by the utility.