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 10—Creating an associated rule


Upon returning to the Data Disguise - Object List you can see that File-AID/RDX has also applied the just defined related rule to the objects related to ORDER_TABLE through the CUSTOMER_NUMBER relationships.

Now, define an associated rule for the MVS object FRSAMP.CUSTOMER.

Data Disguise - Object List

 File-AID/RDX -----------  Data Disguise - Object List  ----- Row 1 to 10 of 10
 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                         CUSTOMER_NUMBER               
 _ FRSAMP.CUSTOMER_TABLE                        CUSTOMER_NUMBER                 
 _ FRSAMP.ORDER_LINE_TABLE                                                    
 _ FRSAMP.ORDER_TABLE                           CUST_NUM                     
 _ FRSAMP.PART_TABLE                                                          
 _ FRSAMP.SUPPLIER_TABLE                                                      
 _ ’TSOID01.FRSAMP.CONTACTT’                    CUSTOMER-NUMBER                 
 S ’TSOID01.FRSAMP.CUSTOMER’                    CUSTOMER-NUMBER                 
 _ ’TSOID01.FRSAMP.PARTTABL’                                                  
 _ ’TSOID01.FRSAMP.SUPPLIER’                                                    
 ******************************* Bottom of data ********************************

To select FRSAMP.CUSTOMER for data disguise definition:

In this field…

Do the following:

CMD

Type S in front of FRSAMP.CUSTOMER.

Press Enter

File-AID/RDX displays the Data Disguise - Column/Field List screen where you select the field to be disguised.

Field Names and Descriptions

For a description of the fields on this screen, see Field Names and Descriptions.

Selecting a Column/Field for Associated Disguise

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

This panel displays the object’s columns or fields and any disguise rules that are assigned to any of the columns/fields. As you just completed defining related rule R0000001, it is now displayed for field CUSTOMER-NUMBER.

For this exercise you define disguise criteria for CONTACT-NAME, a field that is not related, but also occurs in other objects in the disguise object list that are to use the same disguise criteria rule.

Data Disguise - Column/Field List

 File-AID/RDX -------- Data Disguise - Column/Field List  --- Row 1 to 14 of 18
 Command ===>                                                  Scroll ===> CSR  
                                                                               
 Primary Commands: Find, Size, SOrt                                             
    Line Commands: S = Select  A = Add/Assign rule  U =Unassign rule  I = Info  
                                                                               
 Disguise Object: TSOID01.FRSAMP.CUSTOMER                                       
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ CUSTOMER-NUMBER                 * CHAR(6)      R0000001-RELATED UNIQUE TRA
 _ COMPANY-NAME                      CHAR(30)                                   
 _ ADDRESS                           CHAR(30)                                   
 _ CITY                              CHAR(25)                                  
 _ STATE                             CHAR(2)                                    
 _ ZIP-CODE                          CHAR(9)                                    
 _ COUNTRY                           CHAR(20)                                   
 _ AREA-CODE                         CHAR(3)                                    
 _ TELEPHONE-NUM                     CHAR(7)                                    
 A CONTACT-NAME                      CHAR(30)                                   
 _ CONTACT-TITLE                     CHAR(30)                                   
 _ CONTACT-ADDR                      CHAR(30)                                   
 _ CONTACT-CITY                      CHAR(25)                                   
 _ CONTACT-STATE                     CHAR(2)

To add an associated rule for column CONTACT-NAME:

In this field…

Do the following:

Line Command

Type A in front of the CONTACT-NAME column.

Press Enter

File-AID/RDX displays the Associated Rules Window screen.

Field Names and Descriptions

For a description of the fields on this screen, see Field Names and Descriptions.

Creating an Associated Rule

When you select a column/field in the Data Disguise Column/Field List with the A line command, File-AID/RDX displays the Associated Rules Window as displayed in the following figure.

This window displays any previously defined associated rules that could be assigned to the selected column/field. You can either select an existing rule or create a NEW rule to associate it with the current column/field.

No associated rules have been defined yet, so the Rule and Description display is still blank. As you cannot select an existing rule, you create an associated rule with the NEW command.

Associated Rules Window

image2022-1-18_11-7-50.png

To create a new associated rule for column CONTACT-NAME:

In this field…

Do the following:

Command

Type NEW.

Press Enter

File-AID/RDX displays the File-AID/Data Solutions Criteria Menu screen where you define the disguise criteria.

Field Names and Descriptions

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

FIELD

DESCRIPTION

Column/Field

Identifies the name of the column/field for which you entered the A line command in the “Data Disguise - Column List”.

Disguise Object

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

Disguise Rule

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, SCROLL RIGHT or EXPAND commands to view descriptions that are longer than the display field.

Type

Displays the column’s or field’s data type.

Length

Displays the column’s or field’s data length.

Primary Commands

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

COMMAND

DESCRIPTION

NEW

Defines a new associated criteria rule for this column/field. When you press Enter, File-AID/RDX calls BMC Compuware File-AID/Data Solutions’s Disguise function and transfers control to BMC Compuware File-AID/Data Solutions in associated mode. There you actually define the new associated disguise criteria. After defining the new associated rule, you return to the “Data Disguise - Column/Field List” with the new rule assigned to the column/field.

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.

END

Cancels the assign request and returns to the “Data Disguise - Column/Field List”.

Line Commands

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

COMMAND

DESCRIPTION

S (Select)

Assigns this associated rule to the column/field and returns to the “Data Disguise - Column List” with the selected rule assigned to the column/field.

I (Info)

Displays the disguise information for the selected associated rule.

 

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