CL Command Reference - RCLACTGRP
CL Command List > RCLACTGRP Reference
Description:
The Reclaim Activation Group (RCLACTGRP) command deletes a specified activation group and frees the resources that are scoped to it. It does not reclaim resources scoped to the job or scoped to the default activation group. This command is normally used only in the controlling program of the application.
An activation group is eligible to be reclaimed if it meets the following criteria:
. The activation group is not the default activation group. The default activation group cannot be reclaimed.
. The activation group is not active. An activation group cannot be reclaimed if there are programs or procedures running within the activation group.
. The activation group is not one of the debug activation groups. When the job is in debug mode, the activation groups in use do not appear as active on the Call Stack or Display Activation Group displays.
. The activation group is not a shared activation group. A shared activation group cannot be reclaimed because it may be in use by another job.
When an activation group is reclaimed, all resources within the scope of the activation group are reclaimed. Resources within the scope of the activation group include static storage for programs in the activation group, open files, user interface manager (UIM) application resources, Common Programming Interface (CPI) Communications conversations, hierarchical file systems (HFS) resources, user-defined communications sessions, and pending changes for the commitment definition.
A close option can be specified on this command, and is used when closing mixed, communications, binary synchronous (BSC), and intersystem communications function (ICF) files. If an activation group level commitment definition has been started for the activation group, and it has pending committable changes, the close option also indicates whether the system implicitly commits or rolls back the pending changes before ending the commitment definition. When specifying a close option of *NORMAL, and there are no errors when closing files using the activation group level commitment definition, a commit is performed. Otherwise, a rollback is performed. See the Backup and Recovery book, SC41-5304 book for information on how the system performs the rollback operation under commitment control.
An activation group should only be reclaimed if it will never be needed again within the same job. Otherwise, errors and unpredictable results may occur if other programs later attempt to access the resources that were reclaimed. Therefore, this command should normally only be used in the controlling program of an application. Specifying ACTGRP(*ELIGIBLE) requires full knowledge of the job environment. Otherwise, unpredicable results can occur.
Restrictions:
1. This command is not threadsafe. This command fails in a job that allows multiple threads.
Examples:
RCLACTGRP ACTGRP(MYGROUP)
This command reclaims the activation group MYGROUP.