CSLDCxxx member of the IMS PROCLIB data set

Use the Open Database Manager (ODBM) configuration member of the IMS PROCLIB data set (CSLDCxxx) to define the data store connections between one or more ODBM instances and one or more IMS systems.

Each IMS system that ODBM can connect to is defined as a data store in the CSLDCxxx member of the IMS PROCLIB data set. Each data store has one or more alias names and several modifiable connection attributes.

Each instance of ODBM in an IMSplex can use a separate, local CSLDCxxx member of the IMS PROCLIB data set, or all the instances of ODBM in an IMSplex can share one CSLDCxxx member. The shared CSLDCxxx member of the IMS PROCLIB data set must be stored in a data set on shared DASD and concatenated to the local PROCLIB data set member of each ODBM instance that is sharing it. Sharing the CSLDCxxx member simplifies the management of data store connections across multiple instances of ODBM.

Open Database Manager (ODBM) can only connect to the IMS systems that are of the same version as ODBM itself. In a mixed-version IMSplex, to limit ODBM connection to the IMS systems of the same version, list the eligible IMS systems as data stores in the CSLDCxxx member of the IMS PROCLIB data set.

The parameters in the CSLDCxxx member of the IMS PROCLIB data set are organized into sections: a global section and a local section. The parameters in the global section of CSLDCxxx apply to all the data stores defined in the CSLDCxxx member of the IMS PROCLIB data set. The parameters in the local section of the CSLDCxxx member of the IMS PROCLIB data set apply only to specific data store connections of specific instances of ODBM. The parameters in the local section override the same parameters specified in the global section.

Both the global and local sections of the CSLDCxxx member of the IMS PROCLIB data set are identified by a predefined section header. These section headers are required in the CSLDCxxx member of the IMS PROCLIB data set even if no parameters are specified in the global section, as might be the case if all the default values are used.

The section header for the global section is: <SECTION=GLOBAL_DATASTORE_CONFIGURATION>. The section header for the local section is: <SECTION=LOCAL_DATASTORE_CONFIGURATION>.

The global data store configuration section defines attributes that are used by all the data store connections defined on this CSLDCxxx member of the IMS PROCLIB data set. You can specify the following attributes globally:

  • IDRETRY: the number of times ODBM tries to connect to an IMS data store if the first attempt is unsuccessful
  • TIMER: the amount of time to wait between connection attempts
  • MAXTHRDS: the number of concurrent active threads that an IMS data store can have
  • MINTHRDS: the minimum number of concurrent active threads that an IMS data store can have
  • FPBUF: the number of Fast Path DEDB buffers to allocate and fix per thread
  • FPBOF: the number of Fast Path DEDB overflow buffers to allocate per thread
  • CNBA: the total number of Fast Path normal buffer allocation (NBA) buffers that an instance of ODBM can use for all its data store connections
  • SOD: the system output class of a SNAP dump that is produced by the ODBM address space.
  • DIAGDPSBMSG: Specifies the value of the DIAGDPSBMSG= parameter value to control the issuing of CSL4202W and CSL4203W messages in ODBM after an internal DPSB request from ICON is processed.
The local data store configuration section defines attributes for specific data store connections of specific instances of ODBM and overrides the same values specified in the global section:
  • ALIAS(NAME=): the IMS alias names
  • MAXTHRDS: the number of concurrent active threads that an IMS data store can have
  • MINTHRDS: the minimum number of concurrent active threads that an IMS data store can have
  • FPBUF: the number of Fast Path DEDB buffers to allocate and fix per thread
  • FPBOF: the number of Fast Path DEDB overflow buffers to allocate per thread
  • CNBA: the total number of Fast Path NBA buffers that an instance of ODBM can use for all its data store connections
  • SOD: the system output class of a SNAP dump that is produced by the ODBM address space.

An example of the CSLDCxxx member of the IMS PROCLIB data set, is shown in Examples.

You can use the IMS Syntax Checker to modify this member of the IMS PROCLIB data set.

Syntax

The following diagram shows the syntax for the parameters specified in the CSLDCxxx member of the IMS PROCLIB data set.

Read syntax diagramSkip visual syntax diagram <SECTION=GLOBAL_DATASTORE_CONFIGURATION> ,IDRETRY= nn,TIMER= nn,FPBUF= nnnn,FPBOF= nnnn,CNBA= nnnn or nnK,MAXTHRDS= nnnn,MINTHRDS= nnnn,SOD= n<SECTION=LOCAL_DATASTORE_CONFIGURATION>DIAGDPSBMSG=SHORTLONGNONEODBM(NAME= odbmname,DATASTORE(NAME= imsidAB))
A
Read syntax diagramSkip visual syntax diagram,ALIAS(,NAME= aliasname)
B
Read syntax diagramSkip visual syntax diagram,FPBUF= nnnn,FPBOF= nnnn,CNBA= nnnn or nnK,MAXTHRDS= nnnn,MINTHRDS= nnnn,SOD= n

Usage

A CSLDCxxx member of the IMS PROCLIB data set consists of one or more fixed-length character records (the configuration data set can be of any LRECL greater than eight, but it must be fixed record format). The rightmost-eight columns are ignored but can be used for sequence numbers or any other notation. Keyword parameters can be coded in the remaining columns in free format, and they can contain leading and trailing blanks. You can specify multiple keywords in each record; use commas or spaces to delimit keywords. Statements that begin with a “*” or “#” in column 1 are comment lines and are ignored. Additionally, comments can be included anywhere within a statement by enclosing them between “ /* ”and “*/”, for example, /* PROCLIB comments */. Values coded in this member of the IMS PROCLIB data set are case sensitive. In general, you should use uppercase for all parameters.

Parameters

The parameters on the CSLDCxxx member of the IMS PROCLIB data set include those that can be specified only in the global section, those that can be specified only in the local section, and those that can be specified in either the global section, the local section, or both.

Parameters that can be specified as a global default and as an instance-specific override of the default value

The following parameters can be specified in both the global and the local sections of CSLDCxxx. When specified in the global section, these parameters define the default value for the parameter on all data store connections defined on the CSLDCxxx member of the IMS PROCLIB data set. When specified in the local section, these parameters apply only to the specified data store connection of a specified instance of ODBM and override the global specifications.

MAXTHRDS=nnnn
Specifies the maximum number of concurrent active threads for an individual IMS data store. Valid values for MAXTHRDS are from 1 to 4095. The default value for MAXTHRDS is 1.

Values for MAXTHRDS specified in the local section of CSLDCxxx override the value of MAXTHRDS from the global section.

MINTHRDS=nnnn

Specifies the minimum number of concurrent active threads for an individual IMS data store. Valid values for MINTHRDS are from 1 to 4095.

If the MINTHRDS is not explicitly specified in the CSLDCxxx member of the IMS PROCLIB data set, MINTHRDS is set to 62% of the value of MAXTHRDS.

Values for MINTHRDS specified in the local section of the CSLDCxxx member of the IMS PROCLIB data set override the value of MINTHRDS from the global section.

DIAGDPSBMSG=SHORT | LONG | NONE
Specifies the value of the DIAGDPSBMSG= parameter to control ODBM issuing the CSL4202W or CSL4203W message after an internal DPSB request from ICON is received.
The parameters specify the following:
  • SHORT: Specifies that the CSL4202W message is to be issued. This is the default.
  • LONG: Specifies that the CSL4203W message is to be issued.
  • NONE: Specifies no CSL4202W or CSL4203W message is to be issued after the CSL4201W message.
FPBUF=nnnn
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.
FPBOF=nnnn
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.

Values for FPBOF specified in the local section of CSLDCxxx override the value of FPBOF from the global section.

CNBA=nnnn or nnK
Specifies the total number of Fast Path NBA buffers for ODBM use. Valid values for CNBA are from 0 to 9999 and 1K to 32K. The default value for CNBA is 0.

Values for CNBA specified in the local section of CSLDCxxx override the value of CNBA from the global section.

You can determine a starting value for CNBA by using the following formula: FPBUF × MAXTHRDS + FPBOF= CNBA. If needed, adjust the value of CNBA to meet the performance and storage requirements of your installation.

If FPBUF > 0 or FPBOF > 0, and CNBA = 0, the IMS system calculates the CNBA size during connection request processing by using the formula.

SOD=n
Specifies the system output class of SNAP dumps that can be produced by the ODBM address space. Valid values for SOD are any single alphanumeric character. The default value is A.

Values for SOD specified in the local section of CSLDCxxx override the value of SOD from the global section.

Parameters that can be specified only as global defaults

The following parameters can be specified only in the global section of the CSLDCxxx member of the IMS PROCLIB data set. Their values apply to all data store statements included in the CSLDCxxx member of the IMS PROCLIB data set.

<SECTION=GLOBAL_DATASTORE_CONFIGURATION>
Required header for the global section of the CSLDCxxx member of the IMS PROCLIB data set.
IDRETRY=nnn
Specifies the number of times that ODBM attempts to connect to an IMS data store if the first connection attempt fails. Valid values for IDRETRY are from 0 to 255. The default value is 0. IDRETRY is an optional parameter.
TIMER=nn
Specifies the number of seconds that ODBM waits between connection attempts if the first attempt to connect to an IMS data store by ODBM fails and the value of IDRETRY is greater than 0. Valid values for TIMER are from 1 to 99. The default value for TIMER is 60.

Parameters that can be specified only as instance-specific values

<SECTION=LOCAL_DATASTORE_CONFIGURATION>
Required header for the local section of the CSLDCxxx member of the IMS PROCLIB data set.
ODBM( )

Contains the attribute specifications for the data store connections of a specific instance of ODBM.

NAME=odbmname
Identifies the ODBM instance to which the included data store statements apply.
DATASTORE( )
Defines an IMS data store that can be connected to by this ODBM. You must include at least one DATASTORE statement in the CSLDCxxx member of the IMS PROCLIB data set.
NAME=imsid
Specifies the 1- to 4-character alphanumeric IMSID of an IMS data store that ODBM can connect to. This parameter is required for each DATASTORE parameter. There is no default for this parameter.
ALIAS( )
Specifies one or more ALIAS names for the data store defined by the DATASTORE statement. Application programs must use an alias name to access IMS data stores and do not need to know the actual IMSID of the IMS data store. If an application program wants to access an IMS data store using the DATASTORE name, that name must be specified as an ALIAS or be an internal alias.

For a DATASTORE statement, an associated ALIAS parameter is not required. If no ALIAS parameter is specified, ODBM generates an internal alias, giving it the data store name specified in the DATASTORE NAME parameter. This allows application programs to use the data store name when making calls to that data store.

These internally generated aliases cannot be started or stopped by using the following commands:
  • UPD ODBM START(CONNECTION) ALIAS(internal_alias_name)
  • UPD ODBM STOP(CONNECTION) ALIAS(internal_alias_name)
Starting or stopping a connection for a data store with an internally generated alias can only be achieved by starting or stopping the data store itself.

When displaying ODBM configuration and status, none of the internally generated aliases appear in any output resulting from a QRY ODBM command.

NAME=aliasname
Specifies a 4-character alphanumeric alias name.

You can specify multiple alias names on a DATASTORE statement, which allows different application programs to access the same IMS data store by using different alias names. For each instance of ODBM, many alias names may be associated with a data store, and an alias name may be associated with more than one data store.

For more information about defining Fast Path buffers, see the information about designing and tuning Fast Path databases in IMS Version 15.3 Database Administration.

Examples

An example of the CSLDCxxx members of the IMS PROCLIB data set is shown below.

**********************************************************************
* CSLDC000 ODBM CSL PROCLIB MEMBER                                   *
**********************************************************************

<SECTION=GLOBAL_DATASTORE_CONFIGURATION>                                                                      
IDRETRY=5                      /* Retry connection 5 times before quit    */
MAXTHRDS=10                    /* 10 threads max to any IMS Datastore     */
TIMER=30                       /* 30 seconds between ID retry attempts    */
FPBUF=10                       /* 10 DEDB buffers per thread              */
FPBOF=10                       /* 10 Overflow buffers per thread          */
CNBA=200                       /* (FPBUF+FPBOF)*MAXTHRDS <= CNBA          */
/**********************************************************************/
/* Define DATASTORE properties for ODBM01                             */
/**********************************************************************/
 
<SECTION=LOCAL_DATASTORE_CONFIGURATION>
ODBM(NAME=ODBM01,                   /* Define parms for ODBM01    */
  DATASTORE(NAME=IMS1,              /* IMSID on LPAR A            */
    ALIAS(NAME=IO1A,NAME=IO1B),     /* Names for APPL sets 1 & 2  */
    FPBUF=0,FPBOF=0,CNBA=0          /* No FastPath on this IMS    */
      )
  DATASTORE(NAME=IMS2,              /* IMSID on LPAR A            */
    ALIAS(NAME=IO2A,NAME=IO2B),     /* Names for DEDB apps        */
    FPBUF=50,FPBOF=50,CNBA=500,     /* FastPath on this IMS       */
    MAXTHRDS=5                      /* Throttle down threads      */
      )
    )
/**********************************************************************/
/* Define DATASTORE properties for ODBM02                             */
/**********************************************************************/
ODBM(NAME=ODBM02,		                /* Define parms for ODBM02    */
  DATASTORE(NAME=IMS3,              /* IMSID on LPAR B            */
    ALIAS(NAME=IO3A,NAME=IO3B)      /* Names for APPL sets 3 & 4  */
      )                             /* Take globals for the rest  */
    )