Process- and activity-related commands

This section describes the CICS® business transaction services commands that relate to processes and activities.

Creating, activating, and terminating processes and activities

Use these commands to create processes and activities:

DEFINE PROCESS
Creates a new process.
DEFINE ACTIVITY
Creates a new child activity.

Use these commands to activate a process or activity:

RUN
Invokes a program that implements a process or activity. Runs it synchronously or asynchronously with the requestor, in a separate unit of work, and with the transaction attributes specified on the DEFINE PROCESS or DEFINE ACTIVITY command.
LINK ACTIVITY
Invokes a program that implements an activity. Runs it synchronously with the requestor, in the same unit of work, and with the same transaction attributes as the requestor.
LINK ACQPROCESS
Invokes the program that implements the process that is currently acquired by the requestor. Runs the program synchronously with the requestor, in the same unit of work, and with the same transaction attributes as the requestor.

Use these commands to return a process or activity to its initial state:

RESET ACQPROCESS
Resets the currently-acquired process to its initial state--used before retrying the process.
RESET ACTIVITY
Resets an activity to its initial state--used before retrying an activity.

Use these commands to control the progress of a process or activity:

SUSPEND (BTS)
Prevents a process or activity being reattached if events in its event pool fire.
RESUME
Allows a suspended process or activity to be reattached if events in its event pool fire.

Use these commands to terminate an activity:

RETURN ENDACTIVITY
Indicates that a process or activity is complete.
CANCEL (BTS)
Forces a process or activity to complete.

Use this command to destroy an activity:

DELETE ACTIVITY
Removes a child activity from the BTS repository data set where it is defined.

Retrieving information about activities

Use this command to discover the activity the current unit of work is acting for:

ASSIGN
Returns information about the activity the current unit of work is acting for.

Use these commands to check the response from a process or activity:

CHECK ACQPROCESS
Returns the completion status of the process that is currently acquired by the requestor.
CHECK ACTIVITY
Returns the completion status of an activity.

See also Browsing and inquiry commands.

Relating UOWs and activities

Use this command to give a unit of work access to an activity:

ACQUIRE
Allows a unit of work executing outside a BTS process to gain access to an activity within the process.

Related concepts
Container commands
Event-related commands
Browsing and inquiry commands
System events
Using the BTS API to write business applications
The Sale example application
Related reference
BTS application programming commands
[[ Contents Previous Page | Next Page Index ]]