How to customize TPX as a Generic Resource

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 two 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) Build the TPX Coupling Facility Structure

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:  TPXGR001
    VTAM Generic Resource name:      TPXPRD
    Generic Resource member count:   04

2. Fill in the VTAM Generic Resource name field with the 1-8
character name that VTAM will use as the generic APPLID.

3. 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).

4. 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.

5. 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.

B) To configure the TPX structure to the Coupling Facility, do the following:
     Run batch job used to define TPXGR001TPXPRD to an existing Coupling facility.

//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.

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.