Display Submitted CRQ Messages (DSPSBMCRQM)

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

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.

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.

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/02) (*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/02 and the current date are displayed.