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 3—Specifying driving object

File-AID/RDX displays the following figure when you enter the NEW primary command in either the Extract Reference List or the Extract Request File Member List, and your current profile specifies that a Db2 object is the default driving object for your extract request; or you enter the DB2 command in the “Driving Object - MVS” screen.

DB2 Driving Object

 File-AID/RDX -------------  DB2 Driving Object  -------------------------------
 Option ===>                                                                    
                                                                               
 Primary Commands: MVS driving object                                           
                                                                              
 Specify table to drive the extract process from:                               
   SSID             ===> DSN                                                   
   Location         ===>                      (* or pattern for selection list)
   Creator          ===> FRSAMP               (* or pattern for selection list)
   Table Name       ===> *                    (* or pattern for selection list)
                                                                               
 Relationship Information:                                                      
   File name or pattern ===> FRSAMP.RELATION                                    
                                                                               
                                                                               
                              ENTER to continue 

Select the driving object for the extract:

In this field…

Do the following:

SSID

Type the subsystem ID where the sample tables reside.

Important

The ID you enter most likely is different from the ID shown in DB2 Driving Object.

Location

Leave blank

Creator

Type FRSAMP (the authorization ID of the owner of the sample tables).

Important

The ID you enter may be different from the ID shown in DB2 Driving Object.

Table Name

Type an asterisk (*).
If you know the complete name of the table, or view, you can type it in this field. File-AID/RDX will then bypass the Table List pop-up window.

File Name or pattern

Type FRSAMP.RELATION

Press Enter

File-AID/RDX displays the Table List window.

Field Names and Descriptions

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

FIELD

DESCRIPTION

SSID

Enter the Db2 subsystem ID where the Db2 object resides.

Location

Indicates the remote location ID for the table you want to drive the extract, if it resides in a remote Db2 subsystem. The location must be defined in the Db2 subsystem catalog table, SYSIBM.SYSLOCATIONS or SYSIBM.LOCATIONS.

Important

The “Extract from Image Copy” option is not available when extracting from a remote location.

Creator

Identify the authorization ID of the owner of the table you want to specify as the driving table.

Table Name

Specify the name of the Db2 object (table or view) that you want to specify as the driving table.

File Name or pattern

Specify the name of the file that contains the RI and AR type relationship information you want to use for the extract process. Prefilled with the file name from your current profile.
If you leave this field blank, File-AID/RDX will perform a single table extract. Optionally, a single table extract now allows to extract selected Db2 columns and/or output of the extract file in delimited format.

Primary Commands

The following primary commands are available on this screen.

COMMAND

DESCRIPTION

MVS (M)

Switches to the “MVS Driving Object” panel prefilled with the applicable information from your profile.

REFERENCE (REF)

Displays your Extract Reference List panel.

REQUEST (REQ)

Displays your Extract Request File Member List panel.

Line Commands

There are no line commands available from this screen.

MVS Driving Object

File-AID/RDX displays the following figure when the driving object type is an MVS File.

Important

The User Guide includes this screen for information only as the driving object for the extract example is a Db2 object.

MVS Driving Object

 File-AID/RDX -------------  MVS Driving Object  -------------------------------
 Option ===>                                                                    
                                                                               
 Primary Commands: DB2 driving object                                           
                                                                               
 File to drive the extract process from:                                        
   File name            ===> FRSAMP.ORDERTAB                                    
                                                                              
 Optional File Information:                                                     
   Record layout usage  ===> S            (S = Single; X = XREF)                
   Record layout file   ===> FRSAMP.LAYOUTS                                     
   Member name          ===>              (Blank or pattern for member list)    
   XREF file            ===> FRSAMP.XREF                                        
   Member name          ===>              (Blank or pattern for member list)    
                                                                              
 Relationship Information:                                                      
   File name or pattern ===> FRSAMP.RELATION                                    
                                                                               
                                                                               
                             ENTER to continue                                  
                                               

To specify extract information:

In this field…

Do the following:

File Name

Type FRSAMP.ORDERTAB

Important

The prefix you enter may be different from the one shown in MVS Driving Object.

Record layout usage

Type S

Record layout file

Type FRSAMP.LAYOUTS

Important

The prefix you enter may be different from the one shown in MVS Driving Object.

File Name or pattern

Type FRSAMP.RELATION

Press Enter

File-AID/RDX continues with the Extract Menu.

Field Names and Descriptions

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

Specify file to drive extract process

Use the File Name field in this area to specify the MVS file for which you want to retrieve relationship information from the relationship file so you can extract related data. When specifying patterns in the fields, File-AID/RDX presents selection lists and then searches the relationship file.

FIELD

DESCRIPTION


File name

Specify the MVS file name of the object from which you want to extract related data. To view a list of files, specify a pattern. Valid pattern character is *(asterisk). If you specify a pattern, select a file from the “Catalog Utility File List”.

If the file name is found in the relationship file, File-AID/RDX uses the layout information as stored in the relationship file, not as entered in the Optional File Information fields.

If the MVS file is not in the relationship file, File-AID/RDX will ask you whether to continue with a single object extract or restart your extract request.

Optional File Information

The following fields are not needed when the selected MVS file is found in the relationship file. However, if the driving object file name is not in the relationship file, you must specify the layout information when continuing with a single object extract.

Record layout usage

Indicate whether a single record layout (usage "S"), or an XREF (usage "X") had been used to define the relationship for the driving object. Only needed when no relationships have been defined for the MVS file and you continue with a single object extract.

Record layout file

Specify the record layout file for the MVS object from which you want to extract related data. To view a list of layout files, specify a pattern.

Member name

Specify the member of the record layout file that contains the layout information for the MVS object. Leave blank or use a pattern to narrow the search.

XREF file name

Only needed if layout usage is X. Specify the XREF file name for the MVS object from which you want to extract related data.

Member name

Specify the member of the XREF file that contains the layout information for the MVS object. Leave blank or use a pattern to narrow the search.

Relationship Information

FIELD

DESCRIPTION

File name or pattern

Specify the name of the file that contains the application relationship information you want to use for the extract process.

Primary Commands

The following primary commands are available on this screen.

COMMAND

DESCRIPTION

DB2 (D)

Switches to the “DB2 Driving Object” panel prefilled with the applicable information from your profile.

REFERENCE (REF)

Displays your Extract Reference List panel.

REQUEST (REQ)

Displays your Extract Request File Member List panel.

Line Commands

There are no line commands available from this screen.

 

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