Step 3--Run QMF installation exec: DSQ2EINS

This section describes the following topics:

• Preparing to run the installation exec
• What the installation exec does
• Running the installation exec
• Installation exec error messages

Preparation

The information you provided in Step 1--Create QMF installation control file: DSQ2ECTL is used by the QMF installation exec. Before running this exec:

1. You must have access to the QMF distribution disk in WRITE mode.
2. Ensure that the QMF installation control file QMF720E INSTALL exists on the distribution disk.
3. Ensure that you are linked to the DB2 for VM production minidisk in READ mode.
4. You can let the printer and console continue processing unless a severe error is found, by issuing the following CMS commands:

   spool prt cont hold
   spool console start cont

Assumptions for installing QMF into a remote database server

Before you attempt to install QMF on a remote database server, be sure to complete the necessary pre-requisites described in installing QMF into a workstation database server on VM.

What the installation exec does

All output from the installation exec is routed to the virtual printer spool file.

Substeps:

• Substep 3.1: Builds the SQL commands to acquire the DB2 DBSPACEs.
• Substep 3.2: Establishes a DB2 for VM CONNECT ID of Q.
• Substep 3.3: Reloads the QMF installation program packages.
• Substep 3.4: Creates the QMF control tables and QMF catalog views.
• Substep 3.5: Reloads the QMF SQL Packages into a DB2 for VM database.
• Substep 3.6: Discards any QMF sample tables, if they exist.
• Substep 3.7: Creates the QMF Version 7.2 sample tables.

Running the QMF installation exec

To start the installation exec, issue:

DSQ2EINS

Restart procedure

If this exec fails, use the following procedure to restart the exec and continue where you left off:

1. Determine what the problem is and fix it.
2. Rerun this exec with an input parameter equal to the restart value provided in the message after the exec terminates.

For example, if you receive the message:

TERMINATING EXECUTION ...
TO RESTART THIS EXEC AND CONTINUE WHERE YOU LEFT OFF:
  - FIX THE PROBLEM ENCOUNTERED.
  - RERUN THIS EXEC WITH THE INPUT PARAMETER OF 2

You can restart the exec with the statement:

DSQ2EINS 2

Installation exec error messages

If you encounter a problem running the QMF installation exec, you need to find the error message describing the problem. This error message may be sent to either the console or the printer; therefore you may want to spool your console and your printer to "HOLD".

If you choose to spool your printer or console, be aware that you may have to enter both of the following statements to release the file that contains the error information:

          spool prt close
          spool console close

Error messages produced by the SQLDBSU exec are sent to the printer. If you see a console message like "Errors processing SQLDBSU", you should examine the output sent to the printer. The command to transfer the printer files to your reader, so that you can view them there, is:

   TRANS PRT ALL *

Look in the DB2 Server for VM Message and Codes manual for explanations of any error messages starting with "ARI".