EZBCTAPI NMI: Invoking the interface

The EZBCTAPI macro accepts parameters to format trace records, in the form of component trace records (cte). The data is formatted in the same fashion as is done using the IBM®-provided packet trace and data trace formatters that are available with the IPCS CTRACE command. Note however that this interface does not require an IPCS environment to be active.

Requirement: High-level assembler language, Version 1 Release 5 or later is required to use this macro.

The EZBCTAPI macro enables users to pass component trace records to the format routine for processing and to obtain the formatted output text. The macro performs the following functions:

SETUP - Define the formatting environment with the various parameters.
FORMAT - Pass a record to the formatting interface.
TERM - Delete the formatting environment allowing final output to be shown.
QUIT - Delete the formatting environment without any final output. Summary and statistical reports created at the end of the processing will not be formatted. This request should be used for quick termination of the interface when no further output is desired.

The macros that are used with the interface are described in the following table.

Macros for assembler programs	Contents
EZBCTAPI	Used to format the records that are created by the SYSTCPDA interfaces.
EZBYPTO	Describes packet trace options for the formatter.

These macros are included in the SEZANMAC data set. This data set must be available in the concatenation when compiling or assembling a part that makes use of these definitions.