LoadParameterInfo (XmlDoc subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 1: Line 1:
{{Template:XmlDoc:LoadParameterInfo subtitle}}
{{Template:XmlDoc:LoadParameterInfo subtitle}}


This method loads an XmlDoc with information about ''Model 204'' parameters
This method loads an <var>XmlDoc</var> with information about ''Model 204'' parameters
in CCA and Sirius products.
in CCA and Sirius products.
A "pattern" argument lets you select parameters
A "pattern" argument lets you select parameters
Line 14: Line 14:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>doc</th>
<tr><th>doc</th>
<td>An expression that points to the XmlDoc to contain the selected parameter information. This XmlDoc instance must be empty. </td></tr>
<td>An expression that points to the <var>XmlDoc</var> to contain the selected parameter information. This <var>XmlDoc</var> instance must be empty. </td></tr>
<tr><th>paramOrFam</th>
<tr><th>paramOrFam</th>
<td>An optional argument that is a complement of, and that may be specified before or after, the ''famOrParam'' argument. This is a string (case ignored, leading and trailing blanks ignored, default null) that represents either of two options, which have the following forms:
<td>An optional argument that is a complement of, and that may be specified before or after, the ''famOrParam'' argument. This is a string (case ignored, leading and trailing blanks ignored, default null) that represents either of two options, which have the following forms:
Line 20: Line 20:
<tr><th><i>paramPattern</i></th>
<tr><th><i>paramPattern</i></th>
<td>This selects, from the sources specified or implied in the method's second argument, all system parameters that match the specified pattern.
<td>This selects, from the sources specified or implied in the method's second argument, all system parameters that match the specified pattern.
<p class="code">Patterns are formed using an asterisk (*) as a wildcard character, where the asterisk stands for one or more characters before or after a specified character string (<tt>A*</tt> or <tt>*A</tt>), or between two specified character strings (<tt>A*BC</tt>). A solitary asterisk selects all parameters (qualified by ''familyString'').
<p class="code">Patterns are formed using an asterisk (*) as a wildcard character, where the asterisk stands for one or more characters before or after a specified character string (<tt>A*</tt> or <tt>*A</tt>), or between two specified character strings (<tt>A*BC</tt>). A solitary asterisk selects all parameters (qualified by ''family<var>String</var>'').
If you omit the ''paramOrFam'' argument, the default for the ''paramPattern'' option is to select all parameters. </td></tr>
If you omit the ''paramOrFam'' argument, the default for the ''paramPattern'' option is to select all parameters. </td></tr>
</p>
</p>
<tr><th><i>familyString</i></th>
<tr><th><i>family<var>String</var></i></th>
<td>Either or both of the strings: <tt>Base</tt> and <tt>Sirius</tt>. <tt>Base</tt> means the ''Model 204'' core product; <tt>Sirius</tt> means the Sirius-added parameters.
<td>Either or both of the strings: <tt>Base</tt> and <tt>Sirius</tt>. <tt>Base</tt> means the ''Model 204'' core product; <tt>Sirius</tt> means the Sirius-added parameters.
<p class="code">If you omit the ''paramOrFam'' argument, the default for the ''familyString'' option is to select from both <tt>Base</tt> and <tt>Sirius</tt> parameters. </td></tr>
<p class="code">If you omit the ''paramOrFam'' argument, the default for the ''family<var>String</var>'' option is to select from both <tt>Base</tt> and <tt>Sirius</tt> parameters. </td></tr>
</p>
</p>
</table>
</table>
Line 36: Line 36:


The parameters that your argument pattern selects are unsorted XML elements
The parameters that your argument pattern selects are unsorted XML elements
in ''doc'', the XmlDoc method object.
in ''doc'', the <var>XmlDoc</var> method object.
The information for each parameter currently includes:
The information for each parameter currently includes:
<ul>
<ul>
Line 54: Line 54:
with <tt>A</tt> and resettable by the system manager.
with <tt>A</tt> and resettable by the system manager.
The SelectNodes method finds the <tt>reset</tt> nodes that have
The SelectNodes method finds the <tt>reset</tt> nodes that have
<tt>System manager</tt> descendants; the Print method displays
<tt><var>System</var> manager</tt> descendants; the Print method displays
the parents of those found nodes:
the parents of those found nodes:
<p class="code">Begin
<p class="code">Begin
%d is Object Xmldoc
%d is <var>Object</var> Xmldoc
%d = new
%d = new
%d:LoadParameterInfo('A*', 'Sirius')
%d:<var>LoadParameterInfo</var>('A*', 'Sirius')
%l Object XmlNodelist
%l <var>Object</var> <var>XmlNodelist</var>
%l = %d:SelectNodes('//reset[.="System manager"]')
%l = %d:SelectNodes('//reset[.="System manager"]')
%i Float
%i <var>Float</var>
For %i From 1 To %l:Count
For %i From 1 To %l:Count
   %l:Item(%i):Print('..')
   %l:Item(%i):Print('..')
Line 74: Line 74:
   <description>ACTIVE RSA SUBTASKS</description>
   <description>ACTIVE RSA SUBTASKS</description>
   <reset additional="EXEC PARM and User 0">
   <reset additional="EXEC PARM and User 0">
       System manager
       <var>System</var> manager
   </reset>
   </reset>
   <viewClass>system</viewClass>
   <viewClass>system</viewClass>
Line 81: Line 81:
</p>
</p>
'''Note:'''
'''Note:'''
The above result displays the XmlDoc format from a ''Sirius Mods'' &Vsn. 7.6 request.
The above result displays the <var>XmlDoc</var> format from a ''Sirius Mods'' &Vsn. 7.6 request.
Prior to version 7.6, the parameter name was the name of a document Element,
Prior to version 7.6, the parameter name was the name of a document Element,
and the parameter description was the Element's text.
and the parameter description was the Element's text.
==See also==
==See also==
{{Template:XmlDoc:LoadParameterInfo footer}}
{{Template:XmlDoc:LoadParameterInfo footer}}

Revision as of 17:46, 25 January 2011

Load parameter info into this XmlDoc (XmlDoc class)


This method loads an XmlDoc with information about Model 204 parameters in CCA and Sirius products. A "pattern" argument lets you select parameters from one or both product families.

This method is primarily intended for User Language products delivered by Sirius Software, and the schema of the returned document may change from release to release.

Syntax

doc:LoadParameterInfo[( [string])]

Syntax terms

doc An expression that points to the XmlDoc to contain the selected parameter information. This XmlDoc instance must be empty.
paramOrFam An optional argument that is a complement of, and that may be specified before or after, the famOrParam argument. This is a string (case ignored, leading and trailing blanks ignored, default null) that represents either of two options, which have the following forms:

paramPattern This selects, from the sources specified or implied in the method's second argument, all system parameters that match the specified pattern.

Patterns are formed using an asterisk (*) as a wildcard character, where the asterisk stands for one or more characters before or after a specified character string (A* or *A), or between two specified character strings (A*BC). A solitary asterisk selects all parameters (qualified by familyString). If you omit the paramOrFam argument, the default for the paramPattern option is to select all parameters.

familyString Either or both of the strings: Base and Sirius. Base means the Model 204 core product; Sirius means the Sirius-added parameters.

If you omit the paramOrFam argument, the default for the familyString option is to select from both Base and Sirius parameters.

famOrParam An optional argument that is a complement of, and that may be specified before or after, the paramOrFam argument. This argument has the same constituent options as paramOrFam, and it is interpreted as the alternative option type of the one you specify in paramOrFam.

Usage notes

The parameters that your argument pattern selects are unsorted XML elements in doc, the XmlDoc method object. The information for each parameter currently includes:

  • As XML attributes: two or more XML attributes that specify where to locate the parameter within internal data structures, maximum and minimum values (if applicable), and possibly other parameter-specific values.
  • As XML child or grandchild elements: a text description of the parameter, where the parameter is set, whether it is a system or user parameter, and whether it is displayed as character, numeric, or hexadecimal.

Example

The following request displays all Sirius parameters beginning with A and resettable by the system manager. The SelectNodes method finds the reset nodes that have System manager descendants; the Print method displays the parents of those found nodes:

Begin %d is Object Xmldoc %d = new %d:LoadParameterInfo('A*', 'Sirius') %l Object XmlNodelist %l = %d:SelectNodes('//reset[.="System manager"]') %i Float For %i From 1 To %l:Count %l:Item(%i):Print('..') End For End

The example result follows (the long first line is wrapped for display purposes).

<parameter name="ACTRDS" table="KZS" offset="036C" looseMin="-32,768" looseMax="32,767"> <description>ACTIVE RSA SUBTASKS</description> <reset additional="EXEC PARM and User 0"> System manager </reset> <viewClass>system</viewClass> <displayType>numeric</displayType> </parameter>

Note: The above result displays the XmlDoc format from a Sirius Mods &Vsn. 7.6 request. Prior to version 7.6, the parameter name was the name of a document Element, and the parameter description was the Element's text.

See also