IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

148 IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

10.2 IMS Connect traces

The IMS Connect traces normally are only used if requested by the IBM support center while

analyzing a problem. This section helps you to identify how to process these traces and how

to read them in order to provide better information to IBM.

The IMS Connect Base Primitive Environment (IMS Connect BPE) is the component that

provides the tracing services.

10.2.1 BPE configuration

You can enable the IMS Connect traces by updating the IMS Connect startup configuration

member, as specified by the BPECFG parameter. See Chapter 4, “Configuring IMS Connect”

on page 43 for a description of this member.

The following keywords are available for the BPE configuration parameter member:

 LANG

The LANG parameter specifies the language used for IMS Connect BPE and IMS Connect

messages. ENU is for U.S. English, which is currently the only supported language.

 TRCLEV

The TRCLEV parameter specifies the trace level for a trace table and, optionally, the

number of pages of storage allocated for the trace table. TRCLEV controls the level of

tracing (the amount of detail traced) for each specified trace table type. BPE-managed

trace tables are areas in storage where IMS Connect BPE, and IMS Connect, can trace

diagnostic information about events going on within the address space. Each trace table

has a trace table type associated with it. A trace table’s type refers to the kind of events

that are traced into that table. For example, the BPE DISP trace table contains entries

related to events in the BPE dispatcher.

IMS Connect BPE-managed trace tables are internal incore tables only. Trace records are

not written to any external data sets. Some trace table types are defined and owned by

IMS Connect BPE itself. These are known as system trace tables. IMS Connect also

defines its own trace tables. These are known as component trace tables or user-product

trace tables.

Refer to Chapter 4, “IMS Connect Definition and Tailoring,” in IMS Version 9: IMS Connect

Guide and Reference, SC18-9287, for detailed information about the traces available.

10.2.2 Formatting incore trace tables

IMS Connect trace tables are incore tables, you can format them from a dump of an IMS

Connect address space by using the IMS Connect Dump Formatter of the Interactive

Problem Control System (IPCS).

The standard IMS Connect BPE formatting services format the traces. You must link-edit

HWSFTRC0 with an alias of HWSFTvrm (where v is the version level, r is the release level,

and m is the modification level). For example, IMS Connect V9.1.0 would have the alias of

HWSFT910.

The HWSFTRC0 is link-edited as HWSFT910 and must reside in the IMS formatting library to

use for formatting IMS Connect. Example 10-5 on page 149 shows the include, alias, and

name statement.