Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Session Methods › CreateGlobalRule Method—Creates Global Rule

CreateGlobalRule Method—Creates Global Rule

The CreateGlobalRule method creates a rule that has a global scope.

Syntax

The CreateGlobalRule method has the following format:

Netegrity::PolicyMgtSession‑>CreateGlobalRule(ruleName, resource, event, agent[, ruleDesc][, allowAccess][, regexMatch][, activeExpr][, isEnabled])

Parameters

The CreateGlobalRule method accepts the following parameters:

ruleName (string)

Specifies the global rule's name.

resource (string)

Specifies the filter for the resource that the global rule is protecting.

event (string)

Specifies the type of event that the global rule is executing.

agent (PolicyMgtAgent | PolicyMgtGroup)

Specifies the agent or agent group associated with the global rule.

ruleDesc (string)

(Optional) Specifies the global rule's description.

allowAccess (int)

(Optional) Specifies whether to allow or deny access to the resource protected by the rule:

• value = 1 (default)

  Specifies allowing access.

• value = 0

  Specifies denying access.

  regexMatch (int)

(Optional) Specifies whether to perform regular expression pattern matching:

• value = 1

  Specifies performing regular expression pattern matching.

• value = 0 (default)

  Specifies not performing regular expression pattern matching.

  activeExpr (string)

(Optional) Specifies the global rule's active expression.

isEnabled (int)

(Optional) Specifies whether to enable or disable the global rule:

• value = 1 (default)

  Specifies that the global rule is enabled.

• value = 0

  Specifies that the global rule is disabled.

Return Value

The CreateGlobalRule method returns one of the following values:

• PolicyMgtRule (object)
• undef if the call is unsuccessful