WRKRCVCRQA (Work with Received Change Request Activities) Command Description

Note: To use this command, have the 5722-MG1 (Managed System Services for iSeries) licensed program installed.

WRKRCVCRQA Command syntax diagram

 

Purpose

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. This command applies to a managed system or a central site system operating as a managed system.

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 server 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, or release) them.

 

Restrictions

1. 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.
2. This command is only applicable to an activity received from another system.
3. 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.

 

Optional Parameters

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.

Element 1: Network ID

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

Element 2: Control Point Name

*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

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.

RCVTIME

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

Element 1: Start Time

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

Element 2: Start Date

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

Element 3: End Time

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

Element 4: End Date

*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 for WRKRCVCRQA

Example 1: Working with all Activities Received

WRKRCVCRQA

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

Example 2: Working with Held Activities

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

This command allows a user 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 a user 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 for WRKRCVCRQA

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