ADC CLI Commands

cache-global

The following operations can be performed on “cache-global”:

show bind unbind

show cache global

Displays the global bindings for cache policies.

Synopsis

show cache global [-type ]

Arguments

type The bind point to which policy is bound. When you specify the type, detailed information about that bind point appears.

Possible values: REQ_OVERRIDE, REQ_DEFAULT, RES_OVERRIDE, RES_DEFAULT, HTTPQUIC_REQ_OVERRIDE, HTTPQUIC_REQ_DEFAULT, HTTPQUIC_RES_OVERRIDE, HTTPQUIC_RES_DEFAULT

Output

policyName Name of the cache policy.

policy Name of the cache policy.

priority Specifies the priority of the policy.

gotoPriorityExpression Expression specifying the priority of the next policy which will get evaluated if the current policy rule evaluates to TRUE.

invoke Invoke policies bound to a virtual server or a user-defined policy label. After the invoked policies are evaluated, the flow returns to the policy with the next priority. Applicable only to default-syntax policies.

labelType Type of policy label to invoke.

labelName Name of the label to invoke if the current policy rule evaluates to TRUE. (To invoke a label associated with a virtual server, specify the name of the virtual server.)

numpol The number of policies bound to the bindpoint.

flowType flowtype of the bound cache policy.

rule The request/response rule that will trigger the given action.

action The integrated cache action to be applied when the system sees content that matches the rules.

storeInGroup The content group to store the object when the action directive is CACHE.

invalGroups The content group(s) to be invalidated when the action directive is INVAL.

invalObjects The content group(s) whose objects will be invalidated when the action directive is INVAL.

hits Hits.

flags Flags.

precedeDefRules Override the default request/response cacheability rules.

stateflag globalBindType devno count

Example

show cache global

bind cache global

Binds the cache policy to one of the two global bind points (an unnamed policy label invoked at request time and an unnamed policy label invoked at the response time). The flow type of the policy implicitly determines which label it gets bound to. A policy becomes active only when it is bound. A globally bound policy, it is available to all virtual servers on the Citrix ADC. All HTTP traffic is evaluated against the global policy labels. Each label contains an ordered list ordered by policies’ priority values.

Synopsis

bind cache global -priority [-gotoPriorityExpression ] [-type ] [-invoke ( ) ]

Arguments

policy Name of the policy to bind. (A policy must be created before it can be bound.)

priority Priority to assign to the policy. The appliance might disallow some priority values, depending on what you have already configured. For example, a response cache policy cannot have a higher priority than a request cache policy. Priority helps in dictating the order of policy evaluation. Minimum value: 1 Maximum value: 2147483647

gotoPriorityExpression Expression or other value specifying the priority of the next policy to evaluate if the current policy rule evaluates to TRUE. Specify one of the following values:

  • END. Terminate evaluation of this policy bank. This setting is equivalent to omitting the parameter.
  • NEXT. Evaluate the policy with the next higher priority.
  • An expression whose evaluation results in a number. Evaluation of an expression determines the next action as follows:
  • If the expression evaluates to a priority number larger than the highest priority number in the policy bank, the next policy bank is evaluated.
  • If the expression evaluates to the priority of a policy with a lower priority (higher number) within the same policy bank, that policy is evaluated next.
  • If the expression evaluates to the priority of the current policy, the policy with the next-lower priority is evaluated next. Any of the following results trigger an UNDEF condition
  • The expression cannot be evaluated.
  • The expression evaluates to a number that is smaller than the current policy’s priority number

type Bind point to which to bind the policy. Available settings function as follows:

  • REQ_OVERRIDE. Binds the policy to the override request queue.
  • REQ_DEFAULT. Binds the policy to the default request queue.
  • RES_OVERRIDE. Binds the policy to the override response queue.
  • RES_DEFAULT. Binds the policy to the default response queue.
  • HTTPQUIC_REQ_OVERRIDE - Binds the policy to the HTTP_QUIC override request queue.
  • HTTPQUIC_REQ_DEFAULT - Binds the policy to the HTTP_QUIC default request queue.
  • HTTPQUIC_RES_OVERRIDE - Binds the policy to the HTTP_QUIC override response queue.
  • HTTPQUIC_RES_DEFAULT - Binds the policy to the HTTP_QUIC default response queue.

Possible values: REQ_OVERRIDE, REQ_DEFAULT, RES_OVERRIDE, RES_DEFAULT, HTTPQUIC_REQ_OVERRIDE, HTTPQUIC_REQ_DEFAULT, HTTPQUIC_RES_OVERRIDE, HTTPQUIC_RES_DEFAULT

invoke Invoke policies bound to a virtual server or a user-defined policy label. After the invoked policies are evaluated, the flow returns to the policy with the next priority. Applicable only to default-syntax policies.

labelType Type of policy label to invoke.

Possible values: reqvserver, resvserver, policylabel

labelName Name of the label to invoke if the current policy rule evaluates to TRUE. (To invoke a label associated with a virtual server, specify the name of the virtual server.)

unbind cache global

Deactivate the policy by unbinding it from a global bind point.

Synopsis

unbind cache global [-type ] [-priority ]

Arguments

policy Name of the policy to unbind.

type Bind point from which to unbind the policy.

Possible values: REQ_OVERRIDE, REQ_DEFAULT, RES_OVERRIDE, RES_DEFAULT, HTTPQUIC_REQ_OVERRIDE, HTTPQUIC_REQ_DEFAULT, HTTPQUIC_RES_OVERRIDE, HTTPQUIC_RES_DEFAULT

priority Priority of the NOPOLICY to be unbound. Required only you want to unbind a NOPOLICY that might have been bound to this policy label. Minimum value: 1 Maximum value: 2147483647

cache-global