Note on usage
Function: Delete a file in a remote system
User group: FT user
Functional description
With ftdel you can delete files in the remote system.
Format
ftdel | -h | <partner 1..200>![<file name 1..512>] |
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
partner!file name
Specifies which file in which remote system has to be deleted.
partner
Partner is the name of the partner system in the partner list or the address of the partner system. For details on address specifications, see section “Specifying partner addresses”.
file name
file name can be either absolute or relative to the remote login authorization. If the file name in the remote system has been predefined in an FT profile, it must not be specified here.
If the partner system is running openFT (BS2000), elements from PLAM libraries may also be specified here (Syntax: Libname/Element type/Element name).
transfer admission | @n | @d |
user ID[,[account][,[password]]]
In order to execute file management requests in the remote system, you must furnish the remote system with proof of identity. For this purpose, you will need login authorization in the syntax valid for the remote system. You can specify this transfer admission
as an FTAC transfer admission if FTAC is used in the remote system,
or as a login/LOGON authorization in the syntax used by the remote system (user ID, possibly together with account and/or password).
For details, see section “Entering the authorization data for the partner system” .
@n for transfer admission
By entering @n you specify that the remote system requires no login authorization.
@d for transfer admission
Specifying @d (blanked transfer admission) causes openFT to query the transfer admission on the screen after the command is entered. Your entry is not displayed to prevent unauthorized persons from seeing the transfer admission.
A binary password or binary transfer admission must be specified, see section “Entering commands”.
password not specified
Omitting the password necessary for admission causes openFT to query the password on the screen after the command is entered. Your entry is not displayed to prevent unauthorized persons from seeing the password.
Nevertheless, you have to specify the commas, e.g.:
ftdel file partner!file user-id,,
or
ftdel file partner!file user-id,account,
neither transfer admission nor user ID specified
causes the same as @d, i.e. openFT queries the transfer admission on the screen after the command is entered. Your (blanked) entry is always interpreted as transfer admission and not as user ID.
-fnc=t | -fnc=c (file name coding)
specifies the encoding mode for the remote file name.
t (transparent, default value)
Specification of the remote file name in transparent mode (compatible to the previous versions).
c (character)
Specification of the remote file 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.
-fnc=c is only permitted for partners as of openFT V12.1.
-p=[management-password]
If the file in the remote system is protected by a password, you must enter this password here.
A binary password must be entered in hexadecimal format, see section “Entering commands”. This is of relevance for links to openFT (BS2000), because BS2000 supports the definition of hexadecimal passwords.
management password not specified
Specifying -p= causes openFT to query the password on the screen after the command is entered. Your entry is not displayed to prevent unauthorized persons from seeing the password.
Example
The file junk in the BS2000 computer bs2r1 under login name jim with account number a1234ft and password C'pwd' is to be deleted from your system. The file is protected by the password abcd.
ftdel bs2r1!unsinn jim,a1234ft,C\'pwd\' -p=C\'abcd\' (Unix systems)
ftdel bs2r1!unsinn jim,a1234ft,C'pwd' -p=C'abcd' (Windows systems)