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