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

Document ID : KB000029409
Last Modified Date : 14/02/2018
Show Technical Document Details

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