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.

Common Screen Fields


In general, the first five lines, with Action Bar active, or three lines of each display are formatted as follows:

Line

Description

Action Bar

List of available Pull-down menus

Action Bar Divider Line

Screen Title

Short Message
or Db2 Subsystem ID

Command or Option Prompt

Scroll amount or
Db2 Subsystem prompt

Point-and-Shoot Fields

Cursor-sensitive text to execute commands

Long Message

Action Bar

An action bar at the top of a panel shows the action items you can select on that panel. Action-Bar-and-Pull-Downs-Summary lists all action items and pull-down choices.

Use the TAB key to move the cursor to an action item. Typical action items are: Menu, Action, View, Options, or Help. Press ENTER to select an action item.

Pull-Downs

When you select an action item on the action bar, File-AID for Db2 shows you a pull-down with choices related to the item you selected (Views Pull-down Menu Example). To select a choice, do one of the following:

  • Type in the Option number, for example 1 for User Parms and press ENTER.
  • Move the cursor with the UP or DOWN arrow keys to the desired Option row and press ENTER.

An asterisk (*) in front of an item tells you that you cannot select it because it is unavailable for the current screen. If you try to select an item marked with an asterisk, File-AID for Db2 ignores it.

An ellipsis (...) after an item tells you that File-AID for Db2 will request additional information before completing the item’s action.

While a pull-down displays, only the items in the pull-down or on the action bar are available. For example, if you select a pull-down and the item you want is not listed in it, you can select another pull-down on the action bar. However, you cannot mark or enter anything on the background panel until the pull-down is removed. Press the END or RETURN PF keys to remove the pull-down when you do not want to select an item.

Views Pull-down Menu Example

image2021-3-9_12-49-28.png

Windows

If you select a pull-down action that is followed by an ellipsis, File-AID for Db2 removes the pull-down and displays a window with more choices related to the action you selected, or with an area in which you must type the information it needs to complete the action (see the following figure).

If you select a window action that is followed by an ellipsis, File-AID for Db2 displays another window on top of the first one.

Sort Command Window

image2021-3-9_12-50-33.png

The following figure illustrates the header area, with Action Bar.

 Screen Header with Action Bar

image2021-3-9_12-51-14.png

Screen Title

The screen title is usually displayed at the top center of each File-AID for Db2 screen. It consists of a short description of the screen’s function.

COMMAND Field

The COMMAND field (command line) is shown on most screens. On some screens, it is shown as the OPTION field. Use this field to enter primary commands or option selections for File-AID for Db2. Some primary commands are valid for all screens, while others are active only on selected screens.

For more detailed information about the File-AID for Db2 primary commands, see Primary-commands-in-File-AID-for-Db2-options.

SCROLL Field

The SCROLL field lets you set the scroll value for screens and fields that permit scrolling. The following positioning commands are used with this field: DOWN, UP, LEFT, and RIGHT.

If you modify the SCROLL field, the value you enter is retained for the duration of the File-AID for Db2 session. If you wish, you can set the SCROLL field to one value for Edit and Browse, and another for the utilities. The following values are valid for the SCROLL field:

CSR

Scrolling based on the cursor’s location.

HALF

Half-screen scrolling.

MAX

Scrolling to the beginning or end of a data area.

PAGE

Full-screen scrolling.

nnnn

Scrolling nnnn lines. Valid entry is from 1 to 9999.

Subsystem Identification

Most File-AID for Db2 screens display your current Subsystem identification (SSID) and some allow you to update it. If the SSID is display only, it displays on the title line and is not highlighted (File-AID for DB2 Screen Header with Action Bar). If the SSID can be updated, it displays on the command line and is highlighted (see the following figure). For information on setting the default SSID value, see User-Parms-Menu.

File-AID for Db2 Screen Header with SSID — Updates Allowed 

image2021-3-9_12-53-45.png

Point-and-Shoot Fields

Some File-AID for Db2 panels allow you to enter primary commands through the use of point-and-shoot text fields. These fields are cursor-sensitive, and are marked with the point-and-shoot attribute (color turquoise by default). Placing the cursor on a point-and-shoot text field and pressing the Enter key will execute the action associated with the field.

To change the default point-and-shoot display, use the PSCOLOR primary command and specify the attributes to your liking, for example, set highlight to REVERSE.

Example:

On the Edit Selection Template screen (see the following figure), EXEC, SQL, SAVE, and SIZE are point-and-shoot text fields. To save the selection criteria using point-and-shoot

  1. Place the cursor on the SAVE text field
  2. Press the Enter key

Point-and-Shoot Fields — REVERSE

image2021-3-9_12-54-39.png

 

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