A command sequence can also be input for SUCCESS-PROCESSING and FAILURE-PROCESSING. Each individual command must be preceded by a slash (/). 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.
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>
BS2000 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>
BS2000 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 *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:
S.FT-BS2.instance name.transfer-id.LST
Here, inst stands for the instance name of the current openFT instance and transfer-id. for the identification number of the FT request.
This reference is output to the screen when acceptance of the request is confirmed.
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:
S.FT-BS2.instance name.transfer-id.LST
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.
MONJV =
Specifies whether the FT request is to be monitored using a job variable.
MONJV = *NONE
The FT request is not monitored using a job variable.
MONJV = <filename 1..54>
Name of the job variable that is to monitor the transfer.
JV-PASSWORD =
Specifies whether a password is required in order to access the job variable.
JV-PASSWORD = *NONE
No password is required for the job variable.
JV-PASSWORD = <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
Password that is required for the job variable.
JV-PASSWORD = *SECRET
The system prompts you to enter the password. However, the input is not displayed on the screen.
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 predefined by XHCS.
CODED-CHARACTER-SET = <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.