Delete Submitted CRQ (DLTSBMCRQ)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Delete Submitted Change Request (DLTSBMCRQ) command allows you to delete one or more submitted change requests.

Restriction: You can only delete a change request if you are the submitter, or have *JOBCTL special authority. Only change requests with a status of Ended can be deleted.

Top

Parameters

Keyword Description Choices Notes
CRQ Change request Element list Required, Positional 1
Element 1: Name Generic name, name, *ALL
Element 2: Sequence number 1-999999, *ALL
DAYS Days 0-999, 30 Optional
Top

Change request (CRQ)

Specifies the change request name and sequence number to be deleted.

The possible change request name values are:

*ALL
Deletes all qualified change requests.
change-request-name
Specify the name of the change request to be deleted.
generic*-change-request-name
Specify a generic change request name. A generic name is a character string containing one or more characters followed by an asterisk (*). The change requests matching the string or beginning with the string is deleted.

The possible sequence number values are:

*ALL
Selects all qualified change requests.
sequence-number
Specify the sequence number of the change request to be deleted.
Top

Days (DAYS)

Specifies the number of days old a change request must be before it is deleted. Change requests that have been ended for the specified number of days or more are deleted. The DAYS parameter is ignored for requests to delete a specific change request.

30
Deletes change requests 30 days old or older.
number-of-days-old
Specify the number of days a change request has had a status of ENDED.
Top

Examples

Example 1: Deleting All Ended Change Requests

DLTSBMCRQ   CRQ(*ALL)  DAYS(0)

This command shows how to delete all ended change requests.

Example 2: Deleting a Submitted Change Request

DLTSBMCRQ   CRQ(CHG4444 123)

This command shows how to delete the submitted change request CHG4444 with a sequence number of 123.

Example 3: Deleting All Change Requests

DLTSBMCRQ   CRQ(CHG* 1)  DAYS(15)

This command shows how to delete all change requests with names starting with CHG and having a sequence number of 1 that are 15 days old or older.

Top

Error messages

None

Top