Previous Topic: Menu Panel - Entity Display ModeNext Topic: Display Alias


Using the Selection Criteria Fill-in Panel

When you select the DISPLAY INDEX, DISPLAY ATTRIBUTES, DISPLAY TEXT, or DISPLAY ALIAS options, you receive a Selection Criteria Fill-in panel similar to the following panel. With the DISPLAY FIELD or DISPLAY COPYBOOK options, CA Datacom Datadictionary first presents a menu where you select the type of field name or copybook to use in the selection process before you make entries on the Selection Criteria Fill-in panel. For more information, see Display Field and :Display Copybook.

CA Datacom Datadictionary does not use the Selection Criteria Fill-in panel with the DISPLAY RELATIONSHIP DEFINITION and the DISPLAY STRUCTURES options. For more information about the selection procedures for these options, see Display Relationship Definitions and Display Structures.

The Selection Criteria Fill-in panel shows the type of display function you are requesting on the panel. For example, notice that the following panel is for the DISPLAY INDEX function. If you select a display of occurrence attributes, the panel shows the DISPLAY ATTRIBUTES command on the left side of the panel. The Selection Criteria panel has a box for selecting optional criteria on the right and lines to select a specific entity-type and occurrence in the following panel.

=> => => 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND ----------------------------------------------------------------------------- DDOL Display Mode Selection Criteria Fill-in T01F ..................optional.............................. DISPLAY INDEX : using _ ________________________________ : DIS IND : using (A-alias) (alias name) : : (D-descr) (descriptor name) : : (P-path) (STANDARD) (S-Sqlname) : :......................................................: / ________________________________ , ________________________________ . (entity-type) (parent occurrence-name) ____________________________ ( ____ , , ) / AS OF ____________ (occurrence-name) (stat, pswd, ovrd) (YYYYMMDDhhmm) (vers, pswd, ovrd) PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

Complete your specifications on a Selection Criteria Fill-in panel according to the following descriptions.

Keywords in the optional criteria box:

using

You can enter qualifiers for the type of display in these fields. With these qualifiers, you can select displays of occurrences by aliases, by descriptors, along a path of related occurrences, or by display of SQL names for a table.

If you enter A (Alias) without an alias name, CA Datacom Datadictionary displays only the occurrences that meet the specifications in the other fields on the panel that also have an alias name. If you specify A and an alias name, CA Datacom Datadictionary displays only the occurrences that meet the specifications in the other fields on the panel that also have the alias name you specify.

If you enter D (Descriptor) without a descriptor name, CA Datacom Datadictionary displays only the occurrences that meet the specifications in the other fields on the panel that also have a descriptor name. If you specify D and a descriptor name, CA Datacom Datadictionary displays only the occurrences that meet the specifications in the other fields on the panel that also have the descriptor name you specify.

If you enter P (Path) without STANDARD, CA Datacom Datadictionary presents the Path Definition panel where you can define the path to display only those occurrences you want to see. For more information, see Define a Path. If you enter P and STANDARD, CA Datacom Datadictionary bypasses the Path Definition panel and uses the Standard Path for the relationship when presenting the display.

If you enter S (Sqlname) and are displaying a table or tables, CA Datacom Datadictionary displays the SQLNAME associated with that table.

Valid Entries:

A
A alias-name
D
D descriptor-name
P
P STANDARD
S SQLNAME

Default Value:

(No default)

Keywords in the remainder of the panel:

(entity-type)

Use this field to limit your selection to a single entity. Specify the name of the entity, such as alias. If you leave this field blank, CA Datacom Datadictionary uses ALL as the default and returns occurrences of all entities. You cannot use abbreviations in this field.

Valid Entries:

An existing entity-type
ALL

Default Value:

ALL

(parent occurrence-name)

When the entity you are selecting is FIELD, KEY, or ELEMENT, you can enter the name of a TABLE or RECORD occurrence in this field to limit your selection to the occurrences contained in a single table or record.

You can enter ALL to select all occurrences or use a generic selection of one or more of the initial characters of the name with an asterisk (*) to select several occurrences. For example, PAY* processes all occurrences of this entity-type with PAY as the first 3 characters in the name.

When you leave this field blank, CA Datacom Datadictionary uses the occurrence that meets the other selection criteria you enter on this panel. For more information, see the topic about how CA Datacom Datadictionary returns occurrences in the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character RECORD or TABLE occurrence name

Generic selection

ALL

Default Value:

The name of the first RECORD or TABLE occurrence that meets the other selection criteria

(occurrence-name)

Limit the selection to a specific occurrence by entering the name of the occurrence.

You can enter ALL to select all occurrences or use a generic selection of one or more of the initial characters of the name with an asterisk (*) to select several occurrences. For example, PAY* processes all occurrences of this entity-type with PAY as the first three characters in the name.

When you leave this field blank, CA Datacom Datadictionary returns the occurrence or occurrences that meet the other selection criteria you enter on this panel. For more information, see the topic about how CA Datacom Datadictionary returns occurrences in the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character occurrence name

Generic selection

ALL

Default Value:

The name of the first occurrence that meets the other selection criteria

stat, or vers,

Specify the status or version. When you leave this field blank, CA Datacom Datadictionary uses ALL as the default and returns the first occurrence or all occurrences that meet the other selection criteria you enter on this panel.

Valid Entries:

TEST or T001—T999
PROD or 001—999
QUAL (valid for TBL, FLD, KEY, ELM, CNS)
INCO
HIST or H000—H997 (000-997 is the generation number)
ASOF (to use the AS OF option)
ALL

Default Value:

ALL

pswd,

Only required if this occurrence has protection against unauthorized maintenance with a password assignment. Supply the password for this occurrence.

Valid Entries:

1- to 4-character password

Default Value:

(No default

ovrd)

Only required if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment. Supply the override code.

Valid Entries:

1- to 4-character override code

Default Value:

(No default)

AS OF (YYYYMMDDhhmm)

(Optional) If you enter ASOF in the status field, specify the date/time stamp to display the version of the structure that was in PROD status at that date and time. You can specify the full date and time or a partial date, such as 200801 for the year and month or 20080101 for the year, month and day.

Note: If your time value includes seconds, round up to the nearest minute.

Valid Entries:

1 to 12 digits

Default Value:

(No default)