Command Definitions; Response Definitions; Command Format - Symmetricom TimeProvider 500 series User Manual

Issue 3: Mar 96
C. Command Definitions
3.04 A command consists of a Command Code fol-
lowed by a colon, parameter blocks separated by co-
lons, and a terminating semicolon; see Figure 1 for an
example. A command can only be entered at the semi-
colon prompt (;).
3.05 Parameter blocks may be null (contain no pa-
rameters), or contain one or more parameters. Two co-
lons occur next to each other if a parameter block is
null. (Some parameters in the complete TL1 language
set are not used. These unused parameters are left
null in this command set.) Colons after the last active
parameter and before the semicolon need not be en-
tered.
3.06 Multiple parameters in a parameter block are
separated by commas. Two commas occur next to
each other if a parameter is null. Commas after the
last active parameter and before a colon or semicolon
need not be entered.
3.07 Entering a semicolon at the end of the com-
mand causes the command to execute.
3.08 If any mistakes are made while entering a
command, send the bad command and reenter a good
command. The system does not recognize edited
commands.
SET-DAT:[<tid>]::<ctag>:<date>,<time>;
Command Code
Null parameter block
SET-DAT:::111:951208,153500;
Optional Parameter block
parameter block
Example of a command format
Example of a command generated using the above format
Figure 1. Command Format
3.09 In this practice, uppercase letters in a com-
mand are parameter values to be entered as shown.
Lowercase letters in a command indicate a choice of
values is available for that parameter. The values spe-
ciÞc to that command are listed with the command.
D. Response Definitions
3.10 A response is returned by the 500 series sys-
tem when it receives a command. All responses in-
clude the source identiÞer (the sender of the
response), the date and time, and the correlation tag
of the given command. A response to a command
may be a Completed or an Error response.
a. Completed : The command has been completed
or information requested is returned. This re-
sponse carries the COMPLD message.
b. Error : The command was denied, and the re-
sponse carries the DENY message. The Error
Code parameter (errcde) shows the reason.
Note: All external communications ports are
software-configurable to set one character as
the end-of-text message. This character does
not replace the TL1 specified end-of-text mes-
sage terminator (;). Refer to the instructions
for the ED-EQPT command for additional in-
formation.
Parameters
Parameter block with param-
eters separated by a comma
TMSL 097-45018-02
Terminating
semicolon
Page 3