Signon And Signoff Exits Xsnon, Xsnoff, And Xsnex - IBM SC34-6814-04 Customization Manual

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.

Signon and signoff exits XSNON, XSNOFF, and XSNEX

Exit XSNON is invoked after a terminal user signs on, and exit XSNOFF is invoked
after a terminal user signs off (whether the signon or sign-off is successful or not).
XSNON and XSNOFF do not make any security decisions; they are merely a
means of tracking users logging on and off a CICS system.
The activities which drive the exits are:
v Invocation of an EXEC CICS SIGNON command for a terminal (when, for
v Invocation of an EXEC CICS SIGNON command for a surrogate terminal (that is,
v Invocation of an EXEC CICS SIGNOFF command for a terminal
v When a 'CANCEL' command is entered to terminate a CRTE routing session
v A timeout sign-off.
XSNEX is a special-purpose global user point, which is intended to be used only
with the IBM-supplied global user exit program, DFH$SNEX.
Exit XSNON
When invoked
Exit-specific parameters
UERCPURG
Task purged during XPI call.
You can use all XPI calls.
example, the terminal user enters the CICS-supplied CESN, or an equivalent,
user-written, signon transaction)
a terminal attached by the CRTE routing transaction, or by dynamic transaction
routing)
When a user signs on.
UEPUSRID
Address of the terminal userid.
UEPUSRLN
Address of the terminal userid length.
UEPGRPID
Address of the group ID. If the signon was successful, the group ID
is that which the user is associated with in this signon session. If
the signon was unsuccessful, it is that specified by the user when
he or she tried to sign on.
UEPGRPLN
Address of the group ID length.
UEPNETN
Address of the terminal's netname.
Chapter 1. Global user exit programs
199