>>-+-/BROADCAST-+--+----+---------------------------------------> '-/BRO-------' '-TO-' >--+-ACT------------------------------------------------+------>< | .-----------. | | V | | +-LINE--+-----line#--+---+-------+-+---------+-----+-+ | | | '-line#-' | | | | | | .--------. | | | | | | V | | | | | | '-PTERM--+---pterm#-+-+-' | | | | '-ALL--------' | | | '-ALL--------------------------------------' | | .----------------. | | V | | +-LTERM--+---+-ltermname--+-+-+----------------------+ | | '-ltermname*-' | | | '-ALL----------------' | +-MASTER--+------------------------+-----------------+ | | .--------. | | | | V | | | | +-MSNAME--+---msname-+-+-+ | | | '-ALL--------' | | | | .--------. | | | | V | | | | '-SYSID--+---sysid#-+-+--' | | '-ALL--------' | | .---------------. | | V | | +-NODE--+---+-nodename--+-+-+------------------------+ | | '-nodename*-' | | | '-ALL---------------' | +-PTERM ALL------------------------------------------+ | .---------------. | | V | | '-USER--+---+-username--+-+-+------------------------' | '-username*-' | '-ALL---------------'
Table 19 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/BROADCAST | X | X | |
ACT | X | X | |
LINE | X | X | |
LTERM | X | X | |
MASTER | X | X | |
MSNAME | X | X | |
NODE | X | X | |
PTERM | X | X | |
SYSID | X | X | |
USER | X | X |
/BROADCAST is a multisegment command used to send a message to terminals in one or more IMS systems. For /BROADCAST commands entered by the master terminal operator, the multisegment input from this command is combined into 79-character segments for output transmission. The first input segment contains only the broadcast destination. The second and subsequent input segments must contain the data to be broadcast. Messages that are broadcast are sent even if the line, terminal, or both, are stopped at the time the broadcast is issued.
All /BROADCAST formats require an EOM indication to denote end-of-message; an EOS indication must be included for all segments that precede the last segment. See Multisegment Command Input for more detail on using EOM and EOS.
Requirement: When the /BROADCAST command is issued from an MCS/E-MCS console, OM API, or an AOI application, a period must appear as a delimeter between the command and the message text.
Unlike message switches, broadcast messages are sent to a terminal even when the terminal, associated line, or both, are not available (stopped, process stopped, or locked). However, broadcast messages are never sent to terminals if the MSGDEL parameter of the TERMINAL macro is specified MSGDEL=NONIOPCB.
Broadcast messages are always queued for logical terminals. When the ACTIVE, LINE, NODE, PTERM, or USER keywords are used, IMS queues the message for the first logical terminal found that is associated for output purposes with the specified line or physical terminal.
When operating on a dynamic terminal, the /BROADCAST ACT command only succeeds if a signed on user exists. A signed on user must exist, otherwise there is no destination to which to send the message.
Where a LTERM does not exist, IMS attempts to create the LTERM and associated user structure if ETO is active. LTERM parameters can be generic, where the generic parameter specifies logical terminals that already exist.
When /BROADCAST LTERM ALL is specified, one copy of the message is queued for each logical terminal in the local system. In a multiple systems configuration, the message is not sent to remote systems when the ALL parameter is used. When more than one logical terminal is assigned to a physical terminal for output purposes, multiple copies of the message will result.
When the LTERM keyword specifies a logical terminal assigned to the VTAM pool, broadcast messages are queued for the first logical terminal in a subpool.
When operating on a dynamic terminal, the /BROADCAST NODE command only succeeds if a signed on user exists. A signed on user must exist, otherwise there is no destination to which to send the message.
In an IMSplex, /BROADCAST USER queues the supplied message to the first LTERM associated with a dynamic user, if the user is signed on locally. /BROADCAST USER may not be used to queue a message to an LTERM associated with a user signed on to another IMS in the IMSplex, or not signed on at all.
Entry ET:
/BROADCAST ACTIVE (EOS) SYSTEM WILL BE SHUTDOWN FOR PM (EOS) IN 5 MINUTES (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
SYSTEM WILL BE SHUTDOWN FOR PM IN 5 MINUTES
Explanation: The entered message is transmitted to all active terminals.
Entry ET:
/BROADCAST TO LTERM APPLE, TREE (EOS) DON'T USE TRANSACTION GREENTRE UNTIL FURTHER (EOS) NOTICE. (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
DON'T USE TRANSACTION GREENTRE UNTIL FURTHER NOTICE.
Explanation: The entered message is transmitted to the logical terminals named APPLE and TREE.
Entry ET:
/BROADCAST TO LINE ALL (EOS) SYSTEM WILL SHUTDOWN AT 5PM (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
SYSTEM WILL SHUTDOWN AT 5PM
Explanation: The entered message is transmitted to all physical terminals.
Entry ET:
/BROADCAST TO LINE 13 PTERM ALL (EOS) EXPECT DEMO YOUR LINE AT 9PM (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
EXPECT DEMO YOUR LINE AT 9PM
Explanation: The entered message is transmitted to all physical terminals on line 13.
Entry ET:
/BROADCAST MASTER SYSID 2 (EOS) SYSTEM WILL SHUTDOWN AT 5:00 PM (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
SYSTEM WILL SHUTDOWN AT 5:00 PM
Explanation: The message is transmitted to the master terminal of the system specified by the SYSID 2.
Entry ET:
/BROADCAST MASTER MSNAME BOSTON, CHICAGO (EOS) SYSTEM WILL SHUTDOWN AT 5:00 PM (EOM)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
SYSTEM WILL SHUTDOWN AT 5:00 PM
Explanation: The message is transmitted to the master terminals. of the remote systems specified by the MSNAMEs BOSTON and CHICAGO.
Remote Terminal entry:
/FORMAT DFSMO4 /BRO LTERM WTOR (eos) this is segment 1 (eos) this is segment 2 (eos) this is segment 3 (eom)
Response ET:
DFS058I BROADCAST COMMAND COMPLETED
Response RT:
THIS IS SEGMENT 1 THIS IS SEGMENT 2 THIS IS SEGMENT 3
Explanation: The remote terminal is first formatted by the /FORMAT command, where default format DFSMO4 supports the input of four segments. This is followed by /BROADCAST with four segments.