BROADCAST command: Sending a file message: Difference between revisions
No edit summary |
|||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 17: | Line 17: | ||
</p> | </p> | ||
<p>where the slash character (/) indicates a new line or a carriage return/line feed sequence.</p> | <p>where the slash character (/) indicates a new line or a carriage return/line feed sequence.</p> | ||
<p>A line is continued by specifying any nonblank character in the continuation column specified by the INCCC parameter.</p> | <p>A line is continued by specifying any nonblank character in the continuation column specified by the <var>[[INCCC_parameter|INCCC]]</var> parameter.</p> | ||
==Example== | ==Example== | ||
| Line 27: | Line 27: | ||
</p> | </p> | ||
==Usage notes== | ==Usage notes== | ||
<p>The file message for a <var class="product">Model 204</var> file is normally displayed when users open the file. The BROADCAST command adds a new file message or changes an existing file message. If the file message is changed after a user has opened the file, the message is displayed the next time that the user is at command level outside a procedure. If URGENT is specified in the command, the message is displayed almost immediately on the terminals of users who have opened the file. (See the discussion of message timing below.)</p> | <p>The file message for a <var class="product">Model 204</var> file is normally displayed when users open the file. The BROADCAST command adds a new file message or changes an existing file message. If the file message is changed after a user has opened the file, the message is displayed the next time that the user is at command level outside a [[Procedures|procedure]]. If URGENT is specified in the command, the message is displayed almost immediately on the terminals of users who have opened the file. (See the discussion of message timing below.)</p> | ||
<p>BROADCAST can delete the existing file message. If no text is specified in the command, as in the example below, then the file message is removed from the file:</p> | <p>BROADCAST can delete the existing file message. If no text is specified in the command, as in the example below, then the file message is removed from the file:</p> | ||
<p class="code">BROADCAST FILE | <p class="code">BROADCAST FILE </p> | ||
<blockquote class="note"><b>Note:</b> The file message automatically is deleted when a file is recreated or reinitialized. | |||
<p>Whenever a file is displayed, it is preceded by the header:</p> | |||
<p class="code">MESSAGE FROM FILE <var class="term">filename</var> | |||
</p> | </p> | ||
<p | <p>If insufficient storage (specified in the <var>[[SPCORE_parameter|SPCORE]]</var> parameter) is available to hold a copy of the file's BROADCAST message during the process of opening the file, the file message is not printed and open processing continues.</p></blockquote> | ||
====Message timing==== | ====Message timing==== | ||
<p>The exact time at which an URGENT message is displayed on a user's terminal depends upon two factors: </p> | <p>The exact time at which an URGENT message is displayed on a user's terminal depends upon two factors: </p> | ||
| Line 52: | Line 49: | ||
<ul> | <ul> | ||
<li> | <li> | ||
<p>If the receiver is currently executing a command, such as a DISPLAY, the message is displayed when the command completes.</p> | <p>If the receiver is currently executing a command, such as a <var>[[DISPLAY_command|DISPLAY]]</var>, the message is displayed when the command completes.</p> | ||
</li> | </li> | ||
| Line 63: | Line 60: | ||
<table> | <table> | ||
<tr> <th>IODEV</th> <th>Device type and access method</th> </tr> | <tr class="head"> | ||
<th>IODEV</th> <th>Device type and access method</th> </tr> | |||
<tr> <th align="right"><var> 7</var></th> <td>SNA Communications Server (formerly VTAM) 3270</td> </tr> | <tr> <th align="right"><var> 7</var></th> <td>SNA Communications Server (formerly VTAM) 3270</td> </tr> | ||
<tr> <th align="right"><var> 37</var></th> <td>SNA Communications Server 3767 and NTO</td> </tr> | <tr> <th align="right"><var> 37</var></th> <td>SNA Communications Server 3767 and NTO | ||
<p class="note"><b>Note:</b> The IODEV=37 setting is no longer supported as of Model 204 version 7.6.</p></td> </tr> | |||
<tr> <th align="right"><var> 45</var></th> <td>CMS line-at-a-time console</td> </tr> | <tr> <th align="right"><var> 45</var></th> <td>CMS line-at-a-time console</td> </tr> | ||
| Line 78: | Line 77: | ||
</ul> | </ul> | ||
<p>For other terminal types, the message is displayed when <var class="product">Model 204</var> has received the input.</p> | <p>For other terminal types, the message is displayed when <var class="product">Model 204</var> has received the input.</p> | ||
====Update units==== | ====Update units==== | ||
<p>When it processes BROADCAST FILE, <var class="product">Model 204</var> ends any current User Language update unit and begins a [[File_integrity_and_recovery#Non-backoutable_update_units|non-backoutable update unit]]. If a <var class="product">Model 204</var> command non-backoutable update unit is in progress, BROADCAST FILE is included in that update unit.</p> | <p>When it processes BROADCAST FILE, <var class="product">Model 204</var> ends any current User Language update unit and begins a [[File_integrity_and_recovery#Non-backoutable_update_units|non-backoutable update unit]]. If a <var class="product">Model 204</var> command non-backoutable update unit is in progress, BROADCAST FILE is included in that update unit.</p> | ||
Latest revision as of 15:17, 6 February 2019
Summary
- Privileges
- File manager
- Function
- Adds, changes, or removes the message associated with a Model 204 file
Syntax
BROADCAST FILE [URGENT][text]
Where: text is the new file message; if text is not specified in the command, the current file message is removed. The maximum length of the file message is 255 characters (247 if URGENT is specified).
Syntax notes
Multiple lines of text are specified in the form:
line1/line2.../
where the slash character (/) indicates a new line or a carriage return/line feed sequence.
A line is continued by specifying any nonblank character in the continuation column specified by the INCCC parameter.
Example
BROADCAST FILE URGENT NO FURTHER UPDATES ALLOWED TODAY
The following command prints one blank line, followed by the specified text, followed by one more blank line:
BROADCAST FILE /FILE IS BACKED UP EVERY DAY AT 6.00 P.M./
Usage notes
The file message for a Model 204 file is normally displayed when users open the file. The BROADCAST command adds a new file message or changes an existing file message. If the file message is changed after a user has opened the file, the message is displayed the next time that the user is at command level outside a procedure. If URGENT is specified in the command, the message is displayed almost immediately on the terminals of users who have opened the file. (See the discussion of message timing below.)
BROADCAST can delete the existing file message. If no text is specified in the command, as in the example below, then the file message is removed from the file:
BROADCAST FILE
Note: The file message automatically is deleted when a file is recreated or reinitialized.
Whenever a file is displayed, it is preceded by the header:
MESSAGE FROM FILE filename
If insufficient storage (specified in the SPCORE parameter) is available to hold a copy of the file's BROADCAST message during the process of opening the file, the file message is not printed and open processing continues.
Message timing
The exact time at which an URGENT message is displayed on a user's terminal depends upon two factors:
-
What the receiver of the message is doing at the time (for example, waiting for input or running a request)
-
The type of Model 204 terminal handler used by the user
The most common situations are summarized below:
-
If the receiver is currently executing a command, such as a DISPLAY, the message is displayed when the command completes.
-
If the receiver is running a request, the message is displayed at certain points during loop processing.
-
If Model 204 is waiting for input, the message is displayed immediately on the devices shown below:
IODEV Device type and access method 7 SNA Communications Server (formerly VTAM) 3270 37 SNA Communications Server 3767 and NTO Note: The IODEV=37 setting is no longer supported as of Model 204 version 7.6.
45 CMS line-at-a-time console 47 CMS full screen
For other terminal types, the message is displayed when Model 204 has received the input.
Update units
When it processes BROADCAST FILE, Model 204 ends any current User Language update unit and begins a non-backoutable update unit. If a Model 204 command non-backoutable update unit is in progress, BROADCAST FILE is included in that update unit.
Interrupting end-users
See "Evaluating whether to issue a BROADCAST URGENT command" in BROADCAST: Sending a login message.