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.

Extended column relationship definition

The following figure is displayed when you attempt to map two columns/fields containing character (CHAR or VCHAR) or graphic (GRPH or VGRPH) data, or one column/field containing DECIMAL or FIXPIC and its parent or dependent CHAR data.

Extended Column Relationship Definition Window

image2021-10-22_15-18-44.png

Use this window to create partial-column/field relationships.

If the columns you want to map are the same length, the fields in this window are prefilled and the following message is displayed:

Press ENTER without any changes for a full-column relationship

Complete this window and press Enter to proceed.

The left side of the body of this window contains fields that pertain to the parent column/field:

Number

Displays the number of the parent column/field.

Name

Displays the name of the parent column/field.

Type(Length)

Displays the type of data contained in the parent column/field. The length, in parentheses, follows the data type. If an MVS field includes an occurrence of subscripts, the ARRAY SIZE and MAX LENGTH values are also displayed, see Extended Field Relationship Definition with Field Subscripts Defined for an example.

Start Position

Specify the starting position of the string in the parent column/field that will comprise the column/field relationship.

For DECIMAL columns/fields the Start Position value cannot be changed.

Length

Specify the length of the string contained in the parent column/field on which the column/field relationship will be based.

For DECIMAL data types the Length value represents its internal byte length and cannot be changed.

The right side of the body of this window contains fields that pertain to the dependent column/field:

Number

Displays the number of the dependent column/field.

Name

Displays the name of the dependent column/field.

Type(Length)

Displays the type of data contained in the dependent column/field. The length, in parentheses, follows the data type. If an MVS field includes an occurrence of subscripts, the ARRAY SIZE and MAX LENGTH values are also displayed, see Extended Field Relationship Definition with Field Subscripts Defined for an example.

Start Position

Specify the starting position of the string in the dependent column/field that will comprise the column/field relationship. If the right side does not display a Length field, the length of the dependent column/field is determined by the length of the string in the corresponding parent column/field.

For DECIMAL columns the Start Position value cannot be changed.

Length

(displays only for DECIMAL to CHAR relationships) Specify the length of the converted decimal string in the dependent character column/field. The maximum length of a DECIMAL to CHAR conversion is “precision + sign + decimal delimiter”. For example, maximum CHAR length for DEC(9,2) is 11 (9 + 1 + 1).

This section provides information about the following topics:

 

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