How can I inactivate all sessions when a user leaves TPX?

Document ID : KB000011294
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

All active sessions should be inactivated automatically when users logoff from TPX. How to achieve this?

Answer:

There are multiple options in TPX to control the inactivation of sessions when users signoff/logoff from TPX.

For users entering /F or /K at the TPX menu.

The action to be taken can be defined by 'Inactivate on:          (F=Signoff, K=Logoff)'

- Specifies whether TPX terminates application sessions when the user exits TPX. 

   If you don't specify either value listed  below, TPX leaves the sessions active.            
                                                                            
   Valid values:                                                            
                                                                            
    - F, active sessions are terminated when the user issues the /F or /K   
      command.                                                              
                                                                            
    - K, active sessions are terminated when the user issues the /K command.

The parameter 'Inactivate on:' can be set at the USER or PROFILE level.

 

SMRT 13 Optional Parameters: There are 2 additional options which can be set in SMRT.

Option 34 - This option is for users who have either F or K set in the Inactivate on user parameter. If they issue a /F or /K with active session(s), this option will cause a panel to be displayed asking if they want to continue with the signoff and force the session(s) inactive.

Option 35 - This option is for users who have either F or K set in the Inactivate on user parameter. If they issue a /F or /K with active session(s), this option will cause a panel to be displayed stating that they need to inactivate all sessions before attempting a signoff.

 

Signoff/logoff due to a 'level 1' timeout defined (SMRT 4 Timing Parameters)

'Stage 1 option' (on user/profile level) and 'Timeout Option - 1st Level' (in SMRT) define the action that should be taken when the first level timeout takes place.

Possible values are:

         F  -  return to the TPX LOGO as if /F command had been issued   
  --->   FI -  return to the TPX LOGO and inactivate all sessions        
         K  -  return to the VTAM screen as if the /K command was issued 
  --->   KI -  return to the VTAM screen and inactivate all sessions     
         L  -  lock the user's screen as if the /L command was issued

 

TPXUSIST (Session Initiation/Termination Exit) call Point 8

In addition to the above, TPXUSIST exit gets control when the terminal returns to VTAM (logoff) either normal (through a /K or PF3 from the TPX logo) or abnormal (e.g. by closing simply the TN3270 emulation). It is not called for signoff processing (/F).

Here you can setup special processing like:

  • inactivate all sessions in any case
  • inactivate all sessions for a group of users/terminals
  • inactivate all sessions on a LOSTERM condition
  • etc.

Please refer to the CA-TPX Systems Programmer Guide and the TPXUSIST exit sample in TPX.. .CB0VSRC.

 

Some sample scenarios:

    • Goal: I want to inactivate all sessions when a user's TPX session ends normal or abnormal
      • Specify 'Inactivate on: F'.
      • Implement a TPXUSIST which always returns from Call Point 8 with RC=4.
      • Specify 'Stage 1 option: KI' or 'Stage 1 option: FI' depending on your needs if you use timeout processing.

 

    • Goal: I want to inactivate all sessions when a user logs off TPX but sessions should be retained on signoff /F.
      • Specify 'Inactivate on: K'.
      • Implement a TPXUSIST which always returns from Call Point 8 with RC=4.
      • Specify 'Stage 1 option: KI' or 'Stage 1 option: F' depending on your needs if you use timeout processing.

 

    • Goal: I only want to inactivate all sessions when users simply close their TN3270 emulator. 
      • Do not specify a value in 'Inactivate on:'.
      • Implement a TPXUSIST which only returns from Call Point 8 with RC=4 if an error condition is detected otherwise with RC=0. Please refer to our sample exit in TPX.. .CB0VSRC(TPXUSIS2).
      • Specify 'Stage 1 option: K' or 'Stage 1 option: F' depending on your needs if you use timeout processing.

 

Additional Information:

The above options DO NOT apply to TPX users who have 'MULT' defined as as transfer option. Here TPX will always inactivate the virtual sessions by design.