Note on usage
Function: Create remote directory
User group: FT user
Alias name: FTCREDIR
Functional description
With the CREATE-REMOTE-DIR command, you can create a directory in an FT partner system.
Format
CREATE-REMOTE-DIR / FTCREDIR |
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 FTR2154.
PASSWORD =
If the file system or the parent directory only permits the directory to be created with a password, you can specify this here.
This is only possible in the case of partner systems which support this type of password.
PASSWORD = *NONE
No password is required to create the directory.
PASSWORD =
<integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128>Password giving permission to create 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 for 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. The alphanumeric input 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. However, 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 directory name in the remote system in transparent mode (compatible to the previous versions).
FILE-NAME-ENCODING = *CHARACTER
Specification of the directory name for the remote system 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”.