CHECK ACQPROCESS

Check the completion status of a BTS process.

Read syntax diagramSkip visual syntax diagram
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.


dfhp4_checkacqprocess.html | Timestamp icon Last updated: Thursday, 27 June 2019