Exit xtsqrin, Xtsptout – IBM SC34-6814-04 User Manual

Page 229

Advertising
background image

XPI calls

All other XPI calls except WRITE_JOURNAL_DATA can be used. However,
their use is not recommended, because they could cause the task to lose
control, thus allowing another task to write more monitoring data.

Temporary storage domain exits XTSQRIN, XTSQROUT, XTSPTIN, and
XTSPTOUT

The temporary storage domain exits XTSQRIN, XTSQROUT, XTSPTIN, and
XTSPTOUT allow you to:

v

Specify, for a request that creates a queue, whether the queue is to be held in
main or auxiliary storage, and its recoverability

v

Monitor the use of temporary storage

v

Control security for temporary storage queues.

The temporary storage domain has two main gates, TSQR, and TSPT, which
support the following functions:

TSQR Write, Rewrite, Read_into, Read_set, Read_next_into, Read_next_set,

Delete.

TSPT

Put, Put_replace, Get, Get_set, Get_release, Get_release_set, Release.

The TSQR functions correspond to those available through the EXEC CICS
interface (or through DFHTS TYPE=PUTQ, GETQ, or PURGE). The TSPT functions
are used by the interval control program in support of START and RETRIEVE
functions (or DFHTS TYPE=PUT, GET, or RELEASE).

Exit XTSQRIN

When invoked

Before execution of a user temporary storage interface request for a user
TS queue (for example, a WRITEQ TS, or READQ TS request).

Exit-specific parameters

UEPTRANID

Address of the 4-byte transaction ID.

UEPUSER

Address of the 8-byte user ID.

UEPTERM

Address of the 4-byte terminal ID.

UEPPROG

Address of the 8-byte application program name.

UEP_TS_FUNCTION

Address of a byte containing the function:

v

UEP_TS_FUN_WRITE

v

UEP_TS_FUN_REWRITE

v

UEP_TS_FUN_READ_INTO

v

UEP_TS_FUN_READ_SET

v

UEP_TS_FUN_READ_NEXT_INTO

v

UEP_TS_FUN_READ_NEXT_SET

v

UEP_TS_FUN_DELETE

Chapter 1. Global user exit programs

207

Advertising