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.

Changing navigational controls for a relationship

When you enter the NAVIGATION command on the Extract Scope - Object View panel, File-AID/RDX displays the Relationship Navigation Criteria screen. The Navigational Criteria Settings are prefilled as specified with the global navigation control settings in the Extract Scope or with your previously saved individual settings. Verify that the values match.

Relationship Navigation Criteria

File-AID/RDX ------- Relationship Navigation Criteria ---------- Row 1 from 12
Command ===>                                                  Scroll ===> PAGE

Primary Commands: EXclude/Unex, Change, Find, Hide, FILter, CHEck, SIze, SOrt
                   VIew, STATus, SAMple, NAVigation, VALidate, GRaphic, REPort
    Line Commands: X = Exclude   U = Unexclude   I = Info
Driving Object: FRSAMP.ORDER_TABLE
           SSID: DSN   Location: DSNLOCAT            Navigation Criteria
Seq Object Name                                    Dir Par Sib Ind Status
---- ---------------------------------------------- --- --- --- --- ----------
0001 FRSAMP.CUSTOMER_TABLE                          -   -   -   Y
        FRSAMP.CONTACT_TABLE                         CONTCUST
0002 FRSAMP.CUSTOMER_TABLE                          -   Y   Y   -
        FRSAMP.ORDER_TABLE                           CUSTOMER-ORDER RELATIONSHIP
0003 FRSAMP.ORDER_TABLE                             Y   -   -   -
        FRSAMP.ORDER_LINE_TABLE                      ORDLORD
0004 FRSAMP.PART_TABLE                              -   Y   N   -
        FRSAMP.ORDER_LINE_TABLE                      ORDLPRT
0005 FRSAMP.PART_TABLE                              -   -   -   Y
        FRSAMP.SUPPLIER_TABLE                        SUPPPART
0006 FRSAMP.SUPPLIER_TABLE                          -   -   -   Y
        'TSOID01.FRSAMP.SUPPLIER'                    DB2 TO MVS SUPPLIER_TABL
U007 'TSOID01.FRSAMP.CUSTOMER'                      -   -   -   -   Excl User
        'TSOID01.FRSAMP.CONTACTT'                    MVS CUST to CONTACTT

To change individual Navigational Controls for the extract:
In this field…	Do the following:
Navigation Criteria: Sib	Type a Y in the Sibling column next to the following relationship: 0002 CUSTOMER_TABLE ===> ORDER_TABLE
Seq	Type the U (Unexclude) line command for the following relationship: 0007 'TSOID01.FRSAMP.CUSTOMER' ===> 'TSOID01.FRSAMP.CONTACTT'This will reverse the eXclude line command entered in panel Extract Scope - Object View, but only for this relationship, not relationships 0008 'TSOID01.FRSAMP.CUSTOMER' ===> 'TSOID01.FRSAMP.ORDERTAB' 0009 'TSOID01.FRSAMP.CUSTOMER' ===> FRSAMP.CUSTOMER_TABLE

Press Enter

File-AID/RDX refreshes the panel and changes the status for Seq 0007 to Excl Scope.

To view the remaining relationships:
In this field…	Do the following:
Scroll	Type CSR to change the scroll amount to cursor.
Command	Type the DOWN primary command and move the cursor to Seq 0007

Press Enter

File-AID/RDX scrolls the listed relationships (see Relationship Navigation Criteria - Scrolled).

Field Names and Descriptions

The following list describes all of the fields in this screen:

Fixed Display Area

In addition to the screen title, the Command field, and the scroll amount input field, the top area of the screen contains

A message indicating how many relationships were retrieved for display
A message indicating the driving object for which these relationships were retrieved

Scrollable Display Area

This screen areas displays a list of referential integrity and application relationships containing the following columns:

FIELD	DESCRIPTION
Seq	The Sequence column displays the sequence number for the listed relationships for the current extract request. Enter line commands in this column. See Line Commands for information about valid commands for this screen.
Object Name (Parent)	Displays the name of the object defined as the parent in a relationship in the upper row (the row with the Seq number).
Object Name (Dependent)	Displays the name of the object defined as the dependent in a relationship in the lower row, under its parent.
Navigation Criteria	Here you specify the Navigation Criteria on an individual relationship basis. You cannot change the dash unless the navigation setting of a higher relationship changes it to a Y or N. Important When your profile has navigation criteria Direct set to C or P, all Extract Navigation Criteria fields are protected and cannot be modified during the extract specification.
	Select:
	Dir	(Direct) Extract all of the dependents of the driving object and their dependents.
	Par	(Parent) Extract parents of all extracted data to maintain the integrity of the extracted data.
	Sib	(Sibling) Extract other dependents of the extracted parents from the same relationships.
	Ind	(Indirect) Extract other dependents of the extracted parents from other relationships.
Status	Displays one of the following messages:
	Excl All	This relationship is excluded as the result of the A (All) line command.
	Excl Miss	This relationship is excluded from the current extract process because at least one of the related objects does not exist.
	Excl Scope	This relationship, with navigation (DPSI) settings of “----”, is excluded as the result of another relationship’s DPSI settings that make it impossible for the extract to navigate to this relationship. Any changes you make to this relationship directly have no affect on the extract. This includes changes to the sampling criteria and the DPSI settings as well.
	Excl User	This relationship has been excluded from the current extract process. This status is the result of the EXCLUDE primary or line command.
	Inactive	A relationship with one or more DPSI switches set to “N”. but none to “Y”, is considered inactive, but still within the scope of the extract as its DPSI settings can be changed. Note that in Object View, an object is marked excluded when all of its relationships are marked inactive.
	KEY Undef	For this relationship you still need to define an output key file with Extract Menu Option “6 - Output Key File” or exclude this relationship from the current extract process, before you can continue.
	KEY Def	An output key file has been defined for this KEY relationship.
	KEY Deleted	The output key file definition for this KEY relationship has been deleted.

Primary Commands

The following primary commands are available from this screen.

COMMAND	DESCRIPTION
CHANGE (C)	Change allows global changes to be made to the sampling criteria on a column-by-column basis. When the CHANGE command is entered with one of the available parameters DIR=n, PAR=n, SIB=n, or IND=n, all values are changed to the new value n. When entered without parameters, specify the values to change in the “CHANGE Command Window”.
CHECK (CHE)	Use the CHECK command to verify the extract paths after you made navigational changes. When the path integrity validation processing is complete, the results are displayed in the “Check Extract Warning” screen (where you can resolve or ignore the findings. Extract Scope Relationship View screen only. Important CHECK is not valid when when the extract n request is built with relationships in the Direct Plus or All Children Only mode (see Direct).
FILTER (FIL)	The FILTER command restricts the relationships being displayed to the relationships for the object(s) that contain the specified object name string. Any relationship where the specified object is either a parent or a child will be displayed.
FIND (F)	Searches the relationship list for the specified string and scrolls the list to display the first matching entry at the top of the displayed entries. Use RFind to repeat the search.
HIDE (H)	The HIDE command allows less data to be displayed. Included and excluded relationships can be removed or hidden from the display so that the remaining content is more meaningful. Use the RESET command to return all hidden objects to the display.
EXCLUDE (EX or X)	Enter the EXCLUDE command in the COMMAND field to exclude all relationships in the list displayed on the Relationship Criteria screen from the extract. Use this command in conjunction with the U (Undo) line command or UNEXCLUDE primary command when you have a long list of relationships displayed and you want to include only a few relationships in the extract. The optional parameters DB2, IMS, and MVS limit the EXCLUDE command to one of the three object types.
GRAPHIC (G)	Enter the GRAPHIC command in the COMMAND field to invoke the Graphical Relationship Display and show RI and application relationships for the driving object. For more information, see Graphical Relationship Display.
NAVIGATION (NAV)	The NAVIGATION command takes you directly to the NAVIGATION format of the relationship view.
REPORT (REP)	Prints the logical contents of the display. This report includes all of the displayable lines formatted like the current view.
RESET	Use the RESET command to return all hidden objects to the display.
SAMPLE (SAM)	The SAMPLE command takes you directly to the SAMPLE format of the relationship view.
SIZE (SI)	Increases the scrollable area to display more entries at a time by hiding some of the screen header lines. Size is a toggle switch so enter Size again to return to the original format.
SORT (SO)	Sorts the displayed list of relationships by the specified sequence (column) name. Valid SORT sequences are SEQ, PAR, DEP, ST, and DESC.
STATUS (STAT)	The STATUS command takes you directly to the STATUS format of the relationship view.
UNEXCLUDE (U)	Enter the UNEXCLUDE command in the COMMAND field to undo a previous EXCLUDE command for all relationships in the list displayed on the Extract Scope - Object View screen from the extract. Use this command in conjunction with the X (exclude) line command or EXCLUDE primary command when you have a long list of relationships displayed and you want to reverse a previous EXCLUDE command to include relationships in the extract again.
VALIDATE	The VALIDATE command validates all relationships against the relationship file. The message “No changes” informs you that all relationships have been successfully validated. If there are inconsistencies, the “Update Saved Request Window” reports the validation results and gives you the opportunity to update the saved request or reload the request as last saved. VALIDATE corresponds to RDX Utilities Option 10, “Update Saved Extract Requests”, except that it executes online and only on a single request. Important VALIDATE is not valid when when the extract n request is built with relationships in the Direct Plus or All Children Only mode (see Direct).
VIEW (VI)	The VIEW command allows you to easily switch between the object and relationship views. VIEW without any parameter displays the “Extract Scope - Object View” screen. VIEW with one of the parameters SAMPLE, STATUS and NAVIGATION displays the corresponding format of the relationship view.

Line Commands

The following list identifies the line commands that are available from this screen. For details on each command, see File-AID/Related Data XPERT Reference.

COMMAND	DESCRIPTION
I (Relationship Information)	Invokes the Relationship Information screen.
U (Unexclude)	Selects a previously excluded relationship to be included in the extract. Remember, you cannot unexclude an excluded relationship when its link to the driving object is through another, still excluded relationship. See also X (Exclude). Important When the excluded status for a relationship has been set by a navigational control (including ALL), it can only be undone with a navigational control, not with the Undo line command.
X (Exclude)	Excludes a relationship from the extract. When you exclude a relationship, other relationships might also be excluded as a result. This occurs when you exclude a relationship and either of the objects in the excluded relationship is a parent or dependent in another relationship that cannot be linked back to the driving object in any other way.