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 menu

Selecting Option 8, Data Privacy, from the File-AID for IMS Primary Option Menu displays the Data Disguise Menu as shown in the following figure.

Privacy

Select Option P, Privacy when you want to disguise an existing Extract File with Dynamic Privacy Rules (DPR) that were created with the Data Studio’s Data Privacy component of the Topaz Workbench.

Data Disguise with DCF Options

Use Options 1 through 6 when you intend to use the mainframe only disguise criteria options.

Start with defining the disguise criteria for the objects containing sensitive data that you intend to extract.

You can also disguise existing extracts which were created with this or earlier releases of File-AID for IMS using the disguise information stored in the Disguise Control File (DCF).

Important

Prior to using disguise criteria, you must specify the names of your Data Disguise Control File and Data Disguise Criteria File. If you need to create the Disguise Criteria File, you can use Option 8.5, Criteria to allocate the file. Option 8.4, Control can be used to allocate the Disguise Control File. You then specify the DSN of your Disguise Control File on the Data Disguise Menu (Option 8). You specify the DSN you will use as your Disguise Criteria File in Option 8.3, Parms. You must designate these file names before you can create (Option 8.1) or use (Option 8.2) disguise criteria. Option 8.3 also allows you to designate a Business Rules Dataset, if your disguise criteria will require definitions of business rules.

Audit Trail Options

Select Option A, Print Audit when you want to print the audit trail information created when you disguised an Extract File with either Dynamic Privacy Rules (DPR) or mainframe Disguise Control File (DCF).

Data Disguise Menu

 File-AID for IMS ----------------- Data Disguise Menu  -----------------------
 Option ===>                                                   
 ENV: TEST - IMS ENVIRONMENT
                                                                   
    P  Privacy        - DPR: Disguise Existing Extract File     
                                                                
  Data Disguise with DCF Options:                               
  Disguise Control File ===> TSOID01.DISGUISE.CONTROL           
    1  Criteria       - Create and Modify DCF Disguise Criteria
    2  Disguise       - DCF: Disguise Existing Extract File     
    3  Parms          - File-AID/Data Solutions Parameters      
    4  Control        - Allocate Disguise Control File          
    5  Criteria       - Allocate Disguise Criteria File         
    6  Print Control  - Print Disguise Control File             
                                                                
  Audit Trail Options:                                          
    A  Print Audit    - Print Disguise Audit Trail

Privacy

P - Privacy

Select this option to disguise an existing extract file by applying the Dynamic Privacy Rules (disguise criteria rules) as defined in a DPR: Dynamic Privacy Rules Project that was created with the Data Studio’s Data Privacycomponent of the Topaz Workbench.

This option requires installation of BMC’s File-AID/Data Solutions and the Data Studio’s Data Privacy component of the Topaz Workbench.

Before submitting a disguise request with the DPR data privacy option, make sure that you have access to the DPR repository where the disguise criteria (Dynamic Privacy Rules) were defined using Data Studio’s Data Privacy.

File-AID for IMS displays the Disguise Extract File panel DCF Disguise Existing Extract File.

Data Disguise with DCF Menu Options

The Data Disguise Menu contains one input field:

Disguise Control File

Specify the name of your Disguise Control File (DCF). File-AID for IMS uses the information from the Control File to apply disguise criteria when disguising an extract.

If the file does not exist, use Option 4, Control from the Data Disguise Menu to allocate a new file.

Enter the option number (1-6) to select the desired mainframe disguise option.

1 - Criteria

Select this option when you want to define or modify disguise criteria for objects to be extracted and disguised. Creating a list of objects is always the first step in creating or modifying disguise criteria. Use of the object list as the starting point for criteria creation is based on thinking that criteria will be created for a specific set of objects and the list of these objects is the point of control for guiding the process.

Important

Before selecting this option make sure that you have set the correct File-AID/Data Solutions parameters with Option 3, Parms, and that the Disguise Control and Disguise Criteria files already exist. To allocate new Disguise Control and Disguise Criteria files, use the utilities for Data Disguise, options 4 (8.4) and 5 (8.5).

2 - Disguise

Select this option to disguise an existing extract file by applying the disguise criteria rules as defined in the DCF: Disguise Control File. File-AID for IMS displays the Disguise Extract File panel DCF Disguise Existing Extract File.

This option also allows you to disguise extract files that were created with the current or earlier release of File-AID for IMS. The extract file must not be compressed, but can be a retained extract file.

Before submitting a disguise request with the DCF data disguise option, you must have defined the disguise criteria using Option 8, Data Disguise (see Option 1 - Create and Modify Disguise Criteria).

It is possible to use a Disguise Control File with different Relationship Files as long as the set of related objects being disguised has not changed. If there have been changes to the set of related objects, the disguise rules will not be applied to any added relationships. No error checking for such changes will be done at disguise execution time.

3 - Parms

Select this option to specify File-AID/Data Solutions parameters that File-AID for IMS uses to connect to File-AID/Data Solutions including:


    • The Disguise Criteria File where File-AID/Data Solutions will store the actual disguise criteria (necessary).
    • The Business Rules dataset File-AID/Data Solutions uses when operating on date fields; it can also be used by field exits (optional, only necessary when applying business rules).

4 - Control

Displays the Allocate Disguise Control File screen where you can allocate a new Disguise Control File (DCF). The File-AID for IMS Disguise Control File is required for the data disguise function. It is the repository that links disguise criteria with objects.

5 - Criteria

Displays the Allocate Disguise Criteria File screen where you can allocate a new Disguise Criteria File. This file is the repository for detailed disguise criteria.

6 - Print Control

Displays the Print Disguise Control File screen which you can use to print the contents of the disguise control file.

Audit Trail Options

A - Print Audit

Displays the Print Disguise Audit Trail menu which you can use to print the disguise audit trail information.

 

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