How to customize TPX as a Generic Resource
search cancel

How to customize TPX as a Generic Resource

book

Article ID: 36149

calendar_today

Updated On:

Products

TPX - Session Management

Issue/Introduction

Steps  needed to define TPX as a Generic Resource.

Environment

Release: TPX 5.4
Component: TPX for Z/OS

Resolution

There are four areas that must be configured for TPX to run as a Generic Resource /Coupling Facility:

A) Generic Resource Parameters panel in the SMRT - 12.
B)Specify Y in the VTAM Authorized Path Facility field of the SMRT Performance Parameters panel.
C) Specify YES on the SRBEXIT parameter of each APPL statement in the major node
D) Build the TPX Coupling Facility Structure
E) Refresh the VNODEs and Recycle the TPX Instances


See details below: 

A) To configure the Generic Resource Parameters panel in the SMRT, do the following:

  1. Select Option 12 from the Main SMRT panel. The following will display:

System Options Table:  SMRTxxxx
Generic Resource Parameters
---------------------------
    Coupling structure name prefix:  
    VTAM Generic Resource name:      
    Generic Resource member count:  
 

  1. Fill in the VTAM Generic Resource name field with the 1-8 character name that VTAM will use as the generic APPLID.
  1. Fill in the Coupling Structure name prefix with the first 8 characters of the name to be given to the structure (must be 8 characters).
  1. Set the Generic Resource member count to the number of TPX instances that could be part of the generic pool. This can be a value of 1 to 64.
  1. The Coupling structure name prefix combined with the VTAM Generic Resource name is used for the Coupling Facility structure name. In this example, the name would be TPXGR001TPXPRD.


System Options Table:  SMRTxxxx
Generic Resource Parameters
---------------------------
    Coupling structure name prefix:  TPXGR0001
    VTAM Generic Resource name:      TPXPRD
    Generic Resource member count:   04

  

B)Specify Y in the VTAM Authorized Path Facility field of the SMRT Performance Parameters panel.

  1. From the Main SMRT panel, select Option 1 ‘Performance Parameters’ .
    On the ‘VTAM Authorized Path Facility:’ field, change from N to Y.

   Performance Parameters                                  
   ----------------------                                  
       VTAM Authorized Path Facility:      Y               
       Large Message Processing Option:    Y               
       Rtasks (Number of servers):         03              
       Load profiles at startup:           Y               
       Reserve ACB's at startup:           Y                
     * Maximum Sessions:                   00000           
     * Maximum TPX Users:                  00000           
     * ACL Runaway Limit:                  10000           
       Build user name list at startup:    N               
       Load EN and default language only:  N               
       If above is set, also load the following language(s):
          BF N  BP N  CU N  DA N  DU N  FI N  FR N  GE N   
          IT N  JP N  NO N  SF N  SG N  SP N  SW N  UP N   

 

C) Specify YES on the SRBEXIT parameter of each APPL statement in the major node

  1. On the VTAM Major node, please change all occurrences from SRBEXIT=NO  to SRBEXIT=YES as the example shown below:

TPXGR001 APPL MODETAB=TPXLGMD2,DLOGMOD=T3278M2,SRBEXIT=YES,EAS=1
TPXGR002 APPL MODETAB=TPXLGMD2,DLOGMOD=T3278M2,SRBEXIT=YES,EAS=1
TPXGR003 APPL MODETAB=TPXLGMD2,DLOGMOD=T3278M2,SRBEXIT=YES,EAS=1
TPXGR004 APPL MODETAB=TPXLGMD2,DLOGMOD=T3278M2,SRBEXIT=YES,EAS=1
TPXGR005 APPL MODETAB=TPXLGMD2,DLOGMOD=T3278M2,SRBEXIT=YES,EAS=1
…

D) To configure the TPX structure to the Coupling Facility, do the following:
     Run batch job used to define TPXGR001TPXPRD to an existing Coupling facility.
     Note that STRUCTURE NAME(TPXGR001TPXPRD) must match the Generic resource name in the SMRT

 
//STEP20 EXEC PGM=IXCMIAPU
//SYSPRPRD DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSIN DD *
 DATA TYPE(CFRM) REPORT(YES)
 DEFINE POLICY NAME(RTM1) REPLACE(YES)
 CF NAME(CFCCRTM1)
 TYPE(SIMDEV)
 MFG(IBM)
 PLANT(EN)
 SEQUENCE(0000CFCCRTM1)
 PARTITION(0)
 CPCID(00)
 DUMPSPACE(4000)
 STRUCTURE NAME(IXCLIST1) SIZE(3840) PREFLIST(CFCCRTM1)
 STRUCTURE NAME(TPXGR001TPXPRD) SIZE(1280) PREFLIST(CFCCRTM1)
 ALLOWAUTOALT(YES)
 PREFLIST(CFCCRTM1)
 STRUCTURE NAME(ISTGENERIC) SIZE(7598) PREFLIST(CFCCRTM1)
/*
//


STRUCTURE NAME(xxxxxxxxxxxxxx)
This is a concatenation of TPX structure name prefix and the VTAM Generic Resource name.

SIZE(xxxxx)
The structure size is discussed in the CFSTRUCT member of SAMPLIB.
Note: At startup, TPX issues a TPXL5101 message containing the approximate number of users that the structure will support.

ALLOWAUTOALT(xxx)
Allow or disallow system managed rebuild.

PREFLIST(xxxxxxxx)
This is the name of the Coupling Facility to be used for the structure. 

 

E) Refresh the VNODEs and Recycle the TPX Instances

Perform the following steps at each TPX instance that is part of the generic resource group:

  1. Issue the following console commands to inactivate the major node and stop the TPX region:

    V NET,INACT,ID=majornode

    P TPX

  2. Once VNODE is inactive and all TPXs that are part of the generic resource group are down, issue the following console commands to activate the major node and start the TPX regions:

    V NET,ACT,ID=majornode

    S TPX




For more information, refer to: Set Up TPX as a VTAM Generic Resource

Additional Information

For TPX GR/ CF structure to work, the IBM SYSTEM CF (ISTGENERIC) MUST be available. Refer to IBM manuals for details.

-How to setup up TPX as a Generic Resource in a SYSPLEX .

-TPX should not be defined with Affinity as well as a Generic Resource at the same time.
 These should be considered mutually exclusive.  
 Turning on affinity when TPX is defined as a generic resource could cause a conflict between the TPX option and Workload Manager.
 Recommend Affinity be disabled in a GR setup.

Powered by Wolken Software