FTCLOSE—end file tailoring

The FTCLOSE service is used to terminate the file tailoring process and to indicate the final disposition of the file tailoring output.

A member-name parameter should be specified if the output is a library. The file tailoring output is given the specified member name. No error condition results if the member-name parameter is not specified and the output is not stored in the library.

If the member-name parameter is specified and the output is sequential, a severe error results.

The library parameter should be specified if a library other than that represented by the ISPFILE or LIBDEF definition is to be used. The library parameter is ignored if the "TEMP" option (temporary file) is specified on the FTOPEN service or if the ISPFILE definition specifies a sequential data set. A severe error occurs if file tailoring attempts to use a data set that is not a library.

The NOREPL parameter specifies that an existing member in the file tailoring output library is not to be overlaid by the current FTCLOSE service. If a member of the same name already exists, the FTCLOSE service request is terminated with a return code of 4 and the original member remains unaltered.

Command invocation format


>>-ISPEXEC--FTCLOSE--+-------------------+---------------------->
                     '-NAME(member-name)-'   

>--+------------------+--+--------+----------------------------><
   '-LIBRARY(library)-'  '-NOREPL-'

Call invocation format


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><


>>-CALL--ISPLINK--('FTCLOSEb'--,-+-member-name-+---------------->
                                 '-'b'---------'   

>--,-+-library-+--,-+-'NOREPLbb'-+-);--------------------------><
     '-'b'-----'    '-'b'--------'

Parameters

member-name: Specifies the name of the member in the output library that is to contain the file tailoring output.
library: Specifies the name of a DD statement or lib-type on the LIBDEF service request that defines the output library in which the member-name exists. If specified, a generic (non-ISPF) ddname must be used. If this parameter is omitted, the default is ISPFILE.
NOREPL: Specifies that FTCLOSE is not to overlay an existing member in the output library.
buf-len: Specifies a fullword fixed binary integer containing the length of "buffer".
buffer: Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

Return codes

These return codes are possible:

0: Normal completion.
4: Member already exists in the output library and NOREPL was specified. The original member is unchanged.
8: File not open. FTOPEN was not used before FTCLOSE.
12: Output file in use. ENQ failed.
16: Skeleton library or output file not allocated.
20: Severe error.

Example

End the file tailoring process and store the result of the processing in the file tailoring output library in member TELOUT.

ISPEXEC FTCLOSE NAME(TELOUT)

Set the program variable BUFFER to contain:

FTCLOSE NAME(TELOUT)

Set program variable BUFLEN to the length of the variable BUFFER. Enter the command:

CALL ISPEXEC (BUFLEN, BUFFER);

or alternately:

CALL ISPLINK ('FTCLOSE ','TELOUT ');