z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02
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.