SEND System Task

The SEND task transmits user-supplied messages to the following areas:
idmscu19
The SEND task transmits user-supplied messages to the following areas:
  • DC/UCF users
  • Logical terminals
  • Destinations
This task allows you to queue a message to a user who is currently not signed on to the system or to queue a message to a logical terminal or destination that is offline.
This article describes the following information:
Syntax
►►─ SEND ─┬───────────────────┬───┬─────────────────────────┬───────────────►           └─ 
broadcast-parms
 ─┘   ├─ U 
user-id
 ─────────────┤                                   ├─ L 
logical-terminal-id
 ─┤                                   ├─ D 
destination-id
 ──────┤                                   └─ A ─────────────────────┘  ►─┬─────────────┬─┬────────────────┬───────────────────────────────────────►◄    ├─ ALWays ────┤ └─ 
message-text
 ─┘    └─ IMMediate ─┘
Parameters
  • SEND
    Sends a message to the specified receiver. The receiver can be one or more users or destinations. If you do not specify a receiver with the SEND task code, DC/UCF prompts you to specify a recipient.
  • broadcast-parms
    Indicates to execute the SEND command on all or a list of data sharing group members.
    For more information about broadcasting and
    broadcast-parms
    syntax, see "How to Broadcast System Tasks".
  • U
    Sends the message to the specified user.
    user-id
    The ID of a DC/UCF user; cannot contain embedded blanks.
  • L
    Sends the message to the specified logical data terminal.
    lterm-id
    The ID of a logical terminal.
  • D
    Sends the message to the specified destination.
    destination-id
    The ID of a destination. A destination can identify a group of logical terminals or a group of users.
  • A
    Sends the message to all users currently signed on to the DC/UCF system.
    When you specify A, you
    cannot
    queue the message to users who are not signed on. In other words, the message is sent with the IMMEDIATE option (see below).
  • ALWays
    Queues the message in either of the following cases:
  • The specified user is not signed on to the system.
  • The specified logical terminal or destination is offline.
    ALWAYS is not valid for messages sent to all (A) users who are currently signed on.
  • IMMediate
    Sends the message immediately to the specified receiver.
  • message-text
    Specifies the text of the message. The message can be as long as the line length of the terminal device permits. If a message is not specified with the SEND task code, DC/UCF prompts for the message text.
Usage
Receiving messages
The target user
receives the message
only
if the user's terminal is set up to receive messages. To set up a terminal to receive messages, use the DCUF SET BREAK command.
The message is
not
sent to the target user when NOBREAK is in effect at that user's terminal. In this case, the sender is informed that the receiving terminal is not set up to receive messages.
Viewing messages
The target user
views the message immediately
when the user's terminal can receive messages
and
you send the message with the IMMEDIATE option.
In this case, the message overwrites the terminal's previous screen contents. The previous screen contents are saved when a line I/O session is in progress and backpaging is in effect or when the last active task on the target terminal was defined with the SAVE option. The user presses a control key (for example, Enter or PF1) to restore the screen's previous contents.
When messages get queued at the receiving user's terminal
Messages are queued at the receiving user's terminal in any of the following cases:
  • You specify ALWAYS
    in the SEND command, as described above in the syntax rules for SEND.
  • You specify neither ALWAYS nor IMMEDIATE
    in a message to a user who
    is
    currently signed on to the system. In this case, the message is displayed when the current task (if any) at that terminal and the terminal's user presses a control key.
  • The intended recipient is already viewing a message
    . In this case, subsequent IMMEDIATE messages to the terminal are queued. The user at that terminal displays the next queued message by pressing any control key. Queued messages are displayed in the order in which they are received.
Example
SEND U user-id
In this example, you are user JSMITH and you send a message to user MJOHNSON, who is currently signed on:
  • Your input:
Vnnn ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename  
send u mjohnson imm the meeting has been changed to Thursday
Result at your terminal:
      IDMS DC0299004 V55 MESSAGE SENT V55  ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename
Result at user MJOHNSON's terminal:
V55  ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename  FROM LR1: THE MEETING HAS BEEN CHANGED TO THURSDAY
The message sent to user MJOHNSON'S terminal is output at the terminal's current cursor location.