Previous Topic: Sign-on/off ExitNext Topic: Batch Signon/off Exit


Online Signon/off Exit

In online, the name you specify in the SONEXIT= parameter is the name of the exit you want to call at signon and signoff time. See DQOPTLST Parameters for information about the valid entries and default value of the SONEXIT= parameter.

A user-written Signon/off Exit for CICS must be a command or macro level CICS program. Information is passed to the user exit in an 80-byte CICS temporary storage record. The user exit reads the temporary storage record. The following is the format of the 8-character name for the temporary storage record:

DQnnnnSO

where nnnn is the CICS terminal ID.

The information passed consists of the following 80-byte area as follows:

  USRFUNC   DS   CL3    Function:      SON=signon
                                       SOF=signoff
                                       EOJ= end of job
  USROPID   DS   CL32   User's DQ user ID
  USRPASS   DS   CL9    User's DQ password
  USRDATE   DS   CL8    Date signed-on on(off), MM/DD/YY
  USRSOTIM  DS   XL4    Signon time in seconds
  USRSFTIM  DS   XL4    Signoff (or EOJ) time in seconds
  USRRETCD  DS   X      Return code:   0 if signon valid
                                       <>0 to deny signon
            DS   CL(80-(*-USRDSECT))   RFFU