Supporting On Demand Business Applications with the IBM Problem Determination Tools (APA, DT, DT with Advanced Facilities, FA, File Export, FM, WS)

500 Supporting On Demand Business Applications with the IBM Problem Determination Tools

17.1 Coverage Utility

To effectively use DTCU (Debug Tool Coverage Utility), you must customize it first.

17.1.1 DTCU customization

This section describes:

򐂰 Where to place certain Coverage Utility load modules so that the correct people have

access to them

򐂰 How to install the monitor SVCs

򐂰 How to customize the product

Make the load modules in hlq.SEQAMOD accessible to all users

Certain Coverage Utility load modules must be placed in an APF-authorized data set that is

accessible to all your users. The APF-authorized data set does not need to be in the link list.

Perform the following steps:

1. Mark the hlq.SEQAMOD data set as APF-authorized and make it accessible to all users or

copy the following load modules to an APF-authorized data set that all users can access:

– EQACUOCM (monitor interface)

– EQACU9M0 (monitor messages)

– EQACU9M1 (monitor messages)

– EQACU9M2 (monitor messages, and only if the JPN feature is installed)

2. Add the EQACUOCM program to the AUTHPGM entry in the member IKJTSOxx of the

SYS1.PARMLIB data set.

3. Issue the PARMLIB UPDATE(xx) command from TSO or IPL your system.

4. Edit the EQASTART member of the hlq.SEQAEXEC data set and set the

INST_Auth_SEQAMOD variable to the name of the data set from step 1 that contains

EQACUOCM.

Placing load modules in an APF data set not accessible to general users

Certain Coverage Utility load modules must be placed in an APF-authorized data set that is

accessible only to system programmers. The APF-authorized data set must not be in the link

list. Do one of the following:

򐂰 Mark the hlq.SEQAAUTH data set as APF-authorized and limit access to these load

module.

򐂰 Do not mark the hlq.SEQAAUTH data set as APF-authorized. Copy the following load

modules into an APF-authorized data set that only system programmers can access:

– EQACUOIN (SVC installer)

– EQACUOSV (SVCs)

Installing and enabling the monitor SVCs

The EQACUOIN module installs and enables the monitor SVCs. The monitor SVCs must be

installed and enabled before a user starts a monitor session. The EQACUOIN module must

be run:

򐂰 When the SVCs are initially installed

򐂰 After service is applied

򐂰 Any time you IPL your system

Chapter 17. Debug Tool Utilities and Advanced Functions 501

The monitor SVCs use a common system storage, as described later. In addition, each user

session uses ECSA storage:

򐂰 CSA: 13248 bytes

򐂰 SQA: 25496 bytes

To perform the initial installation:

1. Reserve two free user SVC numbers. IEASVCxx does not need to be updated since these

user SVCs are installed dynamically.

2. Customize the EQACUOIS member of the hlq.SEQASAMP data set.

3. Submit EQACUOIS on the system on which you intend to run the monitor.

4. To verify that the monitor was installed properly, run the following command from ISPF 6:

ex 'hlq.SEQAEXEC(EQACUOSE)' 'LEVEL'

Verify that the monitor release is V6R1M0 and the date is 2002.245 or later, as shown in

Example 17-1.

Example 17-1 EQACUOSE reply

********************************* Top of Data **********************************

Monitor Release: V6R1M0 Date: 2002.245

MAST: 00FC0620 PSA: 00FA9000 CPU: 00000000 SEST: 00FC0308 UNID: 00000000

******************************** Bottom of Data ********************************

To have the monitor SVCs installed automatically after a system IPL, make the following

changes:

1. Add COM='S EQACUOIN' to the COMMNDxx member of the SYS1.PARMLIB data set.

2. Copy and customize hlq.SEQASAMP(EQACUOPS) to your SYS1.PROCLIB data set as

member EQACUOIN.

3. The process started by EQACUOIN must have access to the EQACUOIN and

EQACUOSV load modules.

Customizing the product defaults

Complete the following steps to edit hlq.SEQAEXEC(EQACUDFT):

1. Change all occurrences of EQAW to hlq.

2. In the execute step data entry for EXEJOBLB, change the name hlq.SEQAMOD to the

name of the APF-authorized data set you used for the EQACUOCM program.

3. Enter the Coverage Utility Monitor SVC numbers (in hexadecimal notation) in the

CUSVC2B and CUSVC4B entries.

4. When you create JCL, the *JOBLn lines become the first three lines of the JOB card for

each respective job. Customize these lines.

5. If your site requires a specification for allocation parameters such as STORCLAS or UNIT

on new or temporary data set allocations, look for the word SPACE in this EXEC and the

'hlq.SEQAS*' data sets and update the allocation specifications.

6. If you want Coverage Utility to generate or build each data set as sequential or partitioned,

set the USEPRGNM variable to Y. To generate a data set as sequential, set the DSORG

variable to SEQ. To generate a data set as partitioned, set the DSORG variable to PDS.

7. If you do not want Coverage Utility to generate or build any data set names automatically,

set the USEPRGNM variable to N.