Delete file
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Routing code: | $ (with NBCONOPI=N) or E (with NBCONOPI=Y) |
Function
The DELETE-FILE command can be used to delete temporary or permanent files which are cataloged under the user’s own user ID, and selected according to criteria which must be specified in the command. A tape file may also be specified, but since an implicit EXPORT-FILE is executed for it, only its catalog entry will be deleted.
There are separate commands for deleting file generations and file generation groups (see DELETE-FILE-GENERATION and DELETE-FILE-GROUP).
The DELETE-FILE command has 4 main functions:
Selection
With the SELECT operand, the user specifies which files or catalog entries are to be processed. The attributes stored in the catalog entries are used as selection criteria. These selection criteria correspond with those of the SHOW-FILE-ATTRIBUTES command.
Action parameters
The OPTION operand permits the user to control the internal execution of the DELETE-FILE processing. The scope of the deletions can be specified, i.e. the handling of the catalog entry, the data contained in the file, and the reserved storage space.
Verifying command execution
The DIALOG-CONTROL, OUTPUT and SUPPRESS-ERRORS operands allow the user to define his own user interface, within certain limits. For example, he may use interactive prompts, request the names of deleted files on SYSOUT, or have DMS errors ignored (for error handling in procedures).
File protection
The IGNORE-PROTECTION and PASSWORDS-TO-IGNORE operands save the user from having to enter the MODIFY-FILE-ATTRIBUTES or ADD-PASSWORD commands when files which are protected against write access by passwords, retention periods, or active access control need to be deleted.
Privileged functions
The privileged functions for systems support staff (TSOS privilege) include specification of temporary or cataloged files of any user ID, the ability to ignore protection attributes of the file being deleted and, in the case of a user ID change, to branch to guided dialog. Systems support staff can use wildcards in the user ID. If no catalog ID is specified in such cases, the specified files are deleted from the associated default pubsets of the relevant users.
By default, systems support (TSOS privilege) is a co-owner of all the files (and can, therefore, delete files under any user ID). When SECOS is used, this co-ownership can be restricted for permanent files.
Systems support can generate files under any user ID (TSOS privilege). In conjunction with the SECOS software product a user can allow other user IDs to act as co-owners. Co-owners of a user ID are also allowed to delete files under that ID.
Overview of functions
Function / Meaning | Level 1 operands | Level 2/3 operands |
|---|---|---|
Name of file to be deleted |
| |
Selection criteria for the files to be deleted | ||
Date specification | ||
| ||
| ||
| ||
| ||
| ||
| ||
Storage space | ||
| ||
| =*PUBLIC-DISK =*PRIVATE-DISK =*TAPE | |
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
File security/file protection | ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
|
| |
| ||
| ||
HSMS-related file attributes | ||
| ||
| ||
| ||
| ||
Deletion parameters | ||
| ||
| ||
| ||
| ||
| ||
Mount request | ||
Control parameters | ||
| ||
| ||
| ||
| ||
| ||
| ||
Message for successfully deleted files | ||
| =*NO | |
| =*SYSOUT | |
Ignore protection attributes | ||
| =*ACCESS | |
| =*EXPIRATION-DATE | |
| =*WRITE-PASSWORD / | |
Ignore password protection provided by specified passwords | ||
Suppress error situations |
Format
DELETE-FILE | Alias: DLF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
FILE-NAME = *DUMMY / <filename 1..54 without-gen with-wild(80)>
The name of the file to be deleted. Only the user’s own user ID or a user ID for which the user is co-owner may be specified. If the wildcard “*” is the first character in a wildcard string, it must be entered twice.
FILE-NAME = *DUMMY
Designates the dummy file *DUMMY, which “always exists”, and which satisfies all selection criteria. Any other operands, except for the control parameters DIALOG-CONTROL, OUTPUT and SUPPRESS-ERRORS will be checked for their formal correctness, but otherwise ignored. If *DUMMY is specified, no catalog or data access is necessary. The main use of *DUMMY is in testing procedures.
SELECT = *ALL
All the files in the set specified by FILE-NAME are selected.
SELECT = *BY-ATTRIBUTES(...)
Restricts the files in the set specified in FILE-NAME to files which satisfy the criteria which follow. The default values, *ANY and ANY, each indicates that the file set is not to be restricted to any particular values for the attribute concerned.
CREATION-DATE = *ANY / *NONE / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) /
<date>(...) / *INTERVAL(...)
The user can select the files to be deleted by their creation date. On a given date, the selection can be restricted to a time interval within which the file was created (see the relevant TIME operands in each structure).
On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands. See also the CRE-DATE and CRE-TIME output fields in the SHOW-FILE-ATTRIBUTES command.
CREATION-DATE = *ANY
The creation date is not to be used as a selection criterion.
CREATION-DATE = *NONE
Only those files which have the value NONE entered in the CREATION-DATE field in their catalog entry are deleted, i.e. files which have never been opened.
CREATION-DATE = *TODAY(...)
Only those files which have today’s date entered in the CREATION-DATE field in their catalog entry are deleted.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files for deletion to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Deletes only those files which were created on the specified day within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = *YESTERDAY(...)
Only those files which have yesterday’s date entered in the CREATION-DATE field in their catalog entry are deleted.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Deletes only those files which were created on the specified day within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = <integer -99999..991231>(...)
Only those files which have the specified date entered in the CREATION-DATE field in their catalog entry are deleted. Here, the user can specify the creation date in either of two ways:
- as an absolute date value:
(6 digits), a specific date in the form yymmdd
(yy = year, mm = month, dd = day) - as a relative date value:
(6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future;
(YESTERDAY corresponds to -1, TODAY corresponds to ±0)
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Deletes only those files which were created on the specified day within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = <date>(...)
Only those files which have the specified date entered in the CREATION-DATE field in their catalog entry are deleted. The user can specify the creation date in the form [yy]yymm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Deletes only those files which were created on the specified day within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = *INTERVAL(...)
Only those files which were created within the specified time period are deleted. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified using <integer> values). It is also possible to specify limits using the operands FROM (lower limit) and TO (upper limit). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit.
FROM = *EARLIEST / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Only those files which have been created since the specified date (i.e. CREATION-DATE >= specified date) are deleted. If EARLIEST is specified, the system will use the earliest possible date.
FROM = *TODAY(...)
Deletes only those files which were created after the specified date (i.e. files for which CREATION-DATE >= current date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = *YESTERDAY(...)
Deletes only those files which were created after the specified date (i.e. files for which CREATION-DATE >= date of preceding day).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = <integer -99999..991231>(...)
Deletes only those files which were created after the specified date (i.e. files for which CREATION-DATE >= specified date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = <date>(...)
Deletes only those files which were created after the specified date (i.e. files for which CREATION-DATE >= specified date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Deletes only those files which were created before the specified date (i.e. files for which CREATION-DATE <= specified date).
TO = *TODAY(...)
Deletes only those files which were created before the specified date (i.e. files for which CREATION-DATE <= current date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = *YESTERDAY(...)
Deletes only those files which were created before the specified date (i.e. files for which CREATION-DATE <= date of preceding day).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = <integer -99999..991231>(...)
Deletes only those files which were created before the specified date (i.e. files for which CREATION-DATE <= specified date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = <date>(...)
Deletes only those files which were created before the specified date (i.e. files for which CREATION-DATE <= specified date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
EXPIRATION-DATE = *ANY / *NONE / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
The user can select the files to be deleted by their release date (expiration date). The selection can be restricted for a specified date to a time interval in which the last file update occurred (see the TIME operand for each structure). Note that at present the time 00:00:00 is always entered in the file catalog as the time of the expiration date. On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands. See also the EXPIR-DATE and EXPIR-TIME output fields in the SHOW-FILE-ATTRIBUTES command.
EXPIRATION-DATE = *ANY
The expiration date is not to be used as a selection criterion.
EXPIRATION-DATE = *NONE
Only those files which have no expiration date (i.e. the value NONE) entered in the EXPIRATION-DATE field in their catalog entry are deleted.
EXPIRATION-DATE = *TOMORROW(...)
Deletes only those files which have tomorrow’s date entered as the EXPIRATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Deletes only those files whose expiration date lies within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *TODAY(...)
Only those files which have today’s date entered as the EXPIRATION-DATE in their catalog entry are deleted.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Deletes only those files whose expiration date lies within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *YESTERDAY(...)
Only those files which have yesterday’s date entered as the EXPIRATION-DATE in their catalog entry are deleted.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Deletes only those files whose expiration date lies within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = <integer -99999..991231>(...)
Only those files which have the specified date entered as the EXPIRATION-DATE in their catalog entry are deleted. Here, the user can specify the expiration date in either of two ways:
- as an absolute date value:
(6 digits), a specific date in the form yymmdd
(yy = year, mm = month, dd = day) - as a relative date value:
(6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future;
(YESTERDAY corresponds to -1, TODAY corresponds to ±0, TOMORROW corresponds to +1)
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Deletes only those files whose expiration date lies within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = <date>(...)
Only those files which have the specified date entered as the EXPIRATION-DATE in their catalog entry are deleted. The user can specify the expiration date in the form [yy]yy-mm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Deletes only those files whose expiration date lies within the specified time interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *INTERVAL(...)
Only those files for which the expiration date lies within the specified time period, i.e. files for which the retention period ends within the specified time period, will be deleted. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for EXPIRATION-DATE = <integer...>. It is also possible to specify limits using the operands FROM (lower limit) and TO (upper limit)). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit.
FROM = EARLIEST / TOMORROW(...) / TODAY(...) / YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...)
If EARLIEST is specified, the system will use the earliest possible date. Only those files for which the retention period expires on or after the specified date (EXPIRATION-DATE >= specified date) are deleted.
FROM = *TOMORROW(...)
Deletes only those files for which the EXPIRATION-DATE >= the date of next day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = TODAY(...)
Deletes only those files for which the EXPIRATION-DATE >= current date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = *YESTERDAY(...)
Deletes only those files for which the EXPIRATION-DATE >= date of preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = <integer -99999..991231>(...)
Deletes only those files for which the EXPIRATION-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = <date>(...)
Deletes only those files for which the EXPIRATION-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *LATEST / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...)
Only files for which the retention period expires on or before the specified date (EXPIRATION-DATE <= specified date) will be deleted.
TO = *TOMORROW(...)
Deletes only those files for which the EXPIRATION-DATE <= date of next day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *TODAY(...)
Deletes only those files for which the EXPIRATION-DATE <= current date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *YESTERDAY(...)
Deletes only those files for which the EXPIRATION-DATE <= date of preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = <integer -99999..991231>(...)
Deletes only those files for which the EXPIRATION-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = <date>(...)
Deletes only those files for which the EXPIRATION-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
LAST-ACCESS-DATE = *ANY / *NONE / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
The user can select the files to be deleted by the date when they were last accessed. On a given date, the selection can be restricted to a time interval within which the file was last accessed (see the relevant TIME operands in each structure). On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands. See also the ACC-DATE and ACC-TIME output fields in the SHOW-FILE-ATTRIBUTES command.
LAST-ACCESS-DATE = *ANY
The date of last access is not to be used as a selection criterion.
LAST-ACCESS-DATE = *NONE
Deletes only those files which have the value NONE entered in the ACC-DATE field in their catalog entry, i.e. files which have never been opened.
LAST-ACCESS-DATE = *TODAY(...)
Deletes only those files for which today’s date has been entered as the LAST-ACCESS-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a time period relative to today’s date.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files that were last accessed after the specified time.
TO = 23:59:59 / <time>
Selects files that were last accessed before the specified time.
LAST-ACCESS-DATE = *YESTERDAY(...)
Deletes only those files for which yesterday’s date has been entered as the LAST-ACCESS-DATE in the catalog entry.
TIME = INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files that were last accessed after the specified time.
TO = 23:59:59 / <time>
Selects files that were last accessed before the specified time.
LAST-ACCESS-DATE = <integer -99999..991231>(...)
Deletes only those files for which the specified date has been entered as the LAST-ACCESS-DATE in the catalog entry. Here, the user can specify the date of last access in either of two ways:
- as an absolute date value:
(6 digits), a specific date in the form yymmdd
(yy = year, mm = month, dd = day) - as a relative date value:
(6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future;
(YESTERDAY corresponds to -1, TODAY corresponds to ±0)
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files that were last accessed after the specified time.
TO = 23:59:59 / <time>
Selects files that were last accessed before the specified time.
LAST-ACCESS-DATE = <date>(...)
Deletes only those files for which the specified date has been entered as the LAST-ACCESS-DATE in the catalog entry. The user can specify the creation date in the form [yy]yy-mm-dd.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files that were last accessed after the specified time.
TO = 23:59:59 / <time>
Selects files that were last accessed before the specified time.
LAST-ACCESS-DATE = *INTERVAL(...)
Only files which were last accessed within the specified time period will be deleted. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified using <integer> values). It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit.
FROM = *EARLIEST / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Only files which have been accessed since the specified date (i.e. for which LAST-ACCESS-DATE >= specified date) will be deleted. If EARLIEST is specified, the system will use the earliest possible date.
FROM = *TODAY(...)
Returns information on files for which the LAST-ACCESS-DATE >= date of the current day.
TIME = 00:00:00 / <time>
Time on the specified date. All files which were last accessed after the specified time are selected.
FROM = *YESTERDAY(...)
Returns information on files for which the LAST-ACCESS-DATE >= date of the preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files which were last accessed after the specified time are selected.
FROM = <integer -99999..991231>(...)
Returns information on files for which the LAST-ACCESS-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files which were last accessed after the specified time are selected.
FROM = <date>(...)
Returns information on files for which the LAST-ACCESS-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files which were last accessed after the specified time are selected.
TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Only those files which were last accessed on or before the specified date (i.e. files for which LAST-ACCESS-DATE <= the specified date) are deleted.
TO = *TODAY(...)
Returns information on files for which the LAST-ACCESS-DATE <= date of the current day.
TIME = 23:59:59 / <time>
Time on the specified date. All files which were last accessed before the specified time are selected.
TO = *YESTERDAY(...)
Returns information on files for which the LAST-ACCESS-DATE <= date of the preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files which were last accessed before the specified time are selected.
TO = <integer -99999..991231>(...)
Returns information on files for which the LAST-ACCESS-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files which were last accessed before the specified time are selected.
TO = <date>(...)
Returns information on files for which the LAST-ACCESS-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files which were last accessed before the specified time are selected.
LAST-CHANGE-DATE = *ANY / *NONE / *TODAY(...) / *YESTERDAY(...) / <integer -99999..0>(...) /
<date>(...) / *INTERVAL(...)
The user can select the files to be deleted based on the date on which they were last accessed for writing (i.e. the date they were last changed). On a given date, the selection can be restricted to a time interval within which the file was last changed (see the relevant TIME operands in each structure). On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands. See also the CHANG-DATE and CHANG-TIME output fields in the SHOW-FILE-ATTRIBUTES command.
LAST-CHANGE-DATE = *ANY
The date of the last write access is not to be used as a selection criterion.
LAST-CHANGE-DATE = *NONE
Deletes only those files for which no LAST-CHANGE-DATE has been entered in the catalog entry, i.e. files which have never been opened.
LAST-CHANGE-DATE = *TODAY(...)
Deletes only those files for which today’s date has been entered as the LAST-CHANGE-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a time period relative to today’s date.
TIME = *INTERVAL(...)
Deletes only those files which were last changed within the specified time interval.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = *YESTERDAY(...)
Deletes only those files for which yesterday’s date has been entered as the LAST-CHANGE-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Deletes only those files which were last changed within the specified time interval.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = <integer -99999..0>(...)
Deletes only those files for which the specified date has been entered as the LAST-CHANGE-DATE in the catalog entry. Here, the user can specify the date of the last write access relative to the current date (in the form -n).
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Deletes only those files which were last changed within the specified time interval.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = <date>(...)
Deletes only those files for which the specified date has been entered as the LAST-CHANGE-DATE in the catalog entry. The user can specify the date in the form [yy]yymm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Deletes only those files which were last changed within the specified time interval.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = *INTERVAL(...)
Only files which were last changed within the specified time period will be deleted. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for the operand LAST-CHANGE-DATE= <integer...>). It is also possible to specify only the FROM operand (lower limit) or the TO operand (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = *EARLIEST / *TODAY(...) / *YESTERDAY(...) / <integer -99999..0>(...) / <date>(...)
Only those files which have been changed since the specified date (i.e. LAST-CHANGE-DATE >= specified date) are deleted.
FROM = *TODAY(...)
Deletes only those files for which the LAST-CHANGE-DATE >= current date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = *YESTERDAY(...)
Deletes only those files for which the LAST-CHANGE-DATE >= date of preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = <integer -99999..0>(...)
Deletes only those files for which the LAST-CHANGE-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = <date>(...)
Deletes only those files for which the LAST-CHANGE-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..0>(...) / <date>(...)
Only those files which were changed on or before the specified date (i.e. LAST-CHANGE-DATE <= specified date) are deleted.
TO = *TODAY(...)
Deletes only those files for which the LAST-CHANGE-DATE <= current date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = *YESTERDAY(...)
Deletes only those files for which the LAST-CHANGE-DATE <= date of preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = <integer -99999..0>(...)
Returns information on files for which the LAST-CHANGE-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = <date>(...)
Deletes only those files for which the LAST-CHANGE-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
SUPPORT = *ANY / list-poss(3): *PUBLIC-DISK / *PRIVATE-DISK / *TAPE
The user can select which files are to be deleted by the DELETE-FILE command by the type of their volumes. On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands.
SUPPORT = *ANY
The volume type is not to be used as a selection criterion.
SUPPORT = *PUBLIC-DISK
Only files on disks of the pubset or on Net-Storage volumes are deleted.
SUPPORT = *PRIVATE-DISK
Only files on private disks are to be deleted.
SUPPORT = *TAPE
Only files on tape or tape cartridge are to be deleted.
STORAGE-TYPE = *ANY / *PUBLIC-SPACE / *NET-STORAGE
The selection criterion is the assigned storage type.
STORAGE-TYPE = *ANY
The storage type is not a selection criterion.
STORAGE-TYPE = *PUBLIC-SPACE
Only files residing on disks of the pubset are deleted.
STORAGE-TYPE = *NET-STORAGE(...)
Only files residing on Net-Storage volumes are deleted.
FILE-TYPE = *ANY / *BS2000 / *NODE-FILE
The selection criterion is the file type.
FILE-TYPE = *ANY
The file type is not a selection criterion.
FILE-TYPE = *BS2000
Only BS2000 files on Net-Storage volumes are deleted.
FILE-TYPE = *NODE-FILE
Only node files on Net-Storage volumes are deleted.
VOLUME = *ANY / <vsn 1..6>
For files on private volumes: by specifying a volume serial number (VSN) the user can limit the deletion of files by the DELETE-FILE command to those files only which are stored on this volume.
VOLUME = *ANY
The volume is not to be used as a selection criterion.
VOLUME = <vsn 1..6>
All files which are stored on the specified volume, or which have dummy entries on the volume, are to be deleted. In this case, no file name must be specified under the FILE-NAME operand.
SIZE = *ANY / *FREESIZE / <integer 0..2147483647> / *INTERVAL(...)
Only for files on disks and Net-Storage volumes: the user can select which files are to be deleted by the DELETE-FILE command according to their size, or the size of their reserved storage area (= number of PAM pages). On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands.
The value of the SIZE operand specifies the number of PAM pages: the upper and lower limits are both included in the range specified.
SIZE = *ANY
The file size is not to be used as a selection criterion.
SIZE = *FREESIZE
Only files for which storage space has been reserved but which do not yet occupy any of it (HIGH-US-PA=0) are to be deleted.
SIZE = <integer 0..2147483647>
Only files for which the number of PAM pages reserved is exactly equal to the number specified here are to be deleted.
SIZE = *INTERVAL(...)
Only files for which the number of pages lies within the specified range are to be deleted. The upper and lower limits are both included in the range specified (see description of SIZE=<integer...>). It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit. Only files for which the number of PAM pages reserved is at least equal to the FROM value and at most equal to the TO value will be processed (FROM <= SIZE <= TO).
FROM = 0 / <integer 0..2147483647>
Only files for which the number of PAM pages reserved is at least equal to the specified number are to be deleted (SIZE >= specified value).
TO = 2147483647 / <integer 0..2147483647>
Only files for which the number of PAM pages reserved is at most equal to the specified number are to be deleted (SIZE <= specified value).
NUMBER-OF-EXTENTS = *ANY / <integer 0..65535> / *INTERVAL(...)
Only for files on disks and Net-Storage volumes: the user can select the files to be processed by DELETE-FILE by the number of extents into which a file is “split”. An extent is a contiguous area on a disk, occupied by one file; the output field EXTENTS shows how many extents the file has. On deleting file generation groups and file generations see the DELETE-FILE-GROUP and DELETE-FILE-GENERATION commands.
NUMBER-OF-EXTENTS = *ANY
The number of extents is not to be used as a selection criterion.
NUMBER-OF-EXTENTS = <integer 0..65535>
Only disk files with exactly the specified number of extents (EXTENDS = integer) are to be deleted.
NUMBER-OF-EXTENTS = *INTERVAL(...)
Selects all the files whose number of extents lies within the specified range. The upper and lower limits are both included in the range specified. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit. Only disk files which have at least as many EXTENTS as specified by the FROM value and at most as many as given by the TO value will be processed (FROM <= EXTENTS <= TO).
FROM = 0 / <integer 0..65535>
Only files for which the number of extents is at least equal to the specified number are to be deleted (EXTENTS >= integer).
TO = 65535 / <integer 0..65535>
Only files for which the number of extents is at most equal to the specified number are to be exported (EXTENTS <= integer).
NUMBER-OF-FREE-PAGES = *ANY / *SIZE / <integer 0..2147483647> / INTERVAL(...)
Only for files on disks and Net-Storage volumes: the user can select the files to be processed according to their number of free PAM pages, i.e. the number of pages reserved for the file but unused.
NUMBER-OF-FREE-PAGES = *ANY
The number of free PAM pages is not to be used as a selection criterion.
NUMBER-OF-FREE-PAGES = *SIZE
Only files which actually occupy no storage space are to be deleted (i.e. no PAM page has been written yet).
NUMBER-OF-FREE-PAGES = <integer 0..2147483647>
Only files which have exactly the number of reserved but unused (=free) PAM pages specified by <integer...> are to be deleted.
NUMBER-OF-FREE-PAGES = *INTERVAL(...)
Selects all files for which the number of unused PAM pages lies within the specified range. The upper and lower limits are both included in the range specified (see description of NUMBER-OF-FREE-PAGES = <integer...>). It is also possible to specify limits using the operands FROM (lower limit) and TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for deletion can only be meaningful if the chosen lower limit <= the upper limit. Only disk files which have at least as many free PAM pages as specified by the FROM value and at most as many as given by the TO value will be deleted (FROM <= FREE <= TO).
FROM = 0 / <integer 0..2147483647>
Only files for which the number free PAM pages is at least equal to the specified number are to be deleted (FREE >= integer).
TO = 2147483647 / <integer 0..2147483647>
Only files for which the number free PAM pages is at most equal to the specified number are to be deleted (FREE <= integer).
HIGHEST-USED-PAGE = *ANY / <integer 0..2147483647> / *INTERVAL(...)
The number of PAM pages used serves as a selection criterion here, i.e. the last page pointer points to the specified page (see also the HIGH-US-PA output field of the SHOW-FILE-ATTRIBUTES command).
HIGHEST-USED-PAGE = *ANY
The number of PAM pages used is not used as a selection criterion.
HIGHEST-USED-PAGE = <integer 0..2147483647>
Only the files for which the specified number of PAM pages are used (i.e. files for which the last page pointer points to the specified page) are deleted.
HIGHEST-USED-PAGE = *INTERVAL(...)
Deletes only those files which use a number of pages that falls within the specified range.
FROM = 0 / <integer 0..2147483647>
Only the files in which the number of used pages >= the specified number are deleted.
TO = 2147483647 / <integer 0..2147483647>
Only the files in which the number of used pages <= the specified number are deleted.
BLOCK-COUNTER = *ANY / <integer 0..2147483647> / *INTERVAL(...)
The number of blocks occupied by a tape file serves as the selection criterion (see also the BLK-COUNT output field of the SHOW-FILE-ATTRIBUTES command).
BLOCK-COUNTER = *ANY
The number of occupied tape blocks is not to be used as a selection criterion.
BLOCK-COUNTER = <integer 0..2147483647>
Deletes only those tape files which occupy exactly the specified number of tape blocks.
BLOCK-COUNTER = *INTERVAL(...)
Deletes only those tape files for which the occupied number of tape blocks falls within the specified range.
FROM = 0 / <integer 0..2147483647>
Only the tape files for which the number of occupied tape blocks >= the specified number are deleted.
TO = 2147483647 / <integer 0..2147483647>
Only the tape files for which the number of occupied tape blocks <= the specified number are deleted.
ACCESS = *ANY / *READ / *WRITE
The specified access type will be used as a selection criterion (ACCESS value in the catalog entry.)
ACCESS = *ANY
The ACCESS value is not to be used as a selection criterion.
ACCESS = *READ
Only files for which write access is prevented by ACCESS=READ, i.e. for which only read access is permitted, will be deleted.
ACCESS = *WRITE
Only files for which write and read access are permitted will be deleted.
PASSWORD = *ANY / list-poss(4): *NONE / *READ-PASSWORD / *WRITE-PASSWORD /
*EXEC-PASSWORD
The user can select files with specific password types for processing by the DELETE-FILE command.
PASSWORD = *ANY
Password protection is not to be used as a selection criterion.
PASSWORD = *NONE
Only files for which there is no password protection are to be deleted.
PASSWORD = *READ-PASSWORD
Only files which are protected by a read password are to be deleted.
PASSWORD = *WRITE-PASSWORD
Only files which are protected by a write password are to be deleted.
PASSWORD = *EXEC-PASSWORD
Only files which are protected by an execute password are to be deleted.
USER-ACCESS = *ANY / list-poss(3): *OWNER-ONLY / *ALL-USERS / *SPECIAL
The user can select files using their access authorizations as a criterion.
USER-ACCESS = *ANY
The access authorization is not to be used as a selection criterion.
USER-ACCESS = *OWNER-ONLY
Only files which the owner alone may access are to be deleted.
USER-ACCESS = *ALL-USERS
Only files which permit access to all users are to be deleted.
USER-ACCESS = *SPECIAL
Only files which can be accessed by all user IDs including the maintenance IDs (i.e. user IDs with HARDWARE-MAINTENANCE privileges) are to be deleted.
FILE-STRUCTURE = *ANY / list-poss(5): *PAM / *SAM / *ISAM / *BTAM / *NONE
The user can select files for processing according to their access method (FILE-STRUC output field).
FILE-STRUCTURE = *ANY
The access method is not to be used as a selection criterion.
FILE-STRUCTURE = *PAM
Only PAM files should be processed.
FILE-STRUCTURE = *SAM
Only SAM files are to be processed.
FILE-STRUCTURE = *ISAM
Only ISAM files are to be processed.
FILE-STRUCTURE = *BTAM
Only BTAM files are to be processed. BTAM files are tape files.
FILE-STRUCTURE = *NONE
Only files for which FILE-STRUCTURE=NONE, i.e. files which have not yet been opened, are to be deleted.
BACKUP-CLASS = *ANY / list-poss(5): *A / *B / *C / *D / *E
The user can select files for deletion by their BACKUP-CLASS level.
BACKUP-CLASS = *ANY
The BACKUP-CLASS level is not to be used as a selection criterion.
BACKUP-CLASS = *A
Only the files for which the value A is entered in the catalog as the BACKUP-CLASS (most frequent backup) are deleted.
BACKUP-CLASS = *B
Only the files for which the value B is entered in the catalog as the BACKUP-CLASS are deleted.
BACKUP-CLASS = *C
Only the files for which the value C is entered in the catalog as the BACKUP-CLASS are deleted.
BACKUP-CLASS = *D
Only the files for which the value D is entered in the catalog as the BACKUP-CLASS are deleted.
BACKUP-CLASS = *E
Only the files for which the value E is entered in the catalog as the BACKUP-CLASS are deleted.
BLOCK-CONTROL-INFO = *ANY / list-poss(9): *NONE / *NO / *WITHIN-DATA-BLOCK /
*WITHIN-DATA-2K-BLOCK / *WITHIN-DATA-4K-BLOCK / *PAMKEY / *NK / *NK2 / *NK4
The user can select files for deletion by their block format (BLK-CONTR output field).
BLOCK-CONTROL-INFO = *ANY
The BLOCK-CONTROL entry is not to be used as a selection criterion.
BLOCK-CONTROL-INFO = *NONE
Only files for which no BLK-CNTRL value has been defined, i.e. files which have not yet been opened, are to be deleted.
BLOCK-CONTROL-INFO = *NO
Only files which contain no block control field are to be deleted.
BLOCK-CONTROL-INFO = *WITHIN-DATA-BLOCK
Only files which were created with BLOCK-CONTROL-INFO=WITHIN-DATA-BLOCK (i.e. files for which block control information is held in a block control field at the start and within the data block) are to be deleted.
BLOCK-CONTROL-INFO = *WITHIN-DATA-2K-BLOCK
Only files which were created with BLOCK-CONTROL-INFO=WITHIN-DATA-2K-BLOCK (i.e. files for which block control information is located at the start of each 2K block) are to be deleted.
BLOCK-CONTROL-INFO = *WITHIN-DATA-4K-BLOCK
Only files which were created with BLOCK-CONTROL-INFO=WITHIN-DATA-4K-BLOCK (i.e. files for which block control information is located at the start of each 4K block) are to be deleted.
BLOCK-CONTROL-INFO = *PAMKEY
Only files which use a separate PAM key for the block control field (i.e the block control information is held in a separate key field, outside the PAM block) are to be deleted.
BLOCK-CONTROL-INFO = *NK
Only the NK files are to be deleted, i.e. files which can also be stored on NK volumes (NK2 and NK4).
BLOCK-CONTROL-INFO = *NK2
Only files which can also be stored on NK2 volumes (but not NK4 volumes) are to be deleted.
BLOCK-CONTROL-INFO = *NK4
Only files which can also be stored on NK4 volumes are to be deleted.
MIGRATE = *ANY / list-poss(3): *ALLOWED / *INHIBITED / *FORBIDDEN
The user can specify which files are to be processed by the DELETE-FILE command by the migration entry in the catalog (see the CREATE-FILE command, MIGRATE operand).
MIGRATE = *ANY
The specified files are to be deleted, irrespective of the value in the MIGRATE operand in each of their catalog entries.
MIGRATE = *ALLOWED
Only files for which the catalog entry specifies the appropriate operand value, i.e. files which may be migrated to storage levels S1 and S2, are to be deleted.
MIGRATE = *INHIBITED
Only files for which the catalog entry specifies the appropriate operand value are to be processed, i.e. files for which a simple migration lock is declared.
MIGRATE = *FORBIDDEN
Only files for which the catalog entry specifies the appropriate operand value are to be processed, i.e. files for which an intensified migration lock is declared. The files may not even be migrated for a brief period (e.g. for reorganization purposes).
STORAGE-LEVEL = *ANY / list-poss(3): *S0 / *S1 / *S2
Only files at a specific HSMS storage level are to be deleted. Where HSMS (Hierarchical Storage Management System) is used, there are three possible storage levels for files on shared storage media:
The processing level, S0. This comprises all pubsets to which the user has access according to his user entry.
The background level, S1. This comprises disks on which HSMS has stored files which have been migrated from the S0 level. When DMS requires access to them, they are fetched back to processing level S0 by HSMS.
The archival level, S2. This is a tape archive in which HSMS stores files which have been migrated from S0 on a longer term basis. When DMS requires access to them, they are fetched back to the processing level S0, depending on the HSMS operating parameters which have been set, and the availability of tape units.
The user can select files for deletion according to the level in the storage hierarchy (STORAGE-LEVEL) at which they are held. Where HSMS (Hierarchical Storage Management System) is used, the following three storage levels are possible for files on shared storage media:
S0: | implemented as fast access disk storage (for online processing); all the pubsets to which his user entry gives him access. |
S1: | implemented as high capacity disk storage (background level, available online). These are disks on which HSMS stores files which have been migrated from the S0 level. When DMS requires access to them, they are fetched back to processing level S0 by HSMS. |
S2: | implemented as a magnetic tape and tape cartridge archive (background level, available offline). Archive level S2 is a tape archive in which HSMS stores files which are to be migrated from S0 on a longer-term basis. When DMS requires access to them, they are fetched back to the processing level S0, depending on the HSMS operating parameters which have been set, and the availability of tape units. |
STORAGE-LEVEL = *ANY
The specified files are to be deleted, irrespective of the storage level at which they are being held.
STORAGE-LEVEL = *S0
Only files which are being held at level S0 are to be deleted.
STORAGE-LEVEL = *S1
Only files which are being held at level S1 are to be deleted.
STORAGE-LEVEL = *S2
Only files which are being held at level S2 are to be deleted.
BASIC-ACL = *ANY / *NONE / *YES / *PARAMETERS(...)
The BASIC-ACL entry in the file catalog is used as a selection criterion.
BASIC-ACL = *ANY
The BASIC-ACL entry is not to be used as a selection criterion.
BASIC-ACL = *NONE
Only the files that have no BASIC-ACL entry in the catalog are to be deleted.
BASIC-ACL = *YES
Only the files which have a BASIC-ACL entry in the catalog are to be deleted.
BASIC-ACL = *PARAMETERS(...)
Only the files which have the specified BASIC-ACL entry in the catalog are to be deleted. NO-ACCESS means that no access rights were granted.
OWNER = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights must already be defined for the owner.
OWNER = *PARAMETERS(...)
Access rights that must be present for the owner (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
GROUP = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for the owner’s user group.
GROUP = *PARAMETERS(...)
Access rights that must be present for the owner’s user group (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
OTHERS = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for all other users.
OTHERS = *PARAMETERS(...)
Access rights that must be present for all other users (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
GUARDS = *ANY / *NO / *YES / *PARAMETERS(...)
The use of GUARDS for access control (see the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command) is used as a selection criterion.
GUARDS = *ANY
Access control with GUARDS is not to be used as a selection criterion.
GUARDS = *NO
Only the files which are not protected by GUARDS against unauthorized access are to be deleted (see also the PROTECTION-LEVEL operand).
GUARDS = *YES
Only the files which are protected by GUARDS against unauthorized access (i.e. files for which access is controlled via the GUARDS function unit) are to be deleted.
GUARDS = *PARAMETERS(...)
Deletes only those files which are protected by GUARDS against unauthorized access as specified, i.e. files for which access control is implemented using GUARDS: Access to the file is controlled by a guard, i.e. a special object which contains all the conditions under which a user is granted access authorization (e.g. date, time, user ID). The GUARDS function unit of the chargeable software product SECOS (see the “SECOS” manual [35]) must be installed in order to create and maintain a guard. Each access mode can be controlled by a separate guard. If no guard (*NONE) is defined for a given access mode, no corresponding access is permitted. If a defined guard is not accessible, the mode of access protected by it is not permitted. If the GUARDS subsystem is not available at the time of accessing the job variable, no access of any kind is allowed for the job variable.
READ = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Only the files which are protected against unauthorized read access by the specified guard are deleted. The default value *ANY means that the selection of files is not based on read protection with a guard. *NONE selects files for which no read access is permitted.
WRITE = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Only the files which are protected against unauthorized write access by the specified guard are deleted. The default value *ANY means that the selection of files is not based on a guard. *NONE selects files for which no write access is permitted. These files can be deleted with IGNORE-PROTECTION=*ACCESS.
EXEC = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Only the files which are protected against unauthorized execution by the specified guard are deleted. The default value *ANY means that the selection of files is not based on execute access protection by a guard. *NONE selects files for which no execution is permitted.
PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1 / *LEVEL-2
The highest activated access control method (protection level) is used as a selection criterion. Only the files which have access protection at specified protection level are deleted. When the file is accessed, the highest activated protection level applies. The following table shows the method used for access control, the protection attributes, and the job variable protection hierarchy (protection levels):
Access control | Protection attribute | Prot. level |
|---|---|---|
Standard access control | ACCESS and USER-ACCESS | 0 |
Basic access control list | BASIC-ACL | 1 |
Access control via guards | PASSWORD | 2 |
All other protection attributes of the file (e.g. passwords) are evaluated independently, without regard to the implemented protection level.
PROTECTION-ACTIVE = *ANY
The access control method is not to be used as a selection criterion.
PROTECTION-ACTIVE = *LEVEL-0
Only the files for which access is controlled via standard access control are to be deleted.
PROTECTION-ACTIVE = *LEVEL-1
Only the files for which access is controlled via a basic access control list (BASIC-ACL protection) are to be deleted.
PROTECTION-ACTIVE = *LEVEL-2
Only the files for which access takes place via GUARDS are deleted.
ACCESS-COUNTER = *ANY / <integer 0..2147483647> / *INTERVAL(...)
The access counter for the file is used as a selection criterion (see the ACC-COUNT output field of the SHOW-FILE-ATTRIBUTES command).
ACCESS-COUNTER = *ANY
The access counter is not to be used as a selection criterion.
ACCESS-COUNTER = <integer 0..2147483647>
Only the files for which the access counter exactly matches the specified value are selected for deletion.
ACCESS-COUNTER = *INTERVAL(...)
Deletes only the files for which the access counter lies in the specified value range which follows.
FROM = 0 / <integer 0..2147483647>
Deletes only those files for which the access counter >= the specified value.
TO = 2147483647 / <integer 0..2147483647>
Deletes only those files for which the access counter <= the specified value.
CODED-CHARACTER-SET = *ANY / *NONE / <name 1..8>
The coded character set defined in the catalog entry is used as a selection criterion (see the CREATE-FILE command; if a CCS is defined, see also the COD-CH-SET output field of the SHOW-FILE-ATTRIBUTES command).
CODED-CHARACTER-SET = *ANY
The defined character set is not to be used as a selection criterion.
CODED-CHARACTER-SET = *NONE
Only the files for which no coded character set was explicitly defined are selected for deletion.
CODED-CHARACTER-SET = <name 1..8>
Only the files for which the specified character set was defined are selected for deletion.
STATUS = *ANY / *PARAMETERS(...)
The current file status is used as a selection criterion.
STATUS = *ANY
The file status is not to be used as a selection criterion.
STATUS = *PARAMETERS(...)
Only the files which have the specified status are selected for deletion. The following selection criteria are possible:
CLOSED-OUTPUT = *ANY / *YES / *NO
Specifies whether the “file closed” status is to be used as a selection criterion.
CLOSED-OUTPUT = *YES
Only the files which have already been closed are deleted.
CLOSED-OUTPUT = *NO
Only the output files which have been opened in a program (OPEN OUTIN, INOUT or OUTPUT) and files which were not closed in an earlier system run or because a job was aborted are selected for deletion.
CACHED = *ANY / *YES / *NO
Specifies whether file processing via a cache is to be used as a selection criterion.
CACHED = *ANY
Deletes files regardless of whether or not they are cached.
CACHED = *YES
Only the currently cached files are selected for deletion.
CACHED = *NO
Only the files for which no data has been cached are deleted.
REPAIR-NEEDED = *ANY / *YES / *NO
Specifies whether files which were not closed in an earlier system run and not reconstructed with REPAIR-DISK-FILES are to be selected.
REPAIR-NEEDED = *ANY
Deletes files regardless of whether or not they need to be repaired.
REPAIR-NEEDED = *YES
Only the files which were not closed in an earlier system run and which have not yet been reconstructed are selected for deletion.
REPAIR-NEEDED = *NO
Only the files which were closed normally or reconstructed with the REPAIR-DISK-FILES command are deleted.
OPEN-ALLOWED = *ANY / *YES / *NO
Specifies whether files which could not be opened due to data inconsistency are to be selected.
OPEN-ALLOWED = *ANY
Deletes files regardless of whether or not they can be opened.
OPEN-ALLOWED = *YES
Only the files that can be opened are deleted.
OPEN-ALLOWED = *NO
Only the files which cannot be opened due to data inconsistency are deleted.
DEFECT-REPORTED = *ANY / *YES
Specifies whether files which may contain defective disk blocks are to be used as a selection criterion.
DEFECT-REPORTED = *ANY
Files are deleted irrespective of whether or not they may contain defective blocks.
DEFECT-REPORTED = *YES
Only files which may contain defective blocks are deleted.
CACHE-NOT-SAVED = *ANY / *YES
Specifies whether to select files for which updates have not been written out from the cache.
CACHE-NOT-SAVED = *ANY
Files are deleted irrespective of whether or not they contain modified data which could not be written back from the cache.
CACHE-NOT-SAVED = *YES
Only files containing modified data which could not be written back from the cache are deleted.
TYPE-OF-FILES = *ANY / list-poss(2): *FILE / *PLAM-LIBRARY
Specifies whether files are to be selected on the basis of information specific to the file type. The files to be exported can restrict to normal files or to PLAM libraries.
TYPE-OF-FILES = *ANY
Deletes files without taking their file type into account.
TYPE-OF-FILES = *FILE
Only files are deleted.
TYPE-OF-FILES = *PLAM-LIBRARY
Only PLAM libraries are deleted.
SPACE-RELEASE-LOCK = *ANY / *NO / *YES
The lock to prevent the release of unused memory space is used as a selection criterion (see the SP-REL-LOCK output field in the SHOW-FILE-ATTRIBUTES command).
SPACE-RELEASE-LOCK = *ANY
The permission to release unused memory space is not used as a selection criterion.
SPACE-RELEASE-LOCK = *NO
Only the files for which unused memory space may be released are selected for deletion.
SPACE-RELEASE-LOCK = *YES
Only the files for which the release of unused memory space is not permitted are selected for deletion.
IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
The performance attributes defined in the catalog are used as a selection criterion.
IO-ATTRIBUTES = *ANY
The performance attributes are not to be used as a selection criterion.
IO-ATTRIBUTES = *PARAMETERS(...)
Only the files for which the specified performance attributes which follow have been entered in the catalog are selected for deletion.
PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Deletes files with the specified performance attribute (IO(PERF) output field).
PERFORMANCE = *ANY
The performance attribute is not a selection criterion.
PERFORMANCE = *STD
Only the files that can be processed without any special performance requirements are deleted.
PERFORMANCE = *HIGH
Only the files which should be processed via a cache (high performance priority) are deleted.
PERFORMANCE = *VERY-HIGH
Only the files which should be processed via a cache and which should be permanently maintained in the cache if possible (highest performance priority) are selected for deletion.
USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Only the files which have a performance attribute that applies to the specified I/O operations (IO(USAGE) output field) are to be deleted.
USAGE = *ANY
The type of I/O operations to which the performance attribute applies is not to be used as a selection criterion.
USAGE = *READ-WRITE
Only the files for which the performance attribute applies to read-write operations are selected for deletion.
USAGE = *WRITE
Deletes files for which the performance attribute applies to only write operations.
USAGE = *READ
Deletes files for which the performance attribute applies to only read operations.
DISK-WRITE = *ANY / *IMMEDIATE / *BY-CLOSE
The time at which data consistency is required after a write operation is used as a selection criterion (see also the DISK-WRITE output field in the SHOW-FILE-ATTRIBUTES command).
DISK-WRITE = *ANY
The point at which data consistency is require is not a selection criterion.
DISK-WRITE = *IMMEDIATE
Deletes files which must be in a consistent state immediately after a write operation.
DISK-WRITE = *BY-CLOSE
Deletes files for which consistency of data is required only after CLOSE processing.
FREE-FOR-DELETION = *ANY / *NONE / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..0>(...) / <date>(...) / *INTERVAL(...)
The date of release for deletion (free-for-deletion date) can be used as a selection criterion for the files which are to be deleted. The selection for a specified date can be restricted to a specific period of time on the free-for-deletion date (see the TIME operands in the various structures) On deleting file generation groups and file generations see the DELETE-FILE-GROUP, and DELETE-FILE-GENERATION commands. See also the SHOW-FILE-ATTRIBUTES command, FREE-DEL-D and FREE-DEL-T output fields.
FREE-FOR-DELETION = *ANY
The free-for-deletion date is not used as a selection criterion.
FREE-FOR-DELETION = *NONE
Only deletes files for which no free-for-deletion date has yet been entered in the catalog.
FREE-FOR-DELETION = *TOMORROW(...)
Only deletes files for which the next day is entered as the free-for-deletion date in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the file selection to a period relative to the date of the next day.
TIME = *INTERVAL(...)
Only deletes files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *TODAY(...)
Only deletes files with today’s date recorded as the free-for-deletion date in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to today’s date.
TIME = *INTERVAL(...)
Only deletes files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *YESTERDAY(...)
Only deletes files with yesterday’s date recorded as the free-for-deletion date in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to yesterday’s date.
TIME = *INTERVAL(...)
Only deletes files with a free-for-deletion date which was changed within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *INTERVAL(...)
Only deletes files with a free-for-deletion date which falls within the specified period. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for the FREE-FOR-DELETION= <integer...> operand). It is also possible to specify only the FROM operand (lower limit) or the TO operand (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = *EARLIEST / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..99999>(...) / <date>(...)
Only deletes files with a free-for-deletion date >= the specified date.
FROM = *TOMORROW(...)
Only deletes files whose free-for-deletion date >= date of the next day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = *TODAY(...)
Only deletes files with a free-for-deletion date >= today’s date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = *YESTERDAY(...)
Only deletes files with a free-for-deletion date >= yesterday’s date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = <integer -99999..99999>(...)
Deletes only those files whose free-for-deletion date >= the specified date (in the form -n for the past or +n for the future).
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = <date>(...)
Only deletes files with a free-for-deletion date >= the specified date. The date is specified in the form [yy]yy-mm-dd. 20 is automatically prefixed to two-digit year specifications < 60, 19 to two-digit year specifications >= 60.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
TO = *LATEST / *TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) / <integer -99999..99999>(...) /
<date>(...)
Only deletes files with a free-for-deletion date <= the specified date.
TO = *LATEST
There is no upper limit on the selection range based on the free-for-deletion date.
TO = *TODAY(...)
Only deletes file generations with a free-for-deletion date <= today’s date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = *TOMORROW(...)
Only deletes files whose free-for-deletion date <= date of the next day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = *YESTERDAY(...)
Only deletes files with a free-for-deletion date <= yesterday’s date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = <integer -99999..99999>(...)
Deletes only those files whose free-for-deletion date <= the specified date (in the form -n for the past or +n for the future).
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = <date>(...)
Only deletes files with a free-for-deletion date <= the specified date. The date is specified in the form [yy]yy-mm-dd. 20 is automatically prefixed to two-digit year specifications < 60, 19 to two-digit year specifications >= 60.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
STORAGE-CLASS = *ANY / *NONE / <composed-name 1..8>
The selection criterion is the assigned storage class.
STORAGE-CLASS = *ANY
The storage class is not a selection criterion.
STORAGE-CLASS = *NONE
Only deletes files with no storage class assigned to them.
STORAGE-CLASS = <composed-name 1..8>
Only deletes files with the specified storage class assigned to them.
MANAGEMENT-CLASS = *ANY / *NONE / <composed-name 1..8>
The selection criterion is the HSMS management class.
MANAGEMENT-CLASS = *ANY
The HSMS management class is not a selection criterion.
MANAGEMENT-CLASS = *NONE
Only deletes files with no HSMS management class assigned to them.
MANAGEMENT-CLASS = <composed-name 1..8>
Only deletes files with the specified HSMS management class assigned to them.
ADM-INFORMATION = *ANY / *NONE / <c-string 1..8 with-low>
The selection criterion is the information that systems support has added to the catalog.
ADM-INFORMATION = *ANY
The systems support information is not a selection criterion.
ADM-INFORMATION = *NONE
Only deletes files with no systems support information in their catalog.
ADM-INFORMATION = <c-string 1..8 with-low>
Only deletes files with the specified string as the systems support information in their catalog.
USER-INFORMATION = *ANY / *NONE / <c-string 1..8 with-low>
The selection criterion is the information that the user has added to the catalog.
USER-INFORMATION = *ANY
The user information is not a selection criterion.
USER-INFORMATION = *NONE
Only deletes files with no user information in their catalog.
USER-INFORMATION = <c-string 1..8 with-low>
Only deletes files with the specified string as the user information in their catalog.
VOLUME-SET = *ANY / <cat-id 1..4>
The selection criterion is the volume set in which the file is stored.
VOLUME-SET = *ANY
The volume set is not a selection criterion.
VOLUME-SET = <cat-id 1..4>
Only deletes files stored in the specified volume set.
AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
The selection criterion is the required availability.
AVAILABILITY = *ANY
Availability is not a selection criterion.
AVAILABILITY = *STD
Only deletes files with no high availability requirements.
AVAILABILITY = *HIGH
Only deletes files with high availability requirements. The files are typically on disks mirrored by DRV.
S0-MIGRATION = *ANY / list-poss(2): *ALLOWED / *FORBIDDEN
The selection criterion is the permissibility of migration within the processing level (S0).
S0-MIGRATION = *ANY
Migration within the processing level is not a selection criterion.
S0-MIGRATION = *ALLOWED
Only deletes files for which migration to other volume sets within the processing level is allowed.
S0-MIGRATION = *FORBIDDEN
Only deletes files for which migration to other volume sets within the processing level is forbidden.
WORK-FILE = *ANY / *NO / *YES
The selection criterion is the work file attribute.
WORK-FILE = *ANY
The work file attribute is not a selection criterion.
WORK-FILE = *NO
Only deletes files which are not marked as work files.
WORK-FILE = *YES
Only deletes files which are marked as work files.
FILE-PREFORMAT = *ANY / list-poss(4): *NONE / *K / *NK2 / *NK4
The selection criterion is the preferred file format.
FILE-PREFORMAT = *ANY
The preferred file format is not a selection criterion.
FILE-PREFORMAT = *NONE
Only deletes files for which no preferred file format has been indicated.
FILE-PREFORMAT = *K
Only deletes files which are intended to be K files.
FILE-PREFORMAT = *NK2
Only deletes files which are intended to be NK files in 2K format.
FILE-PREFORMAT = *NK4
Only deletes files which are intended to be NK files in 4K format.
ENCRYPTION = *ANY / list-poss(3): *NONE / *AES / *DES
The selection criterion is the encryption method.
ENCRYPTION = *ANY
The encryption method is not a selection criterion.
ENCRYPTION = *NONE
Only unencrypted files are deleted.
ENCRYPTION = *AES
Only files which were encrypted using the AES method are deleted.
ENCRYPTION = *DES
Only files which were encrypted using the DES method are deleted.
OPTION = *ALL / *SPACE / *DATA / *DATA-KEEP-ATTRIBUTES / *DESTROY-ALL
Controls the deletion of the file.
If DESTROY-BY-DELETE=YES was defined in the catalog entry of the file, the file or released storage space will definitely be overwritten with binary zeros. If this is not the case and if OPTION=*DESTROY-ALL was also not specified, the file or released storage space will be deleted only logically, rather than being overwritten.
OPTION = *ALL
All catalog entries for the selected files are deleted.
The storage space for files on disks and Net-Storage volumes is also released.
OPTION = *SPACE
Only for files on pubset disks and Net-Storage volumes: The storage space for the deleted files is released and the catalog entry on Net-Storage, if existing, is deleted. The catalog entry in BS2000 is retained, although amended: it is then identical with a catalog entry created with a CREATE-FILE SUPPORT=*NONE command. For tape files the default value ALL applies; for private disks the operand SPACE will be rejected.
OPTION = *DATA
Only for files on disks and Net-Storage volumes (for tape files the default value ALL applies): the data in the selected files is “logically deleted”. After this, the user can no longer access the data, since he/she is no longer permitted to access the volume concerned physically. The catalog entry and the storage space allocation are retained.
OPTION = *DATA-KEEP-ATTRIBUTES
Only for files on disks and Net-Storage volumes (for tape files the default value ALL applies): the data of the files involved is “logically deleted” as with OPTION=*DATA, but the data related file attributes are retained. The data can no longer be addressed by the user.
OPTION = *DESTROY-ALL
Only for files on disks and Net-Storage volumes (for tape files the default value ALL applies):
the storage space for the files involved is released and the catalog entry is deleted; in addition, the storage space thus released is overwritten with binary zeros so that, if the space is allocated again, nobody can read the old data (data security). In the case of files on private disks, all the volumes on which the file was stored must be mounted at the time of deletion.
“Data destruction” when a file is deleted can also be permanently recorded in the catalog entry using the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command (DESTROY-BY-DELETE=*YES operand); a “DESTROY” flag is then set in the catalog entry (DESTROY=YES output field). In this case storage space is released and it will be automatically overwritten.
MOUNT = *FIRST-DISK / *ALL-DISK
Only for files on private disks:
specifies whether to mount all private disks containing files which are to be deleted. The user can request that only the first of the required private disks be mounted, or all of them. The MOUNT operand should be specified if the options *ALL or *DESTROY-ALL are specified. For tape files or files on public disks or Net-Storage volumes, any MOUNT specification will be ignored.
MOUNT = *FIRST-DISK
It is only necessary for the first of the private disks, containing the start of the file and its catalog entry, to be online. The associated private disks do not have to be online.
MOUNT = *ALL-DISKS
All the private disks on which parts of the file are held, must be online. If any of the disks is missing, the file will not be deleted; on completion of the DELETE-FILE processing, the spin-off mechanism will be triggered.
DIALOG-CONTROL = *STD / *NO / *ERROR / *FILE-CHANGE / *MORE-THAN-ONE-FILE /
*CATALOG-CHANGE / *USER-ID-CHANGE
Specifies whether and under what conditions a verification dialog is to be conducted with the user during the deletion process. A control dialog is only possible in dialog mode but, in this mode, may also be used in procedures. The only operand value that you can specify in batch mode is *STD or *NO.
The user can intervene with the following inputs:
Y: the specified file or file set will then be deleted.
N: the specified file or file set will not be deleted.
T: processing of the command will be terminated.
?: the possible responses will be listed, with an explanation of each.
In addition, the following options can be specified, separated by commas:
,CHECK = NO
The DIALOG-CONTROL mode will be changed to ‘*NO’.
,CHECK = PVS
The DIALOG-CONTROL mode will be changed to ‘*CATALOG-CHANGE’.
,CHECK = MULTIPLE
The DIALOG-CONTROL mode will be changed to ‘*MORE-THAN-ONE-FILE’.
,CHECK = SINGLESINGLE
The DIALOG-CONTROL mode will be changed to ‘*FILE-CHANGE’.
,CHECK = ERROR*
The DIALOG-CONTROL mode will be changed to ‘*ERROR’.
,IGNORE = list-poss(5): ACCESS / EXDATE / RDPASS / WRPASS / EXPASS
Specifies which protection attributes are to be ignored during deletion. The specification only applies to a single file in the control dialog. RDPASS, WRPASS and EXPASS are available to privileged users only.
,PASSWORD = list-poss(3): <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647>Enables password-protected files to be deleted (maximum of 3 passwords). The specification only applies to a single file in the control dialog.
DIALOG-CONTROL = *STD
The default *STD setting is equivalent to *MORE-THAN-ONE-FILE in an interactive dialog (when SYSCMD is connected to the terminal) and to *NO in procedures and in batch mode.
DIALOG-CONTROL = *NO
The user cannot intervene in DELETE-FILE processing; all the specified files will be deleted (without a verification dialog).
DIALOG-CONTROL = *ERROR
If deletion of the selected files proceeds without error, they will be deleted immediately, as when *NO is specified (i.e. no verification dialog). However, if a user-correctable error occurs, then a verification dialog takes place as for DIALOG-CONTROL=*FILE-CHANGE. DIALOG-CONTROL=*ERROR applies implicitly if DIALOG-CONTROL=*FILE-CHANGE is set. In the event of an error, the user may acknowledge the error message, abort DELETE-FILE processing or attempt to rectify the error. If he wishes, he can also change the DIALOG-CONTROL mode (see also the possible forms of intervention listed under the first DIALOG-CONTROL operand).
DIALOG-CONTROL = *FILE-CHANGE
For each file which is to be deleted, the user has the intervention options described under the first DIALOG-CONTROL operand. For each file which is to be processed, the user can decide interactively whether it should be deleted or not (response: YES/NO). If in the verification dialog he specifies protection attributes under “IGNORE”, or one or more passwords under “PASSWORD”, these will be taken into account for any selected file and, if satisfied, the file will be deleted without further queries (“YES” must also be specified). The user can also abort DELETE-FILE processing, or change the DIALOG-CONTROL mode.
DIALOG-CONTROL = *MORE-THAN-ONE-FILE
If exactly one file is specified, this will be deleted immediately. If the file is specified in partially qualified form, which means that more than one file is selected, or if the file name contains wildcards, the user can decide, each time the catalog ID changes, whether or not files from the new catalog are to be deleted (see the intervention options described for the first of the DIALOG-CONTROL operands). He must respond to the question issued by the system with “YES” or “NO”. DIALOG-CONTROL = *MORE-THAN-ONE-FILE is useful if wildcards are specified for “catid” in the FILE-NAME operand. In the verification dialog, DELETE-FILE processing can be terminated, or the DIALOG-CONTROL mode can be changed.
DIALOG-CONTROL = *CATALOG-CHANGE
As with DIALOG-CONTROL = *MORE-THAN-ONE-FILE, the DELETE-FILE processing routine branches to a verification dialog if files in different catalogs (PUBSETS) are affected. The user can determine whether the files in the current PUBSET should be deleted (YES/NO), DELETE-FILE processing should be terminated, or the DIALOG-CONTROL mode should be changed.
DIALOG-CONTROL = *USER-ID-CHANGE
Whenever the user ID is changed when deleting the files, a branch is made to guided dialog.
OUTPUT = *STD / *NO / *SYSOUT
The user can specify whether a message (DMS0800) with the name of the deleted file is to be output to SYSOUT for each successfully deleted file. The default setting *STD is equivalent to OUTPUT=*NO.
OUTPUT = *NO
No messages are output to SYSOUT for successfully deleted files.
OUTPUT = *SYSOUT
For each file that is successfully deleted, a message with the name of that file is output to SYSOUT.
IGNORE-PROTECTION = *NONE / list-poss(5): *ACCESS / *EXPIRATION-DATE /
*READ-PASSWORD / *EXEC-PASSWORD
The user can specify whether any defined file protection against write access or any defined retention period is to be ignored. Systems support staff can also ignore password protection. The specification IGNORE-PROTECTION in the DELETE-FILE command thus makes it unnecessary to issue MODIFY-FILE-ATTRIBUTES commands to reset the protection attributes before the files can be deleted.
IGNORE-PROTECTION = *NONE
The protection attributes “read-only” (ACCESS=READ or no write access with BASIC-ACL or GUARDS) and “retention period” (EXPIRATION-DATE) will be observed during deletion.
IGNORE-PROTECTION = *ACCESS
Files for which write access by the owner is not allowed at the highest activated protection level can still be deleted using DELETE-FILE (see the selection criteria PROTECTION-ACTIVE, ACCESS, BASIC-ACL orGUARDS).
IGNORE-PROTECTION = *EXPIRATION-DATE
Files which are still within their retention period (EXPIR-DATE > current date) may be deleted using DELETE-FILE.
IGNORE-PROTECTION = *WRITE-PASSWORD
System support staff are authorized to ignore the protection attribute write password when deleting the file.
IGNORE-PROTECTION = *READ-PASSWORD
System support staff are authorized to ignore the protection attribute read password when deleting the file.
IGNORE-PROTECTION = *EXEC-PASSWORD
System support staff are authorized to ignore the protection attribute execute password when deleting the file.
PASSWORDS-TO-IGNORE = *NONE / *SECRET / list-poss(3): <x-string 1..8> / <c-string 1..4> /
<integer -2147483648..2147483647>
The user can specify one or more passwords, which will permit files protected by these passwords to be deleted. The passwords entered here are not recorded in the password table for the job, and are valid only for the current DELETE-FILE processing. Up to 3 passwords may be specified in the form of a list.
In order to delete a password-protected file, the password at the highest access level must be specified (see also the ADD-PASSWORD command).
The operand has the following special characteristics:
The password entered is not logged.
The input field is automatically blanked out in the guided dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^, SDF provides a blanked out input field for inputting the password.
PASSWORDS-TO-IGNORE = *NONE
No passwords are specified.
SUPPRESS-ERRORS =*NONE / list-poss(3): <alphanum-name 7..7>
In procedures the user can specify whether the spin-off mechanism or SDF-P error handling is to be triggered every time an error occurs (apart from syntax errors), or whether specific error conditions are to be ignored.
SUPPRESS-ERRORS = *NONE
All errors will trigger the spin-off mechanism or SDF-P error handling.
SUPPRESS-ERRORS = list-poss(3): <alphanum-name 7..7>
The user can define which errors are to be ignored by means of their DMS error codes (alphanum-name 7..7). If the specified error occurs, the spin-off mechanism will not be triggered. A maximum of 3 error codes may be specified. DMS error code: 7 characters, of which the first three are always “DMS”; the last 4 characters identify the error; the digits 0...9 and letters A...F are permitted. When error codes are entered, no check is made to verify that valid error codes have been specified.
A detailed list of valid DMS error codes can be found on the manual server (URL: http://bs2manuals.ts.fujitsu.com) by means of an HTML application and on the “BS2000 SoftBooks” DVD.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | 0 | CMD0001 | No action required |
2 | 0 | DMS05F7 | File generation does not exist, but group entry is updated |
2 | 0 | DMS06D6 | Error on deleting certain files |
1 | CMD0202 | Syntax or semantic error in command | |
32 | DMS0584 | A state that does not allow the function to continue was reported during processing | |
64 | CMD0102 | Interrupted by K2 key | |
64 | CMD0216 | Privilege errors | |
64 | DMS0501 | Requested catalog not available | |
64 | DMS0512 | Requested catalog not found | |
64 | DMS051B | Requested user ID not in pubset | |
64 | DMS051C | User not authorized to access pubset | |
64 | DMS0535 | Specified file not shareable | |
64 | DMS055C | The catalog entry could not be found on the assigned volume | |
64 | DMS057B | Invalid operand for migrated file | |
64 | DMS057C | Processing not possible due to HSMS error | |
64 | DMS057D | File has been migrated and cannot be recalled without delay | |
64 | DMS057E | File has been migrated, and HSMS is not available | |
64 | DMS0585 | Error detected when processing catalog or multiprocessor system | |
64 | DMS0586 | It is not possible to access or reserve a volume at present | |
64 | DMS0587 | Use of the specified command has been restricted by the system administrator | |
64 | DMS05FC | Specified user ID not in HOME pubset | |
64 | DMS0609 | No access to system file | |
64 | DMS0640 | Access to Net-Storage is rejected by the ONETSTOR subsystem because of communication problems with the net client | |
64 | DMS0643 | Net client reports access error | |
64 | DMS0644 | Net client reports internal error | |
64 | DMS0645 | File does not exist on Net-Storage | |
64 | DMS0649 | Net server reports POSIX-ACL error | |
64 | DMS064A | Net client reports that access to files is forbidden on the Net-Storage volume | |
64 | DMS064B | Access to node files not supported by the net client | |
64 | DMS064C | Directory of the specified user ID does not exist on Net-Server | |
64 | DMS06FF | BCAM connection severed | |
130 | DMS0524 | System address space exhausted | |
130 | DMS0582 | File is currently locked or being used and cannot be processed | |
130 | DMS0585 | Error detected when processing catalog or multiprocessor system | |
130 | DMS0586 | It is not possible to access or reserve a volume at present | |
130 | DMS0594 | Not enough virtual memory available |
Notes
If a file held on a private disk is to be deleted, the device on which this disk is mounted will be requested for the job. After deletion of the file generation, the device will be returned to the system.
For files stored on private disks, if OPTION=*DESTROY-ALL or MOUNT=*ALL-DISK is specified then all the volumes which hold the file must be already mounted at the time the command is executed. Otherwise, only the first volume which holds the file has to be mounted. The following volumes will not be requested until the command is being executed. This rule also applies if a partially qualified file name is specified in the DELETE-FILE command, thus addressing a number of files. In this situation, it is not necessary that all the volumes for all the files are mounted simultaneously. The system will determine which of the files requires the most devices, and will request the corresponding number of devices.
Examples
Example 1: Deleting selected files; in this case, files that have names starting with 'D.' followed by one of the numbers from '1' to '8'
/show-file-attr inf=*minimum ———————————————————————————————— (1)
%N NNN NW 3 :2OS2:$USER1.D.1 %N NNN NW 3 :2OS2:$USER1.D.10 %N NNN R-------- 3 :2OS2:$USER1.D.2 %S NNN NW 60 :2OS2:$USER1.D.3 %N NNN NR 3 :2OS2:$USER1.D.4 %N NNN GUARDS 3 :2OS2:$USER1.D.5 %N NNN NW 3 :2OS2:$USER1.D.6 %N NYN NW 3 :2OS2:$USER1.D.7 %N NNN NW 3 :2OS2:$USER1.D.8 %N NNN NW 3 :2OS2:$USER1.D.9 %S NNN NW 6 :2OS2:$USER1.LST.ADDCMD %S NNN NW 333 :2OS2:$USER1.LST.DOMAIN.D %S NNN NW 333 :2OS2:$USER1.LST.DOMAIN.E %S NNN NW 24 :2OS2:$USER1.LST.HELP %S NNN NW 24 :2OS2:$USER1.LST.RFA.416 %S NNN NW 66 :2OS2:$USER1.LST.SDF.D.1 %S NNN NW 30 :2OS2:$USER1.LST.SDF.E %N NNN NW 3*:2OS2:$USER1.MAX.DISK-FILE.1 %N NNN NW 3 :2OS2:$USER1.MAX.FILE.1 %N NNN RWX------ 3 :2OS2:$USER1.MAX.FILE.2 %N NNN GUARDS 3 :2OS2:$USER1.MAX.FILE.3 %N NNN NW 0*:2OS2:$USER1.MAX.GROUP.1 (FGG) %N YNN NW 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) %N NNN NW 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) %N NNN YW :2OS2:$USER1.MAX.TAPE-FILE.1 %I NNN NW 384 :2OS2:$USER1.SF.NEU %I NNN NW 48 :2OS2:$USER1.SF.ROBAR %I NNN NW 123 :2OS2:$USER1.SF.TEST.DEV.1
/del-file :*:d.<1:8>,dialog-control=*catalog-change —————————————————————— (2)
% DMS0516 DELETE FILE(S) ':2OBU:$USER1.D.<1:8>' ? REPLY (Y=YES; N=NO; T=TER
MINATE COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y ———————————————————————————————————— (3)
% DMS0801 ERROR WHEN DELETING FILE ':2OBU:$USER1.D.<1:8>'
% DMS051B REQUESTED USER ID NOT IN PUBSET 2OBU
% DMS0516 DELETE FILE(S) ':2ORZ:$USER1.D.<1:8>' ? REPLY (Y=YES; N=NO; T=TER
MINATE COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y ———————————————————————————————————— (4)
% DMS0801 ERROR WHEN DELETING FILE ':2ORZ:$USER1.D.<1:8>'
% DMS051B REQUESTED USER ID NOT IN PUBSET 2ORZ
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.<1:8>' ? REPLY (Y=YES; N=NO; T=TER
MINATE COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?? ———————————————————————————————————— (5)
% ? The user can decide, in interactive mode, whether or not to execute the
% specified delete task.
% (&00): partially qualified file name, or name of a file, a file generation
% or a file generation group.
% Y: the file, file generation or file generation group will be deleted.
% N: the displayed file, file generation or file generation group will
% not be deleted.
% T: processing of the entered delete command will be terminated.
% ?: explanations of the additional options will be displayed, followed
% by renewed display of the task.
% The meanings of the operands of the possible additional options are
% analogous to those of the corresponding operands in the command and
% may be looked up in the 'Control System Command Language' manual.
% The following additional options may be added, separated by a comma,
% to the response ('Y' or 'N' or 'T'):
% ,CHECK: update the current dialog form:
% ,CHECK=NO or =PVS or =MULTIPLE or =SINGLE or =ERROR.
% ,IGNORE: redefine the protection attribute before processing the delete
% task:
% ,IGNORE=ACCESS or =EXDATE or ,IGNORE=(ACCESS,EXDATE).
% ,PASSWORD: reassign the passwords before processing the delete task.
% A maximum of 3 (hexadecimal or numeric) passwords are
% permitted.
% ,PASSWORD=password or =(password,...).
% ! Enter the appropriate reply for the explanation in the 'Meaning' text.
% If the reply is invalid or if an empty string is entered, the task
% will not be processed.
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.<1:8>' ? REPLY (Y=YES; N=NO; T=TERM
INATE COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y,check=single ——————————————————————— (6)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.1' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.2' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0801 ERROR WHEN DELETING FILE ':2OS2:$USER1.D.2'
% DMS0666 REQUESTED ACCESS TO FILE NOT PERMITTED DUE TO EXISTING FILE PROTEC
TION. COMMAND NOT PROCESSED ———————————————————————————————————————————————————————— (7)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.3' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0801 ERROR WHEN DELETING FILE ':2OS2:$USER1.D.3'
% DMS05C3 FILE TO BE DELETED IS IN USE. RETRY COMMAND LATER ——————————————————————— (8)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.4' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0801 ERROR WHEN DELETING FILE ':2OS2:$USER1.D.4'
% DMS06D5 FILE IS READ-ONLY. CHECK FILE. MODIFY ACCESS TYPE AND REENTER COMM
AND
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.4' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y,ignore=access —————————————————————————— (9)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.5' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0801 ERROR WHEN DELETING FILE ':2OS2:$USER1.D.5' ————————————————————————————— (10)
% DMS0666 REQUESTED ACCESS TO FILE NOT PERMITTED DUE TO EXISTING FILE PROTEC
TION. COMMAND NOT PROCESSED
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.6' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.7' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y ——————————————————————————————————————— (11)
% DMS0801 ERROR WHEN DELETING FILE ':2OS2:$USER1.D.7'
% DMS05BF FILE PASSWORD-PROTECTED. FIRST ENTER CORRECT PASSWORD VIA APPROPRI
ATE COMMAND, THEN REENTER COMMAND FOR DELETION
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.7' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y,password=1234 ————————————————————————— (12)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.8' ? REPLY (Y=YES; N=NO; T=TERMINAT
E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y
/show-file-attr d. —————————————————————————————————————————————— (13)
% 3 :2OS2:$USER1.D.10 % 3 :2OS2:$USER1.D.2 % 60 :2OS2:$USER1.D.3 % 3 :2OS2:$USER1.D.5 % 3 :2OS2:$USER1.D.9 %:2OS2: PUBLIC: 5 FILES RES= 72 FRE= 36 REL= 36 PAGES
/show-system-file-assignment ————————————————————————————————————————— (14)
%PROCEDURE LEVEL NUMBER 0 %SYSCMD : (PRIMARY) %SYSDTA : (PRIMARY) %SYSIPT : NOT ASSIGNED %SYSOUT : (PRIMARY) %SYSLST : :2OS2:$USER1.D.3 %SYSOPT : (PRIMARY) %TASKLIB : (PRIMARY)
(1) | Lists all files of the user ID USER1 on the default pubset 2OS2. The most important file attributes are shown in condensed form (INFORMATION=*MINIMUM). |
(2) | All files that have names which begin with D., end with one of the numbers from 1 to 8, and which comprise a total of 3 characters are to be deleted. In order to do this, all file catalogs that can be accessed by the user are searched (with the wildcard * in the catalog ID). In addition, an interactive prompt is to be issued for all selected files to be deleted (DIALOG-CONTROL=*CATALOG-CHANGE). |
(3) | (Prompt to verify whether the searched file set on pubset 2OBU is to be deleted. The positive response that was indicated with Y is rejected, since no files which match the sequence of wildcards exist on the pubset. |
(4) | Prompt to verify whether the searched file set on pubset 2ORZ is to be deleted. The positive response that was indicated with Y is rejected, since no files which match the sequence of wildcards exist on the pubset. |
(5) | Prompt to verify whether the searched file set on pubset 2OS2 is to be deleted. The ? is used to request an explanation for the various responses that can be made. |
(6) | The response to the prompt to verify whether the searched file set on pubset 2OS2 is to be deleted is Y. In addition, the dialog control mode is set to CHECK=SINGLE, which means that a prompt is to be displayed for each file that is found. |
(7) | The file D.2 cannot be deleted, since it is protected by a BASIC-ACL and the user (OWNER) has no write authorization, see item (1). |
(8) | The file D.3 cannot be deleted because it is still open, see item (14). |
(9) | The file D.4 is protected against write access using ACCESS=READ. The response to the second prompt for the file is Y,IGNORE=ACCESS, so the file can now be deleted. |
(10) | The file D.5 cannot be deleted because it is protected using GUARDS and because the user has no write authorization (see example 2). |
(11) | The file D.7 cannot be deleted, since it is protected against write access by a password and the user has not yet entered the password into his password table. |
(12) | When the second prompt appears, the required password is also specified. This allows the file to be deleted; however, the specified password is not entered into the password table of the task. The only possible way to do that is by using the ADD-PASSWORD command. |
(13) | Output of all file names beginning with D. |
(14) | Output of the system files along with their assignments: The file D.3 is assigned to the system file SYSDTA and could not be deleted as a result (see item 8). |
Example 2: Deleting files which are protected against write access by means of a BASIC-ACL or GUARDS
/show-file-attr d.<2,5>,inf=(security=*yes) ———————————————————————————————————— (1)
%0000000003 :2OS2:$USER1.D.2 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % OWNER = R - - GROUP = - - - OTHERS = - - - % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE %0000000003 :2OS2:$USER1.D.5 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % OWNER = R W X GROUP = - - - OTHERS = - - - % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % GUARD-READ = $USER1.OWN-PROT % GUARD-WRIT = NONE % GUARD-EXEC = NONE %:2OS2: PUBLIC: 2 FILES RES= 6 FRE= 3 REL= 3 PAGES
/delete-file d.<2,5>,dialog-control=*file-change,ignore-protection=*access ————— (2)
% DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.2' ? REPLY (Y=YES; N=NO; T=TERMINAT E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y —————————————————————————————————— (3) % DMS0516 DELETE FILE(S) ':2OS2:$USER1.D.5' ? REPLY (Y=YES; N=NO; T=TERMINAT E COMMAND; ?=EXPLAIN ADDITIONAL OPTIONS)?y —————————————————————————————————— (4)
/show-file-attr d.<2,5> ———————————————————————————————————————————————————————— (5)
% DMS06CC NO FILE CORRESPONDING TO SPECIFIED OPERANDS
(1) | Shows the protection attributes of the files D.2 and D.5. Access control for the file D.2 is implemented by a BASIC-ACL. The user (OWNER) has no write authorization, i.e. cannot delete the file without a change in the protection attributes. Access control for the file D.5 is implemented using GUARDS. Since no guard has been defined for write access, no write access is granted to any user, i.e. the user cannot delete his or her file unless the protection attributes are changed. |
(2) | The two files are to be deleted by ignoring any access protection that may have been defined (with ACCESS, BASIC-ACL or GUARDS). The deletion of each file is to be verified by means of a prompt. |
(3) | On confirmation of the prompt with Y, the file D.2 is deleted. |
(4) | On confirmation of the prompt with Y, the file D.5 is deleted. |
(5) | The file catalog now contains no information on these files. |
Example 3: Selecting files using wildcards in the file name
/show-file-attr <lst,max>. —————————————————————————————————————————————————— (1)
% 6 :2OS2:$USER1.LST.ADDCMD % 3 :2OS2:$USER1.LST.BSP.2 % 333 :2OS2:$USER1.LST.DOMAIN.D % 333 :2OS2:$USER1.LST.DOMAIN.E % 24 :2OS2:$USER1.LST.HELP % 24 :2OS2:$USER1.LST.RFA.416 % 66 :2OS2:$USER1.LST.SDF.D.1 % 30 :2OS2:$USER1.LST.SDF.E % 3*:2OS2:$USER1.MAX.DISK-FILE.1 % 3 :2OS2:$USER1.MAX.FILE.1 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 0*:2OS2:$USER1.MAX.GROUP.1 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % :2OS2:$USER1.MAX.TAPE-FILE.1 %:2OS2: PUBLIC: 13 FILES RES= 828 FRE= 26 REL= 18 PAGES %:2OS2: PRDISC: 2 FILES RES= 3 FRE= 3 REL= 0 PAGES %:2OS2: TAPE : 1 FILE
/delete-file ///.file.2,dialog-control=*file-change ————————————————————————— (2)/show-file-attr ///.file. ——————————————————————————————————————————————————— (3)
% 3 :2OS2:$USER1.MAX.FILE.1 % 3 :2OS2:$USER1.MAX.FILE.3 %:2OS2: PUBLIC: 2 FILES RES= 6 FRE= 6 REL= 6 PAGES
(1) | Shows all files for which the first partial name is MAX or LST. |
(2) | Selects files for deletion if their first partial name consists of exactly three characters and if the file name ends in FILE.2. |
(3) | Only one file was selected, i.e. the file MAX.FILE.2. Since this was the only file available for selection, it was deleted without confirmation. |