TK-Works Manual

TK-WORKS MANUAL
table of contents

(main)

EXPORT ROUTINES

 In addition to providing the means for creating and maintaining MUMPS routines, TK-WORKS also provide utilities for moving those routines from place to place.

The export utility can be used to move source code (including internal comments) from one TK-WORKS environment to another. And when used on a PC-DOS machine, this utility can be used to create DOS distribution files which can be loaded using the Restore Routines Utilities provided with each of the available PC implementations of MUMPS.

Step 1 From the Function menu, select Utility.
From the Utility menu, select Export.

Step 2 Select the routines to be exported. Additional information regarding selection of source and routines is covered at the beginning of the Routine Utilities section under Conventions.

Step 3 Select export medium. If you are working on a PC-DOS based system, the export medium may be a DOS file or a global. If you are not working on a PC-DOS based machine, the only available export medium at this time is a global.

If you select a global as the export medium, you will be asked for the name of the global to be used. It is then your responsibility to move the global to the desired system and restore it with TK-WORKS.

If you select a DOS file as the export medium, you will be asked for the name of the file to be used. If that file already exists, you will be notified of its existence and asked if it should be overwritten.

Step 4 Select routine format. You may export routines in either source code or executable format. Routines exported in source code format include all internal comments and can only be restored using the TK-WORKS Import utility. Routines exported in executable form contain no internal comments and are written in a format compatible with the destination system's Restore Routine Utility.

Step 5 Enter comments. You may enter a brief comment as part of the export file header.

Exporting of the selected routines will begin immediately, and as it proceeds, the name of the routine being exported will be displayed in the lower left corner of the screen. When complete you will be returned to the Utility menu.

IMPORT ROUTINES

 In addition to providing the means for creating and maintaining MUMPS routines, TK-WORKS also provides utilities for loading routines into the system from other sources. Possible sources include MUMPS, a TK-WORKS export global or file, and the files created by Routine Save utilities in PC-DOS based implementations of MUMPS. Imported routines are placed directly into the workfile.

Step 1 From the Function menu, select Utilities.
From the Utilities menu, select Import.

Step 2 Select the source of the routines to be imported. Available sources include GLOBAL and MUMPS. If you are running a PC-DOS based system, a DOS FILE option will also be provided.

Step 3 If you selected GLOBAL or DOS FILE as the source, you will be asked for the appropriate name. Enter the name of the global or DOS file. For DOS files, drive and path should be specified as well. If the file is present, a window will appear which displays the contents of the file header for confirmation purposes.
Step 4 Select type of confirmation desired. You may have TK-WORKS request confirmation before importing a routine. The three confirmation options include...
EXISTING Confirm import of routines which already exist in the TK-WORKS system.
EACH Confirm import of every routine.
NEVER Import all routines without confirmation.
Step 5 Decide whether routine names should be changed before saving. The default answer is NO. However, if you do want routine names to be changed, and answer YES by pressing [Y] and [RETURN], you will then be asked for Name Masks which will specify the change to be made as shown below.

            Change names from:            to:

The first mask specifies the portion of the incoming name to be changed. The second specifies the change to be made. Consider the following examples:

     a) Change names from: AA*        to: ZZ*

...changes the first two characters of routine name to "ZZ" if the routine name begins with "AA".

     b) Change names from: *          to: %*

...results in a percent sign ("%") being added to the beginning of all routine names.

     c) Change names from: %*         to: *

...results in the first character being removed from all routine names which begin with a percent sign ("%").

     d) Change names from: *Z         to: *A

...changes the last character of routine name from "Z" to "A" if the routine name ends with an "A".

Step 6 Ready to begin? If ready, press [Y] and [RETURN] to begin processing.

As the import proceeds, the name of the routine being imported will be displayed at the bottom of the screen. If the rename function has been used, the changed name will be displayed. When finished, you will be returned to the Utilities menu.

SCREEN MAINTENANCE

For sites which have PG&A's Toolkit I and use the screen painting system, TK-PAINT, direct access to this tool is provided through the TK-WORKS menus. Refer to your TOOLKIT I manual for assistance in using TK-PAINT.

FORM MAINTENANCE

 For sites which have PG&A's TK-FORM, direct access to this tool is provided through the TK-WORKS menus. Refer to your TK-FORM manual for assistance in using the product.