IBM 2 Computer Hardware User Manual


 
CCA Release 2.54
each verb. For descriptions of these parameters, see the definitions with the
individual verbs.
Variable Direction: The parameter descriptions use the following terms to identify
the flow of information:
Input The application program sends the variable to the verb (to the
called routine)
Output The verb returns the variable to the application program
In/Output The application program sends the variable to the verb, or the verb
returns the variable to the application program, or both.
Variable Type: A variable that is identified by a verb parameter can be a single
value or a one-dimensional array. If a parameter identifies an array, each data
element of the array is of the same data type. If the number of elements in the
array is variable, a preceding parameter identifies a variable that contains the
actual number of elements in the associated array. Unless otherwise stated, a
variable is a single value, not an array.
For each verb, the parameter descriptions use the following terms to describe the
type of variable:
Integer A four-byte (32-bit), signed, two's-complement binary number.
In the AIX and OS/400 environments, integer values are presented in
four bytes in the sequence high-order to low-order (big endian). In the
personal computer (Intel) environments, integer values are presented
in four bytes in the sequence low-order to high-order (little endian).
String A series of bytes where the sequence of the bytes must be maintained.
Each byte can take on any bit configuration. The string consists only
of the data bytes. No string terminators, field-length values, or
type-casting parameters are included. Individual verbs can restrict the
byte values within the string to characters or numerics.
Character data must be encoded in the native character set of the
computer where the data is used. Exceptions to this rule are noted
where necessary.
Array An array of values, which can be integers or strings. Only
one-dimensional arrays are permitted. For information about the
parameters that use arrays, see “Rule_Array and Other Keyword
Parameters” on page 1-12.
Variable Length: This is the length, in bytes, of the variable identified by the
parameter being described. This length may be expressed as a specific number of
bytes or it may be expressed in terms of the contents of another variable.
For example, the length of the exit_data variable is expressed in this manner. The
length of the exit_data string variable is specified in the exit_data_length variable.
This length is shown in the parameter tables as “exit_data_length bytes,” The
rule_array variable, on the other hand, is an array whose elements are eight-byte
strings. The number of elements in the rule array is specified in the
rule_array_count variable and its length is shown as “rule_array_count * 8 bytes.”
Note: Variable lengths (integer, for example) that are implied by the variable data
type are not shown in these tables.
1-10 IBM 4758 CCA Basic Services, Release 2.54, February 2005