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 install function of the group list on an initial or cold start of CICS
- The CEDA INSTALL command
- All autoinstall operations, as follows:
- The autoinstall of a terminal, connection, program, mapset, partitionset,
or journal
- The automatic discard of an unused terminal, controlled by the AILDELAY
system initialization parameter and the SIGNOFF parameter on the TYPETERM
resource definition.
- The connection to, and disconnection from, an MVS™ log stream
- A CEMT DISCARD and EXEC CICS DISCARD command
- The front-end programming interface (FEPI) install and discard operations:
the EXEC CICS FEPI INSTALL command and EXEC CICS FEPI DISCARD command.
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.
- 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
UEIDURIM
A URI map (URIMAP)
UEIDWEBS
A Web service (WEBSERVICE)
- 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.
[[ Contents Previous Page | Next Page Index ]]