ERROR: "TPX1599 - TPX CF STRUCTURE OUT OF SPACE"

Products

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

Issue/Introduction

Message TPX1599 TPX CF STRUCTURE OUT OF SPACE, is observed in the TPX JESMSGLG.

A search for Message "TPX1599 .... " on the web site and the messages manual returns no hits.
There is no corresponding message found in the TPX LOG DD.

Environment

TPX® Session Management for z/OS

Cause

Missing in messages manual.

Resolution

Once the number of elements in a CF structure approach or reach a 100% this may result in this message and user sign ON will be impacted.

TPX1599   TPX CF STRUCTURE OUT OF SPACE  

  REASON: 
  The SIZE parameter in the Coupling Facility structure for TPX has run out of space. No new users will be able to logon.      

  ACTION: 
  The SMRT has the max number of TPX instances involved in the GR ring; and the two parts of structure name (Prefix and GR name)
  Review the CFSTRUCT member in the TPX CB0VJCL data set.           

 Example: STRUCTURE NAME(AB12CFTPXAPPL) 
                 SIZE(20480)                   
                 INITSIZE(4096)                   
                 ALLOWAUTOALT(YES)                   
                PREFLIST(CFCCENF2,CFCCSM1)  

For details on determining the structure storage requirements, see How many megabytes of Coupling Facility (CF) storage are required for the TPX list structure?
Update the currently active Coupling Facility policy data set to reflect the new changes.

 A SYSTEM REBUILD normally clears the error. The SYSTEM REBUILD will work most times, but is not a guarantee.
However, The preferred method to implement the change in CFRM policy that has been implemented for TPX structure, is to shutdown all TPX instances affected then restart them all. This will ensure the TPX structure was de-allocated and deleted in the CF.

Additional Information

 An enhancement for TPX 5.4 was released for Z/OS 2.4 
 PTF SO11715 
 Title: CFSIZER ENHANCEMENT - DISPLAY MINSIZE AND INITSIZE VALUES 

Ensure SO11715 is applied ...
Assemble member CFSTRSRC in CB0VSRC using sample JCL member CFSTRASM in same library then run CFSTRSIZ member after the appropriate changes...
This gives the report to modify CFSTRUCT in CB0VJCL with structure information for the CFRM policy update job (sample not included, since the TPX structure definition is only a part of what is necessary )...