Named counter options table
The POOL( name ) parameter is optional on all the EXEC CICS COUNTER and DCOUNTER commands. If you specify the POOL parameter, it can refer to either an actual or a logical pool name. Whether you specify a POOL parameter or omit it, CICS resolves the actual pool name by reference to the named counter options table, which is loaded from the link list.
For more information about EXEC CICS COUNTER and DCOUNTER commands see Using the named counter EXEC interface.
The named counter options table, DFHNCOPT, provides several methods for determining the actual pool name referenced by a named counter API command, all of which are described in the Setting up shared data sets, CSD and SYSIN . This also describes the DFHNCO macro that you can use to create your own options table.
DFHNCO POOLSEL=DFHNC*,POOL=YES
DFHNCO POOL=
END DFHNCOPT
- POOLSEL=DFHNC*
- This pool selection parameter defines a generic logical pool name beginning with the letters DFHNC. If any named counter API request specifies a pool name that matches this generic name, the pool name is determined by the POOL= operand in the DFHNCO entry. Because this is POOL=YES in the default table, the name passed on the POOL( name ) option of the API command is taken to be an actual name. Thus, the default options table specifies that all logical pool names beginning with DFHNC are actual pool names.
- POOL=
- This entry in the default table is the 'default' entry. Because
the POOLSEL parameter is not specified, it defaults to POOLSEL=*,
which means it is taken to match any value on a POOL parameter
that
does not find a more explicit match. Thus, any named counter API
request
that:
- Specifies a POOL value that begins with other than DFHNC, or
- Omits the POOL name parameter altogether
You can specify the default pool name to be used by a CICS region by specifying the NCPLDFT system initialization parameter. If NCPLDFT is omitted, the pool name defaults to DFHNC001.
- You use pool names of the form DFHNC xxx , or
- Your CICS region uses only one pool that can be defined by the NCPLDFT system initialization parameter.
- DFHNCOPT named counter options tables are not suffixed. A CICS region loads the first table found in the MVS™ link list.
- There must be a named counter server running, in the same MVS image as your CICS region, for each named counter pool used by your application programs.