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.

Get Supporting On Demand Business Applications with the IBM Problem Determination Tools (APA, DT, DT with Advanced Facilities, FA, File Export, FM, WS) now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.