This statement deletes terminated or interrupted requests from the request file of an SF or SM pubset environment. All users can also delete requests which have the status “STARTED”. Requests can also be deleted from the display of the SHOW-REQUESTS statement.
The following applies to an SF pubset environment:
You can only delete requests from the system on which they originated. Requests in a master’s request file which were created through the processing of a slave request on the master and have the status INTERRUPTED can only be deleted from the slave. This involves deleting the corresponding request in the slave’s request file.
This statement has different formats for nonprivileged users and HSMS administrators. Privileged operands or operand values are marked with *P).
Format
DELETE-REQUESTS | Alias: DLR | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
*P) Privileged operand or operand value
REQUEST-NAME =
You can select the requests that are to be deleted via their request names.
The default name specified via the action statement or assigned by HSMS is extended internally by a prefix formed by the user ID and a suffix in the form of a time stamp. Since the name by itself need not be unique, the request name can be used to refer to more than one request at a time.
REQUEST-NAME = *ANY
The requests to be deleted are to be selected irrespective of their names.
REQUEST-NAME = <name 1..8>
Restricts deletion to requests with the specified name.
ENVIRONMENT =
Determines the HSMS environment where the request file to be processed is located.
ENVIRONMENT = *STD
The HSMS statement affects the default environment for DMS requests:
For privileged users: *STD is set to the value *SINGLE-FEATURE.
For nonprivileged users: *STD is the environment that is associated with the user’s default pubset (the default pubset is defined in the user catalog).
ENVIRONMENT = *NODE-STD
The archive is located in the default environment for node requests:
For privileged users: *NODE-STD is set to the value *SINGLE-FEATURE.
For nonprivileged users: *NODE-STD is set to the value of the environment in which the home directory of the user is defined.
ENVIRONMENT = *SINGLE-FEATURE
The HSMS statement only affects the request file of the SF environment.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The HSMS statement only affects the request file of the specified SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset to which the HSMS statement applies.
REQUEST-DATE =
Serves to select the requests to be deleted using the creation date as the selection criterion. The date is output by SHOW-REQUESTS.
REQUEST-DATE = *LATEST
Restricts deletion to the most recently created requests.
REQUEST-DATE = *INTERVAL(...)
Serves to select the requests to be deleted using a time interval as the selection criterion.The interval includes all requests created between CREATED-AFTER and CREATED-BEFORE.
Unless otherwise specified, all requests starting with the one created first (*EARLIEST-DATE) up to the one created last (*LATEST-DATE) are selected.
CREATED-BEFORE = *LATEST-DATE
The requests are to be deleted irrespective of whether they were created before a specific date.
CREATED-BEFORE = <date with-compl> / <integer -99999..0 days>
Restricts deletion to requests created on or before the specified date.
CREATED-AFTER = *EARLIEST-DATE
The requests are to be deleted irrespective of whether they were created after a specific date.
CREATED-AFTER = <date with-compl> / <integer -99999..0 days>
Restricts deletion to requests created on or after the specified date.
REQUEST-DATE = <date with-compl> (...)
The requests to be deleted are selected using the date and time of their creation as the selection criterion.
TIME = <time>
Time specification in the form hh:mm:ss
REQUEST-ORIGIN =
This operand is only available to the HSMS administrator.
The requests are selected on the basis of their origin: this is the central BS2000 host (DMS and node requests).
REQUEST-ORIGIN = *BS2000(...)
The requests were issued by a BS2000 user at a BS2000 host.
USER-ID =
You can select the requests for deletion via the user ID under which they were created.
USER-ID = *OWN
Only those requests that are running under your own user ID are deleted (SYSHSMS for HSMS administrators).
USER-ID = *ALL
The requests of all users are deleted.
USER-ID = <name 1..8>
Only the requests of the specified user ID are deleted.
REQUEST-ORIGIN = *NODE-CL(...)
This operand only exists for compatibility reasons.
REQUEST-STATE =
Serves to select the requests to be deleted using their current processing state as the selection criterion.
REQUEST-STATE = *COMPLETED
Only completed requests are to be deleted from the request file. This permits completed requests to be deleted from the request file before the end of the HSMS session.
REQUEST-STATE = *INTERRUPTED
Only requests whose processed was interrupted are to be deleted from the request file.
REQUEST-STATE = *ACCEPTED
Only accepted requests are deleted from the request file.
REQUEST-STATE = *CANCELLED
Only cancelled requests are deleted from the request file.
REQUEST-STATE = *STARTED
Only started requests are aborted and deleted from the request file.
Started requests are not deleted immediately. Before a started request is deleted, a deletion message is sent to the HSMS server task that is processing the request. The HSMS server task checks the deletion message and aborts once it has been read. However, since the deletion message does not have any priority, it cannot be read if the HSMS server task, for example, is locked in a security queue. As a result, the started request is not deleted immediately but only after a few minutes.
The following restrictions apply:
Activities which have already been performed for a started request which is due to be deleted are not reset. As a result, HSMS structures which have already been modified retain their modified status.
The deletion of requests with the status “STARTED COLLECTED” is not supported.
It is not possible to delete requests while the copy on the master is in the status “STARTED”.
- It is not possible to delete REORGANIZE-VERSION-BACKUP requests in the status “STARTED”.
- It is not possible to restart the request following deletion since it has been removed from the request file.
REQUEST-STATE = *ANY
Completed, interrupted, cancelled and accepted requests are deleted from the request file.
ARCHIVE-NAME =
Only for archive owners:
The requests to be deleted can be selected via the archive for which they were created.
ARCHIVE-NAME = *ALL
The requests to be deleted are selected in the specified environment irrespective of the archive.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Only requests referring to the archive in the specified environment are deleted.