BROADCAST command: Sending a file message - Revision history

DCameron: /* Message timing */

2019-02-06T15:17:54Z

Message timing

← Older revision		Revision as of 15:17, 6 February 2019
Line 49:		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>

DCameron: /* Usage notes */

2019-02-06T15:17:01Z

Usage notes

← Older revision		Revision as of 15:17, 6 February 2019
Line 34:		Line 34:
	<p class="code">MESSAGE FROM FILE <var class="term">filename</var>		<p class="code">MESSAGE FROM FILE <var class="term">filename</var>
	</p>		</p>
	<p>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.</p></blockquote>		<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>

DCameron: /* Usage notes */

2019-02-06T15:15:29Z

Usage notes

← Older revision		Revision as of 15:15, 6 February 2019
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>		<p class="code">BROADCAST FILE </p>

DCameron: /* Syntax notes */

2019-02-06T15:13:43Z

Syntax notes

← Older revision		Revision as of 15:13, 6 February 2019
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==

ELowell: minor formatting - fixed the note

2017-03-31T15:55:26Z

minor formatting - fixed the note

← Older revision		Revision as of 15:55, 31 March 2017
Line 29:		Line 29:
	<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 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 ~~class="note"><b>Note:</b>~~		<p>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.</p></blockquote>
	~~<br/>The file message automatically is deleted when a file is recreated or reinitialized.~~
	~~<br/>Whenever a file is displayed, it is preceded by the header:~~
	~~<br/></p>~~
	~~<p class="code">MESSAGE FROM FILE <var class="term">filename</var>~~
	~~</p><p>~~
	~~<br/~~>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.</p>
	====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>

ELowell: /* Message timing */

2017-01-28T00:43:55Z

Message timing

← Older revision		Revision as of 00:43, 28 January 2017
Line 69:		Line 69:

	<tr> <th align="right"><var> 37</var></th> <td>SNA Communications Server 3767 and NTO		<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.7.</p></td> </tr>		<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>

ELowell: /* Message timing */

2016-08-05T22:21:15Z

Message timing

← Older revision		Revision as of 22:21, 5 August 2016
Line 63:		Line 63:
	<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.7.</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 80:
	</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>

ELowell at 22:35, 11 December 2013

2013-12-11T22:35:31Z

← Older revision		Revision as of 22:35, 11 December 2013
Line 79:		Line 79:
	<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>
	====Interrupting end-users====		====Interrupting end-users====
	<p>See "Evaluating whether to issue a BROADCAST URGENT command" in [[BROADCAST command: Sending a login message\|BROADCAST: Sending a login message]].</p>		<p>See "Evaluating whether to issue a BROADCAST URGENT command" in [[BROADCAST command: Sending a login message\|BROADCAST: Sending a login message]].</p>

ELowell: /* Usage notes */

2013-07-16T19:05:30Z

Usage notes

← Older revision		Revision as of 19:05, 16 July 2013
Line 35:		Line 35:
	<br/>Whenever a file is displayed, it is preceded by the header:		<br/>Whenever a file is displayed, it is preceded by the header:
	<br/></p>		<br/></p>
	<p class="code">MESSAGE FROM FILE filename		<p class="code">MESSAGE FROM FILE <var class="term">filename</var>
	</p><p>		</p><p>
	<br/>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. </p>		<br/>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.</p>
	====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 79:		Line 79:
	<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 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~~. For more information about <var class="product">Model 204</var> update units, see the <var>Model 204 File Manager's Guide</var>~~.</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>
	~~<p>~~Interrupting end-users~~</p>~~		====Interrupting end-users====
	<p>See "Evaluating whether to issue a BROADCAST URGENT command" in [[BROADCAST command: Sending a login message\|BROADCAST: Sending a login message]].</p>		<p>See "Evaluating whether to issue a BROADCAST URGENT command" in [[BROADCAST command: Sending a login message\|BROADCAST: Sending a login message]].</p>

	[[Category: File manager commands]]		[[Category: File manager commands]]
	[[Category:Commands]]		[[Category:Commands]]

ELowell: /* Syntax */

2013-07-16T19:00:01Z

Syntax

← Older revision		Revision as of 19:00, 16 July 2013
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax">BROADCAST FILE [URGENT][text]		<p class="syntax">BROADCAST FILE [URGENT][<var class="term">text</var>]
	</p>		</p>

	<b>Where:</b>		<b>Where:</b>
	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).		<var class="term">text</var> is the new file message; if <var class="term">text</var> 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===		===Syntax notes===
	<p>Multiple lines of text are specified in the form:</p>		<p>Multiple lines of text are specified in the form:</p>
	<p class="code">line1/line2.../		<p class="code"><var class="term">line1</var>/<var class="term">line2</var>.../
	</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 INCCC parameter.</p>

	==Example==		==Example==
	<p class="code">BROADCAST FILE URGENT NO FURTHER UPDATES ALLOWED TODAY		<p class="code">BROADCAST FILE URGENT NO FURTHER UPDATES ALLOWED TODAY