All the parameters of the callable services are required positional
parameters. When you specify a call, you must specify all the parameters
in the order listed.
Note: Some parameters do not require
values, and allow you to substitute zeros for the parameter. The descriptions
of the parameters identify those that can be replaced by zeros, and
when to do so.
In the descriptions of the calls, each parameter is described as
supplied or
returned:
- Supplied means that you supply a value for
the parameter in the call.
- Returned means that the service returns
a value in the named parameter when the call is finished (for example, Return_code).
- Some parameters are both supplied and returned.
Each parameter is also described in terms of its
data
type and
length:
- Data type is one of the following: integer,
address, character string, or structure.
- Length depends on the data type of the parameter:
- For an address item, the length is a fullword (for AMODE 31 callers)
or a doubleword (for AMODE 64 callers).
- For an integer item, the length indicates the size of the field
in bytes or fullwords: bytes are 1, 2, 3, 4, or 8.
- For a character string parameter, the length indicates the number
of characters that can be contained in a character-type parameter.
- For a structure parameter, the length indicates the size of the
structure in bytes or fullwords, or refers to a label in the structure's
mapping macro that defines the length.