Database resource adapter startup table for CCTL regions
Use the database resource adapter (DRA) startup table to provide definitional parameters for the coordinator control (CCTL) region. The DRA startup table establishes the subsystem name of the IMS that is being connected to, and defines the characteristics of the DRA, such as the number of threads.
This topic presents sample source code for DFSPZP00 and describes the parameters that are specified through the DFSPRP macro in DFSPZP00.
Sample DFSPZP00 source code
The DRA startup table, DFSPZPxx, is created by assembling the DFSPZPxx module. This code sample
is the actual source code for DFSPZP00. To define other variations of DFSPZPxx, modify this code
through the DFSPRP macro. Specify the DRA parameters as keywords on the DFSPRP macro. The keywords
and their descriptions are described in DFSPRP macro keywords in DFSPZP00.
**********************************************************************
* *
* MODULE NAME: DFSPZP00 *
* *
* DESCRIPTIVE NAME: DATABASE RESOURCE ADAPTER (DRA) *
* STARTUP PARAMETER TABLE. *
* *
**************************************************************@SCPYRT*
* *
* Licensed Materials - Property of IBM *
* *
* 5635-A01 *
* *
* (C) Copyright IBM Corp. 1989,2011 All Rights Reserved. *
* *
* US Government Users Restricted Rights - Use, duplication or *
* disclosure restricted by GSA ADP Schedule Contract with *
* IBM Corp. *
**************************************************************@ECPYRT*
* *
* FUNCTION: TO PROVIDE THE VARIOUS DEFINITIONAL PARAMETERS *
* FOR THE COORDINATOR CONTROL REGION. THIS *
* MODULE MAY BE ASSEMBLE BY A USER SPECIFYING *
* THEIR PARTICULAR NAMES, ETC. AND LINKEDITED *
* INTO THE USER RESLIB AS DFSPZPXX . WHERE XX *
* IS EITHER 00 FOR THE DEFAULT, OR ANY OTHER ALPHA- *
* NUMERIC CHARACTERS. *
* *
* KEYWORDS FOR THE DFSPRP MACRO: *
* DSECT=NO-A DSECT STATEMENT FOR PRP WILL NOT BE *
* GENERATED (LABEL DFSPRP WILL BE ON DS 0D). *
* *
* FUNCLV= DEFAULT (3). ADAPTER FUNCTIONAL LEVEL. *
* *
* DDNAME= 1 TO 8 CHARACTER DD NAME TO BE USED WITH *
* DYNAMIC ALLOCATION OF THE DBCTL RESLIB. *
* DEFAULT (CCTLDD). *
* *
* DSNAME= 1 TO 44 CHARACTER DATASET NAME OF THE *
* DBCTL RESLIB. *
* DEFAULT (IMS.SDFSRESL) *
* *
* DBCTLID=XXXX-NAME OF THE DBCTL REGION *
* DEFAULT = SYS1 *
* *
* USERID=XXXXXXXX-NAME OF THE USER REGION *
* *
* MINTHRD=XXXX-MINIMUM NUMBER OF THREADS TO BE *
* AVAILABLE (MAXIMUM NUMBER IS 4095) *
* DEFAULT = 1 *
* *
* MAXTHRD=XXXX-MAXIMUM NUMBER OF THREADS TO BE *
* AVAILABLE (MAXIMUM NUMBER IS 4095) *
* DEFAULT = 1 *
* *
* TIMER=XX-IDENTIFY TIMER VALUE IN SECONDS (DEFAULT 60) *
* *
* IDRETRY=XXX-Retry IDENTIFY attempt count *
* before DFS690A message will be *
* reissued. *
* (Default = 0, Min = 0, Max =255) *
* *
* FPBUF=XXXX-NUMBER OF FAST PATH BUFFERS TO BE ALLOCATED*
* AND FIXED PER THREAD (DEFAULT 00) *
* *
* FPBOF=XXXX-NUMBER OF FAST PATH OVERFLOW BUFFERS TO BE *
* ALLOCATED PER THREAD (DEFAULT 00) *
* *
* SOD=X-OUTPUT CLASS TO BE USED FOR SNAP DUMP OF *
* ABNORMAL THREAD TERMINATIONS (DEFAULT A) *
* *
* GENSNAP= SPECIFIES WHETHER OR NOT DFSPAT20, THE DRA *
* THREAD TERMINATION ROUTINE, SHOULD GENERATE *
* SNAP OUTPUT. IF GENSNAP=YES IS SPECIFIED, *
* SNAP OUTPUT IS GENERATED. IF GENSNAP=NO IS *
* SPECIFIED, NO SNAP OUTPUT IS GENERATED BY *
* DFSPAT20. (DEFAULT YES) *
* *
* TIMEOUT=XXX-DRATERM TIMEOUT VALUE IN SECONDS(DEFLT 60)*
* *
* CNBA=XXXX TOTAL FP NBA BUFFERS FOR CCTL *
* 0 - 9999 or 1K - 32K *
* 0 = *
* If FPBUF and/or FPBOF *
* are 0, or not specified, *
* 0 indicates no CNBA buffer *
* If FPBUF or FPBOF are *
* specified >0, CNBA=0 *
* indicates IMS *
* will determine the CNBA *
* size based on: *
* (MAXTHRD*FPBUF)+FPBOF *
* 1K - 32K = *
* nnK =(nn * 1024)-1 *
* *
* AGN=XXXXXXXX-1 to 8 CHARS (THIS PARM IS NO *
* LONGER SUPPORTED, BUT IS ALLOWED *
* FOR COMPATIBILITY REASONS.) *
* *
* PCBLOC=24|31 Specifies the storage location *
* of the application PCB list. *
* 24 - DIRCA allocated in 24 bit private *
* 31 - DIRCA allocated in 31 bit private *
* *
* OPENTHRD= CCTL | DISABLE *
* *
* LOCATION: PRIVATE STORAGE, USER KEY *
* *
* THIS MODULE CONTAINS NO EXECUTABLE CODE. *
* *
**********************************************************************
DFSPRP macro keywords in DFSPZP00
The following information describes DRA table
parameters specified through the DFSPRP macro in DFSPZP00.
- CNBA=
-
Is the total number of Fast Path NBA buffers for CCTL's use. Valid values for CNBA are from 0 to 9999 and 1K to 32K. The default value for CNBA is 0.
You can determine a starting value for CNBA by using the following formula: FPBUF × MAXTHRDS + FPBOF = CNBA. The minimum value of CNBA must be equal to or greater than the total of the FPBUF and FPBOF values. If necessary, adjust the value of CNBA to meet the performance and storage requirements of your installation.
If the FPBUF > 0 or FPBOF > 0, and CNBA = 0, the IMS system calculates the CNBA size during connection request processing based on the formula.
- DBCTLID=
- Is the four-character name of the DBCTL region. This is the same as the IMSID parameter in the DBC procedure. The default name is SYS1. For more information about the DBC procedure, see DBC procedure.
- DSECT=
- Specifies whether a DSECT statement for PRP is generated.
- YES
- A DSECT statement is generated. The existing CSECT will be reestablished. The default is YES.
- NO
- A DSECT statement is not generated. Label DFSPRP will be on DS 0D.
- DDNAME=
- Is a one- to eight-character ddname to be used with the dynamic allocation of the DBCTL execution library. The default ddname is CCTLDD. This library must contain the DRA modules.
- DSNAME=
- Is a one- to forty-four-character data set name of the DBCTL execution library. This library must contain the DRA modules and must be z/OS® authorized. The default dsname is IMS.SDFSRESL.
- FPBOF=
- Specifies the number of Fast Path DEDB overflow buffers to be allocated per thread. Valid values for FPBOF are from 0 to 9999. The default value for FPBOF is 0.
- FPBUF=
- Specifies the number of Fast Path DEDB buffers that are allocated per thread. Valid values for FPBUF are from 0 to 9999. The default value for FPBUF is 0.
- FUNCLV=
- Specifies the level of the DRA
that the CCTL supports:
- 1
- Base CCTL function support.
- 2
- ODBM Callable Interface support.
- 3
- DRA Options.
- GENSNAP=
- Specifies whether DFSPAT20, the DRA thread termination routine,
generates SNAP output.
- YES
- SNAP output is generated during thread termination. The default is YES.
- NO
- SNAP output is not generated during thread termination.
When ODBM connects to ODBA as a DRA client, it specifies GENSNAP=NO is to suppress the SNAP output.
- MAXTHRD=
- The maximum number of DRA thread TCBs available at one time. The maximum number is 4095. The default is number 1.
- MINTHRD=
- The minimum number of DRA thread TCBs available at one time. The maximum number is 4095. The default is number 1.
- OPENTHRD=
- Identifies whether DRA Open Thread support processing is enabled. When DRA Open Thread support
processing is enabled and uses CICS 4.2 or higher, the OPENTHRD option directs the DRA not to attach
dedicated IMS DRA thread task control blocks (TCBs). Instead,
the DRA uses CICS TCBs intended for increased parallelism within the CICS/DRA environment.
- CCTL
- DRA Open Thread support processing is enabled.
- DISABLE
- DRA Open Thread support processing is disabled. This is the default.
- PCBLOC=
- Identifies where the application PCB list is built. It can be built either below the 16M line (PCBLOC=24), which is the default, or in extended private storage (PCBLOC=31), above the 16M line.
- SOD=
- Is the output class to be used for a SNAP DUMP of abnormal thread terminations. The default is A.
- TIMEOUT=
- Is the amount of time (in seconds) a CCTL should wait for the successful completion of a DRA TERM request. Specify this value only if the CCTL is coded to use it. This value is returned to the CCTL upon completion of an INIT request. The default is 60 seconds.
- TIMER=
- Is the amount of time (in seconds) between attempts of the DRA to identify itself to DBCTL during an INIT request. The default is 60 seconds.
- TIMETHREADCPU=
- Specifies whether the DRA monitors and reports the CPU usage statistics
that are related to DRA threads, to IMS when DRA Open Thread support
is enabled.
- YES
- The DRA monitors and reports the CPU usage statistics. A value
of
YESoverrides any value that is specified by the CCTL.YESis the default. - NO
- The DRA does not monitor and report the CPU usage statistics.
A value of
NOoverrides any value that is specified by the CCTL. - CLIENT
- The DRA uses the setting that is specified by the DRA client through
the INIT call (
YESorNO) . If the client does not specify a setting,YESis the default.
- USERID=
- Is an eight-character name of the CCTL region.