gtps1m28System Macros

CWRTC-Write Critical Message to the System Console

Use this system macro to:

Mainline communications queuing is bypassed and the messages are written through the preemptive I/O facility. You can call this macro only in C-type (control program) modules. All CWRTC messages are preceded by the CSMP97I header if the SYSTC SBPRMSG switch is set.

Normal I/O for the central processor complex (CPC) is suspended until the console write operations are complete.

The macro function varies slightly, depending on whether the system includes 1052/3215 console support, or (3270) native console support. If 1052 support has been generated, then the macro will write to the 1052 console, and sound the alarm. If native console support has been generated, then the macro will write to the 327x CRT system console, sound the alarm, and also copy the message on the associated 328x printer (RO).

Format




label
A symbolic name can be assigned to the macro statement.

MSG
It must be coded in one of the following ways;

MSG=(register)

MSG=label

MSG='literal'

(register)
The specified general register must point to the message formatted as below:

DC AL1(Length of message)

DC C' .. message text .. '

The TEXTONLY option of the GENMSG macro may be used to generate the text in the required format.

label
If coded, then at that location must be the message formatted as above.

'literal'
The macro will generate (inline) a correctly formatted message.

TIME=YES|NO
It may be coded as YES or NO. NO is the default. If YES is specified, an 8-byte time stamp (of the HH.MM.SS format) will be inserted ten bytes into the message text.

If NO is specified or defaulted, the message will be sent unaltered.

ENDOFM
It may be coded as YES or NO. If neither ENDOFM nor ENDOFMR is specified, YES is the default. This parameter only affects 1052/3215 console support. This parameter is mutually exclusive with the ENDOFMR parameter.

YES
An end-of-message-complete character (EOMC) is added at the end of the message.

NO
An EOMC character is not added at the end of the message.

ENDOFMR=(Rn)
This parameter only affects 1052/3215 console support. If the right-most byte of the specified register is 0, an EOMC character is added at the end of the message. Otherwise, no EOMC is added at the end of the message. This parameter is mutually exclusive with the ENDOFM parameter.

CSMP97I=YES|NO
Specifies whether the message will be preceded by the CSMP97I header if the appropriate SYSTC switches are set. This facility is intended for use when writing multiline messages. The default is CSMP97I=YES.

CSMP97I=NO should not be coded for the first line of a message, unless the calling program has verified through the SYSTC switches that the CSMP97I header is not required.

ROUT=(code1 [,code2 [,code3 ]])
Up to three routing codes, as defined in the Functional Support Console Routine Codes segment (RTCEQ), may be specified. This facility is intended for use in writing status messages which need not be logged to all three operator consoles. Only the codes PRC, RO and AUDT are supported. The default is ROUT=(PRC,RO,AUDT).

DSECT=YES
This form of the macro is used to generate a DSECT which describes the macro parameters. It is intended for use in the system error CSECT only.

Entry Requirements

Return Conditions

Programming Considerations

Examples