Reference Guide › Command-Line Scripting › Policy Commands › dpmpolicy setruleexeclimit Command--Set Limits for a Rule

dpmpolicy setruleexeclimit Command--Set Limits for a Rule

The dpmpolicy setruleexeclimit command sets a limit that determines how many times your rule retries.

This command has the following format:

dpmpolicy setruleexeclimit [-sc sc_url] -entity_type entitytype -entity_name entityname -rule_name rulename -limit_option option [-limit_value value] [-ws_user username -ws_password password] [-locale iso639value]

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-entity_type={server|service}

Defines whether this rule is associated with a server or service.

-entity_name entityname

Defines the name of the server or service.

-rule_name rulename

Defines the name that you assigned to the rule that you created.

-limit_option=[limited|unlimited|disabled]

Specifies the limit option for the number of times the rule runs. Options are as follows:

limited

Specifies the number of times the rule runs.

unlimited

Specifies that the rule can run an unlimited number of times.

disabled

Specifies that the rule limit option is disabled.

-limit_value value

(Option) Defines the limit value. This option is valid only when you use it with the limit option set to limited.

Limits: 0 and greater

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Set Rule Retries

This example sets the limit to 40 retries for a rule that runs on a service.

dpmpolicy setruleexeclimit -entity_type service -entity_name SERVICE1 -rule_name SERVICE1_RULE -limit_option limited -limit_value 40

Example: Set Rule Retries to Unlimited

This example sets no limit on the number of times the rule can run on a server.

dpmpolicy setruleexeclimit -entity_type server -entity_name machine1.ca.com -rule_name MACHINE1_RULE -limit_option unlimited

Example: Disable the Limit Option

This example disables the limit option for this rule.

dpmpolicy setruleexeclimit -entity_type server -entity_name machine2.ca.com -rule_name MACHINE2_RULE -limit_option disabled