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 12—Assigning an existing associated rule


Upon returning to the Data Disguise - Object List you can see that File-AID/RDX has added CONTACT-NAME as a disguised column/field for object FRSAMP.CUSTOMER.

Now, assign the same associated rule to the MVS object FRSAMP.CONTACTT.

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                                                      
 S ’TSOID01.FRSAMP.CONTACTT’                    CUSTOMER_NUMBER                 
 _ ’TSOID01.FRSAMP.CUSTOMER’                    CONTACT-NAME, CUSTOMER-NUMBER   
 _ ’TSOID01.FRSAMP.PARTTABL’                                                    
 _ ’TSOID01.FRSAMP.SUPPLIER’                                                    
 ******************************* Bottom of data ********************************

To assign an associated rule:

In this field…

Do the following:

CMD

Type S in front of FRSAMP.CONTACTT.

Press Enter

File-AID/RDX displays the Data Disguise - Column/Field List screen where you select the column to be disguised using the existing associated rule.

Field Names and Descriptions

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

Selecting a 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.

This panel displays the object’s columns or fields and any disguise rules that are assigned to any of the columns/fields.

Now, add the associated rule you just defined.

Data Disguise - Column/Field List

 File-AID/RDX -------- Data Disguise - Column/Field List  --- Row 1 to 12 of 12
 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.CONTACTT                                       
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ CUSTOMER-NUMBER                 * CHAR(6)      R0000001 RELATED UNIQUE TRANSL
 _ CONTACT-ID                        CHAR(2)                                    
 A CONTACT-NAME                      CHAR(30)                                   
 _ CONTACT-TITLE                     CHAR(30)                                   
 _ CONTACT-CODE                      CHAR(4)                                    
 _ ADDRESS                           CHAR(30)                                   
 _ CITY                              CHAR(25)                                   
 _ STATE                             CHAR(2)                                   
 _ ZIP-CODE                          CHAR(9)                                    
 _ COUNTRY                           CHAR(20)                                   
 _ AREA-CODE                         CHAR(3)                                    
 _ TELEPHONE-NUM                     CHAR(7)                                    
 ******************************* Bottom of data ********************************
 .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

To add an associated rule for the 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.

Selecting an Associated Rule

When you select an object in the Data Disguise Column/Field List with the A line command, File-AID/RDX displays the Associated Rules Window.

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.

As you just created an associated rule, it is listed and can be assign to another column where you want the same disguise criteria to be used.

Associated Rules Window

image2022-1-18_11-39-27.png

To assign an existing associated rule for column CONTACT-NAME:

In this field…

Do the following:

Line Command

Type S in front of rule A0000001.

Press Enter

File-AID/RDX displays the Data Disguise - Column/Field List screen with the associated rule now assigned.

Field Names and Descriptions

Refer to Field Names and Descriptions for a description of the fields on this screen.

Reviewing Assignment of Associated Rule

When you select an associated rule in the Associated Rules Window with the S line command, File-AID/RDX returns to the Data Disguise - Column/Field List with the associated rule now assigned.

Data Disguise - Column/Field List

 File-AID/RDX -------- Data Disguise - Column/Field Li----------- Rule assigned
 Command ===> END                                              Scroll ===> CSR  
                                                                               
 Primary Commands: Find, Size, SOrt                                             
    Line Commands: S = Select  A = Add/Assign rule  U =Unassign rule  I = Info  
                                                                               
 Disguise Object: TSOID01.FRSAMP.CONTACTT                                       
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ CUSTOMER-NUMBER                 * CHAR(6)      R0000001 RELATED UNIQUE TRANSL
 _ CONTACT-ID                        CHAR(2)                                    
 _ CONTACT-NAME                      CHAR(30)     A0000001 ASSOCIATED CONTACT-NA
 _ CONTACT-TITLE                     CHAR(30)                                   
 _ CONTACT-CODE                      CHAR(4)                                    
 _ ADDRESS                           CHAR(30)                                   
 _ CITY                              CHAR(25)                                   
 _ STATE                             CHAR(2)                                    
 _ ZIP-CODE                          CHAR(9)                                    
 _ COUNTRY                           CHAR(20)                                   
 _ AREA-CODE                         CHAR(3)                                    
 _ TELEPHONE-NUM                     CHAR(7)                                    
 ******************************* Bottom of data ********************************

To return to the Data Disguise Object List:

In this field…

Do the following:

Command

Type END.

Press Enter

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

Field Names and Descriptions

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

Specifying an Associated Rule to More Objects

Upon returning to the Data Disguise - Object List you can see that File-AID/RDX has added CONTACT-NAME to the list of disguised columns for FRSAMP.CONTACTT.

Now, assign the same associated rule to the Db2 objects FRSAMP.CUSTOMER_TABLE and FRSAMP.CONTACT_TABLE so that their contact name data is disguised using the same criteria.

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       +
   -------------------------------------------- --------------------------------
 S FRSAMP.CONTACT_TABLE                         CUSTOMER_NUMBER   
 S FRSAMP.CUSTOMER_TABLE                        CUSTOMER_NUMBER   
 _ FRSAMP.ORDER_LINE_TABLE                                                    
 _ FRSAMP.ORDER_TABLE                           CUST_NUM                        
 _ FRSAMP.PART_TABLE                                                          
 _ FRSAMP.SUPPLIER_TABLE                                                      
 _ ’TSOID01.FRSAMP.CONTACTT’                    CONTACT-NAME, CUSTOMER-NUMBER   
 _ ’TSOID01.FRSAMP.CUSTOMER’                    CONTACT-NAME, CUSTOMER-NUMBER  
 _ ’TSOID01.FRSAMP.PARTTABL’                                                    
 _ ’TSOID01.FRSAMP.SUPPLIER’                                                    
 ******************************* Bottom of data ********************************

To select multiple objects for data disguise:

In this field…

Do the following:

CMD

Type S in front of FRSAMP.CONTACT_TABLE.

CMD

Type S in front of FRSAMP.CUSTOMER_TABLE.

Press Enter

File-AID/RDX displays the Data Disguise - Column/Field List screen for the first selected object. Follow the same procedures as for assigning the rule for FRSAMP.CONTACTT. When finished you will return to Data Disguise - Object List.

Field Names and Descriptions

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

 

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