Message formats

The following formats are described:

• Format for receiving messages in dialog between system and user

• Format for sending responses

• Format for command-linked responses

• Format for entering operator commands

• Format of command results and command termination messages

Format for receiving messages in dialog between system and user

{?|%|;}tns-mid{.|#}hhmmss'BLANK'text

%	Message, response not required
?	Message requiring a response that can also be given by the operator
;	Message requiring a response that cannot be given by the operator
tsn	Task serial number of the task that caused the system message
-	Hyphen
mid	Message job ID, default value = 000 (A..Z, 0-9, @, #, $)
.	Period as separator. The sender is a user program.
#	Hash as separator. The sender is a system module. The use of period or “#” depends on the class 2 system parameter SECSTART.
hhmmss	Time (6 digits; hh = hour, mm = minute, ss = second)
text	Freely selectable message text

Example

%TSN1-000#142423 % NBR0970 OPERATOR TASK WITH TSN 'XAAA' CREATED FOR 
                   CONSOLE 'K1' 
?TSN9-000#142753 % NBR0820 SHOULD K1 BECOME MAIN OPERATOR TERMINAL ? 
;TSN4-001#142823 % XYZ0123 SWITCH OFF DEVICE L1 URGENTLY

Messages of types “?” and “;” can be displayed again using the SHOW-PENDING-MSG command.
Messages of the type “;” can only be removed from the queue of unresolved queries by the sender of the message.
The operator has only indirect influence on this, in that he/she gives the response required by the sender (in the above example, switching off the device L1).

 

Format for sending responses

dest [-mid].[text]

dest	Destination of response This is the sender of the message to which a response is to be given.
-	Hyphen
mid	Message job ID (A..Z, 0-9, @, #, $); leading zeros may be omitted (mid must correspond to the message requiring a response)
.	Period, indicating a response
text	Arbitrary response text. Only certain texts are permissible for responses to system messages.  You can obtain help on individual messages using /HELP-MSG-INFORMATION.

Example

TSN9-000.YES

TSN9.YES

Format for command-linked responses

dest [-mid]:[text]

dest	Destination of additional command information This is the sender of the message to which a response is to be given.
-	Hyphen
mid	Message job ID (A..Z, 0-9, @, #, $) (must correspond to the message to which a response is to be given)
:	Colon, indicating command status information
text	Arbitrary response text. Only certain texts are permissible for responses to system messages.  You can obtain help on individual messages using /HELP-MSG-INFORMATION.

Example

TSN3-TUR:Y

 

Format for entering operator commands

/[.cid]'BLANK'cmd'BLANK'[operands]

/	Slash. Character indicating a command
-	Period. Character indicating that a “cid” is specified
cid	command job ID The cid starts with a letter or one of the characters @, $, #, which may be followed by up to 7 additional characters (A-Z, 0-9, or @,$,#). In its format it corresponds to the job names for user commands (see “Commands” manual [27]). The cid serves to identify the jobs associated with an operator command. The first three characters of the cid appear as the mid (message job ID, see "Message formats") in all messages associated with the command (command results, requests for additional information and the additional information itself).
cmd	Describes the operation performed by an operator command
'BLANK'	Blank
operands	Command operands

Examples

/.MINE CANCEL-JOB *TSN(1532) 
/SPECIAL-CMD OP1=<value1>,OP2=<value2> 
/.EVAN16 SHOW-USER-ATTRIBUTES USER-IDENTIFICATION=RZ01 
/.E SHOW-USER-ATTRIBUTES USER-IDENTIFICATION=RZ01

Unlike message job IDs, command job IDs may be no more than eight characters long. Command job IDs consisting of only one or two digits are filled to as many as three digits with leading zeros. Command job IDs must begin with a letter or the special characters $,#,@. The first three characters of the command job ID appear as the message job ID.

Format of command results and command termination messages

{+ | & | !}{tns | an}-mid{. | #}hhmmss'BLANK'text

+	Command result; no response required
&	Request for additional command information; the sender requires a response
!	Command termination; no response required
tsn	Task sequence number of the task in which the command is processed
on	Authorization name of the authorized user program performing command processing (special operator command)
-	Hyphen
mid	Message job ID, default value = 000 (A..Z, 0-9, @, #, $)
.	Period as a separator
#	Number character (hash) as a separator Whether the separator is a period or the “#” depends on the system parameter SECSTART.
hhmmss	Time of day (6 digits; hh = hour, mm = minute, ss = second).
text	Freely selectable message text

Examples

&TSN3-TUR.142623  %  EXC0422 PROCESSING OF /TURN TO BE CONTINUED? REPLY
                             (Y=YES; N=NO)
+TSN2-ASR.142523  %  NBR0825 THIS CONSOLE IS (K3)
!TSN2-ASR.142723  %  NBR0740 COMMAND COMPLETED 'ASR' (RESULT: SC2=00, 
                             SC1=00, MC=CMD0001); DATE :<date>