$Post - Revision history

JAL: add italics

2018-01-02T17:21:37Z

add italics

← Older revision		Revision as of 17:21, 2 January 2018
Line 2:		Line 2:

	==Syntax==		==Syntax==
	<p class="code">$Post({ECB-number[,post-code][,string] \| 'QZSIG'})		<p class="code">$Post({<span class="term">ECB-number</span>[,<span class="term">post-code</span>][,<span class="term">string</span>] \| 'QZSIG'})
	</p>		</p>
	<p>Where:</p>		<p>Where:</p>
	<ul>		<ul>
	<li>ECB-number is a string with a numeric value from one to the value of the <var>[[NECBS parameter\|NECBS]]</var> parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>		<li><var class="term">ECB-number</var> is a string with a numeric value from one to the value of the <var>[[NECBS parameter\|NECBS]]</var> parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name. </li>

	<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.		<li><var class="term">post-code</var> is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.
	<p>The post code is accessible using the <var>$EcbTest</var> function followed by the <var>$StatusD</var> function for the specified posted ECB.</p>		<p>The post code is accessible using the <var>$EcbTest</var> function followed by the <var>$StatusD</var> function for the specified posted ECB.</p>
	<p>Once set, unless explicitly reset to zero, post codes persist whether or not the ECB is posted.</p>		<p>Once set, unless explicitly reset to zero, post codes persist whether or not the ECB is posted.</p>
	</li>		</li>

	<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.		<li><var class="term">string</var> can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.
	<p>String data is accessible using the <var>$EcbDGet</var> function for the specified ECB.</p>		<p>String data is accessible using the <var>$EcbDGet</var> function for the specified ECB.</p>
	<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDSet</var> functions.</p></li>		<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDSet</var> functions.</p></li>

Dme: /* Example */

2017-12-27T12:38:47Z

Example

@@ Line 109: / Line 109: @@
 <p>
 In the previous code, the <var>$UnPost</var> function on Thread A marks the ECB specified as unposted. Then, Thread A waits at the <code>$WAIT(1)</code> until another thread issues a <code>$Post(1,nnnn)</code>. Thread B posts the ECB number one with <code>$Post(1,32)</code>, at which point Thread A resumes evaluation with <code>PRINT $STATUSD</code> and prints the post code of 32.</p>
 [[Category:SOUL $functions]]

Dme: /* Syntax */

2017-12-27T12:28:29Z

Syntax

← Older revision		Revision as of 12:28, 27 December 2017
Line 6:		Line 6:
	<p>Where:</p>		<p>Where:</p>
	<ul>		<ul>
	<li>ECB-number is a string with a numeric value from one to the <var>[[NECBS parameter\|NECBS]]</var> parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>		<li>ECB-number is a string with a numeric value from one to the value of the <var>[[NECBS parameter\|NECBS]]</var> parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>

	<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.		<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.

Dme: /* Syntax */

2017-12-27T12:27:23Z

Syntax

← Older revision		Revision as of 12:27, 27 December 2017
Line 6:		Line 6:
	<p>Where:</p>		<p>Where:</p>
	<ul>		<ul>
	<li>ECB-number is a string with a numeric value from one to the NECBS parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>		<li>ECB-number is a string with a numeric value from one to the <var>[[NECBS parameter\|NECBS]]</var> parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>

	<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.		<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.

JAL: add link

2015-03-02T20:51:40Z

add link

← Older revision		Revision as of 20:51, 2 March 2015
Line 22:		Line 22:
	==Usage==		==Usage==
	<p>		<p>
	The <var>$Post</var> function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting ($~~WAIT~~) on the specified ECB becomes eligible to resume processing.</p>		The <var>$Post</var> function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting (<var>[[$Wait]]</var>) on the specified ECB becomes eligible to resume processing.</p>
	<p>Use the <var>$Post</var>, <var>$UnPost</var>, and <var>$Wait</var> functions to coordinate processing between threads. </p>		<p>
			Use the <var>$Post</var>, <var>[[$UnPost]]</var>, and <var>$Wait</var> functions to coordinate processing between threads. </p>
	<p>		<p>
	The following return codes apply to the <var>$Post</var> function</p>		The following return codes apply to the <var>$Post</var> function</p>
Line 31:		Line 32:
	<th>Meaning</th>		<th>Meaning</th>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">0 </td>		<td align="right">0 </td>
	<td>Success</td>		<td>Success</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">2 </td>		<td align="right">2 </td>
Line 42:		Line 45:
	<tr>		<tr>
	<td align="right">3</td>		<td align="right">3</td>
	<td>NECBS parameter is not specified or is zero</td>		<td><var>[[NECBS and NOECBS parameters\|NECBS]]</var> parameter is not specified or is zero</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">4 </td>		<td align="right">4 </td>
	<td>The first argument is less than one or greater than the NECBS parameter</td>		<td>The first argument is less than one or greater than the <var>NECBS</var> parameter</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">5 </td>		<td align="right">5 </td>
	<td>NUSERS = 1</td>		<td><var>[[NUSERS parameter\|NUSERS]]</var> is 1</td>
	</tr>		</tr>

JALWiccan: Automatically generated page update

2014-09-08T20:15:07Z

Automatically generated page update

← Older revision		Revision as of 20:15, 8 September 2014
Line 14:		Line 14:

	<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.		<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.
	<p>String data is accessible using the <var>$~~EcbDget~~</var> function for the specified ECB.</p>		<p>String data is accessible using the <var>$EcbDGet</var> function for the specified ECB.</p>
	<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDSet</var> functions.</p></li>		<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDSet</var> functions.</p></li>

JALWiccan: Automatically generated page update

2014-09-08T20:13:19Z

Automatically generated page update

← Older revision		Revision as of 20:13, 8 September 2014
Line 15:		Line 15:
	<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.		<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.
	<p>String data is accessible using the <var>$EcbDget</var> function for the specified ECB.</p>		<p>String data is accessible using the <var>$EcbDget</var> function for the specified ECB.</p>
	<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$~~EcbDset~~</var> functions.</p></li>		<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDSet</var> functions.</p></li>

	<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>		<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>

JAL at 19:48, 8 September 2014

2014-09-08T19:48:16Z

← Older revision		Revision as of 19:48, 8 September 2014
Line 1:		Line 1:
	<b>~~Function~~</b>		<var>$Post</var> indicates that some event has occurred. The thread(s) waiting on the Event Control Block (ECB) can resume processing.
	~~<p>Indicates~~ that some event has occurred. The thread(s) waiting on the Event Control Block (ECB) can resume processing.~~</p>~~
	~~<b>~~Syntax~~</b>~~		==Syntax==
	<p class="code">$Post({ECB-number[,post-code][,string] \| 'QZSIG'})		<p class="code">$Post({ECB-number[,post-code][,string] \| 'QZSIG'})
	</p>		</p>
Line 7:		Line 7:
	<ul>		<ul>
	<li>ECB-number is a string with a numeric value from one to the NECBS parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>		<li>ECB-number is a string with a numeric value from one to the NECBS parameter that identifies the ECB to be posted. The ECB-number can be expressed as a numeric literal, a %variable, or a field name.</li>
	~~</li>~~
	<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.~~</li>~~		<li>post-code is a numeric value between zero and 16,777,215. You can use this optional argument for whatever you wish. If omitted, a default post code of zero is used.
	<p>The post code is accessible using the $~~ECBTEST~~ function followed by the $~~STATUSD~~ function for the specified posted ECB.</p>		<p>The post code is accessible using the <var>$EcbTest</var> function followed by the <var>$StatusD</var> function for the specified posted ECB.</p>
	<p>Once set, unless explicitly reset to zero, post codes persist whether or not the ECB is posted.</p>		<p>Once set, unless explicitly reset to zero, post codes persist whether or not the ECB is posted.</p>
	</li>		</li>
	<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name. ~~</li>~~
	<p>String data is accessible using the $~~ECBDGET~~ function for the specified ECB.</p>		<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name.
	<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or $~~ECBDSET~~ functions.</p>		<p>String data is accessible using the <var>$EcbDget</var> function for the specified ECB.</p>
	</li>		<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or <var>$EcbDset</var> functions.</p></li>

	<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>		<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>
	~~</li>~~
	</ul>		</ul>
	~~<b>~~Usage~~</b>~~
	<p>The <var>$Post</var> function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting ($WAIT) on the specified ECB becomes eligible to resume processing.</p>		==Usage==
	<p>Use the <var>$Post</var>, <var>$UnPost</var>, and $~~WAIT~~ functions to coordinate processing between threads. </p>		<p>
	<p>The following return codes apply to the <var>$Post</var> function</p>		The <var>$Post</var> function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting ($WAIT) on the specified ECB becomes eligible to resume processing.</p>
			<p>Use the <var>$Post</var>, <var>$UnPost</var>, and <var>$Wait</var> functions to coordinate processing between threads. </p>
			<p>
			The following return codes apply to the <var>$Post</var> function</p>
	<table>		<table>
	<tr class="head">		<tr class="head">
Line 36:		Line 39:
	<td>Bad argument specified</td>		<td>Bad argument specified</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">3</td>		<td align="right">3</td>
	<td>NECBS parameter is not specified or is zero</td>		<td>NECBS parameter is not specified or is zero</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">4 </td>		<td align="right">4 </td>
	<td>The first argument is less than one or greater than the NECBS parameter</td>		<td>The first argument is less than one or greater than the NECBS parameter</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">5 </td>		<td align="right">5 </td>
	<td>NUSERS = 1</td>		<td>NUSERS = 1</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">8 </td>		<td align="right">8 </td>
	<td>No argument specified</td>		<td>No argument specified</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">9</td>		<td align="right">9</td>
	<td>Checkpointing inactive</td>		<td>Checkpointing inactive</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">10 </td>		<td align="right">10 </td>
	<td>Post code out of range, 0 to 16,777,215</td>		<td>Post code out of range, 0 to 16,777,215</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">11</td>		<td align="right">11</td>
	<td>The QZSIG ECB is already posted</td>		<td>The QZSIG ECB is already posted</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">12</td>		<td align="right">12</td>
	<td>Invalid argument CPQZ specified or invalid argument following QZSIG</td>		<td>Invalid argument CPQZ specified or invalid argument following QZSIG</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">13</td>		<td align="right">13</td>
	<td>Cannot be issued outside of extended quiesce</td>		<td>Cannot be issued outside of extended quiesce</td>
	</tr>		</tr>

	<tr>		<tr>
	<td align="right">14</td>		<td align="right">14</td>
Line 77:		Line 90:
	</tr>		</tr>
	</table>		</table>
	~~<b>~~Example~~</b>~~
			==Example==
	<p>On Thread A</p>		<p>On Thread A</p>
	<p class="code">BEGIN		<p class="code">BEGIN
Line 90:		Line 104:
	END		END
	</p>		</p>
	<p>In the previous code, the $~~UNPOST~~ function on Thread A marks the ECB specified as unposted. Then, Thread A waits at the $WAIT(1) until another thread issues a <code>$Post(1,nnnn)</code>. Thread B posts the ECB number one with <code>$Post(1,32)</code>, at which point Thread A resumes evaluation with PRINT $STATUSD and prints the post code of 32.</p>		<p>
			In the previous code, the <var>$UnPost</var> function on Thread A marks the ECB specified as unposted. Then, Thread A waits at the <code>$WAIT(1)</code> until another thread issues a <code>$Post(1,nnnn)</code>. Thread B posts the ECB number one with <code>$Post(1,32)</code>, at which point Thread A resumes evaluation with <code>PRINT $STATUSD</code> and prints the post code of 32.</p>

	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Admin: minor cleanup

2014-09-08T19:07:13Z

minor cleanup

← Older revision		Revision as of 19:07, 8 September 2014
Line 2:		Line 2:
	<p>Indicates that some event has occurred. The thread(s) waiting on the Event Control Block (ECB) can resume processing.</p>		<p>Indicates that some event has occurred. The thread(s) waiting on the Event Control Block (ECB) can resume processing.</p>
	<b>Syntax</b>		<b>Syntax</b>
	<p class="code">$~~POST~~({ECB-number[,post-code][,string] \| 'QZSIG'})		<p class="code">$Post({ECB-number[,post-code][,string] \| 'QZSIG'})
	</p>		</p>
	<p>Where:</p>		<p>Where:</p>
Line 14:		Line 14:
	<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name. </li>		<li>string can be up to 255 bytes long. It can be a numeric, a literal enclosed in quotation marks, a %variable, or a field name. </li>
	<p>String data is accessible using the $ECBDGET function for the specified ECB.</p>		<p>String data is accessible using the $ECBDGET function for the specified ECB.</p>
	<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the $~~POST~~ or $ECBDSET functions.</p>		<p>Once set, unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the <var>$Post</var> or $ECBDSET functions.</p>
	</li>		</li>
	<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>		<li>QZSIG is an extended quiesce named ECB. To use it, you need not set the NECBS parameter. QZSIG can be expressed as a literal, a %variable, or a field name. Although QZSIG can be posted, it cannot be unposted. Unposting is handled internally at the end of the extended quiesce. You cannot specify a post code or a string for QZSIG.</li>
Line 20:		Line 20:
	</ul>		</ul>
	<b>Usage</b>		<b>Usage</b>
	<p>The $~~POST~~ function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting ($WAIT) on the specified ECB becomes eligible to resume processing.</p>		<p>The <var>$Post</var> function posts a specified ECB with an optional post code and an optional associated string. Only an unposted ECB may be posted. If an ECB is already posted, the posted state is indicated by return code 14. The ECB contents and associated string do not change. Any other thread waiting ($WAIT) on the specified ECB becomes eligible to resume processing.</p>
	<p>Use the $~~POST~~, $~~UNPOST~~, and $WAIT functions to coordinate processing between threads. </p>		<p>Use the <var>$Post</var>, <var>$UnPost</var>, and $WAIT functions to coordinate processing between threads. </p>
	<p>The following return codes apply to the $~~POST~~ function</p>		<p>The following return codes apply to the <var>$Post</var> function</p>
	<table>		<table>
	<tr class="head">		<tr class="head">
Line 90:		Line 90:
	END		END
	</p>		</p>
	<p>In the previous code, the $UNPOST function on Thread A marks the ECB specified as unposted. Then, Thread A waits at the $WAIT(1) until another thread issues a $~~POST~~(1,nnnn). Thread B posts the ECB number one with $~~POST~~(1,32), at which point Thread A resumes evaluation with PRINT $STATUSD and prints the post code of 32.</p>		<p>In the previous code, the $UNPOST function on Thread A marks the ECB specified as unposted. Then, Thread A waits at the $WAIT(1) until another thread issues a <code>$Post(1,nnnn)</code>. Thread B posts the ECB number one with <code>$Post(1,32)</code>, at which point Thread A resumes evaluation with PRINT $STATUSD and prints the post code of 32.</p>

	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Admin: Admin moved page $POST to $Post without leaving a redirect: caps in title

2014-09-08T18:53:48Z

Admin moved page $POST to $Post without leaving a redirect: caps in title

← Older revision	Revision as of 18:53, 8 September 2014
(No difference)