WRITE OPERATOR

Writes a message to the system CICS® System Master Terminal (CSMT) Log.

Syntax

WRITE OPERATOR

Read syntax diagramSkip visual syntax diagramWRITE OPERATOR TEXT ( data-value)TEXTLENGTH( data-value)ROUTECODES( data-value)NUMROUTES( data-value)EVENTUALACTION( cvda)CRITICALIMMEDIATEREPLY( data-area)MAXLENGTH( data-value)REPLYLENGTH( data_area)TIMEOUT( data_value)
Conditions: INVREQ
Note: CICS TX on Cloud ignores the ACTION, CRITICAL, EVENTUAL, IMMEDIATE, MAXLENGTH, NUMROUTES, REPLY, REPLYLENGTH, ROUTECODES, and TIMEOUT options.

 

Description

WRITE OPERATOR enables an application program to write a message to the CICS System Master Terminal (CSMT) Log. The TEXT data-value is written in the CSMT log along with the keyword 'WRITE OPERATOR API (0x6C02) Message', data and time stamps, and terminal information.

Options

TEXT(data-value)
A data value that contains the text that is to be sent. If the text that is specified is more then 120 bytes long, it truncates to 120.
TEXTLENGTH(data-value)
Specifies the length (fullword binary value) of the text. The length is in the range 0 through 120 bytes.
ACTION(cvda)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
CRITICAL, EVENTUAL, IMMEDIATE,
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
MAXLENGTH(data-value)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
NUMROUTES(data-value)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
REPLY(data-area)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
REPLYLENGTH(data-area)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
ROUTECODES(data-value)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.
TIMEOUT(data-value)
This option is not supported by CICS, and should not be used in applications that run under CICS. However, if this option is present (for example, in a migrated program), the translator ignores the option.

Conditions

INVREQ
RESP2 values:
1
The TEXTLENGTH value is not valid.

Default action: Terminates the task abnormally.