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 | 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.
- 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/06) (*AVAIL *CURRENT))
This command displays all change requests submitted by the user profile JOE beginning 31 August 2006 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 |