Manage Policy Actions with CONTROLR Commands

optionally lets you manage the active policy actions with CONTROLR commands. You can either use CONTROLR commands or the CA DCI ISPF interface to perform the primary policy actions such as queue, refresh, activate, overwrite, and display the active policy With CONTROLR commands.  Use the following CONTROLR command format to manage your policy:
dci2val
CA Dynamic Capacity Intelligence
optionally lets you manage the active policy actions with CONTROLR commands. You can either use CONTROLR commands or the CA DCI ISPF interface to perform the primary policy actions such as queue, refresh, activate, overwrite, and display the active policy With CONTROLR commands. Use the following CONTROLR command format to manage your policy:
/f CONTROLR,POLICY,
command-id[,command-parameter]
Based on the command-id, you require command parameter. Following are the policy actions that you can perform with CONTROLR command:
2
2
Queue a Policy
Use
Q
in the following syntax to queue a policy:
/f CONTROLR,POLICY,Q,
policy-id
  • policy-id
    Specifies the policy name. Maximum length is 32 characters.
Refresh a Policy
Use
R
in the following command syntax to reset a policy:
/f CONTROLR,POLICY,R
You do not require any additional parameter for the Reset command.
Stop a Policy
Use
P
in the following command format to stop a policy:
/f CONTROLR,POLICY,P,
policy-id
  • policy-id
    Specifies the name of the policy. The maximum length for policy id is 32 characters.
Activate a Policy for a Defined Duration
Use
AC
in the following command syntax to activate an existing policy:
/f CONTROLR,POLICY,AC,
policy-id
,duration
  • policy-id
    Specifies the name of the policy. The maximum length for policy id is 32 characters. The policy must exist to activate.
  • duration
    Specifies the duration in minutes that is in the range from 1 to 6000.
Overwrite MSU Value for an Entity
Use the command "
O
" to overwrite an MSU value against the current active policy MSU value for the selected entity. The overwritten value for an entity is valid only for the specified time. After the specified time expires, CA DCI considers the active policy MSU values of the entity for capacity adjustments.
/f CONTROLR,POLICY,O,
cpc-id
,
type
,
id
,
msumin
,
msumax
,
duration
  • cpc-id
    Four-character long cpc-id. Valid characters for the cpc-id are A-F, 0-9.
    • If the target id is either type = SYS or type = CG, the cpc-id must be the corresponding cpc-id of the SYS or CG element. The cpc-id must be four characters long. The valid characters include A-F, 0-9.
    • If the target id is type = GRP:
      • In a CPC policy, the cpc-id is the id of the CPC element that GRP is a subnode of.
      • In a CMP policy, the cpc-id is your CMP name that GRP is a subnode of.
  • type
    Specifies the type of the target id. Valid types are GRP (DCI Group), CG (capacity group), or SYS (LPAR).
  • id
    Specifies the ID of the target system.
  • msumin
    specifies the numeric value in the range from 0 to 99999, or no value if you do not want to change the minimum MSU for the element.
  • msumax
    Specifies the numeric value in the range from 0 to 99999, or no value if you do not want to change the maximum MSU for the element.
  • duration
    specifies the duration of time in minutes in the range from 1 to 6000, or 0 to stop an active override.
Display Policy Overview
Use "
L
" in the following format to list the predefined content of a policy with the defined duration:
/f CONTROLR,POLICY,L[,
policy-id
]
  • policy-id
    (Optional) Specifies the name of the policy. The maximum length of policy id is 32 characters. If you omit the policy name or if the policy name does not exist, CA DCI does not display the overview of all defined policies.