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.

The POOLSEL parameter in the default options table works with the POOL( name ) option on the API. The default options table is supplied in source and object form. The pregenerated version is in hlq .SDFHLINK, and the source version, which is supplied in the hlq .SDFHSAMP library (where hlq represents the high-level qualifier for the library names, established at CICS installation time), contains the following entries:
 DFHNCO POOLSEL=DFHNC*,POOL=YES
DFHNCO POOL=
END DFHNCOPT
The default options table entries work as follows:
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
is mapped to the default pool (indicated by a POOL= options table parameter that omits a name operand).

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 can see that you do not need to create you own options table, and named counter API commands do not need to specify the POOL option, if:
  • 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.
Note:
  1. DFHNCOPT named counter options tables are not suffixed. A CICS region loads the first table found in the MVS™ link list.
  2. 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.


dfhp3m6.html | Timestamp icon Last updated: Monday, 5 June 2017