SEND-MESSAGE

File 19
Statement PROCESS
Task Allows you or the application to send messages to a TIAM user and/or the system console.

Relevant Error Codes

For 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.
750 Invalid operand within operand list.
766 User ID or terminal ID missing.
799 Entire Systems Management Adapter internal error.
809 Subsystem not active.
983 DESTINATION-TYPE :1: not supported by BS2000.
986 No or not enough space for COMMAND IN MP.

Field Descriptions

Dictionary Field Name Format/

Length/

Desc/

Mu

Description

DESTINATION (A8) Destination, depending on DESTINATION-TYPE. For TIAM, the message is sent to the user ID.Specify *CONSOLE here to send the message to the console only. The destination can also be a TRANSDATA station.
  D  
    This must be specified in the TERMINAL-NAME and PROCESSOR-NAME fields. Either DESTINATION is required or PROCESSOR-NAME and TERMINAL-NAME.
DESTINATION-TYPE (A8) Type of destination to which the message is to be sent:
  D TIAM To TIAM user only.
MESSAGE (A79) Required. Message text to be sent. This text will be prefixed by: Message from userid  (see the PREFIX field).
  D  
NOLOG (A8) Specify CONSOLE in this field to send the message to the console if the TIAM user is not logged on.
  D  
PREFIX (A3) Message prefix indicator. Possible values:
  D NO Messages have no prefix.
    YES Messages will be prefixed by the string Message from userid.
PROCESSOR-NAME (A8) 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.
  D  
STATUS (A8) Possible values returned to this field:
  D LOG The TIAM user is logged on and has received the message.
    NOLOG The TIAM user is not logged on.
TERMINAL-NAME (A8) 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).
  D