Data disguise - field list
The following figure is displayed when you select an object from the Data Disguise - Object List.
It lists all columns/fields of the selected object along with the assigned disguise rule and rule description. Column is considered a synonym for field.
Use the available line commands to manage the disguise information for the column.
Data Disguise - Column/Field List
Command ===> Scroll ===> PAGE
Primary Commands: Find, Size, SOrt
Line Commands: S = Select A = Add/Assign rule U =Unassign rule I = Info
Disguise Object: PORDR.ORDR010.ORDR010
Column/Field Name Type(Length) Rule Description +
--------------------------------- ------------ -------- ---------------------
_ CW15-PORDR-ORDR010-KEY P CHAR(6)
_ ORDER-NUMBER-PREFIX * CHAR(2)
_ ORDER-NUMBER * FIXPIC(4)
_ ORDER-DESCRIPTION CHAR(40)
S CUSTOMER-NUMBER CHAR(6)
_ PLANNED-ORDER-QUANTITY DEC(5,0)
_ PLANNED-ORDER-AMOUNT DEC(7,2)
_ ORDER-TYPE CHAR(2)
_ ACTUAL-ORDER-QUANTITY DEC(5,0)
_ TOTAL-SCRAP-QUANTITY DEC(5,0)
_ TOTAL-SCRAP-REDEFINES CHAR(3)
_ ORDER-STATUS FIXPIC(2)
_ FILLER CHAR(1)
_ FIRST-ACTIVITY-DATE-YR CHAR(4)
After you complete all desired disguise criteria for this object, press END to return to Data Disguise - Object List.
Disguise Object
Identifies the name of the object you selected in the Data Disguise - Object List.
Column/Field Name
Identifies the names of the columns/fields of the object. An asterisk (*) to the right of the field name indicates a related field.
Type (Length)
Displays the column’s or field’s data type. The length of the data is displayed in parentheses immediately following the data type where applicable.
Rule
Identifies the disguise rule and description assigned to the column/field. When the criteria is stored in a disguise criteria file, File-AID for IMS generates a unique name for each rule and identifies its mode with a prefix, either A, R or U.
Annnnnnn identifies an associated rule
Rnnnnnnn identifies a related rule
Unnnnnnn identifies an unrelated rule
Description
Displays the disguise rule description as entered during disguise creation.
Line Commands
The following File-AID for IMS line commands are valid:
A (Add/Assign Rule)
Displays the Associated Rules List where you can select an already defined associated disguise rule or create a new associated rule to assign to this column (see also Associated Rules List). You can only enter the A line command for a column that does not have a rule assigned to it yet. “A” is used only to assign associated rules. If a field requires a Related or Unrelated rule, use the “S” command instead of “A”.
I (Info)
Displays the disguise information for the selected column. The presented information differs depending on the type of disguise rule, related, associated, or unrelated.
S (Select)
Selects this column as a column to be disguised or to modify its existing disguise information. When you press Enter, File-AID for IMS transfers control over to File-AID/Data Solutions’ Disguise function where you actually define or modify the disguise criteria for the selected object. Depending on the column type File-AID for IMS transfers to File-AID/Data Solutions in either Related, or Unrelated mode (see also File-AID/Data Solutions Criteria Menu). If you want to create an Associated Rule, use the “A” line command rather than “S”.
When selecting a column that already has a disguise rule defined for it, you can modify the disguise criteria as long as the criteria was defined for the selected object and field.
However, when selecting a field with an Associated or Related disguise rule that was defined using a different object and field, a warning message informs you that you can either modify the criteria using the original object and field or cancel your selection.
U (Unassign Rule)
Removes any disguise rule from this field. Notice the behavior depending on the type of rule:
- Unassigning a rule from a related field in one object will unassign it from all related fields in other objects as well.
- Unassigning a rule from an associated field will only affect that object. However, if unassigned from the object of origin, (the object used to define the rule), a warning popup will display all of the places where the rule was applied and the rule will be unassigned from all the associated objects, unless you cancel the command.
- Unassigning an unrelated rule will remove criteria from all unrelated fields in that object. To remove criteria from a single unrelated field, cancel the Unassign, then use the S line command to select the rule and remove the criteria.
Unassigning a rule does not delete it from the criteria file as it might be used by another Disguise Control File.
Primary Commands
The following File-AID for IMS-specific primary commands are valid:
FIND (F)
Searches the list for the specified string and scrolls the list to display the first matching entry at the top of the displayed entries. Use RFind to repeat the search.
SIZE (S)
Increases the scrollable area to display more entries at a time by hiding some of the screen header lines. SIze is a toggle switch so enter SIze again to return to the original format.
SORT (SO)
Sorts the displayed list by the specified display column name.
Associated Rules List
The Associated Rules List shown in following the figure is displayed when you enter an A line command for a column in the Data Disguise - Column/Field List.
Associated Rules are a way of applying the same disguise criteria to otherwise unrelated fields. You select the fields and apply the rule manually. You can apply the rule to fields in any IMS database, in any segment, as long as those fields are not defined as Related. You create an Associated Rule by defining the criteria on one field first. The rule is stored as a member of the Criteria PDS. You can then choose to apply the same rule to other fields also. Each time you apply it, a reference will be stored in the Control File linking each such field to the same rule. So, for example, if you have an identifying number for an item stored in five different places, in various segments and databases, all with different field names, but you know what they all are, then you can choose to set up an Associated Rule and apply the same Associated Rule to all of them. You apply an associated rule by use of the A line command. File-AID for IMS does not provide any automated identification assistance with this.
Associated rules are like related criteria but instead of the Relationship File identifying where the criteria are to be applied, you identify the data locations. Any changes made to associated disguise criteria will apply to all objects that share the criteria.
File-AID/Data Solutions provides disguise options that are repeatable, but it is up to you to choose a disguise method that will return the same replacement value in all objects if the values are to be consistent across objects.
The Associated Rules List lists all currently defined associated rules. You can select an existing rule or create a new one. The associated rule should match the column type and length of the selected column.
Use the available line commands to manage the associated rules for the column.
Associated Rules List
Column/Field
Identifies the name of the column/field for which you entered the A line command in the Data Disguise - Column/Field List. In this context, column is a synonym for field.
Disguise Object
Identifies the name of the object you selected from the Data Disguise - Object List.
Rule
Identifies the defined disguise rule by its member name in the Disguise Criteria File.
Description
Identifies the defined disguise rule by its member name in the Disguise Criteria File and displays the disguise rule description as entered during the disguise creation.
Use the SCROLL LEFT and SCROLL RIGHT commands (PF10 and PF11) to view descriptions that are longer than the display field.
Type
Displays the data type of the field.
Length
Displays the data length of the field.
Line Commands
The following File-AID for IMS line commands are valid:
I (Info)
Displays the disguise information for the selected associated rule.
S (Select)
Assigns this associated rule to the field and returns to the Data Disguise - Column/Field List, with the selected rule assigned to the field.
Primary Commands
The following File-AID for IMS-specific primary commands are valid:
NEW
Allows you to define a new associated criteria rule for this field. When you press Enter, File-AID for IMS transfers control over to File-AID/Data Solutions’ Disguise function in associated mode. There you actually define the new associated disguise criteria (see Criteria Menu - Associated Mode). After defining the new associated rule, you return to the Data Disguise - Field List with the new rule assigned to the field.
FIND (F)
Searches the list for the specified string and scrolls the list to display the first matching entry at the top. Use RFind (PF5) to repeat the search.
SIZE (SI)
Increases the scrollable area to display more entries at a time by hiding some of the screen header lines. SIze is a toggle switch so enter SIze again to return to the original format.
SORT (SO)
Sorts the displayed list by the specified column name.