CHECK ACQPROCESS
Check the completion status of a BTS process.
Description
CHECK ACQPROCESS returns the completion status of the currently-acquired BTS process. Typically, it is used to check the success of a previous RUN ACQPROCESS or LINK ACQPROCESS command. It allows the requester to discover whether the process completed successfully, or whether, for example, it needs to be reactivated to complete its processing.
The only process a program can check is the one that it acquires in the current unit of work - see Acquiring processes and activities .
The RESP and RESP2 options on this command reflect whether the command is understood by CICS® - for example, PROCESSERR occurs if the process is not currently acquired by the requester.
The COMPSTATUS option returns a CVDA value that indicates the completion status of the process's root activity - for example, NORMAL is returned if the root activity successfully completes all its processing steps, while INCOMPLETE is returned if it returns from an activation but needs to be reattached to complete its processing.
Options
- ABCODE(data-area)
- This option returns, if the process's root activity terminates abnormally, the 4-character abend code.
- ABPROGRAM(data-area)
- This option returns, if the process's root activity terminates abnormally, the 8-character name of the program that was in control at the time of the abend.
- ACQPROCESS
- This option specifies that the process that is currently acquired by the requester is to be checked.
- COMPSTATUS(cvda)
- This
option indicates the completion status of the process. CVDA values are:
- ABEND
- The program that implements the process's root activity abended. Any children of the root activity are canceled.
- FORCED
- The process was forced to complete—for example, it was canceled with a CANCEL ACQPROCESS command.
- INCOMPLETE
- The process is incomplete. This can mean:
- That it has not yet run
- That it has returned from one or more activations but needs to be reattached to complete all its processing steps
- That it is currently active.
- NORMAL
- The process completed successfully.
- MODE(cvda)
- This option
indicates the processing state of the process. CVDA values are:
- ACTIVE
- An activation of the process is running.
- CANCELLING
- CICS is waiting to cancel the process. A CANCEL ACQPROCESS command is issued, but CICS cannot cancel the process immediately because one or more of the root activity's children are inaccessible.
- COMPLETE
- The process is completed.
- DORMANT
- The process is waiting for an event to fire its next activation.
- INITIAL
- No RUN or LINK command has yet been issued against the process.
- SUSPSTATUS(cvda)
- This
option indicates whether the process is currently suspended. CVDA values are:
- SUSPENDED
- The process is currently suspended. If a reattachment event occurs, it is not reactivated.
- NOTSUSPENDED
- The process is not currently suspended. If a reattachment event occurs, it reactivates.
Conditions
- 16 INVREQ
- RESP2
values:
- 15
- The unit of work that issues the request has not acquired a process.