How do CA Datacom Datadictionary versions work with History status entities?

Products

• Datacom
• DATACOM - AD

Issue/Introduction

When referencing History versions of entities in Datadictionary, there are two ways to do this:

* Refer to the absolute version number (such as 0042, 0041, etc.)
* Refer to the relative version number (such has H000, H001, etc.)

 

The absolute version number will follow an entity from its Production status into History status. For example, if the current Production status entity is version 15, when a new Test version is copied to Production, the Test status entity is now version 16, and the former Production status entity (15) is changed to History status. Then, as a new Test version is copied to Production, the new entity becomes version 17, the previous Production status entity (16) is changed to History status, and the prior version (15) stays in History status.

Any of these Production or History status entities can be referenced by using the absolute version number – 15, 16 or 17. However, it might be easier to reference the most-current History status entity, or the first previous entity. This reference is similar to using Generation Data Sets, where the most current relative version is 0 (zero), and each previous version is -1, -2, etc., except that in Datadictionary, the minus sign is not used. Therefore, the most current version is denoted as H000, the next previous is H001, then the next previous is H002, etc.

 

This might be better seen in the following chart, showing a new database entity being created and modified. Note the absolute and relative identifiers used within Datadictionary. In each action, you can see the various versions available, and how to reference them.

 

 

 

Action	Stat/Ver	ABSOLUTE	RELATIVE	Notes
1 – Create a new Test version database	T / 001	T001 or 1001		Database created
2 – Copy version T001 to Prod (and delete T001)	P / 0001	0001	PROD	T001 version copied to Prod
3 – Create another Test version	T / 001	T001 or 1001		New Test version
	P / 0001	0001	PROD	Current Prod version
4 – Copy this version T001 to Prod (and delete T001)	P / 0002	0002	PROD	T001 version copied to Prod
	H / 0001	0001	H000	Most current History version
5 – Create Test version 450	T / 450	T450 or 1450		New Test version
	P / 0002	0002	PROD	Current Prod version
	H / 0001	0001	H000	Most current History version
6 – Copy version T450 to Prod (and delete T450)	P / 0003	0003	PROD	T450 version copied to Prod
	H / 0002	0002	H000	Most current History version
	H / 0001	0001	H001	Previous History version

Environment

Release: DATABB00200-14-Datacom/AD
Component: