Display Submitted CRQ Messages (DSPSBMCRQM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Submitted Change Request Messages (DSPSBMCRQM) command displays or prints a list of messages for one or more submitted change requests.
Restriction:
You can only display messages for change requests you submitted, unless you have *JOBCTL authority. In this case, you can display messages for any change request.
| 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 | ||
| ACTIVITY | Activity name | Name, *ALL, *LAST | Optional |
| CPNAME | Managed system node names | Element list | Optional |
| Element 1: Network identifier | Communications name, *ALL, *NETATR | ||
| Element 2: Control point | Character value, *ALL, *NETATR | ||
| SEV | Severity code | 0-99, 0 | 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 | ||
| OUTPUT | Output | Optional |
| Top |
Change request (CRQ)
Specifies the qualified change request name used to display messages.
The possible change request name values are:
- *ALL
- Displays the messages for all change requests matching the selection criteria of the other parameters.
- change-request-name
- Specify a change request name for which the messages are displayed.
- generic*-change-request-name
- Specify the generic change request name for which messages are displayed. A generic name is a string containing one or more characters followed by an asterisk (*).
The possible sequence number values are:
- *ALL
- Displays messages for the change request specified regardless of the sequence number.
- sequence-number
- Specify a change request sequence number that identifies the change request for which messages are displayed.
| Top |
Activity name (ACTIVITY)
Specifies the name of the activity for which the messages are displayed.
The possible values are:
- *ALL
- Display all change request messages regardless of the activity name.
- *LAST
- Display the message for the last activity that runs. The actual stored name is *LAST.
- activity-name
- Specify a change request activity for which you want to display messages.
| Top |
Managed system node names (CPNAME)
Specifies the APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if a node list is specified.
The possible network identifier values are:
- *ALL
- Messages are displayed regardless of the destination network ID.
- *NETATR
- Only change request activity messages for which the destination network ID is the same as the one defined in the network attributes for this system, are displayed.
- network-identifier
- Specify a network ID. Only change request messages with the destination network ID and with the control point name specified, are displayed.
The possible control point values are:
- *ALL
- Messages display regardless of the destination node control point name.
- *NETATR
- Only change request activity messages for which the destination control point name is the same as the one defined in the system network attributes, are displayed.
- control-point-name
- Specify the APPN control point name of the managed system on which the activity is to be performed. For NetView Distribution Management Agents, the control point name is the change control client which supports numeric characters (0-9) in the first position of control point names that are valid in other platforms.
| Top |
Severity code (SEV)
Specifies the severity level for which messages are displayed.
- 0
- All messages in the message queue specified are shown.
- severity-code
- Specify a value, 0 through 99. Displays messages with a severity code equal to or greater than the value specified.
| Top |
Period (PERIOD)
Specifies a period of time for which the change requests or messages 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 message must have been logged. Change requests logged before the specified time and date are not displayed.
- *AVAIL
- The change requests messages 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 messages must have been logged. Messages logged before the specified date are not displayed.
- *BEGIN
- The change request messages from the beginning of the log are displayed. If *BEGIN is specified, then any time value other than *AVAIL for start-time is ignored.
- *CURRENT
- The change request messages logged today between the specified starting and ending times are displayed.
- start-date
- Specify the starting date for which change request messages are displayed.
The possible ending time values are:
One of the following is used to specify the ending time before which the change request messages must have been logged.
- *AVAIL
- The change request messages 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 request messages 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 request messages must have been logged.
- *END
- The last day on which change request messages have been logged is the last day for which the change request messages are displayed. If *END is specified, then any value other than *AVAIL for ending time is ignored.
- *CURRENT
- The change request messages submitted today between the specified starting and ending times are displayed.
- end-date
- Specify the ending date for which change request messages are displayed.
| Top |
Output (OUTPUT)
Specifies that the output from the command is shown at the work station requested, or prints with the job's spooled output.
- *
- An interactive job's output shows on the display. Batch job output prints with the job's spooled output.
- The output prints with the job's spooled output.
| Top |
Examples
Example 1: Displaying All Messages for a Change Request
DSPSBMCRQM CRQ(CHG0001 000001)
This example shows how to display all messages for change request CHG0001 with sequence number 000001.
Example 2: Displaying All Severity 30 Messages for a Change Request
DSPSBMCRQM CRQ(CHG0001 000001) ACTIVITY(APLYPTF) SEV(30)
This example shows how to display all change request messages for CRQ00001 000001 activity APLYPTF with severity greater than, or equal to 30.
Example 3: Displaying All Messages for a Specified Period
DSPSBMCRQM CRQ(CHGRQS*) CPNAME(*NETATR CHICAGO)
PERIOD((*AVAIL 08/31/06) (*AVAIL *CURRENT ))
This example displays all messages for change requests starting with CHGRQS and that have a destination of CHICAGO. Only the messages logged between 8/31/06 and the current date are displayed.
| Top |
Error messages
None
| Top |