Writer instructions

Purpose

Use this page to display a banner announcement on each page of the space. Create the Space announcements page in the master space, outside of the Home branch.

You can version the Space announcements page to enable different banners to be published into different target spaces, however, the banner that is displayed in the versioned (master) space itself only displays the most recently-published banner.  If you find errors in the banner area of your versioned space and you are sure the Space announcements page is set up correctly, try publishing the page to the same space.

For more information, see Space-announcements-banners.

Removing

When an announcement is no longer needed, remove the BMC Space Banner macro.

Translation

Localized spaces using the L10n Viewport theme must change the name of this page to Space announcements l10n.  See Configuring-the-Scroll-ViewPort-theme-for-translated-spaces.

Usage

Choose one or none of the following BMC Space Banner macros.

If your space requires another kind of announcement, you can use this page in coordination with your team lead and editors.

When should I use a space announcement banner?

Use the space organization announcement after you change the content from a book-like organization (such as User Manual, Configuration Manual, and Administration Guide) to the product model.

Use the latest version announcement to push traffic to later versions. You do not need to add this to every previous version, but if you have a specific reason that you want users to be aware—for example, Google searches show content for an obsolete version—use the banner to help users find a relevant version.

When an announcement is no longer needed, remove the BMC Space Banner macro.

Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Step 8—Selecting an object for related disguise


File-AID/RDX displays the Data Disguise - Object List screen illustrated in the following figure when you enter the S line command for an entry in the Extract Reference List for Disguise.

It displays the list of the objects, in alphabetical order, that have been filtered into the Object List. When you selected an existing extract request, all objects that are not excluded from the extract are displayed in the list. From this list you select an object in order to create or modify disguise criteria for the object. Disguise criteria are defined for an object. The Disguise Control File stores the object and disguise criteria information.

Whenever you request to disguise an extract, File-AID/RDX checks the Disguise Control File. If objects in the extract have disguise criteria defined, then the defined disguise criteria will be applied to the extracted data from those objects.

For this exercise, you will disguise the related customer numbers. The disguise criteria will be unique value translation, which File-AID/RDX considers complex criteria. You could select any of the objects that are related through the customer number to define the disguise criteria, but should choose the object that contains all of the different customer numbers to be extracted.

Data Disguise - Object List

 File-AID/RDX -----------  Data Disguise - Object List  ----- Object list built
 Command ===>                                                  Scroll ===> CSR  
                                                                               
 Primary Commands: ObjectIn, ObjectOut, Find, Size                              
    Line Commands: S = Select     I = Info                                      
                   O = ObjectOut  R = Related objects  L = List DB              
                                                                               
   SSID: DSN  Location: DSNLOCAT                                                
   Object Name                                  Disguised Columns/Fields       +
   -------------------------------------------- --------------------------------
 _ FRSAMP.CONTACT_TABLE                                                       
 _ FRSAMP.CUSTOMER_TABLE                                                      
 _ FRSAMP.ORDER_LINE_TABLE                                                    
 S FRSAMP.ORDER_TABLE                                                         
 _ FRSAMP.PART_TABLE                                                         
 _ FRSAMP.SUPPLIER_TABLE                                                      
 _ ’TSOID01.FRSAMP.CONTACTT’                                                    
 _ ’TSOID01.FRSAMP.CUSTOMER’                                                    
 _ ’TSOID01.FRSAMP.PARTTABL’                                                   
 _ ’TSOID01.FRSAMP.SUPPLIER’                                                    
 ******************************* Bottom of data ********************************

To define data disguise criteria for FRSAMP.ORDER_TABLE:

In this field…

Do the following:

CMD

Type in front of the FRSAMP.ORDER_TABLE entry.

Press Enter

File-AID/RDX displays the Data Disguise - Column/Field List screen.

Field Names and Descriptions

The following list describes all of the fields on this screen.

FIELD

DESCRIPTION

Object Name

Identifies the name of the objects that match the specified object filter.

Disguised Columns/Fields

Displays the names of the columns and fields with disguise criteria defined. This field is a scrollable field so the entire contents of the field may not be displayed in the area allowed. Position the cursor on the field and enter the EXPAND command to view the entire field contents.

Primary Commands

The following list identifies the primary commands that are available from this screen. For details on the command, see File-AID/Related Data XPERT Reference.

COMMAND

DESCRIPTION

OBJECTIN (OI)

Allows you to add objects to your current object list. This command displays either the “ObjectIn - DB2 Object Filter” or “ObjectIn - MVS Object Filter” screen. The ObjectIn Filter panels work the same as the “NEW - DB2 Object Filter” and “NEW - MVS Object Filter”.

OBJECTOUT (OO)

Allows you to remove objects from your current object list. This command displays either the “Object-Out - DB2 Object Filter” or “Object-Out - MVS Object Filter” screen.

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.

Line Commands

The following list identifies the line commands that are available from this screen.

COMMAND

DESCRIPTION

S (Select)

Selects this object for data disguise and displays the Data Disguise - Column/Field List.

I (Info)

Displays the disguised columns/fields with the disguise rule and disguise description for the selected object. The Description field is scrollable, use LEFT and RIGHT commands to view the remainder of the description field.

O (ObjectOut)

Removes this object from the object list.

R (Related objects)

Searches the relationship file and displays any related objects that are not yet included in the object list. Then you can select any of the related objects to be added to the object list.

L (List DB)

Lists all objects that are in the same database as this object and are not already in the Object List. Then you can select any of the objects to be added to the object list.

Selecting a Related Column/Field for Disguise

When you select an object in the object list with the S line command, File-AID/RDX displays the Data Disguise - Column/Field List as displayed in the following figure.

This panel displays the object’s columns or fields and any disguise rules that are assigned to any of the columns/fields. For this exercise, disguise rules have not been defined yet, so the Rule and Description display columns are still blank.

Related columns/fields are identified with an asterisk (*) to the right of the column/field name.

Data Disguise - Column/Field List

 File-AID/RDX -------- Data Disguise - Column/Field List  --- Row 1 to 13 of 13
 Command ===>                                                  Scroll ===> CSR  
                                                                               
 Primary Commands: Find, Size, SOrt                                             
    Line Commands: S = Select  A = Add/Assign rule  U =Unassign rule  I = Info  
                                                                               
 Disguise Object: FRSAMP.ORDER_TABLE                                            
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ ORDER_NUMBER                    * CHAR(6)                                   
 S CUST_NUM                        * CHAR(6)                                    
 _ SOC_SEC_NUM                       CHAR(11)
 _ CREDIT_CARD_NUM                   CHAR(16)
 _ ORD_TYPE                          CHAR(8)                                    
 _ ORD_DATE                          DATE                                       
 _ ORD_STAT                          CHAR(8)                                    
 _ ORD_AMOUNT                        DEC(9,2)                                   
 _ ORD_DEPOSIT                       DEC(9,2)                                   
 _ ORD_LINE_COUNT                    INTEGER                                    
 _ SHIP_CODE                         CHAR(2)                                   
 _ SHIP_DATE                         DATE                                       
 _ ORD_DESCRIPTION                   VCHAR(100)                                 
 ******************************* Bottom of data ********************************

To define data disguise criteria for column CUST_NUM:

In this field…

Do the following:

Line Command

Type S in front of the CUST_NUM column.

Press Enter

File-AID/RDX displays the File-AID/Data Solutions Criteria Menu screen in related mode where you enter the related disguise criteria.

Field Names and Descriptions

The following list describes all of the fields on this screen.

FIELD

DESCRIPTION

Disguise Object

Identifies the name of the object you selected in the “Data Disguise - Object List”.

Column/Field Name

Identifies the name of the columns/fields of the object. An asterisk (*) to the right of the column name indicates a related column.

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 for CHAR, VCHAR, GRPH, VGRPH, DEC, FIXPIC, data types only.

Disguise Rule

Identifies the disguise rule and description assigned to the column/field. File-AID/RDX 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

Important

Rules not following this identification pattern are Associated rules for which the identifier has been changed manually.

Position the cursor on the field and enter the EXPAND command to view the entire field contents.

Primary Commands

The following list identifies the primary commands that are available from this screen.

COMMAND

DESCRIPTION

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.

Line Commands

The following list identifies the line commands that are available from this screen.

COMMAND

DESCRIPTION

S (Select)

Selects this column as a column to be disguised or to modify its existing disguise information. When you press Enter, File-AID/RDX transfers control over to BMC Compuware File-AID/Data Solutions’s Disguise function where you actually define or modify the disguise criteria for the selected object. Depending on the column type File-AID/RDX transfers in either Related, Associated, or Unrelated mode.

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 column.

However, when selecting a column with an Associated or Related disguise rule that was defined using a different object and column, a warning message informs that you can either modify the criteria using the original object and column or cancel your selection.

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. You can only enter the A line command for a column that does not have a rule assigned to it, yet.

U (Unassign Rule)

Removes any disguise rule from this column. Notice the behavior depending on the type of rule:

  • Unassigning a rule from a related field will unassign it from all related columns.
  • 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. 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 with BMC Compuware File-AID/Data Solutions.

Unassigning a rule does not delete it from the disguise criteria file as it might be used by another Disguise Control File.

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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*