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.

Data Base Hierarchy display


The following figure is the first screen displayed when you enter Option 2 in the Utility Selection Menu to display the database hierarchy for a specific database. In this screen you specify the name of the DBD that describes the database to be displayed, and the name of the DBD load library where that DBD resides.

For a COPE Managed Database or IMS Managed ACB, see COPE Managed Database or IMS Managed ACB .

Data Base Hierarchy - Data Base Specification Screen

 File-AID for IMS  --  Data Base Hierarchy - Data Base Specification ----------
 COMMAND ===>                                                                   
 ENV: TEST - IMS ENVIRONMENT                        
                                                                               
 Specify the DBD library and member for hierarchy display:                   
                                                                               
          + DBDLIB Dataset 1  . . 'TSOID01.FISAMP.DBDLIB'                      
                   Dataset 2  . .                                               
                      Member  . .            (Blank or pattern for member list) 

The presence of a highlighted plus (+) or minus (-) sign indicates data set concatenations. For more information, see Data-set-concatenation-support.

DBDLIB dataset 1 and dataset 2

Enter one or two DBD load library dataset names. If you enter one DBD load library name, you can enter it on either of the dataset name lines. If you enter two DBD load library names and their blocksizes are different, you must enter the library with the larger block size on the first dataset name line.

Member

Enter the DBD member name. If you enter two DBD library names, File-AID for IMS/ISPF searches the first before the second to locate the DBD member.

COPE Managed Database or IMS Managed ACB

The following figure displays the Data Base Specification Screen for a COPE managed database. The screen for IMS managed ACB is similar, except for the environment line.

Data Base Hierarchy - Data Base Specification (COPE)

 File-AID for IMS  --  Data Base Hierarchy - Data Base Specification ----------
 COMMAND ===>                                                                   
 ENV: EC01 - IMS 14 COPE ENV                                LSYS=IEC01
                                                                               
 Specify the DBD member for hierarchy display:                      
                                                                               

                    DBD Member . .            (Blank or pattern for member list)

Current Environment

The top of the screen displays the environment definition name with its description. For COPE managed environments, it includes the name of the COPE logical system (LSYS), that is in effect for the current session.

DBD Member

Enter the DBD member that describes the database for which you want display the database hierarchy.

Terminating the Screen

Do one of the following to terminate the Data Base Hierarchy - Data Base Specification Screen:

  • Press Enter to proceed to the Hierarchy Display Screen.

    If you leave the DBD Member field blank or specify a pattern, the DBD Member List screen is displayed next. If two DBD libraries are concatenated, the member list is a merged and sorted list of the members in both data sets. You can then select the DBD member from the member list.

  • Enter the END or RETURN primary command or a jump command to terminate the hierarchy display process.

Data Base Hierarchy Display

The following figure is displayed after you entered the DBDLIB information in the Data Base Hierarchy - Data Base Specification Screen.

Hierarchy Display Screen

File-AID for IMS  -----------  Hierarchy Display  -----------------------------
COMMAND ===>                                                   SCROLL ===> PAGE


                 <*******<******  TOP OF DISPLAY *******>*******>
                                DBDNAME: PORDR
                                 .-------------.
                                 |  ORDR010    |
                                 |      1      |
                                 ‘-------------’
                                        |
                        .---------------+---------------.
                        |               |               |
                 .-------------. .-------------. .-------------.
                 |  ORDR020    | |  ORDR040    | |  ORDR050    |
                 |      2      | |      4      | |      5      |
                 ‘-------------’ ‘-------------’ ‘-------------’
                        |
                        |
                        |
                 .-------------.
                 |  ORDR030    |
Press Enter for the DBD/SEGMENT information or,
TAB to the desired segment and press Enter for SEGMENT information

This screen displays the DBDNAME for the current database and the segment name and number for each segment in the database. For a COPE managed database, the DBDNAME displays the COPE C-number, for example, C0000823. If entered on a selected PCB, the display shows which segments are included and not included in the PCB.

You can scroll UP, DOWN, LEFT, or RIGHT to view parts of a database that might not fit on a single screen.

You can do the following on the Hierarchy Display screen:

  • Press Enter without selecting a segment to display the DBD/Segment Information screen.
  • Press TAB to select a segment, and then press Enter to display the Segment Information screen for that segment.
  • Enter the END command to return to the edit screen.

DBD/Segment Information

The DBD/Segment Information screen is displayed when you press ENTER on the Hierarchy Display screen without selecting a segment or enter the INFO command on the Segment Information screen.

DBD/Segment Information Screen

-----------  Hierarchy Display - DBD/Segment Information  --------   LINE 00001
COMMAND ===>                                                   SCROLL ===> PAGE


    DBDNAME: PORDR
    ACCESS:  HDAM  

                                         Start   Length
 Line         Segment         Segment      of      of     Parent   Dataset
Command  Number/Name/Level    Length      Key     Key      Name     Group
-------  ---  --------  --  -----------  ------  ------  --------  --------
         1    ORDR010   1    167         1       6       **ROOT**  PORDRDD
         2    ORDR020   2    50  :200    3       2       ORDR010   PORDRDD
         3    ORDR030   3    45          1       2       ORDR020   PORDRDD
         4    ORDR040   2    40          1       8       ORDR010   PORDRDD
         5    ORDR050   2    47          9       2       ORDR010   PORDRDD  





Press Enter for LOGICAL RELATIONSHIP information or,
Select SEGMENT information using S line command


DBDNAME

Displays the DBDNAME of the current database. For a COPE managed database, the DBDNAME displays the COPE C-number, for example, C0000823.

Access

Displays the DL/I access method for the current database.

Line Command

Enter an S line command next to a segment name and press Enter to display the Segment Information screen.

Segment Number/Name/Level

This field displays the following:


    • A sequential number assigned by File-AID for IMS that represents each database segment.
    • The segment name defined in the DBD.
    • The hierarchical level number of the segment in the database.

Segment Length

Displays the segment length as specified in the DBD. For variable length segments, both the minimum and maximum defined lengths are shown.

Start of Key

Displays the starting position of the segment’s key. If the segment is non-keyed, 0 is displayed.

Length of Key

Displays the length of the key. If the segment is non-keyed, 0 is displayed.

Parent Name

Displays the name of the immediate parent segment of the current segment type. If the current segment type is the root, **ROOT** is displayed.

Dataset group

Displays the DDNAME of the dataset group where the segment is stored.

Terminating the Screen

Do one of the following to terminate the DBD/Segment Information screen:

  • Press Enter to display the Logical Relationship Information screen.
  • Enter the S line command next to the segment name to display the Segment Information screen for that segment.
  • Enter the END command to return to the Hierarchy Display screen.

Logical Relationship Information

The Logical Relationship Information screen is displayed when you press Enter on the DBD/Segment Information screen without entering an S line command next to a segment name.

Logical Relationship Information Screen

-------  Hierarchy Display - Logical Relationship Information  ----  LINE 00001
COMMAND ===>                                                   SCROLL ===> PAGE


                                                       INSERT
  Data                        Related   Start  Length  REPLACE        Type
  Base    Segment   Related   Segment     of     of    DELETE          of
  Name      Name    DBDNAME     Name     Key    Key     Rules     Relationship
--------  --------  --------  --------  ------ ------ ---------  --------------
PORDR     ORDR010
          ORDR020
          ORDR030
          ORDR040
          ORDR050   PCUST     VORDR050  9      2      VVV,LAST   REAL-LOG-CHILD
PCUST     CUST010
          CUST020
          VORDR050  PORDR     ORDR050   0      0      VVV,HERE   VIR-LOG-CHILD  





INSERT, REPLACE, DELETE RULES: P=PHYSICAL, L=LOGICAL, V=VIRTUAL

Database Name

Lists the name of the current database or a logically related database. For a COPE managed database, the database name displays the COPE C-number, for example, C0000823.

Segment Name

Displays the name of the segment that belongs to the database listed in the database Name column.

Related DBDNAME

Displays the name of the DBD containing the segment that is logically related to the segment listed on the same line in the Segment Name column. For a COPE managed database, the database name displays the COPE C-number, for example, C0000823.

Related Segment Name

Displays the name of the segment logically related to the segment listed on the same line in the Segment Name column.

Start of Key

Displays the starting position of the segment’s key. If the segment is non-keyed, 0 is displayed.

Length of Key

Displays the length of the segment’s key. If the segment is non-keyed, 0 is displayed.

INSERT REPLACE DELETE Rules

Displays the insert, replace, and delete rules for segments listed in the Segment Name column within related DBD names. FIRST, HERE, or LAST indicates the insert position rule for the segment.

Type of Relationship

Displays the type of relationship that exists between the segment in the Segment Name column and the DBD in the Related DBD column. This field displays "CONCAT-SEGMENT" for a concatenated segment, "REAL-LOG-CHILD" for a real logical child, and "VIR-LOG-CHILD" for a virtual logical child segment.

Terminating the Screen

Enter the END command to terminate the Logical Relationship Information screen. The DBD/Segment Information screen is displayed.

Segment Information Screen

The Segment Information screen is displayed when you enter the S line command next to segment name on the DBD/Segment Information screen or tab to a segment on the Hierarchy Display screen and press ENTER.

Segment Information Screen

------------------  Hierarchy Display - Segment Information  ------------------
COMMAND ===>

    DBDNAME:                        PORDR
    Segment name:                   ORDR010
    Segment number:                 1
    Parent name:                    **ROOT**
    Segment level:                  1
    Dataset group DDNAME:           PORDRDD
    Description:                    ORDER ROOT  

    Key starting position:          1
    Key length:                     6
    Maximum segment length:         167    FIXED  

    Processing option(s) in use:    G - GET  




 Press Enter for FIELD information or,
 Enter the INFO command for DBD/SEGMENT information

DBDNAME

Displays the DBDNAME of the DBD currently being displayed. For a COPE managed database, the database name displays the COPE C-number, for example, C0000823.

Segment Name

Displays the name of the segment selected. This is the segment name selected from the Hierarchy Display screen or from the DBD/Segment Information screen.

Segment Number

Displays a sequential number assigned by File-AID for IMS that represents the database segments.

Parent Name

Displays the segment name of the immediate parent of the current segment type selected. If the segment selected is the root, **ROOT** is displayed.

Segment Level

Displays the hierarchical level number of the segment in the database.

Dataset group DDNAME

Displays the DDNAME of the data set group where the segment is stored. For a COPE managed database, the database group displays the COPE C-number, for example, C0000953.

Description

Displays the short description from the segment/layout cross-reference dataset.

Key Starting Position

Displays the starting position of the selected segment’s key. If the segment is non-keyed, 0 is displayed.

Key Length

Displays the length of the selected segment’s key. If the segment is non-keyed, 0 is displayed.

Segment Length

Displays the segment length as specified in the DBD. For variable length segments, both the minimum and maximum defined lengths are shown. The literal FIXED or VARIABLE is also displayed to indicate the segment format.

Processing Option(s) in use

Displays the sensitive segment processing options used by File-AID for IMS during the edit/browse session. For browse, G - GET is displayed, except when the sensitive segment PROCOPT is insert only (I - INSERT). For edit, the processing options are G - GET, I - INSERT, R - REPLACE, D - DELETE, or A - ALL. The processing option is determined by the sensitive segment’s PROCOPTS.

Terminating the Screen

Do one of the following to terminate the Segment Information screen:

  • Enter the INFO command to return to the DBD/Segment Information Screen.
  • Press Enter without entering any command to display the Field Information screen.
  • Enter the END command to return to the screen from which the Segment Information screen was requested.

Field Information Screen

The Field Information screen is displayed when you press Enter without entering a command on the Segment Information screen.

Field Information Screen

---------------  Hierarchy Display - Field Information  -----------  LINE 00001
COMMAND ===>                                                   SCROLL ===> PAGE


    DBDNAME:      PORDR
    Segment name: ORDR010
    Description:  ORDER ROOT  

Field Name           Description              Start  Length      Type
----------   ------------------------------   -----  ------  ---------------
ORDRKEY      SEQUENCE(UNIQUE)                 1      6       CHARACTER

DBDNAME

Displays the DBDNAME of the DBD currently being displayed. For a COPE managed database, the database name displays the COPE C-number, for example, C0000823.

Segment Name

Displays the name of the current segment.

Description

Displays the short description of the current segment from the segment/layout cross-reference dataset.

Field Name and Description

Displays all the DBD-defined field names for the current segment and a short description of the fields in the segment. For the key field, SEQUENCE(UNIQUE) is displayed for a unique key, and SEQUENCE(MULTIPLE) is displayed for non-unique keys. SECONDARY INDEX SEARCH FIELD identifies fields used to form a secondary index.

Start

Displays the starting position of each field within the segment.

Length

Displays the length of each field within the segment.

Type

Displays the data type of each field. The possible data types are character, binary halfword, binary fullword, hexadecimal, and packed decimal.

 

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