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. | |
Step 11—Creating associated criteria
The File-AID/Data Solutions Criteria Menu screen is displayed when you enter the NEW command in the Associated Rules Window.
Here you select the desired disguise option(s) and identify the associated rule with a meaningful description as you can change the generated name to a more descriptive associated rule name.
As you are creating an associated rule, you enter the Criteria Menu in Associated Mode.
For this exercise you disguise the contact name in the CUSTOMER file.
File-AID/Data Solutions Criteria Menu
OPTION ===> 4
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. : TSOID01.FRSAMP.CUSTOMER
Column. . . . .: CONTACT-NAME
Associated rule: A0000001
Description ===> ASSOCIATED CONTACT-NAME:TSOID01.FRSAMP.CUSTOMER
Commands: VIEW, SAVE, END, CANCEL, MENU
To define associated disguise criteria using data translator criteria: | |
|---|---|
In this field… | Do the following: |
Option | Type 4 to select the Translator disguise function. |
Press Enter | The Data Translator Criteria panels displays. |
Field Names and Descriptions
For a description of the fields on this screen, see Field Names and Descriptions.
The following list describes the fields for Associated Mode as they differ from Related Mode:
FIELD | DESCRIPTION |
|---|---|
Disguise Object | Identifies the name of the object you selected in the “Data Disguise - Object List”. |
Column | Identifies the name of the column/field of the object you selected in the Data Disguise - Column/Field List. For a related rule, you can apply disguise criteria only on one column/field. |
Associated rule | Identifies the disguise rule member name. When creating a new rule File-AID/RDX assigns a unique name (Annnnnnn) in the current disguise criteria file. You can change the generated name to a more descriptive associated rule name. |
Description | Displays the disguise rule description as entered during the disguise creation. By default, it includes the word ASSOCIATED for associated mode, followed by the related column/field and object name. You can change the generated description to better reflect your disguise criteria |
Specifying Data Translator Criteria
The Data Translator Criteria screen displays when you select option 4, TRANSLATOR in the File-AID/Data Solutions Criteria Menu. It allows you to convert data.
When you first access this screen the message ASSOCIATED DISGUISE reminds you that you are defining criteria in associated mode.
In associated mode, only the selected column is displayed.
Data Translator Criteria
-------------------------------------------------------------------------------
File-AID/Data Solutions ------- Data Translator Crite ASSOCIATED DISGUISE
COMMAND ===> SCROLL ===> CSR
TABLE DATASET ===> FRSAMP.TRANSLAT(LASTNAME)
SET 1 OF 1 PROD001-CUSTOMER-TABLE GBL = N SEL = N
---- FIELD LEVEL/NAME ------- -FORMAT- RO --------- PARAMETERS ---------------+
******************************* TOP OF DATA ***********************************
10 CONTACT-NAME 30/AN DR
***************************** BOTTOM OF DATA **********************************
Valid RO: S = Search, K = Key, D = Direct pointer, H = Hash to key, U = Unique
R = Result, SR, KR, DR, HR, UR (for both), EP, FM
Commands: SELect, View
To define data translator criteria for FRSAMP.CUSTOMER_TABLE: | |
|---|---|
In this field… | Do the following: |
TABLE DATASET | Type FRSAMP.TRANSLAT(LASTNAME) to point to the sample translate table for customer names. |
RO | Type DR as the relational operator for column CONTACT-NAME. |
Press Enter | BMC Compuware File-AID/Data Solutions displays the Direct Pointer/Result Field Parameters screen. |
Field Names and Descriptions
For a description of the fields on this screen, see Field Names and Descriptions.
Specifying Direct Pointer/Result Field Parameters
BMC Compuware File-AID/Data Solutions displays the Direct Pointer/Result Field Parameters screen when you enter the DR relational operator for the associated field.
It enables you to enter parameters to be used by the hashing routine and use the hashed value as a direct pointer to a row in the translate table during data search. The result data is obtained from the translate table and replaces the specified output field value.
Direct Pointer/Result Field Parameters
To specify the direct pointer result field parameters: | |
|---|---|
In this field… | Do the following: |
Location | Type 1. |
CMD | Type END. |
Press Enter | BMC Compuware File-AID/Data Solutions redisplays the File-AID/Data Solutions Criteria Menu screen. |
Field Names and Descriptions
The following list describes all of the fields on this screen.
FIELD | DESCRIPTION |
|---|---|
Field Name | Name of selected field as defined by the record layout. |
Data Type | Data type of selected field as defined by the record layout. |
Length | Length of data in selected field as defined by the record layout. This field may be overtyped to shorten or lengthen the length of data replaced. This is particularly useful when you want to replace all the elements of a group item. |
Location | Location of the replacement data in the translate table. |
Data Type | Type of data at the specified location in the translate data set. Valid entries are: CHAR (Character), VCHR (Variable length Character), NUM (Numeric), BIN (Binary), HEX (Hexadecimal), PS (Packed Signed), DBCS (Double Byte Character Set) or VDBC (Variable length Double Byte Character Set). This data type does not have to match the field's data type as defined by the record layout. If the two data types are different, Data Solutions converts the replacement data type to the data type specified in the record layout. |
Length | Length of data in translate table. If this length is greater than the length defined in the record layout, then truncation occurs. |
Primary Commands
The following list identifies the primary commands that are available from this screen.
COMMAND | DESCRIPTION |
|---|---|
CANCEL (CAN) | Discards the entries and returns to the Translator Criteria screen. |
END | Saves the entered parameters and returns to the Translator Criteria screen. |
Line Commands
There are no line commands available from this screen.
Reviewing Data Translator Criteria
After specifying the Direct Pointer/Result Field Parameters, the Data Translator Criteria screen displays again with the parameters filled in.
Review the entered criteria. You could enter additional sets of criteria (using the INPUT or INSERT command), but for this exercise the criteria definition is complete.
Data Translator Criteria
-------------------------------------------------------------------------------
File-AID/Data Solutions ------- Data Translator Criteria ----------------------
COMMAND ===> END SCROLL ===> CSR
TABLE DATASET ===> FRSAMP.TRANSLAT(LASTNAME)
SET 1 OF 1 PROD001-CUSTOMER-TABLE GBL = N SEL = N
---- FIELD LEVEL/NAME ------- -FORMAT- RO --------- PARAMETERS ---------------+
******************************* TOP OF DATA ***********************************
10 CONTACT-NAME 30/AN DR FLEN(00030);RLOC(00001);RLEN(00030);+
***************************** BOTTOM OF DATA **********************************
Valid RO: S = Search, K = Key, D = Direct pointer, H = Hash to key, U = Unique
R = Result, SR, KR, DR, HR, UR (for both), EP, FM
Commands: SELect, View
To save the criteria and exit the Data Translator Criteria screen: | |
|---|---|
In this field… | Do the following: |
COMMAND | Type END. |
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 fields on this screen, see Field Names and Descriptions.
Reviewing The Associated Criteria Set
The File-AID/Data Solutions Criteria Menu screen is displayed when you return from the Data Translator Criteria screen.
This screen provides an overview of how many sets of disguise criteria have been defined for the current, associated column. In this example you can see that only 1 set of Data Translator 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
OPTION ===> END
G GLOBAL - GLOBAL Fields 0 fields
1 DATE AGING - Aging criteria 0 sets
4 TRANSLATOR - Data Translator criteria 1 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. : TSOID01.FRSAMP.CUSTOMER
Column. . . . .: CONTACT-NAME
Related rule. .: A0000001
Description ===> ASSOCIATED CONTACT-NAME:TSOID01.FRSAMP.CUSTOMER
Commands: VIEW, SAVE, END, CANCEL, MENU
To end specifying associated 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 the Column/Field with an Associated Rule
Upon returning from defining the associated criteria, File-AID/RDX displays the Data Disguise - Column/Field List.
The associated rule is now assigned to the column/field you created it for.
Use the I line command to review the disguise information for each column/field.
Data Disguise - Column/Field List
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.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)
_ CONTACT-NAME CHAR(30) A0000001 ASSOCIATED CONTACT
_ CONTACT-TITLE CHAR(30)
_ CONTACT-ADDR CHAR(30)
_ CONTACT-CITY CHAR(25)
_ CONTACT-STATE CHAR(2)
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 which now shows that column CONTACT-NAME has the newly created associated rule assigned to it. |
Field Names and Descriptions
For a description of the fields on this screen, see Field Names and Descriptions.