% Librarian T09-20A?Js A?J/05 5 About_TFFCommands/EXIT/HELP7"~B, 1 About_TFF1 Terminal Fallback Facility (TFF)F The Open VMS Terminal Fallback Facility (TFF) provides table-drivenG character conversion for terminals. Conversions are transparent to H the application software unless explicit inquiries are made). G You can choose character conversion tables from a master character ) library, located on the system disk in: SYS$SYSTEM:TFF$MASTER.DATF Conversions can be one character to many on output to a terminal,) or one to one on input from a terminal.G TFF does compose character emulation on input, and you can control F which keys are auto-compose keys. TFF allows users with NationalF Replacement Character (NRC) set terminals to use software developedH with the Digital multinational character set (MCS), essentially the G ASCII character set plus 128 characters currently used by owners of ! NRC terminals around the world.wwרB, 1 CommandsG TFU commands follow the standard rules for DCL. For example, to view E the list of character tables on line, enter the following commands:- TFU> SET LIBRARY SYS$SYSTEM:TFF$MASTER.DAT TFU> DIRECTORY 2 DIRECTORYF Provides a directory of a TFF library file. You can specify/ selective, brief, or full directory listings.F If you specify a library name, that library becomes the current work library.& Format: DIRECTORY [library-name] 3 Parameter library-nameF The target library. If you have established a work library, theF 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./COMPOSEF Lists only compose sequence tables. You cannot use /COMPOSE/ with either the /ALL or /FALLBACK qualifiers. /FALLBACKG Lists fallback tables only. This is the default. You cannot use this 8 qualifier with either the /ALL or /COMPOSE qualifiers./FULLF Displays more detailed table information. By default, only one line: of information is displayed about each table you select. 3 ExamplesF The first example shows how to produce a brief directory listing of2 the fallback tables in the current work library.7 TFU> DIRECTORY SYS$SYSTEM:TFF$MASTER.DAT/FALLBACKE Directory of TFF library SYS$COMMON:[SYSEXE]TFF$MASTER.DAT;1 * Name Type Base Des cription* ---- ---- ---- -----------. ASCII Fbk MCS MCS for ASCII (US)H ASCII_OVST Fbk MCS MCS for hardcopy ASCII terminal (overstrike)J BRITISH Fbk MCS MCS for British NRC(BS 4730 [ISO 646 variant])I CANADIAN Fbk MCS MCS for French-Canadian NRC (CSA Z243.4-1985) .  . .> SWEDISH_D47 Fbk MCS MCS for Swedish NRC (old type D47)D SWEDISH_E47 Fbk MCS MCS for Swedish NRC (SEN 85 02 00 - E47)1 SWISS_VT10 2PY Fbk MCS MCS for Swiss VT102PYD TURKISH Fbk MCS MCS for Turkish NRC (partial ISO 6937/2)A VT100_MCS Fbk MCS MCS for VT100s with DEC-Supp in ROM#1B YUGOSLAVIAN Fbk MCS MCS for Yugoslavian NRC (JUS I B1.002) A total of 31 tables TFU> G 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 librar y SYS$COMMON:[SYSEXE]TFF$MASTER.DAT;1. Name Type Base Description. ---- ---- ---- -----------, ASCII Fbk MCS MCS for ASCII (US)2 Table edit level: V1.0-0/ Size (in bytes): 11281 Table format version: 0F ASCII_OVST Fbk MCS MCS for hardcopy ASCII terminal (overstrike)2 Table edit level: V1.0-0/ Size (in bytes): 135 21 Table format version: 0I BRITISH Fbk MCS MCS for British NRC (BS 4730 [ISO 646 variant])2 Table edit level: V1.0-0/ Size (in bytes): 11281 Table format version: 0 .  . . .? VT100_MCS Fbk MCS MCS for VT100s with DEC-Supp in ROM#12 Table edit level: V1.0-0/ Size (in bytes): 14131  Table format version: 0@ YUGOSLAVIAN Fbk MCS MCS for Yugoslavian NRC (JUS I B1.002)2 Table edit level: V1.0-0/ Size (in bytes): 11281 Table format version: 0 A total of 31 tables TFU> 2 LOAD TABLEF Loads a table from the current work library into nonpaged dynamicF memory pool. Before you use this command, the fallback driver,H FBDRIVER, must be loaded  into memory using the System Generation F utility (SYSGEN) or SYS$MANAGER:TFF$STARTUP.COM. You can use a table; only after you load it into nonpaged dynamic memory pool.F 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 ExampleF This example shows how to load the table HEBREW_VT100 into nonpaged4 dynamic memory pool from the current work library." TFU> LOAD TABLE HEBREW_VT1002 SETE Specifies fallback libraries, tables, and terminal characteristics. Format: SET keyword3 DEFAULT_TABLEH Specifies a default table. Before you can specify a default table, F you must load the table into nonpaged dynamic pool using the LOAD G 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-name4 Indicates the name of the specified default table. 4 ExamplesG The first example establishes HEBREW_VT100 as the default fallback F 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:4 HEBREW_VT100 (fallback)G LATIN_1 (compose sequence validation) TFU>G This example shows you how to specify LATIN_1 as the default compose  sequence validation table.$ TFU> SET DEFAULT_TABLE LATIN_1 TFU> 3 LIBRARYF Allows you to declare a work library. Note that some commandsG 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 ExampleF In this example, the first command sets the library to beF SYS$SYSTEM:TFF$MASTER.DAT which is the default file name andF location. This command directs TFF to use character conversionF tables located in that file. The second command loads the table3 HEBREW_VT100 into nonpaged dynamic memory pool. / 1. TFU> SET LIBRARY SYS$SYSTEM:TFF$MASTER.DAT TFU> LOAD HEBREW_VT100 3 TERMINAL TERMINAL/FALLBACKF Enables or modifies TFF terminal parameters. The /FALLBACK qualifierF is required, but you can place it before or after the terminal-name parameter.F SET TERMINAL/NOFALLBACK takes no keywords and is equivalent to SET TERMINAL/FALLBACK=TABLE:NONE.F Format: SET TERMINAL /FALLBACK[=(Option,...)] [terminal_name]7 SET TERMINAL/NOFALLBACK [terminal-name] 4 Parameter terminal-nameF 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)3 o A packet switch interface (PSI) terminal (NVA0)$ o A disconnected virtual terminal9 o A terminal set for dynamic switching (DYNSWITCH) with DECnet for OpenVMS.F You can use TFF locally and then use the DCL command SET HOST to access a remote system. fallback optionG Modifies the terminal parameters. To specify more than one parameter,H enclose each parameter in parentheses, and separate each with commas. $ You can use the following options:# Option DefinitionF [NO]ACCEPT Enables input of 8-bit characters if theF terminal is capable of generating 8-bitF  characters. The default is 7-bit characterF generation. 7-bit terminals, such as VT1xxF and LA1xx, should have this feature turnedF off whereas VT2xx terminals may have it onF (depending on the active table). The NOACCEPTC option causes TFF to clear the eighth bit.F [NO]AUTOCOMPOSE Enables or disables all auto-compose keysH  specified in the fallback table. AUTOCOMPOSE G and NOAUTOCOMPOSE options override the ENABLE - and DISABLE options.F DISABLE=(value[,...]) Disables one or more active auto-composeF keys. Keys are chosen from the list of keysF available for the fallback table associatedF with a terminal. The value argument is a listF of the decimal values of the keys to disable.F If you specify more than one value, separateF the values with commas and place them inF parentheses. SHOW TERMINAL/FALLBACK lists theF currently active keys and their decimal values.F ENABLE=(value[,...]) Enables one or more auto-compose keys. ChooseF keys from the list of keys available for theF  fallback table associated with the specifiedF terminal. The value argument is a list of theF decimal values of the keys to enable. If youF specify more than one value, separate theF values with commas and place them inF parentheses. SHOW TERMINAL/FALLBACK lists theF currently active keys and their decimal  values.F GX_DEFAULT:gx-name Defines as the default character set the nameF of a character set, previously defined andF stored in Read Only Memory (ROM) of theF specified terminal. For example, VT100LDF specifies the line drawing alternateF character set available on VT100 terminals,F and DECSUPP specifie s Digital's supplemental' character set.F These options are available for a variety ofF incompatible terminals. For example, theF ASCII option applies to a special class ofF older Digital terminals that do not have anF ASCII ROM that allows display of the fullF ASCII character set. These terminals have8  only the NRC set of characters.F Currently you can specify any of theF following character sets for the default:F ASCII, CANADA, CANADA_2, DECSUPP, FINLAND,F FINLAND_2, FRANCE, GERMANY, ITALY, JIS,F NETHERLAND, NORDAN, NORWAY, NORWAY_2, SPAIN,F SPECIAL1, SPECIAL2, SPECIAL3, SWEDEN,>  SWEDEN_2, SWISS, TCS, UK, or VT100LD.F For more information about available defaultF and alternate ROM-based character sets, seeF the documentation for your specific" terminal.F [NO]SIGNAL Enables the output of a BELL character toF sound a terminal bell when an invalid composeF sequence is entered. This is the de fault. YouF can disable this feature for applicationsF that split escape sequences (for output) intoF two or more QIOs, because the BELL character5 may destroy such a sequence.F [NO]SOFT_COMPOSE Enables software emulated compose, using theF terminal's compose sequence validation table.F You can enter compose sequences either byF  pressing Ctrl/K followed by the sequence, orF by pressing an auto-compose key followed by> the second character of the sequence.F [NO]SUSPEND Suspends or resumes TFF intervention. InF command procedures that perform dataF transfers over the terminal line, use theF SUSPEND option to avoid having to rememberF which TFF parameters to reset. The SUSPENDF option suspends TFF intervention until you+ specify NOSUSPEND.F TABLE:table-name Indicates the name of the fallback table toF enable. If you omit the table-name option andG fallback is not enabled, the system default G is used. Otherwise the terminal's table does F not chang !e. Specify NONE for the table or useG SET TERMINAL/NOFALLBACK to disable fallback 1 for the target terminal.F Before you can enable it, the target tableF must be present in nonpaged dynamic memoryF pool. Use the SHOW TABLES command forE information about what tables are available.F TERMINAL:terminal_type Specifies the terminal t "ype, as seen by TFF.F The terminal type controls part of the escapeF sequence parsing done by TFF. Thus, youF should set this to the correct value. Use oneF of the following values: VT100, VT102, VT200,F or AL_ARABI. VT102 also includes theF terminals that are named VT100xy, such as! VT100WF. 4 ExamplesF # The first example shows how to enable fallback using system defaultsF that are not already enabled. The ACCEPT option enables 8-bit inputF characters. The NOSIGNAL option disables the terminal bell when in-& valid compose sequences are entered.3 TFU> SET TERMINAL/FALLBACK=(ACCEPT, NOSIGNAL)F The next example command disables fallback for terminal TXB0 and isF equivalent to SET TERMINAL/NOFALLBACK TXB0. Note that you can place9 qualifiers before or after the terminal-name$ parameter.2 TFU> SET TERMINAL TXB0: /FALLBACK=TABLE:NONE2 SHOW: Displays information about default tables and libraries. Format: SHOW option3 DEFAULT_TABLE7 Displays the default fallback tables for your system.! Format: SHOW DEFAULT_TABLE 4 ExampleF This example displays the default fallback and compose tables beforeG 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:0 CANADIAN (fallback)C LATIN_1 (compose sequence validation) TFU> 3 LIBRARY6 Provides information about the current work library. Format: SHOW LIBRARY 4 Example2 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 STATISTICSC Displays memory and other statistical information related to TFF. Format: SHOW STATISTICS 4 Example G This example displays information about TFF use. Two fallback tables N have been loaded (in addition to the default table), no new compose tables M 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:9 FBDRIVER 5608 Loaded tables:9 Compose tables (0) 09 Fallback tables (2) 22882 Memory allocated by fallback terminals (0):9 FBKs 09 Replaced vectors 09 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.K Format: SHOW TABLES 4 ExampleG This example shows how to display one line of information about each 1 table loaded into nonpaged dynamic memory pool. TFU> SHOW TABLES1 The follow )ing TFF tables are currently loaded9 Name Type Base Crefc Trefc9 ---- ---- ---- ----- -----5 ASCII Fbk MCS * 0 05 LATIN_1 Cmp MCS * 0 05 HEBREW_VT100 Fbk Hebr 0 05 CANADIAN Fbk MCS 0 05 %TFF-W-NOMORETAB, No more tables in wildcard scan TFU>3 TERMINAL/FALLBACKF Displays TFF statistics a*bout a specific terminal. The /FALLBACKF qualifier is required, but you can place it before or after the terminal-name parameter.6 Format: SHOW TERMINAL /FALLBACK [terminal-name] 4 Parameter terminal-nameF Indicates the target terminal for the show operation. If excludedF your own terminal is used. Note that you can only use TFF from localF terminals; you cannot use terminal fallback on a remote terminalF (RTAx), the fallback terminal device (FBA0), + a Packet SwitchF Interface (PSI) terminal (NVA0), a disconnected virtual terminal, or? a terminal set for dynamic switching (DYNSWITCH) with DECnet. 4 Qualifiers /ESCAPE_STATE /ESCAPE_STATEF Displays information about escape sequence parsing, and triggeringF Read Only Menories (ROMs). Use this information to debug your application./FLAGS /FLAGSF Displays which TFF terminal flags (options) can be set by the user& and displays any internal TFF flags.,/FULL /FULLF Displays full information about the terminal. You cannot use this. qualifier with /ESCAPE_STATE or /STATISTICS. /STATISTICS /STATISTICS3 Displays statistics about the specified terminal./TABLES /TABLESF Displays THE names of tables assigned to the specified terminal,5 including auto-compose keys for the fallback table. 4 ExampleF 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)2 LATIN_1 (compose sequence validation) I Autocompose-keys (Parenthesized values are character's decimal value): None  Settable flags:B Nosuspend, Noaccept_8bit, Soft_compose, Signal, NoGR_terminal Internal state flags: None / Rom(s) that will trigger TFF I/O conversion: ASCII" Escape sequ.ence parsing states:0 Input_state: Off (0), Output_state: Off (0)F Terminal graphic registers for the next character (setup = VT00): G0 = ASCII, G1 = ASCII Output mapping:1 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 TABLEF Unloads a table from n/onpaged dynamic memory pool, releasing allF memory used by the specified table. You can only unload tables thatF are not currently referenced by users and that are not the systemF default table. You must log out or enter SET TERMINAL/NOFALLBACKF 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-name2 Indicates the name of the table to be unloaded. 3 ExampleF The command in this example unloads table HEBREW_VT100 from nonpaged dynamic memory pool.# TFU> UNLOAD TABLE HEBREW_VT100wwרB,1 EXIT. Use this command or Ctrl/Z to exit from TFU.wwרB,1 HELPF The OpenVMS Terminal Fallback utility (TFU) is the user interface toG to Terminal Fallback facility (TFF). Use the HELP command to display  TFU help information. Format: TFU> HELP [keyword ...]ww