Introduction - Setting Up Dictionary-IV

Operating System Support:
UNIX, Linux, and Windows
For specific information, please contact your Thoroughbred Sales Representative.

Before you can begin to create applications using Dictionary-IV, you must prepare your system. Procedures with which you must be concerned include: creating operator codes, providing security, and system configuration.

Procedure for Set-up

This section will take you through the steps you should follow in setting up Dictionary-IV.

You can start Thoroughbred Dictionary-IV using one of the following methods:

From the Thoroughbred Basic Utilities menu, type ID and press Enter.
From Thoroughbred Basic Console Mode, type RUN“ID” and press Enter.

The system displays the Thoroughbred Dictionary-IV copyright screen. Press Enter to continue to the Operator Login Screen. The system prompts:

Enter Operator Code:

TSI is the default operator code supplied with the product. Type TSI and press Enter.

0010    DIM ]7$(400);
        ]7$(77,3)="xxx"   !specify 3-character operator code
        ]7$(228,1)="A";
        CALL "IDPUB4",]6$,]7$,]8$,]9$;
        CALL "8ZPSYS",]SYSV$;
        RUN "ID"

This program logs into Dictionary-IV using the specified operator code, avoids the Dictionary-IV Copyright screen, and opens the operator’s specified master menu. For more information see Operator Information in the Utilities Reference section of this document.

If the operator code has an entry program specified, the program will be executed prior to displaying the master menu.

Create Operator Codes

Select Operator Information from either the Dictionary-IV Control Menu or the Dictionary-IV Utilities Menu.

This option allows you to add, change, or delete operator codes. You can specify the entry and exit programs as well.

Set up an operator code for each user on the system. You may use the default operator code (TSI), and you may add a password.

For more information see Operator Information in the Utilities Reference section of this manual.

Establish a System Password

Select Security from either the Dictionary-IV Control Menu or the Dictionary-IV Utilities Menu.

This option controls access and restrictions throughout Dictionary-IV (with the exception of operator login). The passwords are in effect only when security is active.

Establishing a system password enables system security. Removing the password disables system security.

For more information see Security in the Utilities Reference section of this document.

Configure Your Terminal

Select Terminal Configurator from the System Administration options.

This runs 8NPSD from Dictionary-IV and configures your terminal for Basic. With 8NPSD you can maintain the following Thoroughbred terminal tables:

TCONFIG8 - the file holding non-window terminal tables.
TCONFIGW - the file holding window terminal tables.

From this option you can add, change, delete, and copy terminal tables. You can also add, change, or delete the user terminal table assignment. These assignments can be used whenever Thoroughbred Basic is executed or only for the current session of Thoroughbred Basic.

If you are running Thoroughbred Dictionary-IV 8.3 and above you should configure your terminals for Thoroughbred Windows (TCONFIGW).

For more information see Terminal Configurator in the Utilities Reference section of this document. Also see the Thoroughbred Basic Reference Manual.

Configure Your Printer

Select Printer Table Maintenance from the System Administration options.

Your printers must be defined in Printer Table Maintenance. This option allows you to create and change the contents of the printer tables, which contain special codes for printer control.

For more information see Printer Table Maintenance in the Utilities Reference section of this document.

Select Printer Assignment from the System Administration options.

You can now associate your printer table with a two-character printer code (LP, P1, etc.). Whenever you print, you may select only from these configured printers.

For more information see Printer Assignment in the Utilities Reference section of this document. For more information on configuring printers for the TS ReportServer, see the VIP Gateway for Windows Reference Manual.

Set Your Backup/ Restore Devices

Select Backup/Restore Parameters from the System Administration options.

For more information see Backup/Restore Parameter in the Utilities Reference section of this document.

Configure the Thoroughbred Windows

Select Window Configurator from the System Administration options. From this option you may design the attributes of Thoroughbred Dictionary-IV windows.

Five types of windows can be configured: Menus, Views, Screens, Help, and Editor. A sample of each window type remains on the screen for reference.

Configurable Window Parameters
Window Attributes	Foreground, background, reverse video, blink, underscore
Window/Border Colors	16 foreground and background colors
Border Parameters	Border type, border/select attributes, paint mode
Special Window Areas	Light bars, view headings, field entry

For more information see Window Configurator in the Utilities Reference section of this document.

Convert Dictionary-IV Definitions

You may convert definitions from older versions of Dictionary-IV to your new version.

For more information see Dictionary Update in the Utilities Reference section of this document.

Set the Installation Information

Select Installation Information from the Dictionary-IV Utilities Menu.

You can set the default values for the master menu, exit program, and the menu timeout. You can also set Screen and Menu functions.

For more information see Installation Information in the Utilities Reference section of this document.

Set Developer/User Flag

Select Set Developer/User from the System Administration options.

Setting the internal flag that defines the operator as a developer or user, enables and disables certain system functions.

For more information see Set Developer/User in the Utilities Reference section of this document.

Set Default File Locations

Two special Link definitions are used to maintain the default disk number for data and work files. The DataFileName column in Link UTWRKFIL contains the default disk number for creating work files. The DataFileName column in Link UTDATFIL contains the default disk number for creating data files.

To change these values, select Dictionary-IV Link maintenance. Change the DataFileName to any disk number defined on a DEV line in the IPLINPUT file. For more information about this please refer to the Thoroughbred Basic Customization and Tuning Guide (System Files).

To Run Another Program

To return to Thoroughbred Basic Utilities:
Select the BASIC Utilities Menu option from the Thoroughbred Dictionary-IV Control Menu.

To run another Thoroughbred Software product:
Press F3 and make a selection. When you run one of these products from Dictionary-IV, you are automatically logged in with the current operator code.

To run a program:
Type a slash ( / ) or a colon ( : ) followed by the program name and press Enter. Examples: /ID or :ID.

To run another menu:
Type ;menu-name and press Enter. The menu-name is the 3 to 8 alphanumeric character name of the menu to display. Example: ;UTMENU1.

To Logoff

There are several ways to exit Thoroughbred Dictionary-IV:

To return to the Operator Login Screen:
Type LOF at any Dictionary-IV menu and press Enter.

To return to the operating system:
Select the Terminal Logoff option from the Thoroughbred Dictionary-IV Control Menu or the Thoroughbred Dictionary-IV Development Menu.

To return to the Operator Exit program:
Press F4 at any Dictionary-IV menu until you reach the master menu. When you reach this menu press F4 to run the operator exit program. You may define this exit program using the Operator Information utility. For more information see Operator Information in the Utilities Reference section of this document.

Timeout:
Exits to the Operator Login screen. Timeouts occur when you leave a terminal unused at a Dictionary-IV menu. The amount of time before logoff can be set in the System Administration options.

Thoroughbred Dictionary-IV Menus

In this section the menus distributed with Thoroughbred Dictionary-IV are briefly described. For more information you should refer to the appropriate Dictionary-IV Reference Manual.

The following menus are provided:

Thoroughbred Dictionary-IV Control Menu
Thoroughbred Dictionary-IV Development Menu
Thoroughbred Dictionary-IV Utilities Menu
Thoroughbred Dictionary-IV Supplemental Utilities Menu
Window Conversion Utilities
Thoroughbred Dictionary-IV Multi-Language Utilities Menu
Thoroughbred Dictionary-IV Upgrade Menu
System Administration Pop-up Menu

Utility Selections

System Administration Displays a menu of options that control Installation Information, Operator Information, Terminal configuration, Printer assignment, etc.

Operator Information
Maintains the operator login codes and other operator information.

Set System Date/Time
Sets the date and/or time.

Security
Switches the system security on/off.

System Selections

Dictionary-IV Development Menu
Selects the Development Menu (see following pages).

Dictionary-IV Utilities Menu
Selects the Utilities Menu (see following pages).

Dictionary-IV Supplemental Utilities Menu
Selects the Supplemental Utilities Menu (see following pages).

BASIC Utilities Menu Exits Thoroughbred Dictionary-IV and selects the Thoroughbred Basic Utilities Menu (see THE Thoroughbred Basic Reference Manual).

Terminal Logoff
Exits Dictionary-IV and returns to the operating system.

The Dictionary-IV Development Menu can be selected from the Dictionary-IV Control Menu.

This menu can be used for most of your development work: creating and printing class definitions, maintaining libraries, compiling scripts, printing reports, and performing database maintenance. This menu contains the following selections:

Dictionary-IV Maintenance: Definition

Edit Allows you to access Definition Maintenance, where you can add, change, delete, rename, and copy a definition in the System Dictionary.

List
Provides a list of definition names and descriptions.

Print
Allows you to obtain a printed copy of definitions.

Dictionary-IV Maintenance: Library

Edit Allows you to access Library Maintenance, where you can add, change, delete, rename, and copy libraries of definitions.

List
Provides a list of library names and descriptions.

Database Maintenance

Screen
Allows you to perform database maintenance using CONNECT SCREEN.

View
Allows you to perform database maintenance using CONNECT VIEW.

Script-IV/ Report-IV Utilities

Generate Compile List
Creates a list of scripts to be compiled.

Compile from Generated List
Compiles the scripts in the generated list.

Compiling Error Report Produces a listing (display or hard copy) of the compiling errors that occurred during the last compiling session. The listing includes the script name, procedure, and error encountered.

Compile Scripts
Compiles specified scripts.

Print Reports
Allows you to print or display reports.

System Selections

Dictionary-IV Utilities Menu
Selects the Thoroughbred Dictionary-IV Utilities Menu (see below).

Terminal Logoff
Exits Thoroughbred Dictionary-IV and returns to the operating system.

The Thoroughbred Dictionary-IV Utilities Menu can be selected from the Thoroughbred Dictionary-IV Control Menu (UTMENU10) or Thoroughbred Dictionary-IV Development Menu (IDMENU1).

This menu provides supporting utilities for your development work and contains the following selections:

Audit File Information
Displays or prints the audit file report.

Backup/Restore
Allows you to backup and restore the contents of the System Dictionary.

Build Global Dictionary
Allows you to build the global dictionary from existing formats.

Dictionary Expansion
Provides optimum free space in the System Dictionary.

Dictionary Report
Provides a report on the contents of the System Dictionary.

Dictionary Update
Verifies the integrity of the System Dictionary.

Installation Check
Verifies the integrity of all Thoroughbred Dictionary-IV programs.

Installation Information Maintains installation information such as the installation name, default login menu, default exit program, and date format. Displays the release number and release date.

Dictionary Compare Allows you to compare a new dictionary with an old one or a translated dictionary with a standard TSI dictionary.

Multi-tasking Information
Allows you to create and maintain multi-tasking menu selection conflict tables.

Operator Information
Maintains the operator login codes and other operator information.

Operator Listing
Lists operators.

Printer Assignment
Allows you to assign defined printer tables to printers.

Printer Table Maintenance
Allows you to define and maintain printer tables.

Remove Help (Dictionary-IV)
Removes all old style Dictionary-IV help from the System Dictionary, creating free space.

Screen Characters
Allows you to set up screen display codes for international keyboards.

Security
Switches the system security on/off.

Set System Date/Time
Sets the date and/or time.

System Error Report
Prints a listing of system errors.

Terminal Configurator
Configure terminals using 8NPSD (TCONFIGW).

The Thoroughbred Dictionary-IV Supplemental Utilities Menu can be selected from the Thoroughbred Dictionary-IV Control Menu.

This menu provides secondary utilities for conversion operators or special management functions and contains the following selections:

Convert Report to Dictionary-IV (Report-IV)
File Definition (to Format)
Copies and converts a Report file definition to a Dictionary-IV format.

Printer Table
Copies and converts a printer table from Thoroughbred Report to Dictionary-IV.

Report Definition
Copies and converts a report definition for Report to Dictionary-IV.

Convert WORD to Dictionary-IV
Printer Table
Copies and converts a printer table from Thoroughbred WORD to Dictionary-IV.

MISC Report-IV
Report-IV: Compile Reports
Allows you to compile all Report-IV reports, individually or as a group.

Report-IV: Compile Errors
Allows you to view report compile errors. You also have the option of printing the compile errors.

Window Conversion Utilities
Window Conversion Utilities
Displays the Window Conversion Utilities pop-up menu (see the next page)

Multi-Language Utilities
Multi-Language Utilities Menu
Selects the Thoroughbred Dictionary-IV Multi-Language Utilities Menu (see the following pages).

Miscellaneous
Rebuild Link Sorts
Allows you to rebuild sorts for a library or a range of link names, display the Sort Rebuild Log, and print
the Sort Rebuild Log report.

Dictionary Compare Allows you to compare a new dictionary with an old one or a translated dictionary with a standard TSI dictionary.

Window Conversion Utilities

Convert Help Text Into Window Format Converts standard Dictionary-IV help text into level 8.n on-line windows. This replaces the original help text in the dictionary.

Convert Screens Into Window Format Converts standard Dictionary-IV Screens into level 8.n window format. This replaces the original Screen definitions with the converted Screen definitions. The Screen size will be increased by two (characters and lines) to account for the window border.

Screen Conversion Log
Displays the screen conversion error log generated by the conversion utility.

Convert Help Graphic Characters
Converts graphics characters in help text to use the current graphics character base defined in IPLINPUT.

Convert Screen Graphic Characters Converts graphics characters in screen text to use the current graphics character base defined in IPLINPUT.

Performs dictionary comparison and language conversion.

SYSTEM UTILITIES
Backup/Restore
Allows you to backup and restore the contents of the System Dictionary.

System Administration Displays a menu of options that control Installation Information, Operator Information, Terminal configuration, Printer assignment, etc.

Language Code Parameters
Enable or Disable the Language Codes.

Installation Information Maintains installation information such as the installation name, default login menu, default exit program, and date format. Displays the software serial number, release number, and release date.

Operator Information
Maintains the operator login codes and other operator information.

Dictionary-IV Login
Returns you to the Thoroughbred Dictionary-IV copyright screen.

Terminal Logoff
Exits Dictionary-IV and returns to the operating system.

CONVERSION UTILITIES
Dictionary Compare
Compares the dictionary of a new release with that of a previous release. This reports definitions that have
been changed or added in the new release. It compares the English (EN) version of each definition.

It also compares two dictionaries and report definitions with language codes other than English (EN).

Definition Conversion
Copies definitions from one language to another.

From any Dictionary-IV menu type ;UTMENU12 to access the Thoroughbred Dictionary-IV Upgrade Menu.

SYSTEM UTILITIES
System Administration
Displays a menu of options that control Installation Information, Operator Information, Terminal
Configuration, Printer Assignment, etc.

Operator Information
Maintains the operator login codes and other Operator Information.

Basic Utilities Menu Exits Thoroughbred Dictionary-IV and selects the Thoroughbred Basic Utilities Menu (see the Thoroughbred Basic Reference Manual).

Terminal Logoff
Exits Dictionary-IV and returns to the operating system.

UPGRADE UTILITIES
Dictionary Update
Verifies the integrity of the System Dictionary.

Rebuild Sorts Rebuilds Link Sorts. It allows you to rebuild Sorts for a library or range of link names, display the Sort Rebuild Log, and print the Sort Rebuild Log Report.

Script-IV: Compile Scripts
Compiles specified scripts.

Script-IV: Compile Errors Produces a listing (display or hard copy) of the compiling errors that occurred during the last compiling session. The listing includes the script name, procedure, and error encountered.

Source-IV
Exits the Thoroughbred Dictionary-IV Upgrade Menu and executes Thoroughbred Source-IV.

Report-IV: Compile Reports
Allows you to compile all Thoroughbred Report-IV reports, individually or as a group.

Report-IV: Compile Errors
Allows you to view report compile errors. You also have the option of printing the compile errors.

System Administration

Window Configurator
Executes the window configurator.

Terminal Configurator
Configures terminals using 8NPSD.

Printer Table Maintenance
Maintains printer tables.

Printer Assignment
Configures system printers for Dictionary-IV.

Generate Printer Tables
Generates the Thoroughbred Basic Printer Table records from the Dictionary-IV configured printers.

System Security Enables and disables definition maintenance functions. If it is disabled, you may view definitions but any changes made will not be saved.

Set Developer/User Sets the internal flag that defines the operator as a developer or user, enables and disables certain system functions.

System Password
Allows you to assign a system password.

During development of a Dictionary-IV application system, it is important to have access to Thoroughbred Dictionary-IV definitions while testing Views, Screens, Menus, and Help. It is helpful to have this access with a minimal number of key strokes.

Once development is complete, this access should be disabled.

Installation Information
Changes parameters in the Installation Record.

Operator Code Information
Changes parameters for the current operator code.

Query-IV Parameters
Changes parameters for Thoroughbred Query-IV.

Basic PRMs
Changes PRMs for Thoroughbred Basic.

Language Code Parameters
Changes the language code parameters.

Backup/Restore Parameters
Configures the backup device names for the Thoroughbred Dictionary-IV Backup/Restore Utility.

Generate Sample Files
Generates sample files for example definitions.

Generate Script Skeletons
Generates skeleton files used by Script-IV.

Generate Help Topics
Generates help topic files. You may select one or more files from a list of libraries.

Operator Stats Report
Produces a report of the Operator Statistics File for audit purposes.

Maintain Date Masks
Allows you to change the Input Date Mask.

Thoroughbred Dictionary-IV now supports a new date type. The new type is type 8 that stores the Thoroughbred Basic SQL date as a number in your data files.

The new date type 8 can support date, time, and date and time:

Description: Length
Date only: 6.0
Time only: 7.6
Date and Time: 11.4

Activate Dictionary-IV
Displays the Dictionary-IV Activation Screen.

Version Manager
Displays the release number and date information.

From the Dictionary-IV Administrator Guide, version 8.9.1. Open this page in the PDF

Introduction - Setting Up Dictionary-IV

Procedure for Set-up

Enter Operator Code:

Create Operator Codes

Establish a System Password

Configure Your Terminal

Configure Your Printer

Set Your Backup/ Restore Devices

Configure the Thoroughbred Windows

Convert Dictionary-IV Definitions

Set the Installation Information

Set Developer/User Flag

Set Default File Locations

To Run Another Program

To Logoff

Thoroughbred Dictionary-IV Menus

Thoroughbred Dictionary-IV Control Menu (UTMENU10)

Thoroughbred Dictionary-IV Development Menu (IDMENU1)

Thoroughbred Dictionary-IV Utilities Menu (IDMENU2)

Thoroughbred Dictionary-IV Supplemental Utilities Menu (UTMENU11)

Window Conversion Utilities

Thoroughbred Dictionary-IV Multi-Language Utilities Menu (UTMENU13)

Thoroughbred Dictionary-IV Upgrade Menu (UTMENU12)

System Administration