This site will undergo a maintenance outage on Saturday, 13 September beginning at 2:30 AM Central/1 PM IST for a platform upgrade. The downtime will be ~three hours.

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 12—Specifying Supporting File information

File-AID/RDX displays the following figure when you select Option 8, Extract File, from the Extract Menu.

Supporting File Specification

File-AID/RDX         Supporting File Specification              
 COMMAND ===> END                                          
 
 Specify DB2 Object Record Layout Information:                       
   Create layouts  ===> Y        (Y = Yes;   N = No)  
   Language        ===> 1        (1 = COBOL, 2 = PLI, 3 = FA COBOL)  
   File name    ===> FRSAMP.LAYOUTS                          
   Member       ===> DB2OBJS    (Blank or pattern for member list)  
   Disposition  ===> SHR         (NEW, SHR)                          
 
 Specify File-AID/MVS XREF for File-AID/RDX Extract File Information:
   Create XREF  ===> Y           (Y = Yes;   N = No)
   File name    ===> FRSAMP.EXTRACT.XREF                            
   Member       ===> SAMPMENU    (Blank or pattern for member list)
   Disposition  ===> NEW         (NEW, SHR)                      

 Specify Topaz Extract Visualizer File:
   Create file  ===> Y           (Y = Yes;   N = No)
   File name    ===> FRSAMP.VISUAL                         
   Member       ===> SAMPMENU    (Blank or pattern for member list)
   Disposition  ===> NEW         (NEW, SHR)                      

   NOTE: Allocating a Topaz file allows for Extract Visualization
         within the Data Visualizer component of Topaz Workbench.

To specify the Record Layout, XREF, and Topaz Extract Visualizer file information:

In this field…

Do the following:

Command

Type END

Create layouts

Type Y

Language

Type 1 for COBOL, or 2 for PLI, or 3 for FA COBOL

File Name

Type FRSAMP.LAYOUTS

Important

If the extract includes MVS objects use the layout file that was used when defining the relationships.

Member

Type DB2OBJS

Important

If the extract includes MVS and Db2 objects specify a member for the Db2 layouts.

Disposition

Type SHR

Create XREF

Type Y

File Name

Type FRSAMP.EXTRACT.XREF

Member

Type SAMPMENU

Important

The XREF must be a PDS.

Disposition

Type NEW

Important

If the file already exists, change the disposition to SHR. Then you don’t need to fill in the following allocation parameters.

Create file

Type Y to create a Topaz Extract Visualizer file.

File Name

Type FRSAMP.EXTRACT.VISUAL

Member

Leave blank (will create a sequential file)

Disposition

Type NEW

For a new file, when you press Enter, specify the allocation parameters in the Create New File screen.

Important

If the file already exists, change the disposition to SHR. Then you don’t need to provide allocation parameters.

Command

Type the END primary command.

Press Enter

File-AID/RDX displays the Extract Menu.

Field Names and Descriptions

The following list describes the fields on this screen.

FIELD

DESCRIPTION

Create layouts

Specify whether or not to create a COBOL, PL/I, or FA COBOL record layout file for the extracted Db2 objects when File-AID/RDX performs the extract. Creating a record layout allows you, for example, to download the extracted data with BMC Compuware File-AID/EX at a later time, or view and compare extract files with BMC Compuware File-AID/MVS.

Important

When you ask File-AID/RDX to create only a record layout (Create XREF = NO) for MVS objects, the resulting layout is only for the complete extracted record, not the fields within the record.

Language

Specify whether to create Cobol or PL/I record layouts.

1 Create a COBOL record layout.

2 Create a PL/I record layout.

3 Create a FA COBOL record layout.

FA COBOL creates a File-AID COBOL layout with special type VAR for Db2 column type VCHAR or VC, for example when the FIRSTNME column is defined to Db2 as VARCHAR(12), with FA COBOL it will be generated as 10 FIRSTNME PIC X(12) VAR. Use option 3, FA COBOL when you need to define disguise criteria for Db2 tables with column type VARCHAR

File Name

Specify the name of the file to which the record layout cross reference (XREF) will be saved.

Important

When also creating an XREF for the extract file and your extract includes MVS objects enter the existing source layout file name, the one used when you defined the relationships. If you specify a different layout file, be sure to copy the layout members from the source layout file into the new record layout file before using the XREF file with BMC Compuware File-AID/MVS or File-AID/Data Ager to access the extract file. The XREF expects all layout members in the same layout file.

Member

The XREF file you specified in File Name must be partitioned. Enter a member name. If you leave this field blank or specify a pattern, File-AID/RDX displays a Member List pop-up window containing a list of members that match the specified pattern.

Disposition

Indicates whether the file is new (NEW) or existing (SHR).

If you specify NEW in the Disposition field, you must specify allocation parameters in the Create New File screen.

Create File-AID/MVS XREF for Extract File

Specify whether or not to create a File-AID/RDX XREF (record layout cross reference) file when File-AID/RDX performs the extract. Yes requires that “Create record layouts for Db2 objects” is also set to Yes.

File Name

Specify the name of the file to which the record layout cross reference (XREF) will be saved.

Member

The XREF file you specified in File Name must be partitioned. Enter a member name. If you leave this field blank or specify a pattern, File-AID/RDX displays a Member List pop-up window containing a list of members that match the specified pattern. The only valid pattern character is an asterisk (*). You can create new members by entering the name of the new member in the Member field.

Disposition

Specify the disposition of the file. You can save to existing files with a disposition of SHR. Specify a disposition of NEW to create a new PDS.

If you specify NEW in the Disposition field, you must specify allocation parameters in the Create New File screen.

Create File

Specify whether or not to create a Topaz Extract Visualizer file when File-AID/RDX performs the extract. The file will contain the extract request information as well as the extract execution information.

File Name

Specify the name of the file to which the extract request and extract execution information to be used with the Topaz Extract Visualizer will be saved. The file may be a PDS/PDSE or a sequential file.

Member

Enter a member name if you specify a PDS or PDSE for the Topaz Extract Visualizer file. If you leave this field blank or specify a pattern, File-AID/RDX displays a Member List pop-up window containing a list of members that match the specified pattern. The only valid pattern character is an asterisk (*). You can create new members by entering the name of the new member in the Member field.

Disposition

Specify the disposition of the file. You can write to existing files with a disposition of SHR. Existing files must conform to the format for the Topaz Extract Visualizer file. Specify a disposition of NEW to create a new file.

If you specify NEW in the Disposition field, you must specify allocation parameters in the Create New File screen.

Primary Commands

The following list identifies the primary command that is available from this window. For details on the command, see File-AID/Related Data XPERT Reference.

COMMAND

DESCRIPTION

END

Returns to the Extract Menu screen.

Line Commands

There are no line commands associated with this screen.

 

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