$EcbDGet: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (add italics) |
||
| (5 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
<var>$ | <var>$EcbDGet</var> gets string data associated with an Event Control Block (ECB). | ||
==Syntax== | ==Syntax== | ||
<p class=" | <p class="syntax">$EcbDGetT(<span class="term">ECB-number</span> | 'CPQZ') | ||
</p> | </p> | ||
<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 from which to retrieve the text. The ECB | <li><var class="term">ECB-number</var> is a string with a numeric value from one to the <var>NECBS</var> parameter that identifies the ECB from which to retrieve the text. The ECB number can be expressed as a numeric literal, a %variable, or a field name.</li> | ||
<li>CPQZ is a named ECB used by the NonStop/204 facility to automatically post an extended quiesce. See [[System and media recovery#Media recovery NonStop/204|Media recovery NonStop/204]] for an explanation of the facility. | <li>CPQZ is a named ECB used by the NonStop/204 facility to automatically post an extended quiesce. See [[System and media recovery#Media recovery NonStop/204|Media recovery NonStop/204]] for an explanation of the facility. | ||
<p> | <p> | ||
To use CPQZ, you need not set the NECBS parameter. CPQZ can be expressed as a literal, a %variable, or a field name. When CPQZ is specified, the value of the <var>$ | To use CPQZ, you need not set the NECBS parameter. CPQZ can be expressed as a literal, a %variable, or a field name. When CPQZ is specified, the value of the <var>$EcbDGet</var> function can be non-null (except for error values) during only extended quiesce. CPQZ is internally cleared to null when the system exits extended quiesce.</p></li> | ||
</ul> | </ul> | ||
==Usage== | ==Usage== | ||
<p> | <p> | ||
When the <var>$ | When the <var>$EcbDGet</var> function is successful, it returns your data as a text string up to 255 bytes long. If you make a coding mistake, you may receive one of the following return codes as a string.</p> | ||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
| Line 21: | Line 21: | ||
<th>Meaning</th> | <th>Meaning</th> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td | <td>2 </td> | ||
<td>Bad argument specified</td> | <td>Bad argument specified</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<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 | <td>4 </td> | ||
<td>The input argument is less than one or greater than the NECBS parameter</td> | <td>The input argument is less than one or greater than the NECBS parameter</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td | <td>5 </td> | ||
<td>NUSERS = 1</td> | <td>NUSERS = 1</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td | <td>8 </td> | ||
<td>No argument specified</td> | <td>No argument specified</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td | <td>9</td> | ||
<td>Checkpoints are inactive, if using extended quiesce ECB named CPQZ</td> | <td>Checkpoints are inactive, if using extended quiesce ECB named CPQZ</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<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> | ||
</table> | </table> | ||
<p> | <p> | ||
The <var>$ | The <var>$EcbDGet</var> function retrieves data set by either the <var>[[$EcbDSet]]</var> function or the <var>[[$Post]]</var> function for the specified ECB.</p> | ||
<p> | |||
The post code, set by the <var>$Post</var> function, can be obtained by the <var>[[$StatusD]]</var> function issued after the <var>[[$EcbTest]]</var> function. | |||
==Example== | ==Example== | ||
<p class="code">%x = $ | <p class="code">%x = $ecbdGet(17) | ||
</p> | </p> | ||
==See also== | |||
The ECB-related $functions are: | |||
<ul> | |||
<li><var>[[$EcbDGet]]</var> | |||
<li><var>[[$EcbDSet]]</var> | |||
<li><var>[[$EcbTest|$EcbTest]]</var> | |||
<li><var>[[$Post]]</var> | |||
<li><var>[[$UnPost]]</var> | |||
<li><var>[[$Wait]]</var> | |||
</ul> | |||
[[Category:SOUL $functions]] | [[Category:SOUL $functions]] | ||
Latest revision as of 17:40, 2 January 2018
$EcbDGet gets string data associated with an Event Control Block (ECB).
Syntax
$EcbDGetT(ECB-number | 'CPQZ')
Where:
- ECB-number is a string with a numeric value from one to the NECBS parameter that identifies the ECB from which to retrieve the text. The ECB number can be expressed as a numeric literal, a %variable, or a field name.
- CPQZ is a named ECB used by the NonStop/204 facility to automatically post an extended quiesce. See Media recovery NonStop/204 for an explanation of the facility.
To use CPQZ, you need not set the NECBS parameter. CPQZ can be expressed as a literal, a %variable, or a field name. When CPQZ is specified, the value of the $EcbDGet function can be non-null (except for error values) during only extended quiesce. CPQZ is internally cleared to null when the system exits extended quiesce.
Usage
When the $EcbDGet function is successful, it returns your data as a text string up to 255 bytes long. If you make a coding mistake, you may receive one of the following return codes as a string.
| Return code | Meaning |
|---|---|
| 2 | Bad argument specified |
| 3 | NECBS parameter is not specified or is zero |
| 4 | The input argument is less than one or greater than the NECBS parameter |
| 5 | NUSERS = 1 |
| 8 | No argument specified |
| 9 | Checkpoints are inactive, if using extended quiesce ECB named CPQZ |
| 12 | Invalid argument CPQZ or invalid argument following QZSIG. |
The $EcbDGet function retrieves data set by either the $EcbDSet function or the $Post function for the specified ECB.
The post code, set by the $Post function, can be obtained by the $StatusD function issued after the $EcbTest function.
Example
%x = $ecbdGet(17)
See also
The ECB-related $functions are: