Exit xnqereq – IBM SC34-6814-04 User Manual

Page 82

Advertising
background image

UEPDMPDY

Buffer is about to be written, and the CICS dump data set is
a dummy file or is closed.

UEPDMPBF

Address of the dump buffer, whose length is addressed by the
parameter UEPDMPLEN.

UEPDMPLEN

Address of the 2-byte dump-buffer length.

Return codes

UERCNORM

Continue processing.

UERCBYP

Suppress dump record output.

XPI calls

WAIT_MVS can be used. Do not use any other calls.

Enqueue EXEC interface program exits XNQEREQ and XNQEREQC

The XNQEREQ exit allows you to intercept enqueue API requests before any action
has been taken on the request. The XNQEREQC exit allows you to intercept the
response after an enqueue API request has completed.

The API requests affected are:

v

EXEC CICS ENQ

v

EXEC CICS DEQ.

Using XNQEREQ, you can:

v

Analyze the API parameter list (function, keywords, argument values, and
responses).

v

Modify any input parameter value prior to execution of a request.

v

Prevent execution of a request. This enables you to replace the CICS function
with your own processing.

Using XNQEREQC, you can analyze the API parameter list.

You can also:

v

Pass data between your XNQEREQ and XNQEREQC exit programs when they
are invoked for the same request

v

Pass data between your enqueue exit programs when they are invoked within
the same task.

Exit XNQEREQ

When invoked

Before CICS processes an EXEC CICS ENQ or DEQ request, or attempts
to match it to an installed ENQMODEL resource definition.

Exit-specific parameters

UEPCLPS

Address of a copy of the command parameter list. See “The
command-level parameter structure” on page 63.

60

Customization Guide

Advertising