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 18—Jumping to the extract function

Upon returning to the Data Disguise - Object List you can see that File-AID/RDX has added the two related objects to the list.

Because FRSAMP.ORDERTAB is related to column CUST_NUM of the FRSAMP ORDER_TABLE, the applicable related rules are automatically assigned. Thus, when you were to unexclude these two objects in another extract, FRSAMP.ORDERTAB would be disguised as well using the related rule.

Data Disguise - Object List

 File-AID/RDX -----------  Data Disguise - Object List  ------- Object(s) added
 Command ===> =2                                           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                         CONTACT_NAME, CUSTOMER_NUMBER   
 _ FRSAMP.CUSTOMER_TABLE                        CONTACT_NAME, CUSTOMER_NUMBER   
 _ FRSAMP.ORDER_LINE_TABLE                                                    
 _ FRSAMP.ORDER_TABLE                           CUST_NUM, SOC_SEC_NUM, CREDIT_CA
 _ FRSAMP.PART_TABLE                            EFFECT_DATE                     
 _ FRSAMP.SUPPLIER_TABLE                                                      
 _ ’TSOID01.FRSAMP.CONTACTT’                    CONTACT-NAME, CUSTOMER-NUMBER   
 _ ’TSOID01.FRSAMP.CUSTOMER’                    CONTACT-NAME, CUSTOMER-NUMBER   
 _ ’TSOID01.FRSAMP.ORDERLIN’                                                    
 _ ’TSOID01.FRSAMP.ORDERTAB’                    CUST_NUM, SOC_SEC_NUM, CREDIT_CA
 _ ’TSOID01.FRSAMP.PARTTABL’                                                    
 _ ’TSOID01.FRSAMP.SUPPLIER’                                                    
 ******************************* Bottom of data ********************************

To jump to Extract Function:

In this field…

Do the following:

Command

Type =2 to exit the Data Disguise option and start the Extract option.

Press Enter

File-AID/RDX displays the Extract Reference List screen.

Field Names and Descriptions

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

Submitting Extract Request from the Extract Reference List

File-AID/RDX displays the Extract Reference List screen illustrated in the following figure when you select Option 2, Extract, from the File-AID/RDX Primary Option Menu and your Extract Reference List contains one or more entries.

Important

If your current profile specifies that the Request File Member List is the first panel when you select Option 2, Extract, simply enter the REF primary command to follow the steps in this exercise.

Now that you have created disguise criteria for the extract request you saved in Extract—With User Profile SAMPMENU, you can execute the extract with disguise request.

Important

If you already executed the extract request and retained the temporary and masked extract file, you don’t have to repeat the extract execution, but can repeat the disguise step with Option 5.2, DCF: Disguise Existing Extract File.

Extract Reference List

 File-AID/RDX -------------  Extract Reference List  ---------- Row 1 to 1 of 1  
 Command ===>                                                  Scroll ===> CSR   
                                                                                
 Primary Commands: New, Find, Size, Detail, REQuest                              
    Line Commands: G = Go   C = Change Selection & Go S = Select M = Modify  
                   I = Info D = Delete from list      L = Lock   U = Unlock      
                                                                                
   Request  Extract File Name                                      RT L YY/MM/DD
   -------- ------------------------------------------------------ -- - --------
 G EXTMENU  TSOID01.FRSAMP.EXTMENU                                 E    09/03/07
 ******************************* Bottom of data ********************************

To submit the extract request:

In this field…

Do the following:

Line Command

Type G to submit the extract request.

Press Enter

File-AID/RDX submits the extract request. It will extract and disguise the data and save it in the extract file FRSAMP.EXTMENU. The temporary and masked extract file will be retained as specified in the extract request so you could reuse it as the input extract file with for Option 5.2, Disguise Existing Extract File, after you made additional changes to your disguise criteria.

In this field…

Do the following:

Command

Type END

Press Enter

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

Once the extract job has completed, you can use the extract file to load the extracted data to target objects.

Field Names and Descriptions

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

FIELD

DESCRIPTION

Request

Name of the extract request (member name in the saved extract request file or extract criteria file). A blank entry means the request was saved to a sequential file.

Extract File Name

Name of the file containing the extracted data. If saved to a PDS the member name is displayed in parentheses).

RT

Request Type. Identifies the extract request type:

E

Extract only request.

EL

Extract and Continue with Load request.

L

Locked Entry. Identifies whether the request is locked in the reference list or whether it is allowed to roll off.

blank

not protected from roll over.

L

Locked in reference list; entry will not roll off the list.

YY/MM/DD

Date when the extract request was last saved or executed. The list entries are ordered with the most recent date placed on top of the list.

Primary Commands

The following File-AID/RDX-specific primary commands are available on this screen.

COMMAND

DESCRIPTION

DETAIL (D)

Expands the one line display for each entry into a two line display. The additional line shows the request description. Detail is a toggle switch; enter Detail again to return to the original format.

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.

Find looks for matches in the request detail information for each list entry. When a match is found and is not visible in the displayed row, use the I (info) line command to display the detail information.

NEW (N)

Starts a new extract request based on your current profile. File-AID/RDX displays either the DB2 or MVS Driving Object screen as set in your profile.

REQUEST (REQ)

Opens a saved extract request file. You also use the REQuest command to open extract criteria files created with File-AID/RDX prior to Release 3.0.

SIZE (S)

Increases the scrollable area to display more entries by hiding some of the screen header lines. Size is a toggle switch so enter Size again to return to the original format.

Line Commands

The following File-AID/RDX-specific line commands are valid on this screen:

COMMAND

DESCRIPTION

C (Change selection criteria & Go)

Repeats this extract request with new selection criteria for the driving object. File-AID/RDX then displays the Driving Object Selection Criteria screen. After you specified the new selection criteria, File-AID/RDX will immediately submit the extract request.

D (Delete from list)

Removes this extract request from the extract reference list, but does not delete the member from the extract request file itself.

G (Go)

Submits this extract request without any changes.

I (Info)

Displays the “Request Details” screen, which provides more comprehensive information about the extract request.

L (Lock)

Protects this entry from rolling off the extract reference list.

M (Modify)

Selects this extract request, displays the “Modify Extract Request” panel for you to change or “clone” an existing extract request.

S (Select)

Selects this extract request and displays the Extract Menu prefilled with all the information from this request.

Related topics

Primary-commands-description

Line-commands-description

 

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