CA TPX start generates an ABEND=S000 U0001 REASON=00000000 in module NVISION

Products

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

Issue/Introduction

Why does TPX abend with USER abend code 0001. The following symptom dump is observed:

IEF403I TPX - STARTED                                                
IEA995I SYMPTOM DUMP OUTPUT  489                                     
  USER COMPLETION CODE=0001                                          
 TIME=10.47.05  SEQ=00305  CPU=0000  ASID=0079                       
 PSW AT TIME OF ERROR  078D1000   0000F86E  ILC 2  INTC 0D           
   ACTIVE LOAD MODULE           ADDRESS=000070A0  OFFSET=000087CE    
   NAME=NVISION                                                      
   DATA AT PSW  0000F868 - 00181610  0A0D1817  47F0C518              
   GR 0: 80000000   1: 80000001                                      
      2: 00000000   3: 00000014                                      
      4: 009E8AB0   5: 80006FB6                                      
      6: 009D9FE0   7: 00006F18                                      
      8: 00006FB0   9: 0001F0A8                                      
      A: 0001ECC0   B: 0001D038                                      
      C: 0000F360   D: 0001EC78                                      
      E: 0000729A   F: 0000F360                                      
 END OF SYMPTOM DUMP                                                 
IEF450I TPX TPX - ABEND=S000 U0001 REASON=00000000                   
IEF404I TPX - ENDED

Environment

CA TPX for z/OS

Cause

There can be various reasons for encountering a User 0001 abend.

In this case, the abend U0001 was triggered because required values for parameters  'SMRT'  and  'ACT' are missing from the procedure.
The Default PROC in the install library has been modified by the user. At TPX start, SMRT= and ACT=  cannot be 'blank'

Resolution

The following incorrect PROC was used that triggered the abend.
 

//TPX     JOB (acct),'TPX',MSGCLASS=...
//*                                           
//TPX    PROC TPREFIX='TPX.TPXPROD',    TPX DATASET NAME PREFIX        
//             VNODE=APTPX,           THE TPX APPL MEMBER IN VTAMLST 
//             SMRT=,                 SYSTEM OPTIONS TABLE                           <== Cannot be a blank
//             ACT=,                  APPL CHARACTERISTICS TABLE                     <== Cannot be a blank
//             PRTB=,                 PRINT DESTINATION TABLE        
//             VMSK=,                 VIRTUAL TERMINAL MASKING TABLE 
//             TMSK=,                 TERMINAL OPTIONS TABLE         
//             PPS=,                  USER PASSTHRU PRINT TABLE      
//             OVAC=,                 OV/MVS APPL CONNECTIVITY TABLE 
//             SAMT=,                 SECURITY ACTION/MESSAGE TABLE  
//             MODETAB=,              MODE TABLE NAME                
//             DUMP=H,                DUMP SYSOUT CLASS              
//             OUT=H                  LOG AND OTHER SYSOUTS          
//*
//TPX     EXEC PGM=NVISION,

 

As part of the TPX install process, sample data is loaded into ADMIN1 and ADMIN2. This includes a SMRT (Session Manager Resource Table) called SMRTTEST and an ACT (Application Characteristics Table) called ACTTEST.

We suggest that you leave the defaults provided in the install member. Once you move beyond using the delivered examples, you can simply override the defaults in the PROC. In addition, if you ever find yourself in an error situation with your SMRT or ACT, you can fall back to the defaults for testing.

Here is an example of the default PROC displaying the default values

//TPX    PROC TPREFIX='TPX.TPXPROD',    TPX DATASET NAME PREFIX        
//             VNODE=APTPX,           THE TPX APPL MEMBER IN VTAMLST 
//             SMRT=SMRTTEST,         SYSTEM OPTIONS TABLE                       < **
//             ACT=ACTTEST,           APPL CHARACTERISTICS TABLE                 < ** 
//             PRTB=,                 PRINT DESTINATION TABLE        
//             VMSK=,                 VIRTUAL TERMINAL MASKING TABLE 
//             TMSK=,                 TERMINAL OPTIONS TABLE         
//             PPS=,                  USER PASSTHRU PRINT TABLE      
//             OVAC=,                 OV/MVS APPL CONNECTIVITY TABLE 
//             SAMT=,                 SECURITY ACTION/MESSAGE TABLE  
//             MODETAB=,              MODE TABLE NAME                
//             DUMP=H,                DUMP SYSOUT CLASS              
//             OUT=H                  LOG AND OTHER SYSOUTS          
//*