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