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.

Data disguise - column list


The Data Disguise - Column/Field List screen shown in 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.

Use the available line commands to manage the disguise information for the column.

Data Disguise - Column/Field List

 File-AID/RDX ---------  Data Disguise - Column/Field List  --- Row 1 to 9 of 9
 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_LINE_TABLE                                   
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ ORDER_NUM                       * CHAR(6)                                   
 _ ORDER_LINE_NUMBER                 DEC(5,0)                                   
 _ PART_NUM                        * CHAR(6)                                    
 _ PLAN_QTY                          DEC(7,2)                                   
 _ UNITS_COMPLETE                    INTEGER                                    
 _ UNITS_STARTED                     DEC(9,3)                                   
 _ SCRAP_QTY                         DEC(9,3)                                   
 _ START_DATE                        DATE         U0000002 UNRELATED FRSAMP.ORDE
 _ LINE_STATUS                       CHAR(6)                                    
 ******************************* Bottom of data ********************************

After you completed 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 name of the columns/fields of the object. An asterisk (*) to the right of the column name indicates a related column.

Important

NULL values will remain NULL even when disguise criteria are applied to the field. The NULL indicator is not changed so the column will be considered NULL at load time: the disguised value will not be loaded.

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, CH, VCHAR, VC, GRPH, VGRPH, DEC, FIXPIC, National data types only.

Unicode Db2 character data types are identified as CH(x), VC(x) or LV(x) with a suffix of U16 or U-8. Unicode character data from an MVS file is identified as N(x) U-16.

For more information about data types displayed in this column, see Data Type Values.

Important

Column types CLOB, BLOB, DBCLOB, ROWID, DECFLOAT, BIGINT, BINARY, VARBINARY, XML, or Unicode data types cannot be selected for disguise.

Disguise Rule

Identifies the disguise rule and description assigned to the column/field. When the criteria is stored in a disguise criteria file, 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.

Line Commands

The following File-AID/RDX-specific line command is 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.

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. The following figure displays the information for unrelated columns/fields.

Unrelated Rules Information - Criteria in Disguise Criteria File

image2021-10-25_18-52-21.png

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 to BMC Compuware File-AID/Data Solutions in either Related, Associated, or Unrelated mode (see also File-AID/Data Solutions Criteria Menu).

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.

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 File-AID/RDX Solutions.

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/RDX-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 the following figure is displayed when you enter an A line command for a column in the Data Disguise - Column/Field List.

Associated rules are a special kind of criteria for unrelated fields. The criteria are always defined for a single field and will be stored separately by associated field. Other objects can share this type of criteria. The same field can exist in multiple objects even though the fields are not related. Associated rules allow the criteria to be defined once and applied to the other objects where the same data exists. You must manually identify the objects and fields that are to share the associated criteria with the A line command; File-AID/RDX does not provide automated identification assistance.

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.

BMC Compuware 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 must 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

image2021-10-25_18-52-52.png

After you selected an existing or defined and selected a new rule, press END to return to Data Disguise - Column/Field 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.

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

Type

Displays the column’s or field’s data type. For more information about data types displayed in this column, see Data Type Values.

Length

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

Line Commands

The following File-AID/RDX-specific line command is valid:

I (Info)

Displays the disguise information for the selected associated rule.

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.

Primary Commands

The following File-AID/RDX-specific primary commands are valid:

NEW

Allows you to define a new associated criteria rule for this column. When you press Enter, File-AID/RDX transfers control over to BMC Compuware File-AID/Data Solutions's 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 - Column List with the new rule assigned to the column.

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

 

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