The standard Predict metadata structure contains the following object types:
database, dataspace, extract, field, file, file relation, interface, keyword, library structure, method, network, node, packagelist, program, property, report listing, server, storagespace, system, trigger, user (owner), verification and virtual machine.
In addition to these predefined types, user-defined object types can be added to the Predict metadata structure.
User-defined object types are created and maintained with functions of the Object Type Administration Menu. Predefined object types can be extended by new attributes. Existing screens can not be modified with functions of the Object Type Administration Menu.
The Object Type Administration Menu is called by entering code O in the Metadata Administration main menu.
09:55:00 ***** P R E D I C T ***** 2007-05-31 - Object Type Administration Menu - Function A Add an object type D Display object type S Select object type M Modify object type N Rename object type P Purge object type T Modify attribute names and numbers X Cross reference object type Function ............. Object type code ....* Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- - - Stop - - Flip Print - - - - Main |
Function:
Single-character code to select one of the functions available.
The functions are described in the following sections:
Object type code:
Identifies the object type in Predict menus or direct commands, such as DA (database) or FI (file).
The Add and Modify functions use the same screens.
When an object type is added, a default extended description and help texts for retrieval and maintenance are generated. The default extended description can be changed using the function Modify Defaults which is called from the Function Main Menu with code D.
This section contains:
When an object type is modified the following rules apply:
If an attribute is deleted, the attribute will be deleted in all existing objects of the object type.
If an attribute is added or an attribute name is changed, the change will be applied to all existing objects of this type.
The type of an attribute cannot be changed.
For an attribute, the total number of positions may only be increased.
If the number of positions is increased and the attribute has a verification or edit mask, the verification or edit mask will be deleted. This rule does not apply to the data types D (date) and T (time).
If the verification or edit mask of an attribute is changed, the corresponding object data remain unchanged.
13:54:15 ***** P R E D I C T ***** 2007-05-31 - Modify object type definition - Object type code ... CE Modified 2006-01-31 at 10:46 by MSZ Object type attributes Default associations Internal code ... 1000005 Passive ......* Name ............ CHNG-ENHANCEMENT Active .......* DA Title ........... Chng-enhancement Object type no .* 1012000 Edit owner ...............* D Disallowed Edit description .........* F Force Check description ......... Y (Y,N) Object ID length .......... 32 (1-32) Disallowed characters ..... Natural naming convention . N (Y,N) Abstract * Zoom: N Object-type to document change enhancements for pro- Screen number .... 1 of 1 (H=Header) Free attributes: 70 |
Note:
The parameters Internal code, Name and Title cannot be
changed using the Modify function. To modify the Name or Title, use the
function Rename object type.
Parameters | |
---|---|
Object type attributes | |
Internal code | This internal code is assigned automatically and cannot be changed. It is used by Predict to administrate object types. This field is empty when an object type is added. |
Name | Name of the object type. A name
|
Title |
String that is used in Predict menus and output screens for the respective object type. Can be up to 17 characters long and contain numbers, special characters and blanks. If no title is specified, the object type name with the first character capitalized will be taken as title. |
Object type no | Number of the object type. When an object type is
created, it is assigned a number between 1,000,000 and 4,999,999. In the Modify function, this number can be modified. You can use the asterisk notation to select a number which has not yet been assigned to an object type, an association type or an attribute. |
Default
association These parameters can be changed for user-defined object types. |
|
Passive / Active |
The associations specified, apply as default values in Predict functions for thedefault parent parameter (for example, in system parameter in maintenance screens of the user-defined object type change enhancement). Only user-defined association types can be specified. |
Note:
The following parameters can be modified for both predefined
and user-defined object types.
Parameters | ||
---|---|---|
Edit owner | Determines the handling of the owner list: | |
F | Force: Only owners which are assigned to a user can be specified. At least one owner must be specified. | |
A | Allow: the owner list can be edited. | |
D | Disallow: the owner list must not be
edited.
Note: |
|
Edit description | Determines the handling of the extended description: | |
F | Force: at least three lines must be specified. | |
A | Allow: the extended description can be modified. | |
D | Disallow: the extended description must not be modified. | |
Check description | Parts of an extended description skeleton can be protected (see Extended Description Skeleton). If this parameter is set to Y, the protected text must be contained in the extended description. | |
Object ID length | Enter a value from 1 - 32. The value entered here is the maximum length of an ID for objects of this type. | |
Disallowed characters | Up to 20 characters
that are not allowed in IDs for objects of this type can be entered here.
Note: |
|
Natural naming convention | N | Default. Predict naming conventions apply. See Naming Conventions in the Predefined Object Types in Predict documentation. |
Y | Natural naming conventions apply to object IDs. These conventions support use of double-byte character sets (DBCS). See your Natural documentation for further information. |
Note:
The parameters above can be modified for existing object
types, but checks are only performed on newly created objects or objects
imported with the Predict Coordinator.
For example:
You can change the parameter Object ID length for object type database to 30 even if databases exist with an ID of 32 characters.
Parameters | |
---|---|
Abstract | An abstract of up to 16 lines can be specified. Each line can contain up to 30 characters. |
Screen number |
Up to five maintenance screens can be defined for each object type. When a number between 1 and 5 is entered, the corresponding screen for attribute definition is selected. Only an existing screen or the next free screen can be selected. If zero is entered, the Metadata Administration menu appears. If 'H' is entered, the header is displayed. |
Free Attributes | The remaining number of free attributes is displayed - a maximum of 80 for each object type. |
Up to 80 attributes can be defined for each object type - a maximum of 40 in one maintenance screen. The maximum numbers of attributes for the individual attribute types are:
alphanumeric: 40; numeric: 40; date, time, logical, and literal 20 each.
13:04:08 ***** P R E D I C T ***** 2007-05-31 - Modify object type definition - Name .......... CHNG-ENHANCEMENT Modified 2006-01-31 at 10:46 Screenname .... Attributes by MSZ Screennumber .. 1 Positions of Title Value Attribute Name Fmt Len Case Li/Col Li/Col Ext Ver * 1 Customer A 58 L 1 1 1 20 2 Title A 58 L 2 1 2 20 3 Version A 6 U 4 1 4 20 T 4 Subproduct A 20 L 3 1 3 20 5 Status A 1 U 6 1 6 20 R 6 Test A 1 U 8 1 8 20 S 7 Closing-date N 8.0 7 1 7 20 8 CE-Nr N 6.0 5 1 5 20 9 time T 10 1 10 20 10 date D 12 1 12 20 Test screen layout: N More: Attributes: N |
Parameters | ||
---|---|---|
Screen name | Name of the
corresponding maintenance screen. If several maintenance screens are existing,
the screen names are displayed in a selection window. Up to 17 characters are
allowed. Default value for the first screen name is Attributes. |
|
Attributes | Names of the attributes which are to be displayed in the corresponding maintenance screen for this object type. Up to 32 characters are allowed. | |
Fmt | Format of the attribute: | |
A | alphanumeric | |
D | date | |
L | logical | |
N | numeric | |
T | time | |
X | literal | |
Len | The length of an attribute value depends on the format: | |
A | 1 to 78 | |
N | 1 to 27 places before the decimal point, and 0 to 7 places after the decimal point, where the total number of places must not exceed 27 | |
Case | This field is only valid for alphanumeric attributes (type A). | |
U | The attribute value is converted to capital letters. | |
L | No conversion to capital letters. | |
Position of Title | The position refers to
a window of 15 lines and 78 columns:
|
|
Position of Value | The position refers to
a window of 15 lines and 78 columns:
|
|
Ext | Extended attribute description. Subsequent screens for the definition or modification of edit masks and verifications for the attribute are displayed. | |
E | edit mask (only for types D, L and T) | |
T | table of verification values | |
R | range of verification values | |
S |
external verification (special check) For type X (literal) neither edit masks nor verifications can be defined; for type L (logical) no verifications can be defined. |
|
The following default values apply to edit masks: | ||
L | F/T | |
D | YYYY-MM-DD | |
T | HH:II:SS | |
Changing the
verification type (T, R or S) is possible. In this case, the old verification
is deleted. Before deletion, a warning is displayed. The corresponding object
data remain unchanged.
Note: |
||
Ver | An existing
verification type (T, R or S) is displayed for the attribute.
Note: |
|
Test screen layout | Y | The maintenance screen is displayed to test the screen layout. |
More Attributes | Y | Each definition screen can contain ten attributes. If more attributes are to be defined (up to 40), this field is used to display a subsequent screen. |
For the attribute types L, D and T (logical, date and time) edit masks are defined. Enter E in the field Ext to display a selection window where you can select an appropriate edit mask for the attribute. The following values are possible:
Attribute Type | Value |
---|---|
L (Logical) | FALSE/TRUE |
OFF/ON | |
NO/YES | |
N/Y | |
* F/T | |
D (Date) | DD/MM/YY |
DD.MM.YY | |
YY-MM-DD | |
DD/MM/YYYY | |
DD.MM.YYYY | |
* YYYY-MM-DD | |
MM/DD/YYYY | |
YYYYMMDD | |
T (Time) | * HH:II:SS |
HH:II:SS:T | |
HH:II:SS AP | |
HH:II:SS:T AP |
Asterisks indicate the active edit mask for the attributes.
There are three methods of performing plausibility checks for object attributes:
using a Table of Values
using a Range of Values
using an External Routine.
Enter T in the field Ext to define a table of values.
13:09:01 ***** P R E D I C T ***** 2007-05-31 - Add a Table Definition - Name ............ CHNG-ENHANCEMENT Modified 2006-01-31 at 10:46 Attribute name .. datum by MSZ EDIT MASK ....... YYYY-MM-DD Required ........ N (Y/N) 1 1993-01-01 2 1994-01-01 3 1995-01-01 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
Parameters | ||
---|---|---|
EDIT MASK | Active edit mask for the attribute (only for types D, L and T). | |
Required | Y |
Attributes for which a verification rule with a table of values has been defined must be filled in maintenance screens (mandatory fields). Attributes with a verification rule that allows blank values need not be filled explicitly. Use the following 24 fields to define the verification values. |
Enter R in the field Ext to define verifications with ranges of values.
13:13:48 ***** P R E D I C T ***** 2007-05-31 - Add a Range Definition - Name ............ CHNG-ENHANCEMENT Modified 2006-01-31 at 10:46 Attribute name .. date by MSZ EDIT MASK ....... YYYY-MM-DD Required ........ N (Y/N) Range of values *: GT 1994-01-01 AND LT DATE____ OR_ GT 1993-01-01 AND LE 1993-03-31 ___ __ ________ ___ __ ________ Error code: ____ |
Parameters | |||||
---|---|---|---|---|---|
EDIT MASK | Active edit mask for the attribute (only for types D, L and T). | ||||
Required (Y/N) | Y | Attributes for which a verification rule with a range of values has been defined must be filled in maintenance screens (mandatory fields). Attributes with a verification rule that allows blank values need not be filled explicitly. | |||
Range of values | In the following fields, you can define ranges of values according to the following syntax: | ||||
AA | Value_1 | BBB | AA | Value_2 | |
CCC | |||||
AA | Value_3 | BBB | AA | Value_4 | |
CCC | |||||
AA | Value_5 | BBB | AA | Value_6 | |
For any defined Value_X, AA is a mandatory field with one of the following possible values: EQ (equal), NE (not equal), LT (less than), LE (less than or equal), GT (greater than), GE (greater than or equal). If you enter an asterisk, the possible values are displayed in a selection window. Value_X are the verification values. Up to six verification values can be defined. For type A (alphanumeric), the length is restricted to 32 - independent of the length of the attribute itself. For type N (numeric), the following applies: a maximum of 20 digits before and 7 digits after the decimal point can be entered. If DATE is entered for type D (date), the verification value is the current date. BBB is one of the possible values AND or OR which combines the two elementary conditions of one line in a boolean expression. CCC combines the boolean expressions defined in each line with the operand AND or OR. The logical expressions are always processed line by line. Note: |
|||||
Error code | User-defined, verification-related number of the error message which appears if an invalid attribute value has been entered. Range of values: 9000 - 9999. |
Note:
With attributes of type A (alphanumeric) only the number of
positions defined in the verification rule are considered.
Enter S in the field Ext to define that an external verification rule is to be called.
13:34:17 ***** P R E D I C T ***** 2007-05-31 - Add a Special Check - Name ............ CHNG-ENHANCEMENT Modified 2006-01-31 at 10:46 Attribute name .. Test by MSZ Subprogram ... N-TEST__ Attribute names * Customer________________________ Version_________________________ ________________________________ |
Parameters | |
---|---|
Subprogram | Name of the subprogram which is called to verify the attribute value. |
Attributes |
In the following fields, you can define up to three object attributes, which are defined in one maintenance screen, as input parameters for the subprogram. If you enter an asterisk, the names of the object attributes of this maintenance screen are displayed in a selection window. Attributes of type X (literal) cannot be defined as input parameters for the subprogram. The values of these attributes are passed to the defined subprogram in alphanumeric format (length 78) as follows:
The following CALLNAT statement is generated: CALLNAT 'subprogram' PAR1 PAR2 PAR3 RETURN-CODE RETURN-TEXT1 RETURN-TEXT2 PAR1 PAR2 PAR3: values of the attributes (format A78); RETURN-CODE: number of a Predict error message (format I2); RETURN-TEXT1 and RETURN-TEXT2: texts as parameters for this error message (format A34). In the subprogram, attribute values of the types D, N, and T can be converted using the Natural function VAL. The verification rules are processed screen by screen. Independent of the sequential numbers of the attributes to be verified, the verification rules with external verification routines are processed last - they are only processed after all verification rules with tables of values and ranges of values have been processed. |
13:43:42 ***** P R E D I C T ***** 2007-05-31 - Modify Header Layout - Object type ..... CHNG-ENHANCEMENT Number of: Column Header Length Format Attr. Scr. 1. 2 1 1 Title 19 A 58 2. 7 1 21 C-date 9 N 8.0 3. 4. Layout: ....+....1....+....2....+....3....+....4 Chng-enhancement Title C-date ------------------------------- ------------------- --------- |
This screen appears after object attributes have been defined. Here you can define a table layout to be used by the maintenance functions List, Select and Link children.
The following rules apply:
A maximum of four rules can be specified.
The total length of all attribute values must not exceed 30 characters (including blanks to separate the columns).
The text of the header lines can be modified as desired.
The display length can only be modified for alphanumeric attributes.
Parameters | |
---|---|
Number of Attr. | Number of the attribute in the definition screen. |
Number of Scr. | Number of the definition screen of this attribute. |
Column | Position in the table screen. |
Header | Text of the header line in the table screen. |
Length | Length with which the value is displayed.
Note: |
Displays object type definitions in an output format similar to the screens used for adding or modifying object type definitions. For a description of all output fields, see Add / Modify Object Type.
A list of predefined and user-defined object types is displayed for selection. Press ENTER to display the next page.
13:36:14 ***** P R E D I C T ***** 2007-05-31 - Select Object Type Definition - Mark Code Title Object type CH Child CHILD CE Chng-enhancement CHNG-ENHANCEMENT DA Database DATABASE predefined DK Dokument DOKUMENT EL Elementary field ELEMENT predefined EY Elementary field EMPTY FI File FILE predefined UP File FILL HI Verif HIT HO Keyword BWG1 JB Owner JOB KY Keyword KEYWORD predefined NO Node NODE predefined Hit the corresponding PF-KEY to STOP, Enter 'X' to ABORT or 'T' for TOP : _ |
09:44:42 ***** P R E D I C T ***** 2007-05-31 - Rename Object Type Definition - Name ............ CHNG-ENHANCEMENT Modified 2006-01-31 at 07:32 Object type ..... CE by ARH Object type attributes Intern code.... 1000005 Title.......... Chng-enhancement New attributes New name ......... CHNG-ENHANCEMENT ( '.' to return to menu ) New object type .. CE New title......... Chng-enhancement ----------------- ATTENTION ------------------ Contents of help-texts and default description will not be adapted. |
The name of the object type, the external code, and the title can be changed.
Deletes a user-defined object type and all data dictionary objects of this type. The following rules apply:
Object types that are linked to another object type by an association cannot be purged.
The default extended description and the help texts for retrieval and maintenance are deleted.
13:22:39 ***** P R E D I C T ***** 2007-05-31 - Modify attribute number - Name ........ Parent_of_H1 Modified 2006-01-31 at 13:30 by HEB Cnt Number Attribute name Attribute title --- *------ -------------------------------- -------------------------------- 1 2000082 SCREEN_1 Screen 1 2 2000077 BLAB01 Blab01 3 2000078 BLAB02 Blab02 4 2000079 BLAB03 Blab03 5 2000080 BLAB04 Blab04 6 2000081 BLAB05 Blab05 7 2000130 SCREEN_2 Screen 2 8 2000001 ALPHA_2-1 Alpha_2-1 9 2000003 ALPHA_2-10 Alpha_2-10 10 2000131 SCREEN_3 Screen 3 11 2000002 ALPHA_3-1 Alpha_3-1 12 2000005 ALPHA_3-12 Alpha_3-12 13 2000132 SCREEN_4 Screen 4 14 2000010 SS ss |
When an attribute is added, it is assigned a number between 1,000,000 and 4,999,999. This value can be modified. You can use the asterisk notation to select a number which has not yet been assigned to an object type, to an association or to an attribute.
Displays the following information on the associations of the object type:
all object types to which the object type is linked
all retrieval models defined for the object type
all retrieval models that report on links to the object type.