Data Manipulation Language Statements › #SENDMSG—sends a message to another terminal or user › #SENDMSG Parameters

#SENDMSG Parameters

RECORD=

Specifies the location in program storage that contains the message to be sent.

message-location-pointer

Either a register that points to the message text or the symbolic name of the area that contains the message text.

RECLEN=

Specifies the length, in bytes, of the message text.

message-length-register

A register that contains the length of the message, the symbolic name of a user-defined field that contains the length, or an absolute expression.

DESTID=

Specifies the destination receiving the message. The destination is a list of logical terminals or users defined during system generation.

destination-id-pointer

A register that points to the destination ID, the symbolic name of a user-defined field that contains the ID, or the ID literal enclosed in quotation marks.

USERID=

Specifies the user to receive the message. The user can be signed on to any terminal.

user-id

A register that points to the user ID or the symbolic name of a user-defined field that contains the ID.

LTERMID=

Specifies the logical terminal to receive the message.

logical-terminal-id-pointer

A register that points to the logical terminal ID, the symbolic name of a user-defined field that contains the ID, or the ID literal enclosed in quotation marks.

OPTNS=

Specifies whether the system is to queue the message if the specified destination, user, or terminal is not currently being used.

ONLY

(Default); The DC/UCF system sends the message immediately if the destination, user, or terminal is available, and does not queue the message for subsequent transmission if the destination, user, or terminal is not available.

Note: If ONLY is specified with the DESTID parameter, described above, the system sends the message to those users or terminals in the destination that are available. The sender is not aware of any unsuccessful transmissions.

ALWAYS

The DC/UCF system sends the message immediately if the destination, user, or terminal is available, and queues the message for later transmission if the destination, user, or terminal is not available.

SMRB=

Specifies the location of the storage area in which the system builds the #SENDMSG parameter list.

SYSPLIST

(Default); is the symbolic name of the storage area in which the system builds the #SENDMSG parameter list.

send-message-request-block

A register that points to the area or the symbolic name of the area in which the system builds the #SENDMSG parameter list.

COND=

Specifies whether this #SENDMSG is conditional and under what conditions control should be returned to the issuing program.

NO

(Default); specifies that the request is not conditional.

ALL

Specifies that control is returned if the #SENDMSG cannot be serviced for one or more of the reasons listed in condition.

condition-option

Specifies conditions under which control is returned to the program. Multiple conditions must be enclosed in parentheses and separated by commas.

IOER

An I/O error occurred during processing.

INVP

The parameter list is invalid.

UNDF

The specified message destination is not defined to the system.

IOERXIT=i/o-error-label

Specifies the symbolic name of a routine to which control should be returned if the #SENDMSG request cannot be serviced because of an I/O error.

INVPXIT=invalid-parameter-list-label

Specifies the symbolic name of a routine to which control should be returned if the #SENDMSG cannot be serviced because of an invalid parameter list.

UNDFXIT=undefined-destination-label

Specifies the symbolic name of a routine to which control should be returned if the #SENDMSG cannot be serviced because the specified destination is undefined to the system.

ERROR=error-label

Specifies the symbolic name of a routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded.