$UnPost - Revision history

JAL: add italics

2018-01-02T17:28:00Z

add italics

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

	==Syntax==		==Syntax==
	<p class="~~code~~">$UnPost(ECB-number)		<p class="syntax">$UnPost(<span class="term">ECB-number</span>)
	</p>		</p>
	<p>		<p>
	Where:</p>		Where:</p>
	<p>ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>		<p>
			<var class="term">ECB-number</var> is a numeric value from one to the <var>NECBS</var> parameter that identifies the ECB to be unposted. The ECB number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>

	==Usage==		==Usage==
Line 24:		Line 25:

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

	<tr>		<tr>
	<td ~~align="right"~~>2 </td>		<td>2 </td>
	<td>Bad argument specified</td>		<td>Bad argument specified</td>
	</tr>		</tr>

	<tr>		<tr>
	<td ~~align="right"~~>3</td>		<td>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>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>
Line 49:		Line 50:

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

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

Dme: /* Usage */

2017-12-27T12:40:50Z

Usage

@@ Line 58: / Line 58: @@
 </tr>
 </table>
 [[Category:SOUL $functions]]

JALWiccan: Automatically generated page update

2014-09-08T20:13:36Z

Automatically generated page update

← Older revision		Revision as of 20:13, 8 September 2014
Line 13:		Line 13:
	<p>Use the <var>$Post</var>, <var>$UnPost</var>, and <var>$Wait</var> functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the <var>$Wait</var> and <var>$Post</var> functions are valid.</p>		<p>Use the <var>$Post</var>, <var>$UnPost</var>, and <var>$Wait</var> functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the <var>$Wait</var> and <var>$Post</var> functions are valid.</p>
	<p>		<p>
	<var>$UnPost</var> does not reset the contents of the post code or string data set by the <var>$Post</var> or <var>$~~EcbDset~~</var> functions for the specified ECB.</p>		<var>$UnPost</var> does not reset the contents of the post code or string data set by the <var>$Post</var> or <var>$EcbDSet</var> functions for the specified ECB.</p>
	<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the <var>$UnPost</var> function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next <var>$Post</var> function is issued.</p>		<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the <var>$UnPost</var> function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next <var>$Post</var> function is issued.</p>
	<p>		<p>

JAL at 19:51, 8 September 2014

2014-09-08T19:51:40Z

← Older revision		Revision as of 19:51, 8 September 2014
Line 1:		Line 1:
	<b>~~Function~~</b>		<var>$UnPost</var> resets a specified Event Control Block (ECB) to an unposted state, meaning that the event has not yet occurred or has not recurred. Resets the post code to zero.
	~~<p>Resets~~ a specified Event Control Block (ECB) to an unposted state, meaning that the event has not yet occurred or has not recurred. Resets the post code to zero.~~</p>~~
	~~<b>~~Syntax~~</b>~~		==Syntax==
	<p class="code">$UnPost(ECB-number)		<p class="code">$UnPost(ECB-number)
	</p>		</p>
	<p>Where:</p>		<p>
			Where:</p>
	<p>ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>		<p>ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>
	~~<b>~~Usage~~</b>~~
	<p>Use the <var>$UnPost</var> function to unpost a specified, numbered ECB. An ECB must be unposted before another post or wait on this ECB takes place. The <var>$Post</var> and <var>$Wait</var> functions do not unpost an ECB, so that a subsequent wait on the same ECB cannot take place, because the ECB is still posted from the previous posting. </p>		==Usage==
	<p>Use the <var>$Post</var>, <var>$UnPost</var>, and $~~WAIT~~ functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the $~~WAIT~~ and $~~POST~~ functions are valid.</p>		<p>
			Use the <var>$UnPost</var> function to unpost a specified, numbered ECB. An ECB must be unposted before another post or wait on this ECB takes place. The <var>$Post</var> and <var>$Wait</var> functions do not unpost an ECB, so that a subsequent wait on the same ECB cannot take place, because the ECB is still posted from the previous posting. </p>
			<p>Use the <var>$Post</var>, <var>$UnPost</var>, and <var>$Wait</var> functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the <var>$Wait</var> and <var>$Post</var> functions are valid.</p>
	<p>		<p>
	<var>$UnPost</var> does not reset the contents of the post code or string data set by the <var>$Post</var> or $~~ECBDSET~~ functions for the specified ECB.</p>		<var>$UnPost</var> does not reset the contents of the post code or string data set by the <var>$Post</var> or <var>$EcbDset</var> functions for the specified ECB.</p>
	<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the <var>$UnPost</var> function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next <var>$Post</var> function is issued.</p>		<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the <var>$UnPost</var> function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next <var>$Post</var> function is issued.</p>
	<p>		<p>
Line 19:		Line 22:
	<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>
	<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">12</td>		<td align="right">12</td>

Admin at 19:10, 8 September 2014

2014-09-08T19:10:16Z

← Older revision		Revision as of 19:10, 8 September 2014
Line 2:		Line 2:
	<p>Resets a specified Event Control Block (ECB) to an unposted state, meaning that the event has not yet occurred or has not recurred. Resets the post code to zero.</p>		<p>Resets a specified Event Control Block (ECB) to an unposted state, meaning that the event has not yet occurred or has not recurred. Resets the post code to zero.</p>
	<b>Syntax</b>		<b>Syntax</b>
	<p class="code">$~~UNPOST~~(ECB-number)		<p class="code">$UnPost(ECB-number)
	</p>		</p>
	<p>Where:</p>		<p>Where:</p>
	<p>ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>		<p>ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.</p>
	<b>Usage</b>		<b>Usage</b>
	<p>Use the $~~UNPOST~~ function to unpost a specified, numbered ECB. An ECB must be unposted before another post or wait on this ECB takes place. The $~~POST~~ and $~~WAIT~~ functions do not unpost an ECB, so that a subsequent wait on the same ECB cannot take place, because the ECB is still posted from the previous posting. </p>		<p>Use the <var>$UnPost</var> function to unpost a specified, numbered ECB. An ECB must be unposted before another post or wait on this ECB takes place. The <var>$Post</var> and <var>$Wait</var> functions do not unpost an ECB, so that a subsequent wait on the same ECB cannot take place, because the ECB is still posted from the previous posting. </p>
	<p>Use the $~~POST~~, $~~UNPOST~~, and $WAIT functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the $WAIT and $POST functions are valid.</p>		<p>Use the <var>$Post</var>, <var>$UnPost</var>, and $WAIT functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the $WAIT and $POST functions are valid.</p>
	<p>$~~UNPOST~~ does not reset the contents of the post code or string data set by the $~~POST~~ or $ECBDSET functions for the specified ECB.</p>		<p>
	<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the $~~UNPOST~~ function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next $~~POST~~ function is issued.</p>		<var>$UnPost</var> does not reset the contents of the post code or string data set by the <var>$Post</var> or $ECBDSET functions for the specified ECB.</p>
	<p>The following return codes apply to the $~~UNPOST~~ function:</p>		<p class="note"><b>Note:</b> Even in a non-multiprocessing environment, the <var>$UnPost</var> function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next <var>$Post</var> function is issued.</p>
			<p>
			The following return codes apply to the <var>$UnPost</var> function:</p>
	<table>		<table>
	<tr class="head">		<tr class="head">
Line 46:		Line 48:
	</tr>		</tr>
	</table>		</table>

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

Admin: Admin moved page $UNPOST to $UnPost without leaving a redirect: caps in title

2014-09-08T18:59:04Z

Admin moved page $UNPOST to $UnPost without leaving a redirect: caps in title

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

Alex: Automatically generated page update

2013-04-20T13:18:29Z

Automatically generated page update

New page

Function
Resets a specified Event Control Block (ECB) to an unposted state, meaning that the event has not yet occurred or has not recurred. Resets the post code to zero.
Syntax
$UNPOST(ECB-number)

Where:
ECB-number is a numeric value from one to the NECBS parameter that identifies the ECB to be unposted. The ECB-number can be expressed as a numeric literal, a literal enclosed in quotation marks, a %variable, or a field name.
Usage
Use the $UNPOST function to unpost a specified, numbered ECB. An ECB must be unposted before another post or wait on this ECB takes place. The $POST and $WAIT functions do not unpost an ECB, so that a subsequent wait on the same ECB cannot take place, because the ECB is still posted from the previous posting. 
Use the $POST, $UNPOST, and $WAIT functions to coordinate processing between threads for numbered ECBs. For the extended quiesce ECB, QZSIG, only the $WAIT and $POST functions are valid.
$UNPOST does not reset the contents of the post code or string data set by the $POST or $ECBDSET functions for the specified ECB.
Note: Even in a non-multiprocessing environment, the $UNPOST function should be used with extreme care. Unposting an ECB while users are waiting on it may keep users in a wait state forever or until the next $POST function is issued.
The following return codes apply to the $UNPOST function:
<table>
<tr class="head">
<th>Return code </th>
<th>Meaning</th>
</tr>
<tr>
<td align="right">0 </td>
<td>Success</td>
</tr>
<tr>
<td align="right">2 </td>
<td>Bad argument specified</td>
</tr>
<tr>
<td align="right">3</td>
<td>NECBS parameter is not specified or is zero</td>
</tr>
<tr>
<td align="right">4 </td>
<td>The first argument is less than one or greater than the NECBS parameter</td>
</tr>
<tr>
<td align="right">5 </td>
<td>NUSERS = 1</td>
</tr>
<tr>
<td align="right">8 </td>
<td>No argument specified</td>
</tr>
<tr>
<td align="right">12</td>
<td>Invalid argument CPQZ or invalid argument following QZSIG</td>
</tr>
</table>
[[Category:SOUL $functions]]