SEND-MESSAGE

#### Search Results

Search

# SEND-MESSAGE

File | 19
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`.

## Fields

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
`PREFIX` | A3 |  | D |
`DESTINATION-TYPE` | A8 |  | D |
`STATUS` | A8 |  | D |
`NOLOG` | A8 |  | D |
`URGENT` | A3 |  | D | Only relevant if your site runs Net-Pass.

## 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
--- | ---
630 | Console not defined or not active.

## Field Descriptions

Field Name | Type/Length
--- | ---
`DESTINATION` | (A8)

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.

Field Name | Type/Length
--- | ---
`DESTINATION-TYPE` | (A8)

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.

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

Field Name | Type/Length
--- | ---
MESSAGE | (A79)

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

Field Name | Type/Length
--- | ---
`NOLOG` | (A8)

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
--- | ---
`PREFIX` | (A3)

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
--- | ---
`STATUS` | (A8)

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
--- | ---
`URGENT` | (A3)

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

- Fields
- Relevant Error Codes
- Field Descriptions