This appendix describes how to customize the installation verification program QCIVP.
This appendix describes how to customize the installation verification program QCIVP.
After the Toad IBM DB2 z/OS Components Installation wizard finishes its tasks, you must perform additional tasks on the mainframe to complete the installation. The last of these mainframe tasks is to run QCIVP
, a mainframe installation verification program. QCIVP
verifies that the IBM DB2 CLI has been installed and bound. It also runs a sample of the components’s procedures and functions and then writes the output to the QSPRINT
message file.
The dataset member permhlq
.JCLLIB(QCIVP
) contains the JCL for running QCIVP
. This dataset is created during the z/OS components installation process you perform on the mainframe.
The instructions for running QCIVP
, as well as for performing all other tasks required to complete the installation on the mainframe, are found in the README
file for the Toad IBM DB2 z/OS Components installation. This README
file is found in either location:
Plugins\DB2\ZOS
directory under your Toad for DB2 installation directory. Before running QCIVP
, you might need to edit the program it if any of the following situations is valid:
QCIVP
is running so that a series of trace messages are written to a user-supplied file for every call to a CLI function for that job.
DSNHDECP
member in the library), the default subsystem ID in DSNHDECP
matches one of the subsystem IDs, but not the others. You need a mechanism for providing the correct IBM DB2 subsystem ID for connection to the subsystems whose IDs do not match the default SSID in DSNHDECP
. You can accomplish this by coding a DSNAOINI
override in QCIVP
. Use the appropriate procedure to edit QCIVP:
Use the following procedure to edit QCIVP
to enable application tracing for the duration of the QCIVP
job.
Note: Enabling tracing for QCIVP
does not affect the long-term results obtained from the WLM procedures.
To enable application tracing
permhlq
.JCLLIB(QCIVP)
in an ISPF EDIT session (where permhlq
is the high-level qualifier for the permanent location where the z/OS component was installed).
Type NUM OFF
at the EDIT session command line to turn off sequence numbering.
Note: If you fail to turn sequence numbering off, errors can occur. Be aware that you might need to turn sequence numbering off each time you edit QCIVP
.
Add the following cards to QCIVP
:
QCIVP
.
permhlq
.JCLLIB(QCIVP)
in another ISPF EDIT session. There should be no sequence numbers in columns 73-80 for lines appearing between //DSNAOINI
and the //*
line.
FIND X ‘AD’ ALL
in the command line, and press Enter.
FIND
command locates all the left brackets.
FIND X ‘BD’ ALL
in the command line, and press Enter.
FIND
command locates all right brackets.
FIND
failed to located even one bracket, type HEX ON
in the command line, press Enter, and then make the appropriate edits in HEX
mode.QCIVP
. Use the following procedure to edit QCIVP
to disable application tracing for the duration of the QCIVP
job.
To disable application tracing
permhlq
.JCLLIB(QCIVP)
in an ISPF EDIT session (where permhlq
is the high-level qualifier for the permanent location where the z/OS component was installed).
Type NUM OFF
at the EDIT session command line to turn off sequence numbering.
Note: If you fail to turn sequence numbering off, errors can occur. Be aware that you might need to turn sequence numbering off each time you edit QCIVP
.
QCIVP
.
permhlq
.JCLLIB(QCIVP)
in another ISPF EDIT session. There should be no sequence numbers in columns 73-80 for lines appearing between //DSNAOINI
and the //*
line.
FIND X ‘AD’ ALL
in the command line, and press Enter.
FIND
command locates all the left brackets.
FIND X ‘BD’ ALL
in the command line, and press Enter.
FIND
command locates all right brackets.
FIND
failed to located even one bracket, type HEX ON
in the command line, press Enter, and then make the appropriate edits in HEX
mode.QCIVP
. Use the following procedure both to enable application tracing and to change the IBM DB2 SSID from the default value in the DSNHDECP
to the actual IBM DB2 SSID for the subsystem on which you are installing the z/OS components.
To enable application tracing and change the default IBM DB2 SSID
permhlq
.JCLLIB(QCIVP)
in an ISPF EDIT session (where permhlq
is the high-level qualifier for the permanent location where the z/OS component was installed).
Type NUM OFF
at the EDIT session command line to turn off sequence numbering.
Note: If you fail to turn sequence numbering off, errors can occur. Be aware that you might need to turn sequence numbering off each time you edit QCIVP
.
QCIVP
.
permhlq
.JCLLIB(QCIVP)
in another ISPF EDIT session. There should be no sequence numbers in columns 73-80 for lines appearing between //DSNAOINI
and the //*
line.
FIND X ‘AD’ ALL
in the command line, and press Enter.
FIND
command locates all the left brackets.
FIND X ‘BD’ ALL
in the command line, and press Enter.
FIND
command locates all right brackets.
FIND
failed to located even one bracket, type HEX ON
in the command line, press Enter, and then make the appropriate edits in HEX
mode.QCIVP
. Use the following procedure to change the IBM DB2 SSID from the default value in the DSNHDECP
to the actual IBM DB2 SSID for your subsystem without enabling application tracing.
To change the default DB2 SSID without enabling application tracing
permhlq
.JCLLIB(QCIVP)
in an ISPF EDIT session (where permhlq
is the high-level qualifier for the permanent location where the z/OS component was installed).
Type NUM OFF
at the EDIT session command line to turn off sequence numbering.
Note: If you fail to turn sequence numbering off, errors can occur. Be aware that you might need to turn sequence numbering off each time you edit QCIVP
.
QCIVP
.
permhlq
.JCLLIB(QCIVP)
in another ISPF EDIT session. There should be no sequence numbers in columns 73-80 for lines appearing between //DSNAOINI
and the //*
line.
FIND X ‘AD’ ALL
in the command line, and press Enter.
FIND
command locates all the left brackets.
FIND X ‘BD’ ALL
in the command line, and press Enter.
FIND
command locates all right brackets.
FIND
failed to located even one bracket, type HEX ON
in the command line, press Enter, and then make the appropriate edits in HEX
mode.QCIVP
. © 2024 Quest Software Inc. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy Cookie Preference Center