A command sequence can also be input for SUCCESS-PROCESSING and FAILURE-PROCESSING. The individual commands must be separated by a semicolon. If a character string is enclosed in single or double quotes (’ or ") within a command sequence, openFT will not interpret any semicolon present within this character string as a separator.
Example
SUCC = ’command1;command2;command3’
The entries for the operands SUCCESS-PROCESSING and FAILURE-PROCESSING may total up to 1000 characters. If the length limit for follow-up processing data is exceeded due to variable replacement, openFT ends the request and returns an error message.
The commands/JCL statements must comply with the z/OS syntax rules; openFT does not check the syntax of the commands and statements specified for follow-up processing, see Syntax rules for follow-up processing on z/OS.
Please refer to section “Follow-up processing” for details on follow-up processing such as using variables, for example.
SUCCESS-PROCESSING =
Follow-up processing to be executed in the local system after a successful file transfer.
SUCCESS-PROCESSING = *NONE
No follow-up processing to be executed.
SUCCESS-PROCESSING = <c-string 1..1000 with-low>
z/OS commands to be executed in the local system after successful file transfer.
FAILURE-PROCESSING =
Follow-up processing to be carried out in the local system if an error is detected after setting up the link or during the file transfer.
FAILURE-PROCESSING = *NONE
No follow-up processing to be executed.
FAILURE-PROCESSING = <c-string 1..1000 with-low>
z/OS commands to be executed in the local system after unsuccessful file transfer. The same specifications are hold for FAILURE-PROCESSING as for SUCCESS-PROCESSING, see above.
LISTING =
Requests a result list in the local system. This listing is generated for the user for whom file transfer is performed. The default setting for LISTING in the local parameters is *STD.
If the result list is printed, the job initiated by openFT for this purpose causes an asynchronous end message to be sent to the user whose user ID is specified in the local TRANSFER-ADMISSION (JOB parameter NOTIFY).
LISTING = *STD
The value is taken from the FT parameter library as defined in the PARM element, LISTPARM key word. If no value is defined there then no result list is generated (same as *NONE).
LISTING = *NONE
No result list is generated.
LISTING = *SYSLST
A result list is printed out.
LISTING = *LISTFILE
openFT creates a result list and stores it under the ID specified in the local TRANSFER-ADMISSION operand. This file has the following name:
inst.Ttransfer-id.LST (the user ID is the "first level qualifier")
Here, inst stands for the instance name of the current openFT instance and transfer-id. for the identification number of the FT request.
If the "transfer-id." is longer than 7 characters, it is divided into two parts in this filename as follows: instance name.Tpart1-id.Tpart2-id.LST, where "part1-id" always has a length of 7 characters and "part2-id" always has a length of 1 to 3 characters. The file is created on the same volume as non-existent receive files. The FT administrator can specify the volume for these (the same for all transfer requests). If the FT administrator has not specified a volume, the system defaults for newly created files apply (see also the section “Result lists generated by openFT (z/OS)”).
LISTING = *PARAMETERS(...)
Requests a result list in the local system. The list is created for the user for whom file transfer is performed.
OUTPUT =
Output medium.
OUTPUT = *SYSLST
The result list is printed out.
OUTPUT = *LISTFILE
openFT stores the result list under the ID specified in the local TRANSFER-ADMISSION operand. This file has the following name:
inst.Ttransfer-id.LST (the user ID is the "first level qualifier")
For more information see LISTING = *LISTFILE.
CONDITION =
Condition under which a result list should be generated.
CONDITION = *ANY
A result list is generated in every case.
CONDITION = *ON-FAILURE-ONLY
A result list is only generated when the file transfer is aborted with an error.
CODED-CHARACTER-SET =
Coding (character set) that is to be used to read or write the local file.
CODED-CHARACTER-SET = *STD
The character set used by default to read or write the local file is the character set specified globally with FTMODOPT or defined in the FT parameter library.
CODED-CHARACTER-SET = <alphanum-name 1..8>
Coding that is to be used to read or write the local file. The character set must be known in the local system.