Parameter values that are set by the application

FCAI-Map

Storage area (defined in EZAFTPKC for COBOL) used to save information about the requests using the FTP client API.

REQUEST-TYPE

A 4-byte field that contains GETL.

OPERATION

A 4-byte field that contains the operation to be performed. The OPERATION values are:

FIND: Find an output line matching TYPE and copy it into the user's buffer.
COPY: Copy all remaining output lines matching TYPE into the user's buffer.

TYPE

A 1-byte field that indicates what type of output is requested by OPERATION. The TYPE values are:

M: Message from the client.
R: Reply from the server.
L: List data from a DIR or LS subcommand.
T: Trace output from debug or dump.
A: Any type of output line.

SEQUENCE (FIND operation only)

A 1-byte parameter that indicates which of the output lines of TYPE to FIND. SEQUENCE values are:

F: Find the first line of the requested TYPE.
N: Find the next line of the requested TYPE.
L: Find the last line of the requested TYPE.

Tip: The SEQUENCE parameter is not included on the call for a COPY operation, which always begins with the first line that matches TYPE at or after the current line.

VECTOR

A 3-word vector that describes the user's buffer that receives a copy of an output line. VECTOR values are:

BUFF-ADDR: The address of the buffer used in the operation.
BUFF-ALET: The ALET of the buffer pointed to by BUFF-ADDR. This can be 0. If not 0, the ALET must reside in the PASN-AL for the application or be a public entry in the DU-AL. All programs that the application invokes must have the authority to access the space. See z/OS MVS Programming: Extended Addressability Guide for information about using ALETs to access data spaces.
BUFF-LEN: The length of the buffer used in the operation. For a COPY operation the interface reserves 4 bytes at the end of the buffer to ensure that there is room for the Y or Z line.

Rule: Align VECTOR on at least a fullword boundary.