Previous Topic: Manage Resources OperatorNext Topic: Output Parameters


Input Parameters

Action

Lists the actions to execute. The Add, Delete, and Edit buttons add, remove, or modify actions in this list. Each action specifies:

Action Properties

This dialog defines an action to perform on a resource. Click either the Add or the Edit button next to the Action list box. This dialog opens the resources properties for a Resources operator.

ResourcePath

Specifies a resources object. Enter the full path to the resource in the CA Process Automation library or click Browse icon to locate the object. Double quotation marks must enclose a literal string. You can use a dataset variable or an expression to specify the resources object. To open the object in the resources editor, click the Open button.

ResourceName

Specifies the resource in the resources object on which to perform the action. Type the name exactly as it is defined in the resources object. Double quotation marks must enclose a literal string. You can use a dataset variable or an expression to specify the resource.

Action

Select the action to perform on the resource:

TakeUnits

Takes the number of resource units specified in the Amount field.

FreeUnits

Returns the number of resource units specified in the Amount field.

LockResource

Locks the resource so other Resources operators cannot take resource units or cannot lock the resource. This action effectively takes all unused resource units for a resource. Actions can still free resource units that were taken before a resource was locked. However, the freed units are only available when the resource is unlocked.

UnlockResource

Unlocks a locked resource.

Amount

For the TakeUnits or FreeUnits actions, this value specifies the number of resource units to take or free. Amount is disabled for the rest of the two options, such as UnlockResource and LockResource.

All resources must be available

If selected, all of the resources that are required by the actions that are listed under Actions must become available within the constraints that the Timeout options impose. The operator succeeds only if all of the resources become available within the time-out constraints of the Timeout setting.

If unchecked, the operator completes successfully when the resources that are required by at least one of the actions that are listed under Actions becomes available within the constraints of the Timeout option. If resources for any of the listed actions are available, the Process Control operator category processes the Successful exit link for this operator.

Execute actions

Determines whether the actions listed under Actions are executed. To only verify whether resources are available without executing actions, clear this check box. The operator then executes the Successful exit link. This link only executes if resources are available within the constraints of the "Timeout" and "All resources must be available" settings without executing any action.

This setting can be used with a resource that is set to enable or disable a whole set of processes. Those processes verify that there is no lock on the resource before starting their tasks. This lock check is done by attempting to take a single resource unit from the resource. Depending on the outcome of the test, some other mechanism can lock or unlock the resource, such as: