$Setg Sys List: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 24: Line 24:
<p class="code"> 0 - No errors
<p class="code"> 0 - No errors
-3 - No room to create $list items
-3 - No room to create $list items
      (if LISTFC <var>$SirParm</var> parameter not set)
    (if LISTFC <var>$SirParm</var> parameter not set)
-6 - $List identifier invalid
-6 - $List identifier invalid
</p>
</p>


==Usage notes==
==Usage notes==
This function can be used for debugging, to retrieve values of selected system global variables. The names global variables can be specified using the following wildcard characters:
<ul>
<li>This function can be used for debugging, to retrieve values of selected system global variables. The names global variables can be specified using the following wildcard characters:


<table class="syntaxTable">
<table class="syntaxTable">
Line 42: Line 43:
</td></tr></table>
</td></tr></table>


The format of the items created by $Setg_Sys_List is as follows; '''ss''' is the length of the separator string, '''gg''' is the length of the global name, '''vv''' is the length of the global value:
<li>The format of the items created by $Setg_Sys_List is as follows:


<p class="code">Length Description
<table>
&#45;----- ----------------
<tr class="head"><th>Length</th> <th>Description</th></tr>
10 Blanks
<tr><th><var>10</var></th> <td>Blanks</td></tr>
gg Global name
<tr><th>gg</th> <td>Global name</td></tr>
ss Separator string
<tr><th>ss</th> <td>Separator string</td></tr>
vv Global value
<tr><th>vv</th> <td>Global value</td></tr>
</p>
</table>


==Example==
==Example==
Line 73: Line 74:
<li>[[Janus Web Server]]
<li>[[Janus Web Server]]
</ul>  
</ul>  
<p>
 
</p>


[[Category:$Functions|$Setg_Sys_List]]
[[Category:$Functions|$Setg_Sys_List]]

Revision as of 21:26, 19 July 2013

Get list of system-wide globals

Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Sys_List function is ListOfGlobals.

This function returns names and values from the current set of system global variables. It may be useful in debugging situations.

The $Setg_Sys_List function accepts three arguments and returns zero, indicating success, or a number indicating the cause of error, if there is one.

The first argument identifies the $list to which items for the subsystem globals will be added. This is a required argument.

The second argument is the string which is used to separate the global name from its value in each item of the output $list. This is an optional argument; if omitted, or if the null string is supplied, it defaults to a single byte with value X'00'. This separator value (X'00') can be particularly useful for sorting the output $list; see $Setg_Subsys_List for an example with sorting.

The third argument is a pattern string; all system global variables matching this pattern are placed on the output $list. This is an optional argument; if omitted, all system global variables are placed on the output $list.

Syntax

%rc = $Setg_Sys_List(list_id, [sep], [glob_pat])

%rc is set to 0 or to an error indicator.

Return codes

0 - No errors -3 - No room to create $list items (if LISTFC $SirParm parameter not set) -6 - $List identifier invalid

Usage notes

  • This function can be used for debugging, to retrieve values of selected system global variables. The names global variables can be specified using the following wildcard characters:
    * Matches any number of characters including none
    ? Matches any single character
    " Indicates that the next character must be treated literally even if it is a wildcard character.
  • The format of the items created by $Setg_Sys_List is as follows:
    Length Description
    10 Blanks
    gg Global name
    ss Separator string
    vv Global value

    Example

    The following request displays information about the system global variables whose names start with the string 'DATE' or with the string 'EXPIRE'. A single slash character ("/") is used to separate the global name from the global value. (This example assumes that the combined length of the global name and value is less than 245.)

    BEGIN %L FLOAT %X FLOAT %L = $ListNew %X = $Setg_Sys_List(%L, '/', 'DATE*') * Append more globals to $list: %X = $Setg_Sys_List(%L, '/', 'EXPIRE*') FOR %X FROM 1 TO $ListCnt(%L) PRINT $ListInf(%L, %X) END FOR END

    Products authorizing $Setg_Sys_List