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.