Check the completion status of a BTS process.

CHECK ACQPROCESS
>>-CHECK -ACQPROCESS--COMPSTATUS(cvda)--+-------------------+--->
'-ABCODE(data-area)-'
>--+----------------------+--+------------+--------------------->
'-ABPROGRAM(data-area)-' '-MODE(cvda)-'
>--+------------------+----------------------------------------><
'-SUSPSTATUS(cvda)-'
Conditions: INVREQ
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 the CICS® Business Transaction Services manual.
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
- INVREQ
- RESP2 values:
- 15
- The unit of work that issued the request has not acquired a process.