SEND-MESSAGE
| File |
19 |
| Op-Sys |
z/OS, z/VSE, BS2000/OSD |
| 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/OSD, 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/OSD
| 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/OSD |
| 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/OSD.
|
|
|
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/OSD |
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/OSD, 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/OSD |
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/OSD:
| 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/OSD: TIAM.
| Field Name |
Type/Length |
Operating System |
| MESSAGE |
(A79) |
z/OS, z/VSE, BS2000/OSD |
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/OSD |
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/OSD |
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/OSD |
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/OSD |
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/OSD |
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.
|
