Work with Received CRQ Act (WRKRCVCRQA)
| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
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 i5/OS 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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |