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.

Task 5 Finalizing the configuration

This milestone will guide you through the tasks to update/refresh the CMSC with the PARMLIB member information for File-AID products.

Important

Roles involved for this milestone:

  • System Administrator
  • File-AID Installer

Tasks


Complete the following tasks to update the CMSC with each products’ PARMLIB information.

Important

We recommend to store your site’s File-AID PARMLIB members in a common library for BMC products.

Related topics

PARMLIB-members

File-AID-SVC

File-AID-RDX-Product-Configuration
BMC Compuware File-AID/MVS
BMC Compuware File-AID/Data Solutions
BMC Compuware File-AID/RDX
BMC Compuware File-AID for Db2
BMC Compuware File-AID for IMS

Task 5.1 Update CMSC with PARMLIB Information


Important

System Administrator involved for this task.

  1. Make your File-AID PARMLIB libraries available in the //CWPARM concatenation of the Compuware Mainframe Services Controller (CMSC) which is located in hlq.SLCXCNTL(CMSC). See the Installing ECC for Release 17.02 for further information on CMSC.

    Important

    • Ensure there is an entry for each File-AID product being used in the CMSC PARMLIB member.
    • Jobs and TSO sessions using File-AID should be restarted to reflect the change.

  2. After making changes to your PARMLIB members, use a JES viewer to issue a z/OS MODIFY command (abbreviated as F) to update the CMSC with the changes you made to the PARMLIB members.

    Important

    The MODIFY command requires proper OPERATOR authority.

    cmscname is the name of the CMSC started task or procname.

    Refresh a single PARMLIB member for a BMC product:   

       F  cmscname,PARMLIB REFRESH member_name

    For example, you updated the parameters in member FACM00:   

       F cmscname,PARMLIB REFRESH FACM00

  3. Verify that the parameters were updated by using a JES viewer and checking the CMSC address space’s FDBDLOG.

CMSC Address Space FDBDLOG
image2021-4-14_17-18-13.png

Task 5.2 Link Edit File-AID SVC/ESR

If your File-AID products use the SMF Audit option and don’t already have a File-AID SVC created with File-AID Release 10.2 or later, perform this task, otherwise skip this task.

Important

Roles involved for this task:

  • File-AID Installer

If you are configuring File-AID products to use SVC/ESR, see File-AID-SVC for instructions.

Task 5.3 Generate Customized Exits

If you use exits with your File-AID products, perform this task, otherwise skip this task.

Important

File-AID Installer involved for this task.

If you are configuring File-AID products to use customized exits, the following lists the available exits. For instructions on the available exit routines, see File-AID-product-exits.

  • Audit Trail Exit Samples and Proc JCL — File-AID/MVS, File-AID/Data Solutions, File-AID for Db2, File-AID for IMS
  • I/O Exit Samples and Proc JCL — File-AID/MVS, File-AID for Db2, File-AID for IMS
  • Security Exit Samples and Proc JCL — File-AID/MVS, BMC Compuware File-AID for IMS
  • Application Relationship Exits — File-AID for IMS
  • Segment Control Exit — File-AID for IMS
  • Date Pattern, Field Level, and Encryption Exits — File-AID/Data Solutions

Task 5.4 File-AID/RDX — Create Default SITE Profiles (XFRPROF)

If you don’t have a SITE Profile for File-AID/RDX, perform this task, otherwise skip this task.

Important

File-AID Installer is required for this task.

If you are configuring File-AID/RDX, determine if you need to complete this task:

  • If the SITE Profile you specified for parameter RDX_SITE_PROFILE_DSN in your FAFRnnnn PARMLIB member already exists, you may skip this task.
  • If the Profile data set does not exist, you must execute the XFRPROF job to allocate and initialize it.

To create the SITE Profile or replace the base profile members:

  1. Modify the JCL in hlq.SXVJSAMP member XFRPROF with site appropriate information.
  2. Submit the JCL as directed.


Important

After the 

File-AID/RDX

 customization has been completed, your site’s File-AID administrator should modify the SITE profiles using Option 0, Profile of the 

File-AID/RDX

 Primary Option Menu to site-specific settings and establish access authorities according to your site’s standards.

Task 5.5 File-AID for IMS — Allocate PSB Library

If you use File-AID for IMS, perform this task, otherwise skip this task.

Important

File-AID Installer is required for this task.

In order for File-AID for IMS to use dynamic PSB processing, use sample JCL (member XIXPPSB in hlq.SXVJSAMP).

  1. Modify this sample JCL to match your site’s ACB prefix and number of ACB names by following the instructions in the job.
  2. Submit the job.

Task 5.6 Add File-AID Libraries to APF Authorized Library List

After the configuration of all your File-AID products has been completed, the File-AID load libraries may have to be added to an APF authorized library list.


Important

File-AID Installer is required for this task.

Task 5.6.1 Add File-AID Libraries to APF Authorized Library List for Topaz Workbench Integration

If you set up File-AID for use with Topaz Workbench, perform this task, otherwise skip this task.

The hlq.SXVJAUTH and hlq.CXVJLOAD load libraries are required to support Topaz Workbench.

After completing the configuration, the hlq.SXVJAUTH and hlq.CXVJLOAD load libraries need only be APF Authorized in order for them to be ready to be referenced in the CSS TP Start-up procedure as mentioned in the Installing ECC. These libraries MUST have universal read access. There are no actual functions in hlq.SXVJAUTH and hlq.CXVJLOAD that require authorization.

Task 5.6.2 Add File-AID Libraries to APF Authorized Library List for File-AID Features

If you set up File-AID with SMF Audit feature with an APF checking SVC or File-AID for IMS with Image Copy feature, perform this task, otherwise skip this task.

The File-AID load library (hlq.SXVJLOAD) includes all SMP/E load modules. Depending on the options used, there may be a requirement to load some File-AID modules from an authorized library. The following options require an authorized library:

  1. Writing audit trail records to SMF (File-AID/MVS, File-AID/Data Solutions, File-AID for Db2, and File-AID for IMS) when using APF checking SVC. For more information, see File-AID-SVC.
  2. Using File-AID/RDX Image Copy option (in PARMLIB member FAFRnnnn, see ALLOW_EXTRACT_FROM_DB2_IMAGE_COPY in File-AID-RDX-Product-Configuration).

If you do not intend to use any of these options, then there are no authorized library requirements.

If some File-AID modules must come from an authorized library, it is suggested that you make the File-AID load libraries authorized data sets. If you concatenate hlq.CXVJLOAD with hlq.SXVJLOAD and hlq.SXVJLOAD is authorized, then hlq.CXVJLOAD must also be authorized.

Use the SETPROG APF system command to authorize the load library, for example:

/SETPROG APF,ADD,DSNAME=hlq.SXVJLOAD,VOLUME=your.volser

where your.volser is the volume serial number of the data set. If the library is an SMS-managed library, replace VOLUME=your.volser with SMS.


Important

If an unauthorized data set is concatenated with an authorized data set, the authorized data set is considered not authorized.

This section provides information about the following topic:

 

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