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