Message Control Statement

Using Auxiliary Disposition › Real-time Auxiliary Disposition › Message Control Statement

Message Control Statement

The Message control statement defines the format and content of messages, determines whether labels are printed, and defines the route code. This statement is required for Real-time Auxiliary Disposition processing and multiple statements are allowed.

The format for the Message control statement is:

ddname  xrLOUT=xxxx,message.text

ddname  xrLmessage.text

ddname

The ddname of the input or output tape. The ddname can be a maximum of eight characters and it must begin in position one.

x

The placement of any non-blank character in position 9 requires the operator to delete the WTO from the console.

r

Identifies the route codes to which the WTO is issued (the default is 13 and it must be in position 10). Possible values for r are:

A = master console (route code 2)
B = tape pool (route code 3)
C = tape library (route code 5)
* = SYSMSG only (route code 11)
F = SYSMSG and console (route codes 2 and 11)
G = SYSMSG and tape pool (route codes 3 and 11)
H = SYSMSG and library (route codes 5 and 11)

L

An L placed in position 11 indicates that you want to generate an external label request for the volume being processed.

External label requests are processed by the Online Label Interface. For more information see Common Tape System.

M

An M placed in position 11 indicates that user data is present and should be passed to the Online Label Interface when the label request is generated. For more information about accessing user data when formatting a label, see Common Tape System. You can specify up to 51 characters.

OUT=xxxx

xxxx is the one- to four-character out-of-area code that is placed in the TMC volume record. When used, it must be separated from the message text by a comma. OUT=xxxx must begin in position 12.

Note: For the out-of-area code to be maintained in the TMC, the volume must not be read for input once it has been marked out-of-area, or CA 1 automatically checks the volume back into the library. Always add the TMSDISP DD statement after the last DD statement to use the volume if the volume is to be marked out-of-area, or use Batch Auxiliary Disposition after you are certain that all processing has been completed.

message.text

Defines up to 60 characters of text to be placed in the IECTMS8 WTO. When an out-of-area code is specified, the text should begin in position 21; otherwise, the text should begin in position 12. If additional text is needed, specify the same ddname in another statement, use the same route code, and begin the text in position 12. A maximum of one hundred ddname statements is allowed for message text.

When the user data option is specified (an M in position 11), message.text defines up to 51 characters of text to be passed to the Online Label Interface with the label request. Additional ddname statements are ignored when user data is specified.