SNAX Creator-2 Configuration and Control Manual
Built-in Functions
Attributes and Built-in Functions for SNAX Creator-2
5–8 117143 SNAX Creator-2 Configuration and Control Manual
configuration. For SNAX/APN, the APPLFILE attribute is in the ADD LU
command for the SNAX/APN logon manager (TLOGMGR) LU. For SNAX/XF,
the APPLFILE attribute is in the ADD APPL command (not to be confused with
the ADD APPL command described elsewhere in this manual).
[#CPUA]
selects an operational CPU (0 through 15) on the system defined by [#SYSTEM].
If the CPUS attribute has been defined, the selection is limited to the set of
numbers specified there. Otherwise, any operational CPU may be selected.
[#CPUB]
selects an operational CPU (0 through 15, excluding the value of [#CPUA]) on the
system defined by [#SYSTEM]. If the CPUS attribute has been defined, the
selection is limited to the set of numbers specified there. Otherwise, any
operational CPU may be selected. If only one CPU is operational, the value -1 is
returned.
[#KEYWORD
name
default-value
]
returns the value of the
name
parameter in the logon user data. If the
name
parameter is not present, the built-in function returns
default-value
. The
default value can be omitted, in which case the keyword has a default value that is
empty.
SNAX Creator-2 processes the user data as follows:
1. If NAMERULE is FIRSTWORD, removes the string from the first non-blank
until the next subsequent blank.
2. Searches the user data for the keyword
name
followed by a blank (the search
is not case-sensitive).
3. If the keyword
name
is found, returns as the value the subsequent string until
the next comma or end of data (leading and trailing blanks are removed).
4. If the keyword
name
is not found or has no value, [#KEYWORD] returns the
value
default-value
.
5. If the keyword
name
appears twice, or is greater than the value of the
MAXARGS attribute (if specified), an event is produced, and the logon fails.
[#
num
]
returns the parameter in the
num
position in the logon user data.
num
can be any
positive integer. If no parameter is found in the
num
position, the function returns
an empty string.
If NAMERULE is FIRSTWORD, SNAX Creator-2 processes the user data as
follows:
1. Removes the string from the first non-blank to the next subsequent blank.