1 Commands TFU commands follow the standard rules for DCL. For example, to view the list of character tables on line, enter the following commands: TFU> SET LIBRARY SYS$SYSTEM:TFF$MASTER.DAT TFU> DIRECTORY 2 DIRECTORY Provides a directory of a TFF library file. You can specify selective, brief, or full directory listings. If you specify a library name, that library becomes the current work library. Format: DIRECTORY [library-name] 3 Parameter library-name The target library. If you have established a work library, the library-name is optional. If you do not specify a library name, the default is: SYS$DISK:[].DAT. 3 Qualifiers /ALL Lists all tables in the target library. /COMPOSE Lists only compose sequence tables. You cannot use /COMPOSE with either the /ALL or /FALLBACK qualifiers. /FALLBACK Lists fallback tables only. This is the default. You cannot use this qualifier with either the /ALL or /COMPOSE qualifiers. /FULL Displays more detailed table information. By default, only one line of information is displayed about each table you select. 3 Examples The first example shows how to produce a brief directory listing of the fallback tables in the current work library. TFU> DIRECTORY SYS$SYSTEM:TFF$MASTER.DAT/FALLBACK Directory of TFF library SYS$COMMON:[SYSEXE]TFF$MASTER.DAT;1 Name Type Base Description ---- ---- ---- ----------- ASCII Fbk MCS MCS for ASCII (US) ASCII_OVST Fbk MCS MCS for hardcopy ASCII terminal (overstrike) BRITISH Fbk MCS MCS for British NRC(BS 4730 [ISO 646 variant]) CANADIAN Fbk MCS MCS for French-Canadian NRC (CSA Z243.4-1985) . . . SWEDISH_D47 Fbk MCS MCS for Swedish NRC (old type D47) SWEDISH_E47 Fbk MCS MCS for Swedish NRC (SEN 85 02 00 - E47) SWISS_VT102PY Fbk MCS MCS for Swiss VT102PY TURKISH Fbk MCS MCS for Turkish NRC (partial ISO 6937/2) VT100_MCS Fbk MCS MCS for VT100s with DEC-Supp in ROM#1 YUGOSLAVIAN Fbk MCS MCS for Yugoslavian NRC (JUS I B1.002) A total of 31 tables TFU> The next example shows how to display detailed information about the fallback tables in SYS$SYSTEM:TFF$MASTER.DAT. TFU> DIRECTORY SYS$SYSTEM:TFF$MASTER.DAT/FALLBACK/FULL Directory of TFF library SYS$COMMON:[SYSEXE]TFF$MASTER.DAT;1 Name Type Base Description ---- ---- ---- ----------- ASCII Fbk MCS MCS for ASCII (US) Table edit level: V1.0-0 Size (in bytes): 1128 Table format version: 0 ASCII_OVST Fbk MCS MCS for hardcopy ASCII terminal (overstrike) Table edit level: V1.0-0 Size (in bytes): 1352 Table format version: 0 BRITISH Fbk MCS MCS for British NRC (BS 4730 [ISO 646 variant]) Table edit level: V1.0-0 Size (in bytes): 1128 Table format version: 0 . . . . VT100_MCS Fbk MCS MCS for VT100s with DEC-Supp in ROM#1 Table edit level: V1.0-0 Size (in bytes): 1413 Table format version: 0 YUGOSLAVIAN Fbk MCS MCS for Yugoslavian NRC (JUS I B1.002) Table edit level: V1.0-0 Size (in bytes): 1128 Table format version: 0 A total of 31 tables TFU> 2 LOAD TABLE Loads a table from the current work library into nonpaged dynamic memory pool. Before you use this command, the fallback driver, FBDRIVER, must be loaded into memory using the System Generation utility (SYSGEN) or SYS$MANAGER:TFF$STARTUP.COM. You can use a table only after you load it into nonpaged dynamic memory pool. The following tables are always present and cannot be loaded or unloaded: ASCII - Fallback LATIN_1 - Compose sequence validation Format: LOAD TABLE table-name 3 Parameter table-name Indicates the name of the table to be loaded. 3 Example This example shows how to load the table HEBREW_VT100 into nonpaged dynamic memory pool from the current work library. TFU> LOAD TABLE HEBREW_VT100 2 SET Specifies fallback libraries, tables, and terminal characteristics. Format: SET keyword 3 DEFAULT_TABLE Specifies a default table. Before you can specify a default table, you must load the table into nonpaged dynamic pool using the LOAD command. This command reads the table type from the target table's header to specify the table as the default for its type. The initial default for each type is: ASCII - Fallback LATIN_1 - Compose validation Format: SET DEFAULT_TABLE table-name 4 Parameter table-name Indicates the name of the specified default table. 4 Examples The first example establishes HEBREW_VT100 as the default fallback table. Load the HEBREW_VT100 table into nonpaged dynamic pool before you issue these commands. TFU> SET DEFAULT_TABLE HEBREW_VT100 TFU> SHOW DEFAULT_TABLE System default TFF tables are: HEBREW_VT100 (fallback) LATIN_1 (compose sequence validation) TFU> This example shows you how to specify LATIN_1 as the default compose sequence validation table. TFU> SET DEFAULT_TABLE LATIN_1 TFU> 3 LIBRARY Allows you to declare a work library. Note that some commands implicitly declare a work library. If you declare a valid existing library, it becomes the new work library. Format: SET LIBRARY library-name 4 Parameter library-name Specifies the target work library. 4 Example In this example, the first command sets the library to be SYS$SYSTEM:TFF$MASTER.DAT which is the default file name and location. This command directs TFF to use character conversion tables located in that file. The second command loads the table HEBREW_VT100 into nonpaged dynamic memory pool. 1. TFU> SET LIBRARY SYS$SYSTEM:TFF$MASTER.DAT TFU> LOAD HEBREW_VT100 3 TERMINAL TERMINAL/FALLBACK Enables or modifies TFF terminal parameters. The /FALLBACK qualifier is required, but you can place it before or after the terminal-name parameter. SET TERMINAL/NOFALLBACK takes no keywords and is equivalent to SET TERMINAL/FALLBACK=TABLE:NONE. Format: SET TERMINAL /FALLBACK[=(Option,...)] [terminal_name] SET TERMINAL/NOFALLBACK [terminal-name] 4 Parameter terminal-name Specifies the target terminal; the default is your terminal. Note that you cannot use TFF on the following: o A remote terminal (RTAx) o The fallback terminal device (FBA0) o A packet switch interface (PSI) terminal (NVA0) o A disconnected virtual terminal o A terminal set for dynamic switching (DYNSWITCH) with DECnet for OpenVMS. You can use TFF locally and then use the DCL command SET HOST to access a remote system. fallback option Modifies the terminal parameters. To specify more than one parameter, enclose each parameter in parentheses, and separate each with commas. You can use the following options: Option Definition [NO]ACCEPT Enables input of 8-bit characters if the terminal is capable of generating 8-bit characters. The default is 7-bit character generation. 7-bit terminals, such as VT1xx and LA1xx, should have this feature turned off whereas VT2xx terminals may have it on (depending on the active table). The NOACCEPT option causes TFF to clear the eighth bit. [NO]AUTOCOMPOSE Enables or disables all auto-compose keys specified in the fallback table. AUTOCOMPOSE and NOAUTOCOMPOSE options override the ENABLE and DISABLE options. DISABLE=(value[,...]) Disables one or more active auto-compose keys. Keys are chosen from the list of keys available for the fallback table associated with a terminal. The value argument is a list of the decimal values of the keys to disable. If you specify more than one value, separate the values with commas and place them in parentheses. SHOW TERMINAL/FALLBACK lists the currently active keys and their decimal values. ENABLE=(value[,...]) Enables one or more auto-compose keys. Choose keys from the list of keys available for the fallback table associated with the specified terminal. The value argument is a list of the decimal values of the keys to enable. If you specify more than one value, separate the values with commas and place them in parentheses. SHOW TERMINAL/FALLBACK lists the currently active keys and their decimal values. GX_DEFAULT:gx-name Defines as the default character set the name of a character set, previously defined and stored in Read Only Memory (ROM) of the specified terminal. For example, VT100LD specifies the line drawing alternate character set available on VT100 terminals, and DECSUPP specifies Digital's supplemental character set. These options are available for a variety of incompatible terminals. For example, the ASCII option applies to a special class of older Digital terminals that do not have an ASCII ROM that allows display of the full ASCII character set. These terminals have only the NRC set of characters. Currently you can specify any of the following character sets for the default: ASCII, CANADA, CANADA_2, DECSUPP, FINLAND, FINLAND_2, FRANCE, GERMANY, ITALY, JIS, NETHERLAND, NORDAN, NORWAY, NORWAY_2, SPAIN, SPECIAL1, SPECIAL2, SPECIAL3, SWEDEN, SWEDEN_2, SWISS, TCS, UK, or VT100LD. For more information about available default and alternate ROM-based character sets, see the documentation for your specific terminal. [NO]SIGNAL Enables the output of a BELL character to sound a terminal bell when an invalid compose sequence is entered. This is the default. You can disable this feature for applications that split escape sequences (for output) into two or more QIOs, because the BELL character may destroy such a sequence. [NO]SOFT_COMPOSE Enables software emulated compose, using the terminal's compose sequence validation table. You can enter compose sequences either by pressing Ctrl/K followed by the sequence, or by pressing an auto-compose key followed by the second character of the sequence. [NO]SUSPEND Suspends or resumes TFF intervention. In command procedures that perform data transfers over the terminal line, use the SUSPEND option to avoid having to remember which TFF parameters to reset. The SUSPEND option suspends TFF intervention until you specify NOSUSPEND. TABLE:table-name Indicates the name of the fallback table to enable. If you omit the table-name option and fallback is not enabled, the system default is used. Otherwise the terminal's table does not change. Specify NONE for the table or use SET TERMINAL/NOFALLBACK to disable fallback for the target terminal. Before you can enable it, the target table must be present in nonpaged dynamic memory pool. Use the SHOW TABLES command for information about what tables are available. TERMINAL:terminal_type Specifies the terminal type, as seen by TFF. The terminal type controls part of the escape sequence parsing done by TFF. Thus, you should set this to the correct value. Use one of the following values: VT100, VT102, VT200, or AL_ARABI. VT102 also includes the terminals that are named VT100xy, such as VT100WF. 4 Examples The first example shows how to enable fallback using system defaults that are not already enabled. The ACCEPT option enables 8-bit input characters. The NOSIGNAL option disables the terminal bell when in- valid compose sequences are entered. TFU> SET TERMINAL/FALLBACK=(ACCEPT, NOSIGNAL) The next example command disables fallback for terminal TXB0 and is equivalent to SET TERMINAL/NOFALLBACK TXB0. Note that you can place qualifiers before or after the terminal-name parameter. TFU> SET TERMINAL TXB0: /FALLBACK=TABLE:NONE 2 SHOW Displays information about default tables and libraries. Format: SHOW option 3 DEFAULT_TABLE Displays the default fallback tables for your system. Format: SHOW DEFAULT_TABLE 4 Example This example displays the default fallback and compose tables before the command was entered. CANADIAN is the default fallback table, and LATIN_1 is the default compose sequence validation table. TFU> SHOW DEFAULT_TABLE System default TFF tables are: CANADIAN (fallback) LATIN_1 (compose sequence validation) TFU> 3 LIBRARY Provides information about the current work library. Format: SHOW LIBRARY 4 Example This example displays the current work library. TFU> SHOW LIBRARY %TFF-I-READIS, Current input library is SYS$COMMON:[SYSEXE]TFF$MASTER.DAT;1 TFU> 3 STATISTICS Displays memory and other statistical information related to TFF. Format: SHOW STATISTICS 4 Example This example displays information about TFF use. Two fallback tables have been loaded (in addition to the default table), no new compose tables have been loaded, and no fallback terminals have memory allocated for them. Other information is also displayed. TFU> SHOW STATISTICS TFF system statistics: Memory (bytes) - Fixed memory: FBDRIVER 5608 Loaded tables: Compose tables (0) 0 Fallback tables (2) 2288 Memory allocated by fallback terminals (0): FBKs 0 Replaced vectors 0 Total memory used (bytes): 7896 Misc - Total tables loaded since boot: 2 System default TFF tables are: CANADIAN (fallback) LATIN_1 (compose sequence validation) TFU> 3 TABLES Displays information about loaded TFF conversion tables. Format: SHOW TABLES 4 Example This example shows how to display one line of information about each table loaded into nonpaged dynamic memory pool. TFU> SHOW TABLES The following TFF tables are currently loaded Name Type Base Crefc Trefc ---- ---- ---- ----- ----- ASCII Fbk MCS * 0 0 LATIN_1 Cmp MCS * 0 0 HEBREW_VT100 Fbk Hebr 0 0 CANADIAN Fbk MCS 0 0 %TFF-W-NOMORETAB, No more tables in wildcard scan TFU> 3 TERMINAL/FALLBACK Displays TFF statistics about a specific terminal. The /FALLBACK qualifier is required, but you can place it before or after the terminal-name parameter. Format: SHOW TERMINAL /FALLBACK [terminal-name] 4 Parameter terminal-name Indicates the target terminal for the show operation. If excluded your own terminal is used. Note that you can only use TFF from local terminals; you cannot use terminal fallback on a remote terminal (RTAx), the fallback terminal device (FBA0), a Packet Switch Interface (PSI) terminal (NVA0), a disconnected virtual terminal, or a terminal set for dynamic switching (DYNSWITCH) with DECnet. 4 Qualifiers /ESCAPE_STATE /ESCAPE_STATE Displays information about escape sequence parsing, and triggering Read Only Menories (ROMs). Use this information to debug your application. /FLAGS /FLAGS Displays which TFF terminal flags (options) can be set by the user and displays any internal TFF flags. /FULL /FULL Displays full information about the terminal. You cannot use this qualifier with /ESCAPE_STATE or /STATISTICS. /STATISTICS /STATISTICS Displays statistics about the specified terminal. /TABLES /TABLES Displays THE names of tables assigned to the specified terminal, including auto-compose keys for the fallback table. 4 Example This example shows how to produce a full display of TFF information for terminal TXB0. 1. TFU> SHOW TERMINAL TXB0: /FALLBACK/FULL TFF status for physical terminal _TXB0: Active tables: ASCII (FALLBACK) LATIN_1 (compose sequence validation) Autocompose-keys (Parenthesized values are character's decimal value): None Settable flags: Nosuspend, Noaccept_8bit, Soft_compose, Signal, NoGR_terminal Internal state flags: None Rom(s) that will trigger TFF I/O conversion: ASCII Escape sequence parsing states: Input_state: Off (0), Output_state: Off (0) Terminal graphic registers for the next character (setup = VT00): G0 = ASCII, G1 = ASCII Output mapping: GL = G0 (maps 7-bit; 8th bit is truncated) Output formatter expansion: Received: 4579 Transmitted: 4579 Expansion rate: +0.0% Replaced vector sizes (bytes): Port vector: 99, Class vector: 139) TFU> 2 UNLOAD UNLOAD TABLE Unloads a table from nonpaged dynamic memory pool, releasing all memory used by the specified table. You can only unload tables that are not currently referenced by users and that are not the system default table. You must log out or enter SET TERMINAL/NOFALLBACK from your terminal to release a table for unloading. Note that you cannot unload the ASCII and LATIN_1 tables. Format: UNLOAD TABLE table-name 3 Parameter table-name Indicates the name of the table to be unloaded. 3 Example The command in this example unloads table HEBREW_VT100 from nonpaged dynamic memory pool. TFU> UNLOAD TABLE HEBREW_VT100