Policy schema versions

Policy schema versions are used to provide the greatest compatibility with your systems.

The policy schema version is identified by a version and release number shown in the schema; for example a policy schema version of 1.0 is expressed in the schema as:

policySchemaRelease="0" policySchemaVersion="1"

If a CICS® release includes a new policy schema, the schema version number is incremented at that release. If the IBM® service organization introduces a new policy schema, the schema release number is incremented.

Important: For CICS TS Version 5.2, when the PTF for APAR PI34509 is applied to CICS TS Version 5.2, the policy schema version 2.0 is available and you can deploy a policy with policy rules that require a policy schema version 2.0 or earlier.

For CICS TS Version 5.1, or CICS TS Version 5.2 without the PTF for APAR PI34509 applied, you can deploy a policy with only policy rules that require policy schema version 1.0.

When you use an editor with a policy file in XML format to add or remove rules, be aware that this might affect the required policy schema version. You must ensure that the schema version expressed in the <policy:policy tag is at the lowest level that supports all the policy rules.

The following table shows the minimum policy schema version for each policy condition, ordered by policy rule type and item.

Table 1. Policy conditions and minimum policy schema version
Policy rule type	Item	Policy schema version	CICS version
Database request	SQL command	1.0	5.1
File request	Delete command Read command Read next command Read previous command Read update command Rewrite command Start browse command Write command	1.0	5.1
Program request	LINK command	1.0	5.1
Start request	START command	2.0	5.2
Storage	24-bit Shared storage 24-bit Task storage 31-bit Shared storage 31-bit Task storage 64-bit Shared storage 64-bit Task storage	1.0	5.1
Storage request	24-bit Shared storage request 24-bit Task storage request 31-bit Shared storage request 31-bit Task storage request 64-bit Shared storage request 64-bit Task storage request	1.0	5.1
Syncpoint request	SYNCPOINT command	2.0	5.2
TD Queue request	READQ TD command WRITEQ TD command	2.0	5.2
Time	CPU time	1.0	5.1
Time	Elapsed time	2.0	5.2
TS Queue bytes	WRITEQ TS auxiliary command WRITEQ TS command WRITEQ TS main command	2.0	5.2
TS Queue request	READQ TS command WRITEQ TS auxiliary command WRITEQ TS command WRITEQ TS main command	2.0	5.2

The following table shows the minimum policy schema version for each policy condition, ordered by policy schema version.

Table 2. Policy conditions and minimum policy schema version
Policy schema version	Policy rule type	Item	CICS version
1.0	Database request	SQL command	5.1
1.0	File request	Delete command Read command Read next command Read previous command Read update command Rewrite command Start browse command Write command	5.1
1.0	Program request	LINK command	5.1
1.0	Storage	24-bit Shared storage 24-bit Task storage 31-bit Shared storage 31-bit Task storage 64-bit Shared storage 64-bit Task storage	5.1
1.0	Storage request	24-bit Shared storage request 24-bit Task storage request 31-bit Shared storage request 31-bit Task storage request 64-bit Shared storage request 64-bit Task storage request	5.1
1.0	Time	CPU time	5.1
2.0	Start request	START command	5.2
2.0	Syncpoint request	SYNCPOINT command	5.2
2.0	TD Queue request	READQ TD command WRITEQ TD command	5.2
2.0	Time	Elapsed time	5.2
2.0	TS Queue bytes	WRITEQ TS auxiliary command WRITEQ TS command WRITEQ TS main command	5.2
2.0	TS Queue request	READQ TS command WRITEQ TS auxiliary command WRITEQ TS command WRITEQ TS main command	5.2