Use the SEND command to communicate with other operators in a multiple-console

support (MCS) environment. In a time-sharing environment, use the SEND

command to communicate with a specific terminal user or all terminal users, and to

manage the SYS1.BRODCAST data set. Table 4-27 summarizes the information

that the SEND command provides. Use it to access the pages on which you can

find details about a particular use of the SEND command.

The syntax for each variation of the SEND command is shown immediately

preceding its respective parameter list.

Use the SEND command to communicate with other operators at MCS consoles.

SE {'message'},{BRDCST }

{msgno } {OPERATOR=routecode}

{CN=console }

The parameters are:

The message to be sent.

The number of the message in SYS1.BRODCAST to be sent. (See "Saving

Messages in the Broadcast Data Set" on page 4-335for information on how to

save and later send messages by message number.)

Chapter 4. MVS System Commands Reference 4-331

The specified message is to be sent to all active consoles that have not

specified the ‘no broadcast’ option (using the K V,LEVEL command).

OPERATOR=routecode

The installation area (such as tape library) to receive the message, specified as

a one or three digit number between 1 and 128 (see Table 3-5 on page 3-13).

CN=console

The console where the message is to be sent; console must be a one or

two-digit decimal number between 0 and 99.

Note: When TSO/E 2.2 is installed, the CN keyword supports console names.

The console name is 2 to 8 alphanumeric characters, the first character

must be alphabetic or one of these characters, @, #, or $. MCS

consoles must be defined by your installation.

When you are uncertain of the routing codes and console identifiers in effect, enter

the DISPLAY CONSOLES command. See "Displaying Console Status Information"

on page 4-105.

To send message number 46 to console 12, enter:

se 46,cn=12

To send the following message to all active consoles, enter:

se 'Close down in 15 minutes',brdcst

Use the SEND...,USER command to communicate with specific time-sharing users.

SE {'message'},USER=(userid[,userid]...),{NOW|LOGON},{WAIT|NOWAIT}

{msgno }

The parameters are:

The message to be sent to the terminal users.

The number of the message to be sent. (See "Saving Messages in the

Broadcast Data Set" on page 4-335. for information about how messages can

be saved and later sent by message number.)

USER=(userid[,userid]...)

The identifiers of those users who are to receive the message.

Specifies that the message is to be sent immediately. If the recipient is not

logged on, you are notified and the message is deleted.

When NOWAIT and USER are specified and the user’s terminal is busy:

v The user does not receive the message

4-332 OS/390 V2R10.0 MVS System Commands

v You are notified which users did not receive the message

v The message is deleted

If any specified user is currently logged on and is accepting messages, the user

receives the message. If the user is logged on but is not receiving messages,

the message is stored in the mail section of the broadcast data set until the

user requests it. If the user is not logged on, the message is stored in the mail

section of the broadcast data set until requested when the user logs on.

When NOWAIT is specified and the user’s terminal is busy, the message is

stored in the mail section of the broadcast data set until the user requests it.

Specifies that the message is held until system output buffers are available for

the specified logged on users. This option ensures that the message is received

by all the specified users. When a user’s terminal is busy, other users will not

receive the message until that user’s terminal is free.

Specifies that the message is not held. When USER is specified, you are

notified of any users who do not received the message. If LOGON is specified,

the message is saved as mail for those user’s who’s terminal is busy or who

were not logged on.

Note: When possible, use the LOGON parameter so you do not interrupt the user’s

terminal session unnecessarily.

To send the following message to users D58 and D04 immediately, if they are

receiving messages, or when they request messages, enter:

se 'your listings are ready',user=(d58,d04),logon

If they are not logged on the system, they receive the message when they log on.

To send the message to the specified user immediately, if he is logged on, enter:

se 'getting I/O errors on your pack',user=(payroll)

You can use the SEND command to send a message to all terminal users currently

logged on the system.

SE {'message'},{NOW|LOGON},{WAIT|NOWAIT},{ROUTE={*ALL|systemname|groupname}}

{msgno }

The parameters are:

The message that is to be sent to all time-sharing terminal users.

Chapter 4. MVS System Commands Reference 4-333

The number of the message to be sent. (See "Saving Messages in the

Broadcast Data Set" on page 4-335for information about how to save and later

send messages by message number.)

Specifies that the message is to be sent immediately to all users currently

logged on; the message is not retained for users not logged on.

When NOWAIT is specified and the user’s terminal is busy:

v the user does not receive the message

v you are NOT notified which users did not receive the message

v The message is deleted

All users logged on and accepting messages receive the message. Those users

logged on but not receiving messages receive it upon requesting messages.

The message is stored in the notices section of the broadcast data set and is

sent to those users requesting messages when they log on. The message is

retained until you delete it.

When NOWAIT is specified and the user’s terminal is busy, the message is

stored in the mail section of the broadcast data set until the user requests it.

Specifies that the message is held until system output buffers are available for

the specified logged on users. This option ensures that the message is received

by all the specified users. When a user’s terminal is busy, other users will not

receive the message until that user’s terminal is free.

Specifies that the message not be held. If you specify LOGON, the system

saves the message as mail for those users whose terminals are busy or who

were not logged on.

Sends the message to all users logged onto the specified system(s). If you do

not specify the ROUTE= parameter, the system sends the message only to the

users logged onto the system where you issue the SEND command. Valid

values for the ROUTE parameter are:

*ALL

Directs the system to send the message to all users logged onto all

systems participating in the sysplex

Directs the system to send the message only to users logged onto

Directs the system to send the message to all users logged onto the

sysplex subset defined by groupname

Note: When possible, use the LOGON parameter so you do not interrupt the users’

terminal sessions unnecessarily.

To send the following critical message to all users immediately, enter:

SE 'system going down in 5 minutes'

4-334 OS/390 V2R10.0 MVS System Commands

To send the following general interest message to users when they request

messages or at LOGON time, enter:

SE 'time-sharing will not be up next Thursday',LOGON

Use the SEND...,SAVE command to store messages in the broadcast data set to be

issued only at LOGON time, or when requested.

SE {'message'},{USER=(userid[,userid]...)},SAVE

{ msgno } {ALL }

The parameters are:

The message to be sent to the terminal users.

The number of the message to be sent.

USER=(userid)

The identifications of those users to receive the message. The message is

stored in the mail sections for those users. (There is a mail section for each

TSO user.)

All terminal users are to receive the message. Terminal users who are currently

using the system receive the message immediately. In addition, the message is

placed in the notices section and assigned a number. This number, printed

when the message is stored, can be used as msgno in this and other forms of

the SEND command.

The message is to be stored in the appropriate section of the broadcast data

set until a user logs on or requests messages. If ALL is specified, the message

is stored in the notices section of the broadcast data set and is retained until

explicitly deleted. If userid is specified, the message is stored in the mail section

of the broadcast data set and deleted after it is sent to the intended user. No

attempt is made to send it immediately, even to those users logged on and

receiving messages.

Note: WAIT and NOWAIT have no effect when specified with SAVE.

To submit messages to the broadcast data set before stopping time-sharing for the

day, enter:

se 'time-sharing will close down at 5:00 p.m. today.',save

When you start time-sharing the next day, the messages are available for users

logging on. The above command does not affect those users currently logged on

and receiving messages.

Chapter 4. MVS System Commands Reference 4-335

Use the SEND...,LIST command to keep track of accumulated messages in the

notices section of the broadcast data set. You can list one or all of the messages.

SE [msgno,]LIST

The parameters are:

The number of the message to list. Omitting this operand results in all

messages in the notices section, and the message numbers assigned to them,

being listed.

The requested message or all messages in the notices section of the

SYS1.BRODCAST data set are to be listed on the console.

If you find, after listing the notices section of the broadcast data set, that a message

is no longer needed, use the SEND...,DELETE command to delete it.

SE msgno,DELETE

The parameters are:

msgno

The number of the message to be deleted.

DELETE

The specified message is to be deleted.

Example: To delete message number 23, enter:

SE 23,DELETE

The information on this site is the combined effort of a lot of people, please credit the authors if you use their information.
Please read the Disclaimer page for the restrictions, copyright, and other uses of the information contained on this site.
For problems or questions regarding this web contact Bob.
Last updated: October 04, 2001.