State data access functions, The inq_application_data call – IBM SC33-1683-02 User Manual

Page 384

Advertising
background image

State data access functions

The state data access functions allow you to inquire on and set certain system data
in the AP domain.

The INQ_APPLICATION_DATA call

The INQ_APPLICATION_DATA call enables you to inquire on application system
data in the AP domain.

INQ_APPLICATION_DATA

DFHAPIQX [CALL,]

[CLEAR,]

[IN,

FUNCTION(INQ_APPLICATION_DATA),]

[OUT,

[DSA(name4 | (Rn) | * ),]

[EIB(name4 | (Rn) | * ),]

[RSA(name4 | (Rn) | * ),]

[SYSEIB(name4 | (Rn) | * ),]

[TCTUA(name4 | (Rn) | * ),]

[TCTUASIZE(name4 | * ),]

[TWA(name4 | (Rn) | * ),]

[TWASIZE(name4 | (Rn) | * ),]

RESPONSE (name1 | * ),

REASON (name1 | * )]

DSA(name4 | (Rn | * )

returns the head of the chain of dynamic storage used by application programs
to make them reentrant (for example, for assembler programs, the DFHEISTG
storage).

name4

The name of a 4-byte area that is to receive the address of the head of
the dynamic storage chain.

(Rn)

A register that is to receive the DSA address.

*

The parameter list itself, in name APIQ_DSA, is used to hold the
address.

EIB(name4 | (Rn) | *)

returns the address of the EXEC interface block (EIB) for the current task.

name4

The name of a fullword area that is to receive the address of the EIB.

(Rn)

A register that is to receive the address of the EIB.

*

The parameter list itself, in name APIQ_EIB, is used to hold the
address.

RSA(name4 | (Rn | * )

returns the address of the register save area for the current task.

name4

The name of a fullword area that is to receive the address of the
register save area.

(Rn)

A register that is to receive the address of the register save area.

*

The parameter list itself, name APIQ_RSA, is used to hold the address.

state data access functions

352

CICS TS for OS/390: CICS Customization Guide

Advertising