Note on usage
Function: Delete remote directory
User group: FT user
Alias name: FTDELDIR
Functional description
With the DELETE-REMOTE-DIR command, you can delete an empty directory in an FT partner system.
Format
DELETE-REMOTE-DIR / FTDELDIR |
PARTNER = <text 1..200 with-low> ,DIRECTORY-NAME = *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low> ,PASSWORD = *NONE / <integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128> / *SECRET ,TRANSFER-ADMISSION = *NONE / <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64> / *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low> ,ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64> ,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128> / <alphanum-name 1..19> / *SECRET ,FILE-NAME-ENCODING = *TRANSPARENT / *CHARACTER |
Operands
PARTNER = <text 1..200 with-low>
Name of the partner system as defined in the partner list by the FT administrator or the partner system address. For more information on address specifications, see section“Specifying partner addresses”.
DIRECTORY-NAME =
Name of the directory in the remote FT partner system.
DIRECTORY-NAME = *NOT-SPECIFIED
The name of the directory is known to the remote system because it has already been completely defined in the addressed FTAC admission profile, for instance.
DIRECTORY-NAME = <filename 1..54> / <c-string 1..512 with-low>
Name of the directory in the remote system. This must be specified in the syntax of the remote system and must adhere to the conventions used in the remote system.
If the directory name is specified with an unattached Public Volume Set (BS2000 systems) then the request is rejected with error message FTR2155.
PASSWORD =
Password making it possible to access the directory in the remote system.
PASSWORD = *NONE
Access is possible without a password.
PASSWORD = <integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128>
Password allowing the user to delete the directory in the remote system. The password must be specified in the syntax of the remote system and must adhere to the conventions used in the remote system.
PASSWORD = *SECRET
The system prompts you to enter the password. However, your input is not displayed on the screen.
TRANSFER-ADMISSION =
Contains specifications concerning the transfer admission in the remote system required to execute the file management request.
TRANSFER-ADMISSION = *NONE
The remote system does not require or does not know any user admissions.
TRANSFER-ADMISSION = <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64>
If FTAC functionality is used in the remote system then the transfer admission for the remote system can be defined via an admission profile. In this case, only the TRANSFER-ADMISSION defined in the admission profile is used here. In the case of alphanumeric input, uppercase is converted to lowercase internally.
TRANSFER-ADMISSION = *SECRET
The system prompts you to input the transfer admission. However, this is not visible on the screen.
TRANSFER-ADMISSION = *PARAMETERS(...)
Specifies the user's identification, account number and password in the remote system. The operands in the brackets can also be used as positional operands without the associated keywords.
USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low>
Identification of the user in the remote system. The identification must be specified in the syntax of the remote system and must adhere to the conventions used in the remote system.
ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64>
Account number of the user in the remote system. The account number must be specified in the syntax of the remote system and must adhere to the conventions used in the remote system.
PASSWORD =
Password allowing the user to access the remote system.
PASSWORD = *NONE
Access is possible without a password.
PASSWORD = <c-string 1..64 with-low> / <x-string 1..128> /
<alphanum-name 1..19>
Password allowing the user to access the remote system. The password must be specified in the syntax of the remote system, must adhere to the conventions used in the remote system and must be known there.
PASSWORD = *SECRET
The system prompts you to enter the password. Your input is not displayed on the screen.
FILE-NAME-ENCODING =
Specifies the encoding mode for the remote directory name.
FILE-NAME-ENCODING = *TRANSPARENT
Specification of the remote directory name in transparent mode (compatible to the previous versions).
FILE-NAME-ENCODING = *CHARACTER
Specification of the remote directory name in character mode. The name is interpreted according to the character code of the remote system, i.e. for Unix partners according to the openFT operating parameter option (ftmodo -fnccs) that has been set there.
FILE-NAME-ENCODING=*CHARACTER is only permitted for openFT partners as of openFT V12.1.
Command return codes
For a list of the possible return codes, see the table in chapter “Command return codes for file transfer and file management”.
Example:
Delete the empty directory Dir1 on the Unix system partux under the transfer admission transadm.
/DELETE-REMOTE-DIR partux,c'Dir1',,transadm