Explanation
OMEGAMON for CICS has enabled or
disabled it GLUE code for the feature yyy, where yyy can be
ATF, MQ or DLI. xxxxx will be set to EXEN or OCSR2, depending on the
module which has issued the request.
System action
The messages are informational and may be used to verify which exits are affected by the
command(s) that you have issued.
The GLUE code will run at the following exit points:
- ATF uses XRMIOUT and XPCABND
- MQ uses XRMIOUT
- DLI uses XDLIPRE and XDLIPOST
Additional Documentation: You can now control which GLUEs are enabled (or disabled) in a
monitored CICS region by choosing the appropriate values in
your global source, or issuing the equivalent online commands. Be aware
that the exit code running at XEIOUT and XMNOUT is essential to the
operation of OMEGAMON for CICS so
these exits will not be disabled unless an OMEG SHUT / REMOVE command is
issued.
In the DATABASE_COLLECTION section coding
<<MQ>>
AUTO_START=NO
will not enable the GLUE code at XDLIPRE <<DLI>>
AUTO_START=NO
will not enable the GLUE code at XDLIPRE or XDLIPOST. In addition you must also
code the parameter, DLI_CLOCKS_AND_COUNTERS=NO
to ensure that the DLI exits are not
enabled. <<TRACE>>
AUTO_START=NO
If you do not use the Application Trace Facility, ATF, you will not enable code
at XPCABND or XRMIOUT (although XRMIOUT code will be active if you enable the MQ clocks and
counters.)
Excluding the entries is equivalent to coding AUTO_START=NO in the Global Data Area.
You can use the OMEGAMON for CICS (3270) command
COLL (fastpath= O.P) to turn the collection on or off, and the exits will be turned on or off
accordingly.
The OMEGAMON File/Database collection
and Application Trace Facility panels can also be used to control the data collection. The
exits will be enabled or disabled as appropriate.
The OOMEGAMON for CICS (3270) command EXIT
(fastpath=CI) will display the exits that are currently active.
The OMEGAMON Global User Exits panel
(fastpath=CE) will display the exits that are enabled in CICS.
In summary you can now expect to see GLUE code at the following exit points activated.
Exit Point Name DLI= MQ= ATF=
YES YES YES
XMNOUT Y Y Y
XEIOUT Y Y Y
As mentioned earlier, XMNOUT and XEIOUT will be
activated when an OMEG INIT transaction is run, or the KOCOME00 program executes in the PLT
XRMIOUT N Y Y
XPCABND N N N
XDLIPRE Y N N
XDLIPOST Y N N
In a CICS region with DLI, MQ and ATF active
you can expect to see all of the exit points active whereas a region with only DB2 (no DLI, no MQ, and no ATF) would only
have XMNOUT and XEIOUT active.
The OMEGAMON for CICS (3270) COLL command can
display one of the following messages, if a non zero return code is received during an attempt
to enable or disable an exit:
ENABLE EXIT REQUEST EIBRCODE 808000
ENABLE EXIT REQUEST EIBRCODE 804000
ENABLE EXIT REQUEST EIBRCODE 802000
ENABLE EXIT REQUEST EIBRCODE 801000
ENABLE EXIT REQUEST EIBRCODE 800800
ENABLE EXIT REQUEST EIBRCODE 800400
DISABLE EXIT REQUEST EIBRCODE 808000
DISABLE EXIT REQUEST EIBRCODE 804000
DISABLE EXIT REQUEST EIBRCODE 802000
DISABLE EXIT REQUEST EIBRCODE 801000
DISABLE EXIT REQUEST EIBRCODE 800800
The EIBRCODES are documented in the CICS System
Programming Reference under ENABLE PROGRAM and DISABLE PROGRAM. If you receive any of these
messages you should determine the cause of the error using the CICS documentation and correct the
error before reissuing the command.