Administering IBM z/OS Connect policies

Use IBM z/OS Connect policies to adjust how an API request is processed in IBM z/OS Connect, based on the HTTP header values sent in by the client.

There are two types of policy, but only one policy is applied to an API.
  1. Specific policies are applied only to selected API requests. You can define only one specific policy per API. Specific policies are defined in the zosConnectAPI element.
  2. Global policies are applied to requests for all APIs with no specific policy defined. Global policies are defined in the zosconnect_zosConnectAPIs element.
Note:
  1. The terms specific and global refer to the way the policy is used, not the way it is defined.
  2. A specific policy can be applied only to requests for an API that is configured in server.xml.
  3. If a specific policy fails to load, then no policy is applied to requests for that API.

You create rule sets to define the condition and actions, then enable IBM z/OS Connect policies to apply those actions to API requests. A rule set contains one or more rules that define the condition and actions.

Diagram showing how a policy uses a rule set to modify the header of an API request.

For a list of the properties that you can modify, see Valid properties for use in policy rules.