How to clear a user that is stuck in the signon process for TPX?

Products

• TPX - Session Management
• Vman Session Management for z/OS

Issue/Introduction

A user is attempting to logon to TPX and gets a message similar to:

SIGNON DISALLOWED
USER SIGNON ALREADY IN PROGRESS

Environment

TPX® Session Management for z/OS

Cause

User already exists in TPX storage. They may have become "stuck" during the signon process or not properly cleaned up during the previous TPX session.

Resolution

First ensure that any and all fixes related to SIGNON have been applied. User storage will be cleared when TPX is cycled. To correct the situation without cycling TPX, you can use the following workarounds to delete the user from memory.

Workaround #1: 

This is the preferred method.

This is a new feature added to TPX 5.4 with PTFs RO86230 & RO86231: USER ID LOCKED, PROVIDE METHOD TO RELEASE USER ID

• ENHANCEMENT DESCRIPTION:  Update the MOD U= oper command to provide a method to free a locked user id. 

If you do not have these fixes applied, you will need to use workaround #2.

Use the TPXOPER command:  MOD U=userid,ERASE

ERASE - Removes the specified user ID from memory. This operand is for use with the U=userid only. TPX documentation - Operator Commands MODIFY Command

Workaround #2:  *** USE WITH CAUTION ***

It is strongly recommended that you discuss the appropriateness of taking this step with Broadcom Technical Support BEFORE proceeding.

1. Go into TPXOPER. Type 'D MEM,U=xxxxxxxx' where xxxxxxxx is the userid and press ENTER.
   
   
2. The Memory Display/Update screen is presented with the following fields:
   
   Sample TPXOPER display: D MEM,U=ABCDE01
   
   

   Field	Meaning
   ADDRESS	Hexadecimal address of memory in address space.
   OFFSET	Hexadecimal offset from beginning of location displayed.
   hex data	Each row contains four words of hexadecimal data at the indicated address.
   char data	Each row contains 16 bytes of character data at the indicated address. Non-displayable hexadecimal characters are translated to a period(.).

   
   
   
3. On first line of data under the heading line (ADDR OFFSET ...) go to the right side of the screen into the area between asterisks which is
   the character display area (NOT the hex area in the center).
   1. Behind the *UIDX you will see the userid that was specified in the D MEM command
   2. Type over the USERID in the character display area (outlined in red in the previous step), NOT in the hex area. We recommend using only upper-case letters, such as all X's. 
      - DO NOT use spaces.
      - DO NOT hit"erase eof ".
      - DO NOT key outside of the USERID otherwise TPX WILL ABEND.
4. Keying over the USERID creates a mock USERID linked to TPX and frees the valid USERID to logon again and continue.
5. Since the purpose of this is to create a phony USERID, you can key over part or all of the valid USERID, so long as the resulting USERID is not a 'real' USERID. Notice that the hex area (outlined in blue) above has not yet changed.
6. Press PF9 to update. The change will not take place until you press PF9.
7. Note that the hex area has changed to correspond to the new userid value: seven X's (hex E7) and a space (hex 40) has remained unchanged. (It is possible to have an eight character TSO userid, which is why the eighth character in this example was always a space.)
8. Press PF3 to end. This takes you back to OPER command line.
9. The original userid should now be able to logon to TPX.
   
   

Note: This procedure should be used with extreme caution!

Additional Information

For access to the ERASE parameter for MODIFY command, apply Published Solutions for TPX 5.4:  PTFs RO86230 TCP/IP INFO, SLOT LOG, RELOAD EXITS, DFLT SMRT, ERASE USER & RO86231 TCP/IP INFO, SLOT LOG, RELOAD EXITS, DFLT SMRT, ERASE USER

TPX documentation - Operator Commands DISPLAY Command for Memory