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 requestor to discover whether the process completed successfully, or whether, for example, it needs to be reactivated in order to complete its processing.
The only process a program can check is the one that it has acquired 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 requestor.
The COMPSTATUS option returns a CVDA value indicating the completion status of the process's root activity - for example, NORMAL is returned if the root activity has successfully completed all its processing steps, while INCOMPLETE is returned if it has returned from an activation but needs to be reattached in order to complete its processing.
Options
- ABCODE(data-area)
- returns, if the process's root activity terminated abnormally, the 4-character abend code.
- ABPROGRAM(data-area)
- returns, if the process's root activity terminated abnormally, the 8-character name of the program that was in control at the time of the abend.
- ACQPROCESS
- specifies that the process that is currently acquired by the requestor is to be checked.
- COMPSTATUS(cvda)
- 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 have been canceled.
- FORCED
- The process was forced to complete—for example, it was canceled with a CANCEL ACQPROCESS command.
- INCOMPLETE
- The process is incomplete. This could mean:
- That it has not yet been run
- That it has returned from one or more activations but needs to be reattached in order to complete all its processing steps
- That it is currently active.
- NORMAL
- The process completed successfully.
- MODE(cvda)
- 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 has been issued, but CICS cannot cancel the process immediately because one or more of the root activity's children are inaccessible.
- COMPLETE
- The process has 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)
- indicates
whether the process is currently suspended. CVDA values are:
- SUSPENDED
- The process is currently suspended. If a reattachment event occurs, it will not be reactivated.
- NOTSUSPENDED
- The process is not currently suspended. If a reattachment event occurs, it will be reactivated.
Conditions
- 16 INVREQ
- RESP2
values:
- 15
- The unit of work that issued the request has not acquired a process.