Step 9--Tailor NLF/QMF for CICS

You can run this step after the QMF product has been tailored for CICS as described in Tailoring QMF for CICS. If you are migrating from QMF 3.1, you need to run all the steps except Step 9Da--update CICS control tables (CICS V2 only). (For information on CICS migration considerations, see Installing and Managing QMF for OS/390.)

Step 9A--Add NLF/QMF transaction ID to DB2 RCT

The database plan ID and authorization ID for a transaction are specified in the DB2 resource control table (RCT). For example, to specify a transaction ID of "QMFn" and an authorization ID of "DEPT1", add the following statement: 

DSNCRCT TYPE=ENTRY,TXID=QMFn,PLAN=QM720,AUTH=DEPT1

QMF ships a sample RCT entry located in QMF720.SDSQSAPn(DSQ1nRCT).

After the RCT is updated with information describing the QMF transaction to DB2, you must then regenerate your RCT.

Step 9B--Link-edit with DFHEAI and DFHEAI0

QMF uses the CICS command-level application programming interface to operate under CICS. You must link-edit QMF with the exec interface modules DFHEAI and DFHEAI0 before you can run any QMF programs. To include CICS interface modules DFHEAI and DFHEAI0, you must run this step each time you apply QMF service.

Substep 9Ba-- Link-edit QMF with CICS command interface modules

This job link-edits QMF NLF modules with CICS command level support modules DFHEAI and DFHEAI0.

Preparation

The job used in this step is QMF720.SDSQSAPn(DSQ1nLNK). Change the job statement to conform to your installation. Change, if necessary, the values for the installation parameters in the job's instream procedure:

Table 21. Installation parameters for DSQ1nLNK
Parameter name Description of value Default
QMFTPRE The prefix name of the QMF target libraries QMF720
REG The job-step region size 4096
OUTC The job output class *
CLOAD The name of the CICS load library CICS.LOADLIB

After completing this job, examine the listing and ensure that all modules have been link-edited successfully.

Note
You must rerun this job if any of the modules are changed by PTF.

Substep 9Bb--translate, assemble and link-edit the QMF supplied governor

Preparation

The job used in this step is QMF720.SDSQSAPn(DSQ1nGLK). Change the job statement to conform to your installation. Change, if necessary, the values for the installation parameters in the job's instream procedure:

Table 22. Installation parmaters for DSQ1nGLK
Parameter name Description of value Default
QMFTPRE The prefix name of the QMF target libraries QMF720
REG The job-step region size 4096
OUTC The job output class *
CLOAD The name of the CICS load library CICS.LOADLIB
CMACS The name of the CICS macro library CICS.MACLIB
SUFFIX The CICS ASM Translator suffix 1$
ASMBLR The name of the Assembler IEV90
WPRL The name of the work volume unit SYSDA

Step 9C--load QMF/GDDM map sets to the ADMF data set

Preparation

The job used in this step is QMF720.SDSQSAPn(DSQ1nADM). Change the job statement to conform to your installation. Change, if necessary, the values for the installation parameters in the job's instream procedure.

Table 23. Installation parameters for DSQ1nADM
Parameter name Description of value Default
QMFTPRE The prefix name of the QMF target libraries QMF720
REG The job-step region size 2048
GDDM The name of the GDDM ADMF data set GDDM.ADMF

Step 9Da--update CICS control tables (CICS V2 only)

Before you can run the NLF/QMF feature under CICS, QMF entries must be defined as follows:

FCT (file control table)

Describes the QMF panel file that contains NLF/QMF help and screen definitions. Add or copy member DSQ1nFCT (in library QMF720.SDSQSAPn) into existing FCT entries on your CICS system.

PCT (program control table)

Describes the QMF transaction name for this NLF/QMF. Add or copy member DSQ1nPCT (in library QMF720.SDSQSAPn) into existing PCT entries on your CICS system.

PPT (processing program table)

Describes the QMF programs that contain NLF/QMF constants and messages. Add or copy member DSQ1nPPT (in library QMF720.SDSQSAPn) into existing PPT entries on your CICS system.

After you include or copy members into your CICS system, assemble and link-edit.

Step 9Db--Update CICS control tables (CICS ESA only)

Before you can run the NLF/QMF feature under CICS, QMF entries must be defined in the CICS system definition file (CSD).

Preparation

The job used in this step is QMF720.SDSQSAPn(DSQ1nCSD). Change the job statement to conform to your installation. Change, if necessary, the values for the installation parameters in the job's instream procedure:

Table 24. Installation parameters for DSQ1nCSD
Parameter name Description of value Default
QMFTPRE The prefix name of the QMF target libraries QMF720
REG The job-step region size 2048
OUTC The job output class *
CLOAD THe name of the CICS load library CICS.LOADLIB
CCSD The name of the CICS CSD data set CICS.DFHCSD

Step 9E--Update CICS region job stream

The QMF panel file must be added to the existing JCL that is used to start the CICS region containing QMF. Add the following statement: 

//DSQPNLn DD DSN=QMF720.DSQPNLn,DISP=SHR

where n is the NLF character.

Step 9F--Run the IVP

Run the IVP as indicated in Step 33 (for CICS)--Run the IVP, changing the following names:

where n is the NLF character.

[ Previous Page | Next Page | Contents | Index ]