INQUIRE ACTIVITYID
Retrieve the attributes of a BTS activity.
Description
INQUIRE ACTIVITYID returns the attributes of a specified BTS activity.
You can use this command to get details of an activity whose identifier has been retrieved during a browse operation.
Options
- ABCODE(data-area)
- returns, if the activity terminated abnormally, the 4-character abend code.
- ABPROGRAM(data-area)
- returns, if the activity terminated abnormally, the 8-character name of the program that was in control at the time of the abend.
- ACTIVITY(data-area)
- returns the 16-character name of the activity being queried.
- ACTIVITYID(data-value)
- specifies the identifier (1–52 characters) of the activity to be queried. (Typically, the activity identifier will have been retrieved by a GETNEXT ACTIVITY command, during an activity browse.)
- COMPSTATUS(cvda)
- indicates
the completion status of the activity. CVDA values are:
- ABEND
- The program that implements the activity abended. Any children of the activity have been canceled.
- FORCED
- The activity was forced to complete—for example, it was canceled with a CANCEL ACTIVITY command.
- INCOMPLETE
- The named activity 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 named activity completed successfully.
- EVENT(data-area)
- returns the 16-character name of the completion event that is sent to the requestor of this activity when the activity completes asynchronously with the requestor.
- MODE(cvda)
- indicates the current state (mode)
of the activity. CVDA values are:
- ACTIVE
- An activation of the activity is running.
- CANCELLING
- CICS® is
waiting to cancel the activity. A CANCEL ACTIVITY command has been
issued, but CICS cannot cancel
the activity immediately because one or more of the activity's children
are inaccessible.
No further operations on the activity are permitted until it has been canceled.
- COMPLETE
- The activity has completed, either successfully or unsuccessfully. The value returned on the COMPSTATUS option tells you how it completed.
- DORMANT
- The activity is waiting for an event to fire its next activation.
- INITIAL
- No RUN or LINK command has yet been issued against the activity; or the activity has been reset by means of a RESET ACTIVITY command.
- PROCESS(data-area)
- returns the 36-character name of the process to which this activity belongs.
- PROCESSTYPE(data-area)
- returns the 8-character name of the process-type to which the process that contains this activity belongs.
- PROGRAM(data-area)
- returns the 8-character name of the program that executes when this activity is run.
- SUSPSTATUS(cvda)
- indicates
whether the activity is currently suspended. CVDA values are:
- SUSPENDED
- The activity is currently suspended. If a reattachment event occurs, it will not be reactivated.
- NOTSUSPENDED
- The activity is not currently suspended. If a reattachment event occurs, it will be reactivated.
- TRANSID(data-area)
- returns the 4-character transaction identifier under which this activity runs.
- USERID(data-area)
- returns the 8-character identifier of the user under whose authority this activity runs.
Conditions
- 109 ACTIVITYERR
- RESP2 values:
- 1
- The activity identifier specified on the ACTIVITYID option does not relate to any activity that is within the scope of this task.
- 19
- The request timed out. It may be that another task using this activity-record has been prevented from ending.
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- 70 NOTAUTH
- RESP2
values:
- 101
- The user associated with the issuing task is not authorized to access this resource in the way requested.