Running the Builder, V The PARM parameter of the EXEC statement

Chapter 7. Running the Builder

This chapter describes how to run the Builder that runs as a batch job to build affinity transaction groups suitable for input to the CICS system management product, the CICSPlex SM element of CICS Transaction Server for OS/390 Release 3.

This chapter contains the following information:

vªSyntax for input to the Builderº on page 56

vªOutput from the Builderº on page 58

You can run the Builder to build affinity transaction groups suitable for input to the CICS system management product, CICSPlex SM. The Builder takes as input a set of ®les containing basic affinity transaction groups, combines those groups, and produces a ®le containing combined affinity transaction groups. CICSPlex SM requires a transaction identi®er be in one transaction group only, and the Builder satis®es this by combining groups that contain the same transaction identi®er.

Note: You can use the Reporter to produce ®les of basic transaction affinity groups for input to the Builder. The ®les can be from several runs of the Detector (for example, against a production CICS region and a test CICS region), but must be for the same workload.

You can run the Builder by editing and running the job CAUJCLBL. Before running the CAUJCLBL job, change the following as appropriate:

vThe JOB accounting parameters

vThe PARM parameter of the EXEC statement

For example:

//BUILD

EXEC PGM=CAUBLD,

//PARM=(©STATE=ACTIVE,MATCH=LUNAME,DSPSIZE=16©,

//©CONTEXT=CICPLEX1©)

[DSPSIZE={16number}]

Specify the size, in the range 2 through 2000 (MB), of the data space created internally by the Builder to store the group tables.

[MATCH={LUNAMEUSERID}]

Specify the ®lter that CICSPlex SM is to use for workload separation, and which applies to all combined affinity groups produced by the Builder.

[STATE={ACTIVEDORMANT}]

Specify whether the combined affinity groups are to be de®ned as active or dormant to CICSPlex SM.

[CONTEXT=plexname]

	Specify the name, one through eight characters, of a CICSplex. If you specify
	this parameter, the Builder generates a CICSPlex SM CONTEXT statement,
	which enables CICSPlex SM to associate the combined affinity transaction
	groups with a particular CICSplex that it is managing. The default is to not
	generate a CONTEXT statement; in which case, CICSPlex SM assumes the
	local CICS-managed address space (CMAS).
	For more information about de®ning transaction groups to CICSPlex SM, see
	CICSPlex SM Managing Business Applications.
	v The STEPLIB DD statement

IBM OS manual Running the Builder, v The PARM parameter of the EXEC statement, DSPSIZE=16number

Models: OS