The DELETE/APPLICATION_PROTOCOL=FTAM command accesses the FTAM
deletion utility, which allows you to delete one or more files
to which you have delete access on any FTAM system within an OSI
network.
1 – Format
DELETE/APPLICATION_PROTOCOL=FTAM [/qualifier(s)] file-spec[,...]
The following table describes the variables in this format state-
ment:
__________________________________________________________________
Variable Explanation
__________________________________________________________________
/qualifier An RMS qualifier of the DELETE command. For a full
description of supported qualifiers, see individ-
ual qualifier subtopics; for a summary, see the
"Qualifier" subtopic.
file-spec A file specification for a local or remote file.
[,...] One or more additional local or remote file specifica-
tions, each of which is separated from the preceding
file specification by either a comma (,) or a plus
sign (+).
__________________________________________________________________
2 – Wildcards
Wildcards provide a method for generalizing a file designation to
encompass a set of local files. Standard DCL wildcard techniques
work for both local (RMS) files and remote files for those remote
FTAM systems that support the NBS-9 document type. If using
wildcard techniques with remote FTAM systems does not work, you
should complete the file designation.
The supported wildcard characters include an asterisk (*) to
represent a text string, a percent sign (%) to represent a single
character, or empty brackets ([ ]) to represent all files in the
local default RMS directory.
3 – Qualifiers
Any DELETE command qualifier that is unlisted here is accepted as
a null qualifier, which produces no effect on the outcome of the
DELETE/APPLICATION_PROTOCOL=FTAM command.
3.1 /CONFIRM
/CONFIRM
/NOCONFIRM
This qualifier controls whether a request is issued before each
delete operation asking you to indicate whether to delete that
file. The local sytem prompts you by asking, "Delete filename?
[N]."
Issue one of the following responses:
o To affirm deleting a specific file: Yes, True, or 1
o To prevent deleting a specific file: No, FALSE, 0, or <RET>
o To continue deleting without further confirmations: ALL
o To stop all deleting: Quit or <CTRL/Z>
Abbreviations and any combination of upper- and lowercase letters
are acceptable.
Default value: Unconfirmed
3.2 /LOG
/LOG
/NOLOG
This qualifier controls whether the FTAM deletion utility displays
the file specification of each file it deletes.
Default value: No logging
4 – Examples
1. $ DELETE/APPLICATION_PROTOCOL=FTAM /CONFIRM -
_$ AMIGUITA::"/MAIN/SUB/FILE/EXT" <RET>
Delete AMIGUITA::"/MAIN/SUB/FILE/EXT"? [N] <RET>
This command allows you to review your deletion request(s)
before they are executed. In this example, confirmation is
denied and the file is undeleted.
2. $ DELETE/APPLICATION_PROTOCOL=FTAM /CONFIRM /LOG -
_$ FREUNDE::"^VOL>MAIN>FILE", TEST.DAT;4 <RET>
Delete FREUNDE::"^VOL>MAIN>FILE.EXT"? [N] Y<RET>
%DELETE-I-FILDEL, FREUNDE::"^VOL>MAIN>FILE" deleted (1 block)
Delete TEST.DAT;4? [N] N<RET>
This command requests conformation about deleting the command
deletes the remote file ^VOL>MAIN>TEST.DAT on FREUNDE and,
receiving a positive response (Y), deletes that file. The
command then requests conformation about deleting the local
file TEST.DAT;4 and, receiving a negative response (N), leaves
that file intact.