Log manager XPI functions

There are two XPI log manager functions. These are the DFHLGPAX calls:

These calls allow you to inquire upon, and set, the log manager parameter, KEYPOINT_FREQUENCY. The value in this parameter specifies the activity keypoint frequency of the CICS® region.

The INQUIRE_PARAMETERS call

INQUIRE_PARAMETERS returns information about the activity keypoint frequency of the system.

INQUIRE_PARAMETERS

DFHLGPAX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(INQUIRE_PARAMETERS),
      [OUT,
      [KEYPOINT_FREQUENCY(name4 | *),]
      RESPONSE(name1 | *),
      REASON(name1 | *)]

Start of changeThis command is threadsafe.End of change

KEYPOINT_FREQUENCY(name4 | *)
returns the activity keypointing frequency of the CICS region.
name4
The name of a 4-byte location that is to receive the frequency value.

RESPONSE and REASON values for INQUIRE_PARAMETERS:

RESPONSE REASON
OK None
DISASTER None
INVALID None
KERNERROR None

The SET_PARAMETERS call

SET_PARAMETERS allows you to set the activity keypoint frequency for the CICS region.

SET_PARAMETERS

DFHLGPAX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(SET_PARAMETERS),
      [KEYPOINT_FREQUENCY(name4 | (Rn) ),]]
      [OUT,
      RESPONSE(name1 | *),
      REASON(name1 | *)]

Start of changeThis command is threadsafe.End of change

KEYPOINT_FREQUENCY(name4 | *)
specifies the activity keypointing frequency of the CICS region.

Permitted values are 0, or any integer between 200 and 65535 inclusive.

name4
The name of a 4-byte location that contains the new frequency value.
(Rn)
A register that contains the new frequency value.

RESPONSE and REASON values for SET_PARAMETERS:

RESPONSE REASON
OK None
EXCEPTION OUT_OF_RANGE
DISASTER None
INVALID None
KERNERROR None
Note:
For more detail, refer to the explanation of RESPONSE and REASON in Making an XPI call.

Related concepts
Overview of the XPI
Global user exit XPI examples, showing the use of storage
Related tasks
Making an XPI call
Writing global user exit programs
Writing a task-related user exit program
Related reference
The XPI functions
[[ Contents Previous Page | Next Page Index ]]