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	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	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.