HELPLIB.HLB  —  SHOW  LOGICAL
    Displays translations, the level of translation, and the logical
    name table for a specified logical name. The SHOW LOGICAL command
    performs iterative translations.

    Requires read (R)  access to the table in which a logical name is
    cataloged to display information about the logical name.

    Format

      SHOW LOGICAL  [logical-name[:][,...]]

1  –  Parameter

 logical-name[:][,...]

    Specifies one or more logical names whose translations you want
    to display. The asterisk (*) and the percent sign (%) wildcard
    characters are allowed; however, if a wildcard character is used,
    iterative translation is not done.

    The logical name is translated iteratively up to a number
    of times determined by the system (from 9 to 11). That is,
    translations are examined to see if they are also logical names.

2  –  Qualifiers

2.1    /ACCESS_MODE

       /ACCESS_MODE=mode

    Displays names defined in the specified access mode and any inner
    access modes. You can specify one of the following keywords to
    indicate the access mode: USER_MODE, SUPERVISOR_MODE, EXECUTIVE_
    MODE, or KERNEL_MODE.

    The default value for this qualifier is USER_MODE; by default any
    definitions in all four access modes are displayed.

2.2    /ALL

       /ALL (default)

    Indicates that all logical names in the specified logical name
    tables are to be displayed. If you do not enter the /PROCESS,
    /JOB, /GROUP, /SYSTEM, or /TABLE qualifier, all logical names
    in the tables specified by the logical name LNM$DCL_LOGICAL are
    displayed.

2.3    /CLUSTER

    Displays all the logical names in all clusterwide tables (for
    example, the LNM$CLUSTER and LNM$SYSCLUSTER tables).

2.4    /DESCENDANTS

       /DESCENDANTS
       /NODESCENDANTS (default)

    Controls whether the system displays names from the specified
    logical name table and any descendant tables. A descendant table
    is created by the CREATE/NAME_TABLE command, with the /PARENT_
    TABLE qualifier specifying its parent table. If you use the
    /DESCENDANTS qualifier, you must also use the /TABLE qualifier.

2.5    /EXACT

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a
    search string that must match the search string exactly and must
    be enclosed with quotation marks (" ").

    If you specify the /EXACT qualifier without the /SEARCH
    qualifier, exact search mode is enabled when you set the search
    string with the Find (E1) key.

2.6    /FULL

    Displays more detailed information for the specified logical
    name. The information includes the access mode, attributes, the
    translation, and the logical name table.

2.7    /GROUP

    Indicates that only the group logical name table is to
    be searched. The /GROUP qualifier is synonymous with the
    /TABLE=LNM$GROUP qualifier. If you specify the /GROUP qualifier
    and you do not also specify a logical name, all names in the
    group table are displayed.

2.8    /HIGHLIGHT

       /HIGHLIGHT[=keyword]

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the
    type of highlighting you want when a search string is found. When
    a string is found, the entire line is highlighted. You can use
    the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD
    is the default highlighting.

2.9    /JOB

    Indicates that only the job logical name table is to be searched.
    The /JOB qualifier is synonymous with the /TABLE=LNM$JOB
    qualifier. If you specify the /JOB qualifier and you do not also
    specify a logical name, all names in the job logical name table
    are displayed.

2.10    /OUTPUT

       /OUTPUT[=filespec]
       /NOOUTPUT

    Controls where the output of the SHOW LOGICAL command is sent.
    By default, the output of the SHOW LOGICAL command is sent to the
    current SYS$OUTPUT device (usually your terminal). To send the
    output to a file, use the /OUTPUT qualifier followed by a file
    specification.

    The asterisk (*)  and the percent sign (%) wildcard characters
    are not allowed in the file specification. If you enter a partial
    file specification (for example, specifying only a directory),
    SHOW is the default file name and .LIS is the default file type.

    If you enter the /NOOUTPUT qualifier, output is suppressed.

2.11    /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE=SAVE qualifier allows you to navigate through screens
    of information. The /PAGE=SAVE qualifier stores up to 5 screens
    of up to 255 columns of information. When you use the /PAGE=SAVE
    qualifier, you can use the following keys to navigate through the
    information:

    Key Sequence              Description

    Up arrow key, Ctrl/B      Scroll up one line.
    Down arrow key            Scroll down one line.
    Left arrow key            Scroll left one column.
    Right arrow key           Scroll right one column.
    Find (E1)                 Specify a string to find when the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit. (Some utilities define these
                              differently.)
    Help (F15)                Display utility help text.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

    The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

2.12    /PROCESS

    Indicates that only the process logical name table is to
    be searched. The /PROCESS qualifier is synonymous with the
    /TABLE=LNM$PROCESS qualifier. If you specify the /PROCESS
    qualifier and you do not also specify a logical name, all names
    in the process table are displayed.

2.13    /SEARCH

       /SEARCH="string"

    Use with the /PAGE=SAVE qualifier to specify a string that you
    want to find in the information being displayed. Quotation marks
    are required for the /SEARCH qualifier, if you include spaces in
    the text string.

    You can also dynamically change the search string by pressing the
    Find key (E1) while the information is being displayed. Quotation
    marks are not required for a dynamic search.

2.14    /STRUCTURE

       /STRUCTURE
       /NOSTRUCTURE (default)

    Controls whether the system displays the "family tree" of all
    accessible logical name tables. The display includes the two
    logical name directory tables (process and system) and all
    logical name tables cataloged in these directory tables. Any
    descendant logical name tables are shown under their parent
    tables.

    If you specify the /STRUCTURE qualifier, you cannot use any other
    qualifiers except /ACCESS_MODE, /FULL, and /OUTPUT.

2.15    /SYSTEM

    Indicates that only the system logical name table is to
    be searched. The /SYSTEM qualifier is synonymous with the
    /TABLE=LNM$SYSTEM qualifier. If you specify the /SYSTEM qualifier
    and you do not also specify a logical name, all names in the
    system table are displayed.

2.16    /TABLE

       /TABLE=(name[,...])

    Specifies the tables you want to search. If you specify only one
    table, you can omit the parentheses. The asterisk (*)  and the
    percent sign (%)  wildcard characters are allowed. Names with
    wildcards are used to match table names. Names without wildcard
    characters are treated both as table names and table search lists
    (whichever is appropriate).

    You can use the /TABLE qualifier to specify the following:

    o  A user-defined logical name table (created with the
       CREATE/NAME_TABLE command)

    o  The process, group, or system logical name tables

    o  The process or system directory tables

    If you specify the table name by using a logical name that
    translates to more than one table, then each table is searched
    in the order specified. For example, if you specify SHOW
    LOGICAL/TABLE=LNM$FILE_DEV, and LNM$FILE_DEV is equated to
    LNM$PROCESS, LNM$JOB, LNM$GROUP, and LNM$SYSTEM, then the
    process, job, group, and system tables are searched, in that
    order.

    If you do not specify the /TABLE qualifier, the default is
    /TABLE=LNM$DCL_LOGICAL.

2.17    /WRAP

       /WRAP
       /NOWRAP (default)

    Use with the /PAGE=SAVE qualifier to limit the number of columns
    to the width of the screen and to wrap lines that extend beyond
    the width of the screen to the next line.

    The /NOWRAP qualifier extends lines beyond the width of the
    screen and can be seen when you use the scrolling (left and
    right) features provided by the /PAGE=SAVE qualifier.

3  –  Examples

    1.$ SHOW LOGICAL/PROCESS
      (LNM$PROCESS_TABLE)
        "SYS$COMMAND" = "_TTB4:"
        "SYS$DISK" = "WORK6:"
        "SYS$DISK" = "WORK6:"
        "SYS$ERROR" = "_TTB4:"
        "SYS$INPUT" = "_TTB4:"
        "SYS$LOGIN" = "WORK6:[ODONNELL]"
        "SYS$LOGIN_DEVICE" = "WORK6:"
        "SYS$OUTPUT" = "_TTB4:"
        "SYS$OUTPUT" = "DKA2:"
        "SYS$SCRATCH" = "WORK6:[ODONNELL]"

      The SHOW LOGICAL command in this example displays all
      process logical names and their translations. (Note that
      /TABLE=LNM$PROCESS would produce the same display as /PROCESS.)

    2.$ SHOW LOGICAL INFILE
        "INFILE" = "WORK6:[LOGAN]PAYROLL.EXE" (LNM$PROCESS_TABLE)

      The SHOW LOGICAL command in this example displays the
      translation for the logical name INFILE. The response indicates
      that the logical name was found in the process logical name
      table.

    3.$ SHOW LOGICAL/GROUP
         .
         .
         .

      The SHOW LOGICAL command in this example displays all
      group logical names and their translations. (Note that
      /TABLE=LNM$GROUP would produce the same display as /GROUP.)

    4.$ SHOW LOGICAL/TABLE=SYSTEM  SYS$LIBRARY
        "SYS$LIBRARY" = "SYS$SYSROOT:[SYSLIB]" (LNM$SYSTEM_TABLE)

      The SHOW LOGICAL command in this example displays the
      translation of the logical name SYS$LIBRARY in the system
      table. The response indicates that SYS$LIBRARY is defined
      in the system table, and that the logical name has two
      translations.

    5.$ SHOW LOGICAL/TABLE=LNM$GROUP/TABLE=LNM$SYSTEM SYS$DISK
        "SYS$DISK" = "ZZZ3:" (LNM$SYSTEM_TABLE)

      The SHOW LOGICAL command in this example is qualified by both
      the /TABLE=LNM$GROUP and /TABLE=LNM$SYSTEM qualifiers. The
      response indicates that the logical name SYS$DISK was found in
      the system logical name table. When you enter two conflicting
      qualifiers, as in this example, only the last qualifier you
      specify is used.

    6.$ SHOW LOGICAL/TABLE=LNM$PROCESS_DIRECTORY

      The SHOW LOGICAL command in this example displays the logical
      names in the process directory table. Each name is either a
      table name, or a name that translates iteratively to a table.
Close Help