$TableC: Difference between revisions
m (1 revision) |
EllieWiccan (talk | contribs) (Automatically generated page update) |
||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 2: | Line 2: | ||
<span class="pageSubtitle">Information provided by TABLEC command</span> | <span class="pageSubtitle">Information provided by TABLEC command</span> | ||
<p class=" | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $TableC function, but you can achieve the same results by capturing the output of a TABLEC command executed in a <var>[[Daemon class|Daemon]]</var> request into a Stringlist.</p> | ||
This function allows retrieval of the information provided in the <var>TABLEC</var> command from a <var class="product">User Language</var> program. | This function allows retrieval of the information provided in the <var>TABLEC</var> command from a <var class="product">User Language</var> program. | ||
| Line 9: | Line 9: | ||
==Syntax== | ==Syntax== | ||
<p class="syntax" | <p class="syntax">[%result =] $TableC(image_name, [file]) | ||
</p> | |||
===Syntax terms=== | ===Syntax terms=== | ||
| Line 33: | Line 33: | ||
</p> | </p> | ||
<p> | <p> | ||
See the | See the [[TABLEC command]] and [[Tuning the hash index#Using the TABLEC command in Monitoring|Using the TABLEC command in monitoring]] for more information on the data returned by <var>$TableC</var>.</p></td></tr> | ||
<tr><th>file</th> | <tr><th>file</th> | ||
| Line 68: | Line 68: | ||
==Products authorizing {{PAGENAMEE}}== | ==Products authorizing {{PAGENAMEE}}== | ||
<ul class="smallAndTightList"> | <ul class="smallAndTightList"> | ||
<li>[[Sirius | <li>[[List of $functions|Sirius functions]]</li> | ||
</ul> | </ul> | ||
[[Category:$Functions|$TableC]] | [[Category:$Functions|$TableC]] | ||
Latest revision as of 23:23, 20 September 2018
Information provided by TABLEC command
Note: Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $TableC function, but you can achieve the same results by capturing the output of a TABLEC command executed in a Daemon request into a Stringlist.
This function allows retrieval of the information provided in the TABLEC command from a User Language program.
The $TableC function is callable.
Syntax
[%result =] $TableC(image_name, [file])
Syntax terms
| %result | A numeric variable to receive 0 or an error code. |
|---|---|
| image_name | This required argument is a string identifying an image to receive returned data. This image should have the following format :
IMAGE TABLEC_IMAGE FILE_NAME IS STRING LEN 8 SLOTS_TOTAL IS BINARY LEN 4 SLOTS_USED IS BINARY LEN 4 SLOTS_PCT IS BINARY LEN 4 * FOLLOWING FIELDS SET TO ZERO FOR PRE-8.1 FILES PROP_COUNT IS BINARY LEN 4 PAGE_SPILL IS BINARY LEN 4 PROP_OVFL IS BINARY LEN 4 PROP_SPCT IS BINARY LEN 4 END IMAGE See the TABLEC command and Using the TABLEC command in monitoring for more information on the data returned by $TableC. |
| file | The name of the file on which the $TableC function should operate. If this argument is not specified, the default file at compilation time is used by $TableC. |
Return codes
0 - Image filled with Table C information 4 - File invalid 8 - File not open 12 - Image specified by argument 1 not found 16 - Image specified by argument 1 not active or too short
Example
The following program prints the percentage of slots used in Table C of file ROSA.
B IMAGE JUNK FILE_NAME IS STRING LEN 8 ... END IMAGE PREPARE IMAGE JUNK %RC = $TableC('JUNK', 'ROSA') IF %RC ^= 0 THEN STOP END IF PRINT %JUNK:SLOTS_PCT END