SEND-MESSAGE

#### Search Results

Search

# SEND-MESSAGE

File | 19
Op-Sys | z/OS, z/VSE, BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
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.

### On this page

- Common Fields for all Operating Systems
- Additional Fields Supported for z/OS
- Additional Fields Supported for BS2000
- Relevant Error Codes
- Field Descriptions