The Hold Submitted Change Request Activity (HLDSBMCRQA) command holds one or more change request activities.

Restrictions:

1. Only activities that have a status of Wait, Scheduled, or Ready can be held.
2. You must be either the submitter of the change request, or have *JOBCTL special authority.

Parameters

Keyword	Description	Choices	Notes
CRQ	Change request	Element list	Required, Positional 1
	Element 1: Name	Name
	Element 2: Sequence number	1-999999
ACTIVITY	Activity name	Name, *ALL, *LAST	Optional
CPNAME	Managed system node name	Element list	Optional
	Element 1: Network identifier	Communications name, *ALL, *NETATR
	Element 2: Control point	Character value, *ALL, *NETATR

Top

Change request (CRQ)

Specifies the change request name and the change request sequence number of the activities held.

The possible change request name value is:

The possible values are:

change-request-name

Specify the change request name of the activities that are held.

The possible sequence number value is:

sequence-number

Specify the change request sequence number of the activities to be held.

Activity name (ACTIVITY)

Specifies the activity to hold.

*ALL

Hold all of the specified change request activities.

*LAST

Hold the activity named *LAST. This is not the last activity added to the change request description object. This is the last activity run after the change request is submitted.

activity-name

Specify the name of the activity to hold.

Managed system node name (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 the node list (NODL) parameter is specified.

The possible network identifier values are:

*ALL

All activities for the specified control point name are held.

*NETATR

Specify that only activities for the network ID matching the one defined in the network attributes for this system are held.

network-identifier

Specify a network ID. Only activities for the network ID and the control point name specified are held.

The control point values are:

*ALL

All activities for the specified network ID are held.

*NETATR

Only activities for the control point name that match the one defined in the network attributes for this system are held.

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.

Examples

HLDSBMCRQA   CRQ(CHG001 456)

This command holds all of the activities for the change request named CHG001 with sequence number 456 for all the nodes.

Error messages

None