The inquire_system call, The inquire_system – IBM SC33-1683-02 User Manual

Page 387

Advertising
background image

The INQUIRE_SYSTEM call

The INQUIRE_SYSTEM call gives you access to CICS system data in the AP
domain.

INQUIRE_SYSTEM

DFHSAIQX [CALL,]

[CLEAR,]

[IN,

FUNCTION(INQUIRE_SYSTEM),

[GMMTEXT(name4),]]

[OUT,

[CICSREL(name4 | *),]

[CICSSTATUS(ACTIVE | FINALQUIESCE |

FIRSTQUIESCE| INITIALIZING),]

[CICSSYS(name1 | *),]

[CICTSLEVEL(name6 | *),]

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

[CWALENGTH(name2 | *),]

[DATE(name4|*),]

[DTRPRGRM(name8 | *),]

[GMMLENGTH(name2 | *),]

[GMMTRANID(name4 | *),]

[INITSTATUS(FIRSTINIT | INITCOMPLETE | SECONDINIT |

THIRDINIT),]

[JOBNAME(name8 | *),]

[OPREL(name2 | *),]

[OPSYS(name1 | *),]

[OSLEVEL(name4 | *),]

[PLTPI(name2 | *),]

[SDTRAN(name4 | *),]

[SECURITYMGR(EXTSECURITY | NOSECURITY),]

[SHUTSTATUS(CONTROLSHUT | NOTSHUTDOWN | SHUTDOWN),]

[STARTUP(COLDSTART | EMERGENCY | WARMSTART),]

[STARTUPDATE(name4| *),]

[TERMURM(name8 | *),]

[TIMEOFDAY(name4| *),]

[XRFSTATUS(NOXRF | PRIMARY | TAKEOVER),]

RESPONSE (name1 | * ),

REASON (name1 | * )]

CICSREL(name4 | *)

returns the level number of the CICS code under which the CICS region is
running.

name4

The name of a 4-byte location that is to receive the level number
characters as hexadecimal values.

CICSSTATUS(ACTIVE|FINALQUIESE|FIRSTQUIESCE|INITIALIZING)

returns the status of the CICS region.

ACTIVE

The CICS region is active and ready to receive work.

FINALQUIESCE

The CICS region is shutting down, and is in the final stage of quiescing.

FIRSTQUIESCE

The CICS region is shutting down, and is in the first stage of quiescing.

INITIALIZING

The CICS region is initializing.

state data access functions

Chapter 3. The user exit programming interface (XPI)

355

|

Advertising