Installing the FOCUS Toolkit

The FOCUS ToolKit is a convenient way to access FOCUS facilities using windows. A few installation steps are required to enable the menu.

Access the FOCUS maintenance disk as A and the FOCUS production disk R/W as C.
Execute the COPYISH EXEC:
```
EXEC COPYISH
```
Customize the ToolKit with site-specific information.
To prepare the background window for the ToolKit, you will be asked to provide the company name, a support center phone number, the installation date, the FOCUS site code, a default printer destination, and a list of optional printer destinations. The company information will be displayed on the background of the ToolKit Menuing system. The printer information will be used to assign a default printer when first executing the ToolKit and allow users to easily change the destination of printed output. You will be asked for this information in simple fill in the blank screens.

This installation will create two files on the production FOCUS disk. The first will contain a site-specific background for the ToolKit (ISHFPROF DATA) and user selections for print destination (ISHDPNTR DATA).

Note: The ToolKit can be customized for user groups by creating separate ISHFPROF and ISHDPNTR files for each group on different minidisks. This minidisk should be accessed in a search order prior to the FOCUS production disk.
1. Attach the FOCUS Production disk as your writable A minidisk and enter FOCUS:
```
EXEC FOCUS
```
2. Execute the ToolKit Installation Procedure.
```
EXEC ISHFINST
```
  At each prompt, enter the required information and press Enter. You will be prompted for the following information:
  Company name.
  Telephone number for support.
  Install date (in MM/DD/YY format).
  FOCUS site code.
  Default printer. The printer value is the CP TAG value desired for the company default printer. Note: The user's printer device must be spooled to RSCS for the print options to be effective.
  Additional printers. Reply yes or no to the prompt asking for additional company printer IDs that can be selected by the user. If the reply is no, installation is complete. If the reply is yes, enter the note that the first printer in the list will be assigned as the user's default printer. You may also designate a disk file as the output by providing a TAG value of DISKFILE and the disk filename, filetype, and filemode as the description. Userid will be prefixed to this name. The disk file must be typed in capital letters, as it will not be translated. Up to 18 printers can be added at this time, including the default printer. Changes can be made after installation by accessing the FOCUS production disk in write mode and executing ISHFPNTR, or by editing the file ISHDPNTR DATA on the FOCUS production disk (be sure to maintain columnar spacing).
  After installation is complete, the ToolKit will be executed. Move the cursor next to the last option on the menu, Exit, and press Enter.
Customize database allocations.
The ToolKit will attempt to dynamically access FOCUS, sequential, and comma delimited files that have been identified to the ToolKit. This is accomplished by creating a FOCEXEC that performs the necessary accesses and USE commands for a given file. This FOCEXEC is named filename ISHFALOC, where filename is the name of the file (as used by FOCUS).

For example, to allow the ToolKit to access the CAR FOCUS data source, create a FOCEXEC named CAR.

For example, the following FOCEXEC accesses a minidisk with the CAR file as B:
```
-*
-* Issue CMS commands within a FOCEXEC which will link the mdisk
-* with the CAR FOCUS database.
-* The CAR FOCUS database has been saved on CARFOCUS 191 mdisk.
-*
CMS EXEC VMLINK CARFOCUS 191 <* B> ( NOTYPE
-RUN
USE
CAR FOCUS B
END
-RUN
-EXIT                                                           
```
Note that this FOCEXEC can include any FOCUS commands.
To provide automatic execution of the ToolKit when a user enters FOCUS, edit the file SHELPROF FOCEXEC (this step is optional). This file resides on the production disk, but it may be located on any disk.
The original FOCEXEC contains the following commands, which invoke automatic execution of the FOCUS Menu:
```
-* This FOCEXEC will be executed only after PROFILE FOCEXEC
-* execution has been completed.
-* INCLUDE FMMAIN
```
Change the FOCEXEC to read:
```
EXEC ISHFSHLL
-EXIT
```
This will allow the ToolKit to execute online only; it will be bypassed in batch.
Note: You can give the user the option to execute the ToolKit, the FOCUS Menu, or exit to native FOCUS with this FOCEXEC.
To execute the ToolKit, enter FOCUS by issuing:
```
EXEC FOCUS
```
If the SHELPROF option is not incorporated, the ToolKit may be executed from command line by issuing:
```
EXEC ISHFALOC
```
Note: The DB2 For VM Data Adapter must already be installed to take advantage of ToolKit DB2 For VM features.

Information Builders