Display Submitted CRQs (DSPSBMCRQ)

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

The Display Submitted Change Requests (DSPSBMCRQ) command allows you to display or print a list of submitted change requests.

Restriction:

Only the change requests submitted by you display. If you have *JOBCTL special authority, all selected change requests display.

Top

Parameters

Keyword Description Choices Notes
CRQ Change request Element list Optional, Positional 1
Element 1: Name Generic name, name, *ALL
Element 2: Sequence number 1-999999, *ALL
STATUS Status *ALL, *SBM, *ACTIVE, *ENDED Optional
HIGHENDCDE Highest end code 0-99, *ANY, *SUCCESS, *FAIL, *NOTRUN Optional
LASTENDCDE Last end code 0-99, *ANY, *SUCCESS, *FAIL, *NOTRUN Optional
CRQD Change request description Qualified object name Optional
Qualifier 1: Change request description Generic name, name, *ALL
Qualifier 2: Library Name, *ALL
SBM Submitter Name, *ALL Optional
PERIOD Period Element list Optional
Element 1: Start time and date Element list
Element 1: Start time Time, *AVAIL
Element 2: Start date Date, *BEGIN, *CURRENT
Element 2: End time and date Element list
Element 1: Ending time Time, *AVAIL
Element 2: Ending date Date, *END, *CURRENT
PRBID Problem identifier Character value, *ALL Optional
PRBORG Problem origin Element list Optional
Element 1: Network identifier Communications name, *ALL, *NETATR
Element 2: Control point Communications name, *ALL, *NETATR
OUTPUT Output *, *PRINT Optional
Top

Change request (CRQ)

Specifies the qualified change request name.

The possible change request name values are:

*ALL
Display all the qualified change requests.
change-request-name
Specify that only the specified change requests display.
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 (*). Only the change request names matching or beginning with the string displays.

The possible sequence number values are:

*ALL
Display all selected change requests regardless of sequence number.
sequence-number
Specify that only the change requests with a sequence number display.
Top

Status (STATUS)

Specifies the status of the change request to display.

*ALL
Display all qualified change requests regardless of status.
*SBM
Display only the change requests with a status of Submitting.
*ACTIVE
Display only the change requests with a status of Active.
*ENDED
Display the change requests with a status of Ended.
Top

Highest end code (HIGHENDCDE)

Specifies the highest end code or range for which change requests are displayed.

*ANY
Display all change requests regardless of the highest end code.
*FAIL
Display all change requests with the highest end code between 10 and 89.
*SUCCESS
Display all change requests with the highest end code between 0 and 9.
*NOTRUN
Display all change requests with the highest end code between 90 and 99.
highest-end-code
Specify the highest end code for which to display change requests. The valid values are 0 through 99.
Top

Last end code (LASTENDCDE)

Specifies that the last change request end code or range for which change requests are displayed.

*ANY
Displays all change requests regardless of the last end code.
*FAIL
Display all change requests with the last end code between 10 and 89.
*SUCCESS
Display all change requests with the last end code between 0 and 9.
*NOTRUN
Display all change requests with the last end code between 90 and 99.
last-end-code
Specify the last end code for which to display change requests. Valid values range from 0 through 99.
Top

Change request description (CRQD)

Specifies the qualified name of the change request description object.

The possible values are:

*ALL
Search all libraries in the system for the specified change request description.
library-name
Specify that only the library specified in this parameter be searched.

The possible values for change request description names are:

*ALL
Display all change requests regardless of their change request descriptions.
change-request-description
Specify that only change requests based on the specified change request description be displayed.
generic*-change-request-description
Specify a generic change request description name. A generic name is a character string containing one or more characters followed by an asterisk(*). Display only change requests based on the change request description names matching or beginning with the string.
Top

Submitter (SBM)

Specifies the user profile that submitted the change request.

*ALL
Specify that all selected change requests submitted by the user profile name specified are displayed.
user-profile-name
Specify that only the change requests submitted by the user profile name specified display.
Top

Period (PERIOD)

Specifies a period of time for which the change requests are displayed. The following values can be coded in this parameter, which contains two list of two elements each:

The possible starting time values are:

One of following is used to specify the starting time at which or after which the change request must have been submitted. Change requests submitted before the specified time and date are not displayed.

*AVAIL
The change requests that are available for the specified starting date are displayed.
start-time
Specify the starting time for the specified starting date that indicates the change requests to be displayed.

The possible starting date values are:

One of the following is used to specify the starting date on which or after which the change requests must have been submitted. Entries submitted before the specified date are not displayed.

*BEGIN
Change requests are displayed beginning with the date that the first change request was submitted. If *BEGIN is specified, then any time value other than *AVAIL for start-time is ignored.
*CURRENT
The change requests submitted today between the specified starting and ending times are displayed.
start-date
Specify the starting date for which change requests are displayed.

The possible ending time values are:

One of the following is used to specify the ending time before which the change requests must been submitted.

*AVAIL
The change requests that are available for the specified ending date are displayed.
end-time
Specify the ending time for the specified ending date that determines the change requests to be displayed.

The possible ending date values are:

One of the following is used to specify the ending date before which or on which the change requests must have been submitted.

*END
The last day on which change requests have been submitted is the last day for which the change requests are displayed. If *END is specified, then any value other than *AVAIL for ending time is ignored.
*CURRENT
The change requests submitted today between the specified starting and ending times are displayed.
end-date
Specify the ending date for which change requests are displayed.
Top

Problem identifier (PRBID)

Specifies the problem identifier associated with the change requests to be displayed.

*ALL
Specifies that change requests are displayed regardless of the associated problem ID.
problem-identifier
Specify the associated problem ID for which the change request is displayed.
Top

Problem origin (PRBORG)

Specifies the originating system of the problem ID.

The possible network ID values are:

*ALL
Display change requests regardless of the problem origin network ID.
*NETATR
Display change requests with a problem origin network ID that is the same as the network ID in the system network attributes.
network-ID
Specify a problem origin network ID for which change requests are displayed.

The possible control point name values are:

*ALL
Display change requests regardless of the problem origin control point name.
*NETATR
Display change requests with a control point name that is the same as the control point name defined in the system network attributes.
control-point-name
Specify a problem origin control point name for which change requests are displayed.
Top

Output (OUTPUT)

Specifies whether the output from the command shows at the requesting work station, or prints with the job's spooled output.

*
Output requested by an interactive job is shown on the display. Batch job output prints with the job's spooled output.
*PRINT
Prints the output with the job's spooled output.
Top

Examples

Example 1: Displaying All Change Requests by Generic Name

DSPSBMCRQ   (CRQ* *ALL)

This command displays all change requests with names that start with CRQ.

Example 2: Displaying All Change Requests That Failed

DSPSBMCRQ   STATUS(*ENDED)  LASTENDCDE(*FAIL)

This command displays all change requests that ended in a failed state.

Example 3: Displaying Change Requests by a Specific User

DSPSBMCRQ   SBM(JOE)
            PERIOD((*AVAIL 08/31/02) (*AVAIL *CURRENT))

This command displays all change requests submitted by the user profile JOE beginning 31 August 2002 to the current date.

Example 4: Displaying Change Requests for a Specific Change Request Description

DSPSBMCRQ   CRQD(CRQD001)

This command displays all submitted change requests based on the CRQD001 change request description.

Top

Error messages

None

Top