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.

Window management


To accomplish your tasks with the greatest convenience, File-AID for Db2 Object Administration has extensive window management capabilities, which are described in this section.

Positioning windows

While using File-AID for Db2 Object Administration, you can reposition your windows to see data in two or more windows at one time. Many row and primary commands open new windows with their upper-left corner at the current cursor position. You can control the placement of the new window by moving the cursor to a new location after typing the command, but before pressing Enter.

You can also use the following positioning commands:

POSITION

Places a window with its upper-left corner at the cursor.

ARRANGE

Arranges the display of windows vertically, horizontally, etc., based on window level.

WINDOW

Moves a window up, down, right, or left by an amount specified with a keyword or the amount in the Scroll field.

More information on these commands is in Primary Commands.

Customizing pop-up window placement

You can customize the placement of most pop-up windows. If the window normally opens with its upper-left corner at the cursor, you can change its pop-up placement. Use the following window placement values in your user profile to specify coordinates for the pop-up window:

  • MAX COLUMN
  • MAX ROW
  • OPEN COLUMN
  • OPEN ROW.

You can access them in the User Profile Display and Edit window. The fast-path command is MENU.PRO.

The first two values (MAX COLUMN and MAX ROW) are threshold values that represent the upper-left corner of a window. If a window normally opens to the right of the MAX COLUMN value or below the MAX ROW value, the window opens at OPEN ROW and OPEN COLUMN values.

For example, a MAX COLUMN of 40 and a MAX ROW of 12 is approximately the center of a normal screen. Any window that would normally open to the right of column 40 or below row 12 is placed at the OPEN COLUMN and OPEN ROW coordinates.

Removing windows

You can remove a window with implicit selection or primary commands. To implicitly select an END command, place the cursor on the bottom border and press Enter.

The following commands are available to remove a window:

END

Removes a window and its descendants. Changes to the window are saved. The default <End> PF key is PF3.

CANCEL

Removes a window and its descendants. Changes to the window are deleted. The default <Cancel> PF key is PF15.

REMOVE

Removes a window; descendants remain visible. Changes to the window are saved.

The difference between the above commands is important when used on a File-AID for Db2 Object Administration work buffer. See About the Work Buffers.

Controlling window size

You can specify a window’s size with commands or implicit selection. The following commands are available to control the size of your windows:

MAXIMIZE

Resizes the window to the size of the screen. The default <Maximize> PF key is PF12.

MINIMIZE

Resizes the window as small as possible.

NORMALIZE

Returns the window to its normal size and position. The default <Normalize> PF key is PF24.

You can also use the COMMAND prompt as a toggle to change the window size. Place the cursor on the word COMMAND and press Enter. File-AID for Db2 Object Administration rotates the window sizing commands for execution. For example, the first time you use the COMMAND prompt this way on a normalized window, you maximize it; the second time minimizes the window; and the third time normalizes the window.

Controlling window columns

You can expand, move, freeze, hide, or reorganize columns to create a more useful display.

Expanding Truncated Columns

A truncated column shows only a portion of the column’s width. For example, if a column is 20 characters wide, it can be truncated to 10 characters for display.

To expand a column, use the ZOOM primary command; see ZOOM-Zoom-Column.

Moving Columns Into the Display Area

Several techniques (and combinations thereof) are available to view the columns outside the currently visible area of the window:

Scrolling

Scroll columns using the same techniques as data scrolling. See Scrolling Window Contents.

Key columns in an object display window default to frozen status and cannot be scrolled without releasing (unfreezing) them. For example, in a table display window, the table name and table creator columns default to frozen.

Excluding (Hiding)

Exclude a column from display by using the HIDE primary command; see HIDE-Hide-Column. When a column is hidden, the remaining columns shift left.

Freezing

Freeze a column to keep it stationary while scrolling by using the FREEZE primary command; see FREEZE-Freeze-Column. When a column is frozen, it moves to the left-most position in the window. As additional columns are frozen, they continue shifting to the left, while unfrozen (thawed) columns are shifted to the right.

Reorganizing the Columns

Change the order and display of the columns by using the Column List window. This window opens when the FREEZE or HIDE command is used without implicit selection.

Using the Column List Window

Executing the FREEZE or HIDE primary command without pointing to a column with the cursor pops up the Column List window (Column List Window for a Database Display). In this window, you can make changes to the parent window’s columns. Changes affect the display immediately. You can specify the following types of changes:

  • Reorganize the columns in the parent window. Use the M (move) row command to select the column. Use the A (after) or B (before) row commands to specify the destination.
  • Hide a column (exclude from display) by using the H row command. See H-Hide-Column.
  • Freeze a column (mark as stationary) by using the F row command. See F-Freeze-Column.
  • Clear a frozen or hidden column by using the CLR row command. See CLR-Clear-Column.

Numeric range specifiers, block ranges, and total symbols can be used with these commands. For example, you can use the HH block format to hide a range of columns. See Ranges.

Column List Window for a Database Display

image2021-4-21_15-47-6.png

Column List Window for a Database Display shows the Column List window for a database display. In all database displays, the DBNAME column has a default status of frozen. As you hide, freeze, and reorganize columns, the current status changes.

Each time you freeze a column, it moves to the top of the list, indicating that the column has moved to the left-most position.

Important

The profile variable MAX FROZEN LENGTH controls the automatic unfreezing of all columns when the total column length of all frozen columns exceeds the maximum frozen length. A MAX FROZEN LENGTH value of 0 (zero) disables the automatic unfreezing. Refer to MAX FROZEN LENGTH for a description of this profile value.

The following figure shows the IBMR and TYPE columns frozen and moved up in the column list.

Freezing Columns

image2021-4-21_15-54-17.png

The RESET primary command without parameters restores a window to its initial status:

  • Excluded rows are unexcluded
  • Hidden, frozen, or moved columns are restored.

Use a parameter for the RESET command to selectively reset column status:

  • Use RESET HIDE to release (unhide) hidden columns
  • Use RESET FREEZE to release (thaw) frozen columns.

Scrolling window contents

You can scroll the contents of a window using primary commands, function keys, or the scrolling characters above the sequence number field. A summary of scrolling commands and characters is in the following table. Use the KEYS primary command to change function key defaults.

Scrolling does not affect frozen columns. File-AID for Db2 Object Administration automatically designates certain key columns as frozen. You can also freeze any column with the FREEZE primary command.

 Data Scrolling Methods

Command

Description

UP, DOWN, RIGHT and LEFT primary commands

Scrolls data for the current window by the amount in the SCROLL field.

LABELS primary command

Displays a list of active labels. Use the cursor to select a label; data scrolls to that location.

ROW primary command

Positions the data display at a specified row.

PF7

Scrolls up the amount in the SCROLL field.

PF8

Scrolls down the amount in the SCROLL field.

PF10

Scrolls left.

PF11

Scrolls right.

< of<\//\> field

Scrolls left the amount in the SCROLL field.

\ of <\//\> field

Scrolls down the amount in the SCROLL field.

/ of <\//\> field

Scrolls to the bottom.

/ of <\//\> field

Scrolls to the top.

\ of <\//\> field

Scrolls up the amount in the SCROLL field.

> of <\//\> field

Scrolls right.

Scrolling Characters

The scrolling characters (<\//\>) above the sequence numbers implicitly select data scrolling inside the window. Each character represents a direction for the scroll. For example, the character < scrolls data to the left. To use a character, position the cursor over it and press Enter.

The characters indicate in which direction you can scroll to see either additional rows or additional columns.

The following figure shows a scrolling right character and the next figure shows scrolling down characters.

Scrolling Right. The scrolling character “>” indicates additional columns are available by scrolling right. Only the top portion of this window is shown.

Scrolling Down. The scrolling characters “\/” indicate additional rows are available by scrolling down. Only the top portion of this window is shown.

image2021-4-21_15-56-34.png

You can change the scrolling characters in your session user profile. For example, you can change the > character to R (for right) and the < character to L (for left). See Window Parameter Display and Edit Window.

Generating vertical displays

Because a window may have many more columns than can be displayed at one time, you may want to generate a vertical display of the column data. When V is executed, a vertical display window opens showing the parent row’s data (see the following figure).

Vertical Display Window. The top border (1) contains information about the source of the row.

image2021-4-21_15-57-44.png

In the vertical display window, you can:

  • Scroll up and down in the usual manner to view data
  • Use the new PREV and NEXT primary commands to select a different row from the parent window.


 

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