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

Products

• TPX - Session Management

Issue/Introduction

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

Environment

Release:  5.4
Component: TPX for Z/Os

Resolution

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.