Discover CICS regions and create a configuration file

You can generate an initial configuration file using the discover utility. Use this utility to search for active CICS regions in the specified LPAR and create a collector configuration file containing a list of those regions. This utility provides a simple method of setting up a valid configuration file that can be used by the collector.

//CPROFCOL JOB ,
/*JOBPARM SYSAFF=SYS1
//*
//S1     EXEC PGM=TXCMAIN
//STEPLIB  DD DISP=SHR,DSN=TXC.V1R2M0.STXCAUTH
//SYSPRINT DD SYSOUT=*
//CONFIG   DD DISP=SHR,
//            DSN=TXC.V1R2M0.INSTALL(CONFIG)
//SYSIN    DD *
DISCOVER WITHGROUPING
/*

JCL to discover CICS regions in the LPAR and create a configuration file

The JCL contains the following elements:

• JOBPARM SYSAFF=SYS1

  Run discovery on LPAR SYS1.

• CONFIG

  The output configuration file. If the name is already in use, it will be overwritten.

• SYSIN

  The DISCOVER utility statement and the optional WITHGROUPING control statement. The WITHGROUPING control statement instructs the discovery process to automatically group the CICS regions it finds. It does this by determining which CICS regions are connected via CONNECTION or IPCONN definitions. This is useful when defining a group of regions that use MRO. If you do not wish to group your regions in this way, simply remove the WITHGROUPING statement. To learn more about region grouping in C\Prof, see GROUP=name and GROUPEND.

Configuration files created using this utility may be manually edited to add or remove additional CICS regions that were not present in your environment at the time of discovery, or to supply additional configuration options.