HELPLIB.HLB  —  SHOW  TRANSLATION
    Displays the first translation found for the specified logical
    name. You can specify the tables that are searched.

    Requires read (R) access to a logical name table to display
    information about any logical name cataloged in that table.

    Format

      SHOW TRANSLATION  logical-name

1  –  Parameter

 logical-name

    Specifies the logical name whose translation you want to display.

2  –  Qualifier

2.1    /TABLE

       /TABLE=name

    Searches the specified table. The default value for the name
    parameter is LNM$DCL_LOGICAL.

    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 until a match is found.

3  –  Examples

    1.$ SHOW TRANSLATION PAYROLL
      PAYROLL = DISK1:[ACCOUNTS.WORKING]FACTOR1.DAT;37 (LNM$PROCESS_TABLE)

      The SHOW TRANSLATION command in this example displays the
      translation for the logical name PAYROLL and also displays
      the name of the table where the logical name was found. In this
      example, PAYROLL was found in LNM$PROCESS_TABLE, the process
      logical name table.

    2.$ DEFINE DISK  DKA1:
      $ DEFINE/GROUP DISK  DKA2:
      $ SHOW TRANSLATION DISK
        DISK = DKA1:(LNM$PROCESS_TABLE)

      The DEFINE commands in this example place entries for the
      logical name DISK in both the process and group logical
      name tables. Then, the SHOW TRANSLATION command shows the
      translation associated with the logical name DISK. By default,
      the process, job, group, and system tables are searched (in
      that order). The first match found is displayed. The logical
      name DISK from the process table (LNM$PROCESS_TABLE) is
      displayed because it is found before the name DISK in the group
      table.

    3.$ RUN ORION
 <Ctrl/Y>

      $ SHOW TRANSLATION TERMINAL
        TERMINAL = _TTT3: (LNM$PROCESS_TABLE)
      $ CONTINUE

      The RUN command in this example executes the image ORION.EXE.
      After the Ctrl/Y function interrupts the image, the SHOW
      TRANSLATION command displays a logical name assignment. The
      CONTINUE command resumes the execution of the image.

    4.$ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER
        USER = "DKA2:"  (LNM$SYSTEM_TABLE)

      The SHOW TRANSLATION command in this example displays the
      translation for the logical name USER. Because a table name
      is specified, the SHOW TRANSLATION command does not use the
      default search order. Only the specified table, LNM$SYSTEM, is
      searched. LNM$SYSTEM is the system logical name table.

    5.$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC -
      _$ TEST_TABLE, LNM$PROCESS
      $ SHOW TRANSLATION/TABLE=MYPROC FILER
        FILER = "[SMITH.FILER]"   (TEST_TABLE)

      In this example, MYPROC defines a list of logical name
      tables that you want searched. It asks the system to first
      search TEST_TABLE (a user-defined table) and then to search
      LNM$PROCESS (the process logical name table). MYPROC is stored
      in LNM$PROCESS_DIRECTORY, the process directory table. When you
      enter the SHOW TRANSLATION command to find FILER in the MYPROC
      table, the tables TEST_TABLE and LNM$PROCESS are searched, in
      that order. The first match found is displayed.
Close Help