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.

Application Relationship Detail


The Application Relationship Detail screen shown in the following figure is displayed when you select the Edit AR option or enter the E line command for an object that already has an application relationship defined in the current relationship file.

Application Relationship Detail Screen

image2021-3-12_11-56-24.png

This screen displays a list of application relationships (AR) for the object and relationship file specified with the Edit AR option or E line command. It is similar to the Relationship-Detail, except that it only displays application relationships for the selected object.

Use this screen to select application relationships from the relationship file that you want to modify (S line command) or delete (D line command). You can also use this screen to display detailed information about a relationship (I line command) or to begin the process of adding new application relationships (A line command or ADD primary command).

CMD

Enter a valid line command next to the appropriate relationship. See Line Commands for information about valid line commands.

Parent/

Displays the name of the object defined as the parent in a relationship in the upper row (the row with the CMD input field).

/Dependent

Displays the name of the object defined as the dependent in a relationship in the lower row, under its parent.

Obj Type

Indicates the object type of the parent and dependent.

DB2

Db2 table.

MVS

MVS file.

KEY

Output Key file or IMS database (dependent only).

Rel Type

Indicates the kind of relationship that exists between the corresponding parent and dependent objects. (Always AR or AR-C as only application relationships are displayed.)

AR

User-defined application relationship. Created and maintained by the user.

AR-C

User-defined data driven, conditional application relationship. Created and maintained by the user with File-AID/RDX Release 4.7 or higher.

Status/Description

Indicates the condition of each relationship in the upper row (Status) and the Application Relationship Description for each relationship in the lower row. If there is an error for the dependent object, it will override the Description in the lower row. For a list of possible messages, see Status.

Message

Explanation

Modified

Displayed when you enter the S line command and complete the Relationships screen. Indicates that this relationship has been modified.

Added

Displayed when you enter the A line command or ADD primary command and complete the Relationships screen. Indicates that this relationship has been added to the relationship file.

Deleted

Displayed when you enter the D line command. Indicates that this relationship has been deleted from the relationship file.

In addition, File-AID for Db2 could display the following error messages:

Message

Explanation

Object not found

cannot find one of the objects (dependent or parent) in the MVS or Db2 catalog. This may indicate that the object not found has been dropped. Use the D line command to delete the invalid relationship.

Column Errors

An invalid column relationship exists within the application relationship. Invalid column relationships may be caused by eliminating or changing a column from a table defined in the Db2 catalog.

Use the S line command to display the Column/Field Relationships screen where the invalid column/field relationship is in indicated by the ERR> flag.

Line Commands

The following File-AID for Db2-specific line commands are valid on this screen:

A (Add)

Adds an application relationship for this parent object. Displays the Add Relationships screen. See Add Relationships — Specify Object Types.

D (Delete)

Deletes an application relationship from the relationship file.

I (Relationship Information)

Invokes the Relationship Information screen. See Relationship Information Screen for more information.

S (Select)

Selects an application relationship for modification and displays the Column/Field Relationships screen. See Building Column/Field Relationships for more information.

Primary Commands

The following File-AID for Db2-specific primary commands are valid on this screen:

ADD

Enter the ADD command in the COMMAND field to add an application relationship. Displays the Add Relationships screen. See Add Relationships — Specify Object Types.

GRAPHIC (G)

Enter the GRAPHIC command in the COMMAND field to invoke the Graphical Relationship Display screen and show application relationships for the selected table. See Graphical Relationship Display for more information on the Graphical Relationship Display screen. There are no operands associated with this command.

Relationship Information

The Relationship Information screen is displayed when you enter the I line command on the Relationship Detail screen or the Application Relationship Detail screen. Use the Relationship Information screen to view detailed information about the relationship on which you entered the I line command. See Relationship Information Screen for more information about the contents of this window.


 

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