Resource management install and discard exit XRSINDI

The XRSINDI global user exit is driven, if it is enabled, immediately after CICS® successfully installs or discards a resource definition.

The install and discard activities that drive the exit are as follows:

The parameter list is designed to pass the names of more than one resource installed or discarded, in field UEPIDNAM. When designing your global user exit program, do not assume that the number of resource names passed is always one. You are recommended to analyze the resources within a loop based on the value referenced by UEPIDNUM.

Note that the names of modegroups are prefixed with the corresponding connection name. There is no separator between the two names: the first four characters form the connection name, followed by eight characters for the modegroup. The parts of the concatenated name are fixed length--if connection names are defined with less than four characters, they are padded with blanks in the concatenated names. Similarly, the connection names for a front-end programming interface (FEPI) connection is a concatenation of a FEPI node name and a FEPI target name, each of which is 8 characters long (fixed length) with no separator.

The exit is driven once for each individual resource in a group list installed during a CICS initial or cold start. If you are concerned about the performance overhead on an initial or cold start, do not enable the exit until after the group list is installed. To obtain the information about resources installed prior to enabling the exit, you can write a program to scan the tables of installed resources, using the EXEC CICS INQUIRE resource_name browse function.

Exit XRSINDI

When invoked
Whenever CICS installs or discards a resource definition.
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.
UEPIDREQ
Address of the 1-byte install or discard identifier. The values are:
UEIDINS
This request is for an install (or in the case of a log stream, it is a connection to a log stream).
UEIDDIS
This request is for a discard (or in the case of a log stream, it is a disconnection from a log stream).
UEPIDTYP
Address of the 1-byte type of resource. The values are:
UEIDAITM
An autoinstall terminal model
UEIDBEAN
An enterprise bean.
Note:
XRSINDI is called once for each bean in a deployed JAR file. For install, these calls occur after the call for the install of the DJAR. For discard, they occur before the call for the discard of the DJAR.
UEIDCONN
A connection
UEIDCSRV
A CorbaServer execution environment for enterprise beans and CORBA stateless objects (CORBASERVER)
UEIDDB2C
A DB2® connection
UEIDDB2E
A DB2 entry (DB2ENTRY)
UEIDDB2T
A DB2 transaction (DB2TRAN)
UEIDDJAR
A deployed JAR file (DJAR)
UEIDDOCT
A DOCTEMPLATE
UEIDFECO
A FEPI connection
UEIDFENO
A FEPI node
UEIDFEPO
A FEPI pool
UEIDFEPS
A FEPI propertyset
UEIDFETA
A FEPI target
UEIDFILE
A file
UEIDJNMD
A journal model
UEIDJNNM
A journal name
UEIDMAP
A mapset
UEIDMODE
A modegroup
UEIDNQRN
An ENQMODEL
UEIDPART
A partner
UEIDPROF
A profile
UEIDPROG
A program
UEIDPRTY
A BTS process-type
UEIDPSET
A partitionset
UEIDRQMD
A request model (IIOP)
UEIDSESS
A session
UEIDSTRM
An MVS log stream
UEIDTCLS
A transaction class
UEIDTCPS
A TCP/IP service
UEIDTDQU
A transient data queue
UEIDTERM
A terminal
UEIDTRAN
A transaction
UEIDTSMD
A temporary storage queue model
Start of changeUEIDURIMEnd of change
Start of changeA URI map (URIMAP)End of change
Start of changeUEIDWEBSEnd of change
Start of changeA Web service (WEBSERVICE)End of change
UEPIDLEN
Address of the length of an individual resource name, as a full-word binary value.
UEPIDNUM
Address of the number of resources reported by this call, as a full-word binary value.
UEPIDNAM
Address of a variable-length list containing the names of the individual resources reported by this call.
UEPIDREC
Address of a 1-byte identifier indicating whether resources are recovered at a warm or emergency restart. The values are:
UEIDKEEP
The resources are recoverable at a warm or emergency restart.
UEIDLOSE
The resources are not recoverable.
Note:
The exit is not driven during a CICS restart.
Return codes
UERCNORM
Continue processing. This is the default.
UERCPURG
Task purged during XPI call.
XPI calls
You can use all XPI calls.
Important

Abends in a program enabled at the XRSINDI exit point may cause CICS to terminate, because for some resources the exit is driven during syncpoint. If the exit returns code UERCPURG during syncpoint for these resources, abend code AUEP is produced and CICS terminates.

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