The End Submitted Change Request Activity (ENDSBMCRQA) command allows you to end one or more change request activities.

Restriction:

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
OPTION	How to end	*CNTRLD, *IMMED, *FRCFAIL	Optional

Top

Change request (CRQ)

Specifies the change request name and the change request sequence number for the activities that are to be ended.

The possible change request name values are:

change-request-name

Specify the change request name of the activities to be ended.

The possible sequence number values are:

sequence-number

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

Activity name (ACTIVITY)

Specifies the activity that is ended.

*ALL

End all activities of the specified change request.

*LAST

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

activity-name

Specify the name of the activity to end.

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

*NETATR

Only network ID activities that match the ones defined in the network attributes for this system are ended.

network-identifier

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

The possible control point values are:

*ALL

All activities for the specified network ID are ended.

*NETATR

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

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.

How to end (OPTION)

Specifies how the activity is ended.

The possible values are:

*CNTRLD

The activity is ended in a controlled manner. Activities that have not started to run are ended. Activities that have already started (Started or Running) only end if they do not leave partial results. The end code returned is 30.

*IMMED

The activity is to be ended as soon as possible even if partial results occur. Activities that have not yet started to run are ended. Activities that have already started (Started or Running) can have their process interrupted which can cause partial results. The end code returned is 35.

*FRCFAIL

The activity is ended immediately. If the activity cannot be ended, it is marked as ended with an end code of 39. Other activities conditioned on this activity are evaluated to determine if they are ready to run.

Examples

ENDSBMCRQA   CRQ(CHG001 456)  ACTIVITY(*ALL)  CPNAME(*ALL)

This command ends all of the activities for the change request named CHG001 with sequence number 456 for all the nodes in a controlled manner.

Error messages

None