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 14—Specifying unrelated disguise criteria


The File-AID/Data Solutions Criteria Menu screen is displayed when you select a column for data disguise in the Data Disguise - Column/Field List.

As the selected column is an unrelated column, you enter the Criteria Menu in Unrelated Mode. Unrelated criteria can be defined for one or more of the unrelated or not associated columns/fields.

File-AID/Data Solutions Criteria Menu

 File-AID/Data Solutions ---------- Criteria Menu --- TSOI -CREATE NEW CRITERIA
 OPTION ===> 1                                                                  
                                                                               
     G   GLOBAL                 - GLOBAL Fields                   0 fields      
     1   DATE AGING             - Aging criteria                  0 sets        
     4   TRANSLATOR             - Data Translator criteria        0 sets        
     5.1 GENERATOR              - Data Generator criteria         0 sets        
     5.2 PATTERN                - Pattern Data Generation         0 sets        
     6   FIELD EXITS            - Utilities criteria              0 sets        
     7   DATA ENCRYPTION        - Data Encryption Criteria        0 sets        
     8   REPLACE                - Data Replace Criteria           0 sets



 Disguise Object. : FRSAMP.PART_TABLE                                           
                                                                               
   Unrelated rule.: U0000001                                                    
   Description ===> UNRELATED DATE AGER FRSAMP.PART_TABLE                       
                                                                               
                                                                               
Commands: VIEW, SAVE, END, CANCEL, MENU

To define unrelated disguise criteria:

In this field…

Do the following:

Option

Type 1 to select the Date Aging disguise function.

Description

Type UNRELATED DATE AGER FRSAMP.PART_TABLE to identify that this unrelated disguise rule uses the unique translate function.

Press Enter

BMC Compuware File-AID/Data Solutions displays the Aging Criteria screen.

Field Names and Descriptions

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

Specifying Date Aging Criteria

File-AID/RDX displays the Aging Criteria screen when you select option 1, DATE AGING, in the File-AID/Data Solutions Criteria Menu.

It enables you to enter criteria to be used during the date aging process.

Unrelated criteria can be defined for one or more of the unrelated or not associated columns/fields. You receive the message “Field modification not allowed by RDX” if you attempt to replace a column/field that is not available for unrelated criteria.

To specify a formatted aging criterion, choose a date field and enter the relational operator, a numeric value in the century, year, month, and/or days field, and the appropriate date pattern. Leave the fields blank for fields not involved in the aging criteria.

For more detailed information on how to use the Aging Criteria function, see File-AID/Data Solutions User Reference.

Aging Criteria

 Action  Sets  Display  Show  Options  Menu  Help                             
 -------------------------------------------------------------------------------
 File-AID/Data Solutions ------- Aging Criteria ------------ UNRELATED DISGUISE
 COMMAND ===>                                                  SCROLL ===> CSR  
 RULES   ===> USA       ("*" or pattern for member list)                        
 SET  1 OF  1           PART_TABLE-TBL                           GBL = N SEL = N
 ---- FIELD LEVEL/NAME ------- -FORMAT- RO -C- -Y- -M- --D-- --DATE PATTERN-- R
 ******************************* TOP OF DATA ***********************************
 5 NULL-INDICATORS              14/AN                                           
 5 PART_NUMBER                   6/AN                                           
 5 PART_NAME                    25/AN                                           
 5 EFFECT_DATE                  10/AN   -  2   7   6   5                       Y
 5 EQUIVALENT_PART               6/AN                                           
 5 PURCH_PRICE                   5/PS                                           
 5 SETUP_COST                    5/PS                                           
 5 LABOR_COST                    5/PS                                           
 5 UNIT_OF_MEASURE               2/AN                                           
 5 MATERIAL_COST                 5/PS                                           
 5 REWORK_COST                   5/PS                                           
 5 AVAILABILITY_IND              1/AN                                           
 5 ENGR_DRAW_NUM                 6/AN                                           
 ***************************** BOTTOM OF DATA **********************************
 Valid RO: +, -, R, FM - For list of patterns,leave PATTERN blank.
 Commands: SELect, View

To define data disguise criteria for FRSAMP.PART_TABLE:

In this field…

Do the following:

RULES

Type USA to select the USA holidays from the DASAMP Business Rules or select the member applicable for your installation.

RO

Type - (minus sign) as the relational operator for column EFFECT_DATE.

C

Type to subtract 2 from the century value.

Y

Type to subtract 7 from the year value.

M

Type to subtract 6 from the month value.

D

Type to subtract 5 from the day value.

R

Type to specify using the business rules.

Press Enter

BMC Compuware File-AID/Data Solutions displays the Available Date Patterns window.

Field Names and Descriptions

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

FIELD

DESCRIPTION

RULES

Member name containing business date rules.

SET

Identifies the set of criteria displayed.

01 LEVEL NAME

Name of the record file structure from layout.

GBL

Specifies whether one or more global fields have been attached to this set of criteria (N or Y).

SEL

Displays whether selection criteria has been attached to this set of criteria (NO or YES).

FIELD LEVEL/NAME

Name of the field from layout.

FORMAT

Length and type of field.

RO






Specify a relational operator. Possible values are:

+

Add to date (default).

-

Subtract from date.

R

Replace with the specified new date.

=

Replicates last entered criteria.

FM

Field mask. See “Field Mask” in the File-AID/Data Solutions User Reference Manual for more information.

-C-

Century. Specify up to three numeric digits. When processing date formats without a century (2-digit year), you may override the default pivot year value, 60, by entering a value in the -C- (Century) field.

-Y-

Year. Specify up to three (3) numeric digits.

-M-

Month. Specify up to three (3) numeric digits.

-D-

Day. Specify up to five numeric (5) digits.

DATE PATTERN

Specify the date pattern exit to call for this field. The date pattern exit converts this date into a standard date format used in BMC Compuware File-AID/Data Solutions processing. If this field is left blank when a relational operator (RO) is specified, Data Solutions displays the Available Date Patterns screen from which you choose the appropriate pattern.

R

Apply business rules field. Specify Y (Yes) to use business rules.
The default is N (No).
When the RO = R (Replace) and R = Y (Yes), Data Solutions displays an error message.

Primary Commands

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

COMMAND

DESCRIPTION

ALIGN (AL)

Controls display of ALIGNED/UNALIGNED term for PL/I data.

ARRAY (AR)

Controls display of array declaration information for PL/I data.

BACK

Positions the display to the previous criteria. Synonym for LEFT.

CANCEL (CAN)

Returns to Criteria Menu without saving current updates.

CHANGE 
(CHG or C)

Switch from the Selection Criteria to the Change Criteria panels. This command is only valid on the Record Layout Selection Criteria and Global Selection Criteria panels.

COMPLEX (CM)

Controls display of COMPLEX terms for PL/I data.

DELETE (DEL)

Deletes a criteria set (change and associated selection criteria).

DISPLAY (DIS)

Specifies a display format.

DOWN

Scrolls down.

END

Ends display of the formatted criteria screen and displays the Criteria Menu.

FILLER (FILL)

Controls display of FILLER fields.

FORWARD (FWD)

Positions the display to the next criteria. Synonym for RIGHT.

GLOBAL (GBL)

Displays the GLOBAL Change Criteria panel which shows the defined global fields (variables). Use this panel to create criteria which will test values of global fields. Valid only if a global field has been defined.

On the GLOBAL Change Criteria panel, you enter change criteria in the same way you enter change criteria on the record layout; the normal relational operators are available to operate against the global variables.

GROUP (G)

Controls the display of occurrences of group-level items.

IMPORT

Import an existing layout.

INPUT/ INSERT (I)

Inputs/inserts a new criteria set.

LEFT

Positions the display to the previous criteria. Synonym for BACK.

LOCATE (L)

Scrolls directly to the specified record layout line.

LR (Locate Record)

Positions the display to the specified criteria number.

MESSAGE (MSG)

Controls the message display.

OCCURS (OCC)

Controls the display of array declaration items.

OFFSET (OFST)

Displays field offsets.

PICTURE (PIC)

Controls the display of the PICTURE or DISPLAY line for numeric data.

PROFILE (PROF)

Displays profile information lines.

RECORD (REC)

Closes the Global Change or Global Selection Criteria panel and returns to the Formatted Selection or Change Criteria panel. Only valid on the Global Selection Criteria or Global Change Criteria panels.

REDEFINE (RED)

Controls the display of data item redefinitions.

REFLNG (REF)

Controls the display of BIT/CHAR REFER field length reference lines for PL/I data.

REPEAT (R)

Causes a criteria set (formatted change and selection) to be repeated.

RESET (RES)

Causes excluded lines to be redisplayed.

RETURN

Returns to the File-AID/RDX Primary Option Menu.

RIGHT

Positions the display to the next criteria. Synonym for FORWARD.

SELECT (SEL)

Displays the Formatted Selection Criteria screen.

SHOW (S)

Displays LEVEL, NUMBER, FORMAT, OFFSET, or PICTURE information for the selection fields.

SYNC

Controls the display of the SYNC term for fields in a COBOL record layout.

UP

Scrolls up.

VIEW (V)

Displays the View Criteria screen which is a keyword summary of the current settings for formatted change and selection criteria.

ZERO (Z)

Controls the display of leading zeros in the numeric data fields.

Line Commands

There are no line commands available from this screen.

Selecting a Date Pattern

BMC Compuware File-AID/Data Solutions displays the Available Date Patterns screen when you don’t enter a date pattern in the Available Date Patterns column for the selected column/field to be changed.

BMC Compuware File-AID/Data Solutions is packaged with more than 50 common date patterns. For any dates that cannot be handled by the supplied date pattern exits, you may add your own date pattern exits. See “Creating Your Own Date Pattern Exits” in the File-AID/Data Solutions User Reference Manual for information on adding your own date pattern exit.

Available Date Patterns

image2022-1-18_12-9-50.png

To select a date pattern:

In this field…

Do the following:

Line Command

Type S in front of the CCYY*MM*DD date pattern.

Press Enter

BMC Compuware File-AID/Data Solutions redisplays the Aging Criteria screen.

Field Names and Descriptions

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

FIELD

DESCRIPTION

Date Pattern

Identifies the date pattern layout.

Data Type

Identifies the data type: B (Binary), C (Character), N (Numeric), or P (Packed).

Description

Description for the date pattern.

Module

Specifies the load module name of the exit (AGER1000 - 9999).

Reviewing Date Aging Criteria

File-AID/RDX displays the Aging Criteria screen after you selected the date pattern for the date column.

Aging Criteria

 Action  Sets  Display  Show  Options  Menu  Help                             
 -------------------------------------------------------------------------------
 File-AID/Data Solutions ------- Aging Criteria ------------ UNRELATED DISGUISE
 COMMAND ===> END                                              SCROLL ===> CSR  
 RULES   ===> USA       ("*" or pattern for member list)                        
 SET  1 OF  1           PART_TABLE-TBL                           GBL = N SEL = N
 ---- FIELD LEVEL/NAME ------- -FORMAT- RO -C- -Y- -M- --D-- --DATE PATTERN-- R
 ******************************* TOP OF DATA ***********************************
 5 NULL-INDICATORS              14/AN                                           
 5 PART_NUMBER                   6/AN                                           
 5 PART_NAME                    25/AN                                           
 5 EFFECT_DATE                  10/AN   -  2   7   6   5      CCYY*MM*DD       Y
 5 EQUIVALENT_PART               6/AN                                           
 5 PURCH_PRICE                   5/PS                                           
 5 SETUP_COST                    5/PS                                           
 5 LABOR_COST                    5/PS                                           
 5 UNIT_OF_MEASURE               2/AN                                           
 5 MATERIAL_COST                 5/PS                                           
 5 REWORK_COST                   5/PS                                           
 5 AVAILABILITY_IND              1/AN                                           
 5 ENGR_DRAW_NUM                 6/AN                                           
 ***************************** BOTTOM OF DATA **********************************
 Valid RO: +, -, R, FM - For list of patterns,leave PATTERN blank.
 Commands: SELect, View 

To exit the Aging Criteria screen:

In this field…

Do the following:

COMMAND

Type END to exit the Aging Criteria panel.

Press Enter

BMC Compuware File-AID/Data Solutions returns to the File-AID/Data Solutions Criteria Menu.

Field Names and Descriptions

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

Reviewing the Unrelated Disguise Criteria

The File-AID/Data Solutions Criteria Menu screen when you return from specifying the aging criteria.

This screen provides an overview of how many sets of disguise criteria have been defined for the current, unrelated column. In this example you can see that only 1 set of Date Aging criteria has been defined.

You can issue the VIEW primary command to view the internal format of your criteria.

File-AID/Data Solutions Criteria Menu

 File-AID/Data Solutions ---------- Criteria Menu --- TSOID01.FRSAMP.DISCRIT --
 OPTION ===> END                                                                

     G   GLOBAL                 - GLOBAL Fields                   0 fields      
     1   DATE AGING             - Aging criteria                  1 sets        
     4   TRANSLATOR             - Data Translator criteria        0 sets        
     5.1 GENERATOR              - Data Generator criteria         0 sets        
     5.2 PATTERN                - Pattern Data Generation         0 sets        
     6   FIELD EXITS            - Utilities criteria              0 sets        
     7   DATA ENCRYPTION        - Data Encryption Criteria        0 sets        
     8   REPLACE                - Data Replace Criteria           0 sets




 Disguise Object. : FRSAMP.PART_TABLE                                           
                                                                               
   Unrelated rule.: U0000001                                                    
   Description ===> UNRELATED DATE AGER FRSAMP.PART_TABLE                       
                                                                               
                                                                               
Commands: VIEW, SAVE, END, CANCEL, MENU

To end specifying unrelated disguise criteria:

In this field…

Do the following:

Option

Type the END primary command.

Press Enter

BMC Compuware File-AID/Data Solutions saves the specified criteria with the rule name as a member name in the File-AID/Data Solutions Criteria file you specified in the File-AID/Data Solutions Parameters screen. This ends the call to BMC Compuware File-AID/Data Solutions and returns control back to File-AID/RDX which displays the Data Disguise - Column/Field List.

Field Names and Descriptions

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

Reviewing Information for Unrelated Disguise

When you return from the File-AID/Data Solutions Criteria Menu after specifying disguise criteria for an unrelated column/field, File-AID/RDX displays the following Data Disguise - Column/Field List.

This panel now displays the object’s columns/fields and the disguise rules that are assigned to any of them, in this exercise the unrelated rule you just created.

Use the line command to view unrelated disguise information.

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: FRSAMP.PART_TABLE                                             
                                                                               
   Column/Field Name                 Type(Length) Disguise Rule                +
   --------------------------------- ------------ ------------------------------
 _ PART_NUMBER                     * CHAR(6)                                    
 _ PART_NAME                         CHAR(25)                                   
 I EFFECT_DATE                       DATE         U0000001 UNRELATED DATE AGER F
 _ EQUIVALENT_PART                   CHAR(6)                                    
 _ PURCH_PRICE                       DEC(9,2)                                   
 _ SETUP_COST                        DEC(9,2) 

To review the data disguise information for column EFFECT_DATE:

In this field…

Do the following:

Line Command

Type I in front of the EFFECT_DATE column.

Press Enter

File-AID/RDX displays the  Unrelated Columns/Fields screen.

Field Names and Descriptions

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

Reviewing Information for Unrelated Disguise

When you enter the I line command in the Data Disguise - Column/Field List for an unrelated column/field, File-AID/RDX displays the  Unrelated Columns/Fields  window.

This window displays the unrelated rule and the name of the Disguise Criteria File for the object’s columns/fields that the rule applies to.

Unrelated Columns/Fields

image2022-1-18_12-13-41.png

To close the Unrelated Columns/Fields Window:

In this field…

Do the following:

Command

Type END to exit the Informational display for the unrelated rule.

Press Enter

File-AID/RDX redisplays the Data Disguise - Column/Field List screen where you entered the I line command.

To return to the Data Disguise - Object List:

In this field…

Do the following:

Command

Type END to exit the Data Disguise - Column/Field List.

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.


 

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