SEND-MESSAGE

File 19
Op-Sys z/OS, z/VSE, BS2000
Statement PROCESS
Task Allows you or the application to send messages to a TP monitor user (Com-plete, TSO, TIAM) and/or the system console.
Note When sending messages to Com-plete users, return code 0 means only that the message has been forwarded to Com-plete. Possible error messages are written to the console by COMBTCH.

Common Fields for all Operating Systems

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
MESSAGE A79   D Required
DESTINATION A8   D Required in z/OS, z/VSE.

In BS2000, either DESTINATION is required or PROCESSOR-NAME and TERMINAL-NAME.

PREFIX A3   D  
DESTINATION-TYPE A8   D  
STATUS A8   D  
NOLOG A8   D  

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
URGENT A3   D Only relevant if your site runs Net-Pass.

Additional Fields Supported for BS2000

Dictionary Field Name F/L Mu DE Remarks
SYSTEM-CODE B2      
PROCESSOR-NAME A8   D Required if no DESTINATION is specified.
TERMINAL-NAME A8   D Required if no DESTINATION is specified.

Relevant Error Codes

For TSO and TIAM: if the message could not be sent because the target user is not logged on, ERROR-CODE is 0 and the STATUS contains NOLOG.

Code Text z/OS z/VSE BS2000
630 Console not defined or not active. X X X
750 Invalid operand within operand list.     X
766 User ID or terminal ID missing.     X
799 Entire System Server internal error.     X
809 Subsystem not active.     X
983 DESTINATION-TYPE :1: not supported by BS2000.     X
986 No or not enough space for COMMAND IN MP.     X

Field Descriptions

Field Name Type/Length Operating System
DESTINATION (A8) z/OS, z/VSE, BS2000

Destination, depending on DESTINATION-TYPE.

For type Com-plete, TSO and TIAM, the message is sent to the user ID.

For type APPL, the message is sent to the application name.

Specify *CONSOLE here to send the message to the console only.

For BS2000, the destination can also be a TRANSDATA station. This must be specified in the TERMINAL-NAME and PROCESSOR-NAME fields.

Field Name Type/Length Operating System
DESTINATION-TYPE (A8) z/OS, z/VSE, BS2000

Type of destination to which the message is to be sent:

Destination Explanation
APPL To the application specified in the field DESTINATION.
COMPLETE To Com-plete user only.
TSO To TSO user only.

BS2000:

Destination Explanation
TIAM To TIAM user only.

Default in z/OS is TSO and Com-plete user (if the user is not logged on to Com-plete, the message is sent to TSO).

Default in BS2000: TIAM.

Field Name Type/Length Operating System
MESSAGE (A79) z/OS, z/VSE, BS2000

Message text to be sent. This text will be prefixed by: Message from userid (see the PREFIX field).

Field Name Type/Length Operating System
NOLOG (A8) z/OS, z/VSE, BS2000

Specify CONSOLE in this field to send the message to the console if the TSO or TIAM user is not logged on.

Field Name Type/Length Operating System
PREFIX (A3) z/OS, z/VSE, BS2000

Message prefix indicator. Possible values:

Value Explanation
NO Messages have no prefix.
YES Messages will be prefixed by the string Message from userid.
Field Name Type/Length Operating System
PROCESSOR-NAME (A8) BS2000

Processor name as defined in TRANSDATA. Together with the field TERMINAL-NAME, the processor name identifies the station within TRANSDATA, if the destination is a terminal. Field DESTINATION must be left blank in this case.

Field Name Type/Length Operating System
STATUS (A8) z/OS, z/VSE, BS2000

Possible values returned to this field:

Value Explanation
LOG The TSO or TIAM user is logged on and has received the message.
NOLOG The TSO or TIAM user is not logged on.
Field Name Type/Length Operating System
TERMINAL-NAME (A8) BS2000

Name of the station in TRANSDATA to which the message is to be sent. The station must be connected to TIAM (see also the field PROCESSOR-NAME).

Field Name Type/Length Operating System
URGENT (A3) z/OS

Urgent message indicator. Only relevant if your site runs Software AG's VTAM session manager Net-Pass or a similar VTAM session manager. Possible values:

Value Explanation
NO Default. Message class is not urgent. The message is displayed on the receiver's terminal the next time he presses Enter or any PF/PA key.
YES Message class is changed to urgent. It is displayed on the receiver's terminal immediately. Any data the receiver has typed in since he last pressed Enter may be lost.