Due to the support of the FTAM protocol, the number of different partner systems is considerably larger when FTAM functionality is used for openFT. For each case, a check should be carried out before the first “productive” file transfer to determine the interoperability between the local system and the partner system (the degree to which they can work together). It is also advisable to perform this check even if the partner system has passed the conformance test.
For an FTAM partner, it is advisable to enter REMOTE-PARAMETER=*ANY(...) in the TRANSFER-FILE command. In this case, openFT will not check the syntax of the entries for the remote system. Of course, these entries must conform to the syntax rules of the remote system. All value assignments in round brackets must be enclosed by quotes.
The operands ACCESS-MODE, FILE-AVAILABILITY, LEGAL-QUALIFICATION and CREATE-PASSWORD are only for communication with FTAM partners. openFT thus supports the operands prescribed in the FTAM norm. With these operands, you can set the attributes of the target file when you make a file transfer request.
These operands are ignored for requests with openFT partners. The file transfer is executed, however.
Functions which cannot be used with FTAM partners
The following functions may not be used for communication with FTAM partners:
transfer of library members in the remote system.
transfer of follow-up data into the remote system.
transfer of ISAM and PAM files.
If you attempt to use such a function in a file transfer request, the request is rejected with the message FTR2170:
FTR2170 Request (&00). Remote system: Function not supported(&02)
FILE-AVAILABILITY =
Availability of the destination file.
The parameter availability can have one of two values: immediate or deferred. A file may be deferred if it has been archived, for example. The partner is responsible for interpreting the term deferred. The FTAM partner conventions must therefore be observed here.
Requests involving FTAM partners that do not support the storage group are rejected. In this case, the request is executed, but the entry for FILE-AVAILABILITY is ignored.
FILE-AVAILABILITY = *BY-RECEIVING-SYSTEM
The FILE-AVAILABILITY file attribute is set to a system-specific default value. In BS2000, this is the value IMMEDIATE.
FILE-AVAILABILITY = *IMMEDIATE
The destination file attribute is set to immediate.
FILE-AVAILABILITY = *DEFERRED
The destination file attribute is set to deferred.
STORAGE-ACCOUNT =
Account number for file storage.
The operand is not available for requests involving FTAM partners that do not support the storage group. In this case, the request is executed, but the entry for STORAGE-ACCOUNT is ignored.
STORAGE-ACCOUNT = *NONE
No account number is specified.
STORAGE-ACCOUNT = <c-string 1..40 with-low> / <text 1..40>
With FTAM partners, this indicates the storage account. File storage fees are to be charged to this account. This operand must be set in accordance with partner system conventions.
ACCESS-MODE =
This sets the access rights of the destination file, provided the security group is available. It is possible to restrict certain access rights in the generated file. The file transfer is only executed if this is permitted by the newly set access rights. If this is not the case, the receive file is created in the remote system, but the transfer is not carried out.
If the access rights cannot be set, or cannot be set in the specified combination, the remote partner may nonetheless be able to carry out the file transfer.
ACCESS-MODE = *BY-RECEIVING-SYSTEM
The default values of the FTAM partner system apply.
ACCESS-MODE = *PARAMETERS(...)
Indicates permitted access methods.
READ-FILE = *NO / *YES
The file cannot or can be read.
INSERT-DATA-UNIT = *NO / *YES
Data units, such as records, cannot or can be inserted in the file.
REPLACE-FILE = *NO / *YES
The file cannot or can be overwritten.
EXTEND-FILE = *NO / *YES
The file cannot or can be extended.
ERASE-DATA-UNIT = *NO / *YES
Data units, such as records, cannot or can be deleted from the record.
READ-ATTRIBUTES = *NO / *YES
The file attributes cannot or can be read.
CHANGE-ATTRIBUTES = *NO / *YES
The file attributes cannot or can be changed.
DELETE-FILE = *NO / *YES
The file cannot or can be deleted.
LEGAL-QUALIFICATION =
Legal qualification.
The operand is not available for requests involving FTAM partners that do not support the security group. In this case, the request is executed, but the LEGAL-QUALIFICATION entry is ignored.
LEGAL-QUALIFICATION = *NONE
There are no legal agreements.
LEGAL-QUALIFICATION = <c-string 1..80 with-low> / <text 1..80>
With FTAM partners, this specifies a legal qualification for the file (similar to a copyright). This must not exceed 80 characters.
CREATE-PASSWORD =
You can use CREATE-PASSWORD to assign a password to send requests for systems which demand password authorization prior to file creation.
CREATE-PASSWORD = *NONE
Creates a file without a password.
CREATE-PASSWORD = <c-string 1..64 with-low> / <x-string 1..128>
Password authorizing a user to create a file in a remote system.
The password must be specified in quotes.
CREATE-PASSWORD = *SECRET
When the system prompts you to enter a password. The input is not echoed on screen.