Name of the directive
INPUT; CHAR(*)
The name of the directive to retrieve.
Length of the directive name
INPUT; BINARY(4)
The length of the directive name.
Number of values returned
OUTPUT; BINARY(4)
The number of values returned in the output buffer. This value will be zero if
the server finds no matching directives or if there was not enough space
available for all the values.
Format name
INPUT; CHAR(8)
The format of the data returned.The possible format names follow:
RTVD0100 Retrieve length/value pairs.
Buffer containing values
OUTPUT; CHAR(*)
The buffer containing the output.
Length of space available
INPUT; BINARY(4)
The length of the space provided to receive the directive values.
Actual length of total values returned
OUTPUT; BINARY(4)
The actual length of the total values returned. When the API is unable to find a
matching directive, this value will be set to zero. When the size required for
the total value is larger than the length of the space provided, the actual space
required for the total number of values is returned.
Error Code
I/O;CHAR(*)
The structure in which to return error information. For the format of the
structure and for details on how to process API errors, see the programming
topic in the AS/400 Information Center.
Format of Output Data
The buffer will contain data in one of the following formats:
RTVD0100 Format: The server uses the RTVD0100 format to retrieve a list of
length and value pairs for the directive specified.
Offset Type Field
Dec Hex
0 0 BINARY(4) Displacement to next
entry
4 4 CHAR(*) Value
Chapter2. Application Programming Interfaces 41