Parameter Description for Callable Services

All the parameters of the APPC/MVS callable system services are required positional parameters. When you invoke a service, you must specify all the parameters in the order listed. APPC/MVS checks all parameters for valid values, regardless of whether the parameters are used in call processing. Even though a language may allow parameters to be omitted, APPC/MVS services do not.

Note: Some parameters do not require values and allow you to substitute zeros or a string of blanks for the parameter. The descriptions of the parameters identify those that can be replaced by blanks or zeros, and when to do so.

In the descriptions of services in this document, each parameter is described as supplied or returned:

Supplied: You supply a value for the parameter in the call.
Returned: The service returns a value in the named parameter when the call is finished (for example, return_code).

Each parameter is also described in terms of its data type, character set, and length:

Data type

Either address, character string, integer, pointer, or structure.

Character set

Applies only to parameters whose values are character strings and governs the values allowed for that parameter. Possible character sets are:

No restriction
There is no restriction on the byte values contained in the character string.
Type A EBCDIC
The string can contain only uppercase alphabetics, numerics, and national characters (@, $, #), and must begin with an alphabetic or national character. Use of @, $, and # is discouraged, because those characters display differently on different national code pages.
01134
The string can contain uppercase alphabetics or numerics, with no restriction on the first character.
00640
The string can contain upper- or lowercase alphabetics, numerics, or any of 19 special characters with no restriction on the first character.
Note: APPC/MVS does not allow blanks in 00640 character strings.

For more detailed information about the characters in each character set, see Character sets.

Length

Depends on the data type of the parameter:

For an address, integer, or pointer, the length indicates the size of the field in bits.
For a character-string parameter, the length value indicates the number of characters that can be contained in a character type parameter. The length can specify a single number or a minimum and maximum number.
For a structure parameter, the length value indicates the size of the structure in bytes, or a minimum and maximum size if the size of the structure is variable.