Defining an HDB allows you to collect (load) and report historical performance data. The definition alone does not cause any action by CICS PA.
File Systems Options Help ---------------------------------------------------------------------------- New HDB Definition Command ===> _______________________________________________________________ Specify new HDB definition options then press EXIT to save. Name . . . . . . CICSWEEK APPLID CICSPROD + Image ________ Qualifier . . . ________ _ Explorer Description . . Production CICS Weekly History__ HDB Format: Selection Criteria: Template . . . WEEKSUM_ + _ Performance Data Retention Period:HDB: Years ___ Months ___ Weeks ___ Days ___ Hours ___
![]()
DB2: Years ___ Months ___ Weeks ___ Days ___ Hours ___
Data Set Allocation Settings: DSN Prefix . . . . . . CICSPA.HISTORY____ Management class . . . ________ (Blank for default management class) Storage class . . . . ________ (Blank for default storage class) Volume serial . . . . ______ (Blank for system default volume) Device type . . . . . ________ (Generic unit or device address) Data class . . . . . . ________ (Blank for default data class) Space Units . . . . . ________ (TRKS, CYLS) Primary quantity . . ________ (In above units) Secondary quantity ________ (In above units) F1=Help F3=Exit F4=Prompt F7=Backward F8=Forward F10=Actions F12=Cancel
HDB LOAD requests use this APPLID and associated SMF files (defined in System Definitions) to build the JCL deck. If not specified, you are prompted at submit time to specify the system.
The CICS System must be defined in System Definitions. To select one from a list, use Prompt (F4). See Select a system (CICS APPLID) for an example of the list of systems. To link directly to System Definitions, use Systems in the action bar.
Qualifier is mandatory if Explorer is selected, and optional otherwise. If Qualifier and Explorer are both entered then details of this HDB will be included in the manifest the next time it is rebuilt for this qualifier.
You should rebuild the manifest when you add an eligible HDB, and also whenever the HDB is changed in a way that affects its eligibility for inclusion in the manifest. See Maintain manifest.
A manifest is a proprietary DB2 table that contains all the information required by the CICS PA plug-in to access and use historical data. It is a catalog of all the HDB DB2 tables that have the same qualifier and for which the Explorer indicator is set.
You should rebuild the manifest when you add an eligible HDB, and also whenever the HDB is changed in a way that affects its eligibility for inclusion in the manifest. See Maintain manifest.
The Template defines the type and format of the HDB. Before defining an HDB, you must first design a Template that defines the required information to be kept in the HDB data sets. In Figure 1 we have specified a Summary Template WEEKSUM and HDB CICSWEEK inherits its attributes.
If you have selected the Explorer option, you must choose an internal template that has been predefined for use with the CICS PA-plug-in.
To select a Template from a list of defined Templates, use Prompt (F4). See Select a Template for an example of the prompt list.
If the HDB container data sets are no longer required after their data has been exported to DB2, you can specify a retention period of 0 in any of the HDB periods to make the HDB data sets expire immediately.
Container data sets and DB2 data are deleted by HDB Housekeeping after they have passed their expiry date. If you do not specify a retention period, the corresponding HDB data sets or DB2 data will never expire.
Use HDB Maintenance to check container data set status or to alter the HDB or DB2 retention period.
DSN-prefix.HDB-name.Dyyddd.Thhmmss.HDB
where
the DSN–prefix is the data set name high level qualifier. For example,
CICSPA.HISTORY.CICSWEEK.D03123.T103821.HDBIf management class is not specified, but storage class is specified or defaulted, management class is derived from automatic class selection (ACS).
If management class is specified and storage class is not specified or derived, the DEFINE will fail. Note that if SMS is inactive and management class is specified, the DEFINE will fail.
Specify allocation settings that satisfy your installation requirements. The size of container data sets is not critical. Typically you would specify a size that accommodates a single load request. For example, if you load data into the HDB daily, then 10 cylinders might be sufficient. However if CICS PA encounters an out-of-space condition (ABENDx37) during load, then it simply closes the data set and recommences loading in a new data set. You can decide to specify a larger size initially and adjust it later using HDB Maintenance.