DSPSBMCRQ (Display Submitted Change Requests)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

DSPSBMCRQ Command syntax diagram

 

Purpose

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 are shown. If you have *JOBCTL special authority, all selected change requests are shown.

CRQ

Element 1: Change Request Name
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.

Element 2: Sequence Number

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.

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.

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.

LASTENDCDE

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

*ANY: Display 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. The valid values are 0 through 99.

CRQD

Specifies the qualified name of the change request description object.

The possible library 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.

SBM

Specifies the user profile that submitted the change request.

*ALL: Display all selected change requests regardless of submitter.

user-profile-name: Specify that only the change requests by the user profile name are displayed.

PERIOD

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

Element 1: Starting Time

One of the 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 request to be displayed.

Element 2: Starting Date

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 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.

Element 3: Ending Time

One of the following is used to specify the ending time before which the change requests must be 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.

Element 4: Ending Date

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.

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.

PRBORG

Specifies the originating system of the problem ID.

Element 1: Network Identifier

*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-Identifier: Specify a problem origin network ID for which change requests are displayed.

Element 2: Control Point Name

*ALL: Display change requests regardless of the problem origin control point name of this system.

*NETATR: Display the change requests with the 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.

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. Output requested by a batch job is printed with the job's spooled output.

*PRINT: Prints the output with the job's spooled output.

Examples for DSPSBMCRQ

Example 1: Displaying All Change Requests

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.

Error messages for DSPSBMCRQ

*ESCAPE Messages

None