SMF 123-2 zOS Connect - API Requester

Introduction

Using SMF records to monitor requests

z/OS® Connect EE can be configured to write SMF 123 records, which capture information about individual API provider, API requester and administration requests. This data can be used for auditing, workload monitoring, capacity planning, and problem determination.

Monitoring API provider and API requester requests
SMF 123 records have two subtypes and each subtype can have different versions.

SMF type 123 subtype 1 recordsVersion 1 contains some basic information about both API provider and API requester requests.Version 2 supersedes version 1 and contains more detailed information about each API provider request, including information about which system of record (SOR) the request was sent to. The version 2 record contains data for multiple requests in one record, making it more efficient as the server information is captured once per record rather than for each request.SMF type 123 subtype 2 recordsVersion 2 supersedes subtype 1 version 1 and contains more detailed information about each API requester request, including information about what HTTP endpoint the request was sent to. The version 2 record contains data for multiple requests in one record, making it more efficient as the server information is captured once per record rather than for each request.

Important: SMF 123 subtype 1 version 2 and SMF 123 subtype 2 version 2 together are known as version 2 of the SMF 123 records. Version 2 records contain data for multiple requests in a single SMF record. Therefore, the record is only written when either of the following conditions is met:

The server processes the required number of requests to fill a record. Currently this is 20.
The server is shutdown.
z/OS Connect EE provides the audit interceptor to capture SMF 123 records, see Configuring the audit interceptor. By default the audit interceptor captures version 1 records. To enable version 2 records, you must specify the required attributes for API provider and API requester.

CAUTION:
SMF 123 version 2 records are not a compatible extension of the version 1 records. Therefore, before you select version 2 of the records, check that the tools you use to format SMF 123 records support the version 2 format.

Monitoring administration requests
The audit interceptor monitors all administration requests sent to z/OS Connect EE. This includes administration requests for APIs, services and API requester resources.

Note: All administration requests are classified as API provider requests and are therefore written as SMF 123 subtype 1 records.

API provider data from SMF type 123 subtype 1 version 2 records.
The SMF type 123 subtype 1 version 2 record is used to capture enhanced data for individual API provider requests.
API requester data from SMF type 123 subtype 2 version 2 records.
The SMF type 123 subtype 2 version 2 record is used to capture enhanced data for individual API requester requests.
Request data from SMF type 123 subtype 1 version 1 records
The SMF type 123 subtype 1 version 1 record is used to capture some basic data for individual requests.

zOS Connect is a product used to make easier the interface between user applications and mainframe, and auditing is made through SMF record 123.

SMF 123 has 2 subtypes, subtype 1 used to list API Provider fields and subtype 2, used to list API requester fields.

Both subtypes can be produced with less and simple information, what is called VERSION 1, which is the default, and with more details and with more data (VERSION 2). To produce VERSION 2 SMF records is necessary to modify the configuration in zOS Connect parameters.

Fields

Stored in zcoar