Before
a program that runs outside a process can activate an activity in
the process, it uses the ACQUIRE command to acquire
access to the activity.
About this task
Acquiring an activity enables the program to:
- Read and write to the containers for the activity.
- Issue various commands, including RUN and LINK, against the activity.
If the acquired activity is a root activity, the program can issue
the commands against the process.
To gain access to an activity from outside the process
that contains it, you use the ACQUIRE command. An activity that a
program accesses with an ACQUIRE command is known as an acquired
activity.
There are two forms of the ACQUIRE command:
- ACQUIRE ACTIVITYID
- Acquires the specified descendant (non-root) activity.
- ACQUIRE PROCESS
- Acquires the root activity of the specified process.
Note: When
a program defines a process, it is automatically given access to root
activity for the process. This enables the defining program to access
the process containers and root activity containers before running
the process. When a program gains access to a root activity with either a
DEFINE PROCESS or an ACQUIRE PROCESS command, the process is known
as the acquired process.
For definitive information about the ACQUIRE
command, see The ACQUIRE command.