Retrieve the attributes of a BTS activity.
INQUIRE ACTIVITYID
>>-INQUIRE--ACTIVITYID(data-value)--+-------------------+------->
'-ABCODE(data-area)-'
>--+----------------------+--+---------------------+------------>
'-ABPROGRAM(data-area)-' '-ACTIVITY(data-area)-'
>--+------------------+--+------------------+--+------------+--->
'-COMPSTATUS(cvda)-' '-EVENT(data-area)-' '-MODE(cvda)-'
>--+--------------------+--+------------------------+----------->
'-PROCESS(data-area)-' '-PROCESSTYPE(data-area)-'
>--+--------------------+--+------------------+----------------->
'-PROGRAM(data-area)-' '-SUSPSTATUS(cvda)-'
>--+--------------------+--+-------------------+---------------><
'-TRANSID(data-area)-' '-USERID(data-area)-'
Conditions: ACTIVITYERR, NOTAUTH
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.