1

CMETA: META DATA

User Manual Version: October 2004

Table of Contents TABLE OF CONTENTS VERSIONS OF DATA MODELS STARTING UP FUNCTION KEYS PRINTING SELECTION SCREEN 01 OVERVIEW DOMAINS 02 OVERVIEW DATA GROUPS DETAIL VERSION DESCRIPTION 03 OVERVIEW TABLES DETAILED TABLE DESCRIPTION OVERVIEW COLUMNS OF TABLE 04 OVERVIEW COLUMNS DETAILED COLUMN DESCRIPTION OVERVIEW COLUMN VALUES 05 OVERVIEW (SUB)SYSTEMS OVERVIEW MANAGERS 06 OVERVIEW USE CODE NAMES

2 4 5 5 6 7 8 9 11 13 16 18 20 23 25 26 28 30

Introduction

Concept The application CMETA is a consulting application to describe the contents of, possibly various versions of, DB2/Oracle tables and who is responsible for them. Comment Consulting application: The description of the contents in the META system originates from the design tools of data management. The management of the documentation regarding DB2/Oracle tables occurs in the design tools (formerly Cayenne and now more and more Mega) The documentation is loaded in the application META data. Within the application it is possible to consult the documentation online and to print it. Description of the contents: Technical information cannot be found unless it is generally useful for making a program. This includes: primary key information, foreign key information, indexes, and characteristics of columns. Various versions: The META system shows for which DB2 month extracts historical situations are archived. At the level of data groups, the changes between the various versions can be called up. DB2/Oracle tables: Documentation about non-DB2/Oracle data groups cannot be found in the system META data. In respect of the C-platform, this documentation can be found in SDADF for IMS databases and SPITAB tables. Target group The META data system provides information that is required in the framework of the work of ICT staff and end users who set up applications in respect of DB2/Oracle tables. Application manager Hans Vandevelde (016/86.20.41)

Versions of data models Introduction Extract tables are sometimes kept for several years. In the course of time, modifications may be made to these tables, due to which various versions come about. After x number of modifications, it must still be possible to consult the description of all versions. This is necessary to always unambiguously retrieve the meaning of the data used in the applications. Concept Within data modelling and META, version management occurs at the level of data group and type. Due to a modification within a data group, the version number of all the other tables within the data group changes. A modification of a data group can be: - the addition or removal of 1 or several tables - the addition or removal of 1 or several columns of 1 or several tables - the basic modification of the description of 1 or several columns of 1 or several tables - the addition/removal/modification of primary keys, foreign keys and indexes Example Within the data group XYZ, there are the month extract tables CEVXYZ01, CEVXYZ02 and CEVXYZ03. Initially all the tables have version number 01 and these are found in stage P (production). Table CEVXYZ02 receives an additional column. The 02 version of the tables goes through the stages T (test), K (accept) and finally P (production). The 01 version of the tables CEVXYZ01, CEVXYZ02 and CEVXYZ03 becomes history information the moment that version 02 enters production.

Starting up The application is started up by entering the command Cmeta in TSO. One time you must set a number of identification data as user: - for ICT: under TSO procedure U..4 - for end users: under TSO procedure 20 Execute point 1 first to retrieve information from your RACF profile. Execute then point 2 to temporarily change language code, company number, building and location. Execute then point 3 to permanently change building and entity.

Function keys Below you will find the main function keys: F key F2 F3 F7 F8 F9 F10 Result split screen to previous screen browse backward browse forward Swap after a split screen Print overview or description see Printing

Printing Introduction From all the screens (except for the selection screen) it is possible to print the displayed overview/description via F10. Screen

Parameters Standards: PRINTER PRINT NR COPIES RECTO/VERSO HOLD NIGHT CLASS VNS NUMBER = = = = = = = 2 the number of your local printer 1 N N N before 15.00 hrs, Y after 15.00 hrs the number of the desired company

When starting up META, these values are each time displayed again. Within 1 session of META, the earlier entered values are saved. Result Due to technical reasons, the layout of the output may differ from the layout on the screen. As regards the contents, however, the same information is always displayed.

Selection screen Introduction This is the first screen of the TSO application META. Via this screen it is possible to select the various procedures by entering the corresponding procedure number. Screen

OVERVIEW DOMAINS OVERVIEW DATA GROUPS OVERVIEW TABLES OVERVIEW COLUMNS OVERVIEW (SUB)SYSTEMS OVERVIEW USE OF CODE NAMES

Progress PROC 01 02 03 04 05 06 result The screen Overview domains is selected. The screen Overview data groups is selected. The screen Overview tables is selected. The screen Overview columns is selected. The screen Overview (sub)systems is selected. The screen Overview use of code names is selected.

01 Overview domains Introduction This screen gives an overview of all the existing domains upon each consultation. Screen

Progress (GS) G result the data groups of the selected domain are displayed, see Overview data groups. the systems and subsystems of the selected domain are displayed, see Overview (sub)systems.

02 Overview data groups Introduction This screen gives an overview of data groups depending on the specified search data. For searching via descriptions, you must use the 3270 application GEG-UPD. Screen

Search data field

DOMAIN DATA GROUP INF. FAM. CODE

possible values see Overview domains or blank data group or blank information family code (= predecessor of data group) or blank

10

Result If Overview data groups is requested from the screen Overview domains, all data groups of the selected domain are displayed. When search data are entered by yourself, the data groups are displayed that satisfy all the filled in search data. If no search data whatsoever has been filled in, all the data groups are displayed. For each data group the following data are displayed: - code and description of the data group - code of the subsystem that is linked to the data group - date from which semester history extracts are created - date from which month history extracts are created - possibly information family code of the concerned data group - code and description of the domain to which the data group belongs Progress (BTV) B result An overview is displayed of the managers for the subsystem of the selected data group, see Overview managers An overview is displayed of all the tables of the selected data group, see Overview tables. The most recent modifications of the selected data group are displayed, see Detail version description.

Function keys F key F11 result Printing of the overview data groups with the addition of the managers. see Printing.

11

Detail version description Introduction This screen displays the modifications of a specific version for a specific data group and type. Screen

Search data field

TYPE

possible values B = operational tables D = day extract tables E = month extract tables I = ICT tables P = local tables W = data warehouse tables see Overview data groups 01 --> 99 to call up a lower version or blank, in which case the most recent version is displayed

DATA GROUP VERSION

12

Standards:

TYPE = E for end users, B for ICT VERSION = most recent version

TYPE and DATA GROUP must always be filled in. Result Version management is automatically built up with the modifications of the data group selected on the screen Overview data group. By filling in the search data yourself, it is possible to call up the modifications of whichever version of a data group. The part above the dotted line shows the general data in respect of the data group: name, version number, domain to which the table belongs and historical data. The part under the dotted line shows a short description of the modifications of the data group. Function keys F key F11 result Printing of all versions of the selected data group. See Printing.

13

03 Overview tables Introduction This screen gives an overview of tables on the basis of various search data. Screen

Search data field

DATA GROUP TYPE

possible values see Overview data groups or blank B = operational tables D = day extract tables E = month extract tables I = ICT tables P = local tables W = data warehouse tables blank = all tables N = Dutch E = English blank = all languages

LANGUAGE

14

DBMS

D = DB2 O = Orcale P = DB2/2 blank = all DBMSs A = standard of A platform C = standard of C platform D = standard of D platform X = unknown standard blank = all standards B = production, acceptance and test P = production K = acceptance T = test blank = all stages (including history) Part of the description of a table. It is possible to use the signs _ and% in the specified description. Valid date: DD/MM/YYYY

STAND.

STAGE

DESCR.

DATE

Standards:

TYPE LANGUAGE DBMS STAND. STAGE DESCR. DATE

= = = = = = =

E for end users, B for ICT N (Dutch) D (DB2) C (C platform) B (production, acceptance and test) % system date

Main checks:

DATE is always mandatory.

15

Result If Overview tables are called up from the screen Overview data groups, all the tables of the selected data group are displayed. When the search data are entered by you, all the tables are displayed that satisfy all the filled in search data. For each table the following data are displayed: - name and description of the table - code and description of the data group - stage of the table - date on which the table arrived in the specified stage - version number of the data model

Progress (S) S result The detailed description of the selected table is displayed, see Detailed description table. The overview of all the columns of the selected table are displayed, see Overview columns of table. Printing of the concerned table description including all the column descriptions, see Printing.

Function keys F key F11 result Printing of the complete table description for all tables of a data group, see Printing.

16

Detailed table description Introduction This screen displays the complete description of a table. Screen

Search data field

VERSION

possible values 01 --> 99 to call up a lower version or blank, in which case the most recent version is displayed

17

Result Table description is automatically built up with the description of the table selected on the screen Overview tables. By filling in a version number yourself, it is possible to call up a lower version of the same table. The part above the dotted line shows the general data of the table: - type, data group and version - table name and table description - the description of the domain - possibly the SDADF member name, the language, the DBMS and the standard - dates of the various environments The part under the dotted line shows: - a short description of the table - information about the primary key - information about the foreign keys - information about the indexes

18

Overview columns of table Introduction This screen gives an overview of the columns of one specific table. Screen

Search data field

VERSION

possible values 01 --> 99 to call up a lower version or blank, in which case the most recent version is displayed

19

Result If Overview columns of table is called up from the screen Overview tables, then all columns of the selected table are displayed. By filling in a version number yourself, it is possible to call up a lower version of the same table. For each column the following data are displayed: - name and description - characteristics (type, length, nulls allowed) N = not null: a value must always be filled in in this column. D = not null with default: if no value is filled in, this column receives a default value. A = nulls allowed: if no value is filled in, this column receives the value NULLS. Progress (S) S result The detailed description of the selected column is displayed, see Detailed column description.

20

04 Overview columns Introduction This screen gives an overview of columns on the basis of various search data. Screen

21

Search data field

COLUMN

possible values (Part of) the COBOL (with -) or DB2 name (with _) or blank. It is possible to use the signs _ and% in the specified column name. By default a% is placed at the beginning of the field. If it is not removed, all the columns will be displayed in which the specified value occurs anywhere in the column name. If the% is left out, all the columns are displayed in which the specified value occurs at the first positions in the column name. To search columns that end in a specific suffix, you must add a blank after the last indicating letter, e.g. all the columns that have a code suffix are found by specifying %KD(blank)%.

DESCR.

(Part of) the description of a column. It is possible to use the signs _ and% in the specified description. see Overview data groups or blank B = operational tables D = day extract tables E = month extract tables I = ICT tables P = local tables W = data warehouse tables blank = all tables N = Dutch E = English blank = all languages D = DB2 O = Orcale P = DB2/2 blank = all DBMSs A = standard of A platform C = standard of C platform D = standard of D platform X = unknown standard blank = all standards B = production, acceptance and test P = production K = acceptance T = test blank = all stages (including history)

DATA GROUP TYPE

LANGUAGE

DBMS

STAND.

STAGE

22

Standards:

COLUMN DESCR. TYPE LANGUAGE DBMS STAND. STAGE

= = = = = = =

% % E for end users, B for ICT N (Dutch) D (DB2) C (C platform) B (production, acceptance and test)

Result The displayed columns satisfy all the filled in search data. For each column the following data are displayed: name and description characteristics (type, length, nulls allowed), table to which the column belongs, stage and version of the table (also of the column therefore). Progress (S) S result The detailed description of the selected column is displayed, see Detailed column description. An overview is displayed of all the columns of the table of which the selected column is part, see Overview columns of table.

Function keys F key F11 result print detail of all the columns of the overview

23

Detailed column description Introduction This screen displays the complete description of a column. Screen

Search data field

COLUMN

possible values Here you can enter the complete name of another column from the same table. 01 --> 99 to call up a lower version or blank, in which case the most recent version is displayed

VERSION

24

Result Column description is automatically built up with the description of the column selected on the screen Overview columns or Overview columns of table. By filling in the search data yourself, it is possible to call up the description of whichever column. The part above the dotted line shows general data of the column: name and description of the column, type, data group and version name and description of the table characteristics (type, length, nulls allowed), name of the SDADF member who may also describe the column the dates on which this data arrived in test, accept, production or history. The part below the dotted line shows a short description of the column, characteristics, codes... Function keys F key F12 result All the column values of the selected column are displayed. To this end a dynamic call of the Code system occurs, see also Overview column values.

25

Overview column values Introduction This screen displays all the allowed values of a specific column for a specific company. Screen

Search data field

CODE NAME COMPANY

possible values the name uniquely identifying a code. the number of the company for which the code values are called up

Result Overview column values is automatically built up based on the code name that has been assigned to a column. The code at the end of the overview indicates whether or not the code value is currently active (Y/N). By filling in the search data yourself, it is possible to call up all the column values from any code for whichever company.

26

05 Overview (sub)systems Introduction This screen gives an overview of (sub)systems depending on specified search data. To search via descriptions you must use the 3270 application GEG-UPD. Screen

Search data field

DOMAIN SYSTEM SUBSYSTEM

possible values see Overview domains or blank system code or blank subsystem code or blank

27

Result If Overview (sub)systems is called up from the screen Overview domains, all the subsystems of the selected domain will be displayed. By filling in search data yourself, subsystems are displayed that satisfy all the filled in search data. If no search data is filled in whatsoever, all the subsystems are displayed. For each subsystem the following data are displayed: code and description of the system to which the subsystem belongs code and description of the subsystem Progress (B) B result An overview of the managers for the selected subsystem is displayed, see Overview managers

Function keys F key F11 result printing of the overview (sub)systems with the addition of the managers, see Printing.

28

Overview managers Introduction This screen displays all the managers of a specific subsystem. Screen

Search data field

SUBSYSTEM

possible values see Overview (sub)systems.

29

Result Overview managers is automatically built up with the description of the subsystem selected on the screen Overview data groups or Overview (sub)systems. By filling in the search data yourself, it is possible to call up the description of whichever subsystem. The part above the dotted line shows the description of the subsystem. The part below the dotted line shows: the code and the description of the system to which the subsystem belongs, possibly the code and the description of the concerned data group the involvements, possibly the company to which the involvement applies, user code, name, and telephone number of the responsible persons.

30

06 Overview use code names Introduction This screen gives an overview of columns that refer to a code name, via various search data. Screen

31

Search data field

CODENAME

possible values (Part of) the code name (see also KOD-UPD). By default a % is placed at the beginning of the field. If it is not removed, all the columns will be displayed in which the specified value occurs anywhere in the code name of the column If the% is omitted, all the columns will be displayed in which the specified value occurs at the first positions in the code name. To search code names that end in a specific suffix, a blank must be added after the last indicating character, e.g. all the code names that end in AAL-KD are found by specifying %AAL-KD(blank)%.

DESCR.

(Part of) the description of a column. It is possible to use the signs _ and% in the specified description. see Overview data groups or blank B = operational tables D = day extract tables E = month extract tables I = ICT tables P = local tables W = data warehouse tables blank = all tables N = Dutch E = English blank = all languages D = DB2 O = Orcale P = DB2/2 blank = all DBMSs A = standard of A platform C = standard of C platform D = standard of D platform X = unknown standard blank = all standards

DATA GROUP TYPE

LANGUAGE

DBMS

STAND.

32

Standards:

COLUMN DESCR. TYPE LANGUAGE DBMS STAND. STAGE

= = = = = = =

% % E for end users, B for ICT N (Dutch) D (DB2) C (C platform) B (production, acceptance and test)

Result The displayed columns satisfy all the filled in search data. For each column the following data are displayed: name and description code name characteristics (type, length, nulls allowed), table to which the column belongs, stage and version of the table (and also of the column therefore). Progress (S) S result The detailed description of the selected column is displayed, see Detailed column description. An overview is displayed of all the columns of the table of which the selected column is part, see Overview columns of table.