Work with Received CRQ Act (WRKRCVCRQA)

The Work with Received Change Request Activities (WRKRCVCRQA) command enables the user of a managed system to work with a list of activities received by the system. The user can hold, release or end an activity not being processed, end an activity currently being processed, or display the information available for a specific activity.

When a request is sent to locally-attached change control clients, a single SNA distribution list is associated with those clients. The SNA list contains the change control client destinations.

The iSeries system receiving the change control client requests actually transfers and does not process the requests sent to the change control server agent. The agent processes the activities. You may be able to see the change control client distributions but you cannot control (Hold, End, Release) them.

Restrictions:

In order to hold, end, or release an activity, the user profile processing the command must have *JOBCTL authority or be the same as the user profile under which the activity is running.
This command is only applicable to an activity received from another system.
The Hold, End, and Release options work only for distributions received for the local managed system agent. They do not work for distributions received for change control clients.

Parameters

Keyword	Description	Choices	Notes
ORIGIN	Origin	Values (up to 5 repetitions): Element list	Optional
	Element 1: Network identifier	Communications name, ALL, NETATR
	Element 2: Control point name	Communications name, ALL, NETATR
STATUS	Status	Single values: ALL Other values (up to 5 repetitions): ENDED, HELD, READY, RUN, SCHED	Optional
RCVTIME	Received time	Element list	Optional
	Element 1:	Element list
	Element 1: Start time	Time, *AVAIL
	Element 2: Start date	Date, BEGIN, CURRENT
	Element 2:	Element list
	Element 1: End time	Time, *AVAIL
	Element 2: End date	Date, END, CURRENT

Top

Origin (ORIGIN)

Specifies the network ID and control point name of the central site system. Only activities received from this system are displayed.

You can enter multiple values for this parameter.

The possible network ID values are:

*ALL: The user can work with the activities received from any network with the specified control point name.
*NETATR: The central site system is in the local APPN network.
network-id: Specify the APPN network name of the central site system from which the activity was sent.

The possible control point name values are:

*ALL: The user can work with the activities received from any node in the specified network.
*NETATR: The central site system is in the local control point name.
control-point-name: Specify the name of the APPN control point of the central site system from which the activity was sent.

Status (STATUS)

Specifies the current status of activities to be displayed.

You can enter multiple values for this parameter.

*ALL: The user can work with any activities received from the specified central site.
*ENDED: The user can work with completed (ended) activities.
*HELD: The user can work with held activities.
*READY: The user can work with received activities that are ready and waiting to be processed.
*RUN: The user can work with activities that are currently being processed.
*SCHED: The user can work with scheduled activities.

Received time (RCVTIME)

Specifies the time period an activity is received. Only activities received during this time period are displayed.

The possible start time values are:

*AVAIL: The time period begins with the first available activity received for the specified date.
start-time: Specify the time after which activities received for the specified date are included in the list.

The possible start date values are:

*BEGIN: The time period begins with the first available activity received.
*CURRENT: The time period begins with activities received on or after today.
start-date: Specify the date on which the time period is to begin for activities received.

The possible end time values are:

*AVAIL: The time period is ended with the last activity received for the specified date.
end-time: Specify the time before which activities received are included in the list.

The possible end date values are:

*END: The time period ends with the last activity received.
*CURRENT: The time period ends with activities received on or before today.
end-date: Specify the date for which activities received on or before are included in the list.

Examples

Example 1: Working with all Activities Received

WRKRCVCRQA

This command allows you to work with all activities received from any system.

Example 2: Working with Held Activities

WRKRCVCRQA   ORIGIN((RPC *ALL))  STATUS(*HLD)

This command allows you to work with any activities that were received from a central site system in the RPC network and are currently being held.

Example 3: Working with Scheduled Activities

WRKRCVCRQA   ORIGIN((RPC CPNAME))  STATUS(*SCHED)
             RCVTIME((*AVAIL *CURRENT) (*AVAIL *CURRENT))

This command allows you to work with activities that were received any time today from the central site system with a control point name of CPNAME in network RPC that have been scheduled to run at a later date or time.

Error messages

*ESCAPE Messages

CPF9871: Error occurred while processing.
MSS0013: Error occurred while performing request.
MSS0055: End time and date earlier than start time and date.
MSS0059: Internal object not found or damaged.
MSS005B: Storage limit exceeded.
MSS0066: Internal processing error occurred.
MSS0067: Not able to allocate internal object.