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.

Unrelated Object Specification panel


The Unrelated Object Specification screen shown in the following figure is displayed when you select Option 3 - Unrelated Objects on the Extract Menu and your extract request already includes one or more unrelated objects or after you added unrelated objects in the Unrelated Object Definition screen.

Unrelated Object Specification

 File-AID/RDX ---------  Unrelated Object Specification  ------ Row 1 to 2 of 2
 Command ===>                                                        Scroll===>
CSR


    Primary Commands: MENU
       Line commands: A = Add Object       M = Modify MVS Object
                      R = Remove           U = Undo Remove

 CMD Object Name                                       Type    Status
 --- ------------------------------------------------- ---- ------------------  
  _  LOCATION.FRSAMP.EMP                               DB2
  _  LOCATION.FADB2.ORDER_1                            DB2
 ******************************* Bottom of data ********************************

This screen lists all unrelated objects that are to be extracted with the current extract request. Here you can use line commands to add objects or remove them from the list. Enter MENU or END to return to the Extract Menu.

To add sampling criteria to unrelated objects, go to Extract-Scope-Object-View-panel, to add selection criteria, go to Object Selection Criteria.

The scrollable area has the following columns:

CMD

Specify whether you want to:

  • Modify the layout information for an MVS object (M line command)
  • Add an unrelated object (A line command)
  • Remove an unrelated object (R line command)
  • Reverse removing an unrelated object (U line command)

Object Name

Displays a list of the unrelated objects from which data is to be extracted.

Type

Displays the object type of the unrelated object.

DB2

Db2 table.

MVS

MVS file.

Status

Displays the status of the objects to be extracted. If the status message indicates an error, you must correct the error before proceeding with the extract.

Message

Explanation

Added

The unrelated object has been added to the extract set.

Object not found

The object does not exist.

Removed

The unrelated object has been marked as remove pending with the R (Remove) line command and will not be extracted when you END out of the panel. You can reverse the Removed status with the U (Undo Remove) line command or the CANCEL primary command.

Line Commands

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

A (Add)

Adds an unrelated object to the extract set. When you enter the A line command, File-AID/RDX displays the Unrelated Object Definition screen where you can specify either an MVS file or a Db2 table.

M (Modify)

Use this command to change the record layout or XREF information for an MVS object. See Modify Unrelated MVS Object Definition.

R (Remove)

Removes the unrelated object from the extract set.

U (Undo Remove)

Reverses removing the unrelated object from the extract set.

Primary Commands

The following File-AID/RDX-specific primary command is valid on this screen:

MENU

Switches from this panel to the full Extract Menu.

Modify Unrelated MVS Object Definition

The Modify Unrelated MVS Object Definition screen shown in the following figure is displayed after you entered the (Modify) line command for an unrelated MVS object in the Unrelated Object Specification screen.

Use this screen to modify the record layout and/or XREF information for the selected MVS file.

Modify Unrelated MVS Object Definition

 File-AID/RDX ----  Modify Unrelated MVS Object Definition  --------------------

 Command ===>                                             

 Specify MVS File for Object:                                            
  File Name..............: 'TSOID01.FRSAMP.CONTACTT'                     
  Record layout usage ===> S          (S = Single; X = XREF)             
  Record layout File  ===> 'TSOID01.FRSAMP.LAYOUTS'                     
  Member name         ===> CONTACTT   (Blank or pattern for member list)
  XREF File name      ===>                                               
  Member name         ===>            (Blank or pattern for member list)
  I/O exit name       ===> 

After modifying or viewing the MVS object information, press END to return to the Unrelated Object Specification screen.

Specify MVS File for Object Area

You can change the object definition for the selected unrelated MVS file from which you want to extract data. When specifying patterns in the fields, File-AID/RDX presents selection lists.

File name

Displays the file name of the unrelated MVS file from which you want to extract data.

Record layout usage

Indicate whether a single record layout (usage "S"), or an XREF (usage "X") had been used to define the selection criteria. Only needed when no relationships have been defined for the MVS file.

Record layout file

Specify the record layout file for the MVS object from which you want to extract data. To view a list of layout files, specify a pattern. Valid pattern character is * (see Pattern Characters). If you specify a pattern, the MVS Catalog Utility File List window is displayed if defined relationships match.

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 data. Valid pattern character is * (see Pattern Characters). If you specify a pattern, the MVS Catalog Utility File List window is displayed if defined relationships match.

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.

I/O Exit Name

Specify the I/O Exit Name for the unrelated MVS file you want File-AID/RDX to use when accessing the MVS file.

 

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