Version 8.2.5
 —  Utilities  —

ADDCLOG: Dynamically Add CLOG Data Sets

The ADDCLOG function allows you to dynamically add a new command log (CLOG) data set without terminating your current nucleus session. Using this utility function, you can specify up to eight CLOG data sets. This will reduce the chances of a wait condition in the nucleus, when the nucleus waits for an available CLOG. You might find this particularly useful during busier times of the month or year.

To add a CLOG data set dynamically, the nucleus must know about its JCL at startup time. We recommend that you set up your Adabas nucleus startup jobs to include definition statements for the maximum number of CLOG data sets as you plan to use, but limit the actual usage of the CLOGs using the ADARUN NCLOG parameter. For example, you might start a nucleus with eight CLOG definitions in the Adabas startup JCL, but limit the number of CLOGs actually used during nucleus processing to three CLOGs by setting the NCLOG parameter to "3". When the nucleus starts up, only three CLOGs will be opened and logged in the PPT, even though eight are defined in the JCL. The additional CLOG data sets can then be dynamically added using this ADADBS ADDCLOG utility or its equivalent function in the Adabas Online System (AOS).

Note:
Any CLOG data sets you add dynamically will not be retained once you recycle your Adabas nucleus. To retain these new CLOG data sets when Adabas is stopped and restarted, alter the Adabas startup JCL as well, ensuring that the number of CLOG definition statements in the JCL matches the increased number of CLOG data sets and that the NCLOG ADARUN parameter setting includes the new CLOG data sets.

Running the ADADBS ADDCLOG utility function is invalid when Adabas is running with dual CLOGs.

graphics/util_adadbs_addclog.png

This document describes the syntax, processing, and parameters of the ADADBS ADDCLOG function.


Essential Parameters

NUMBER: CLOG Data Set Number

Use the NUMBER parameter to specify the number of the nonsequential CLOG data set to be added. Valid values are integers ranging from "2" through "8" (inclusive).

Note:
Be sure that the Adabas startup JCL allows for this additional CLOG data set by including a definition statement for the data set. If a definition statement is not already specified for this CLOG data set in the Adabas startup JCL, you will need to add it now and recycle the nucleus. Ideally, you would already have included definition statements in the JCL for all potential CLOG data sets, even though they are not all in use when the nucleus starts up.

NUCID: Cluster Nucleus ID

This parameter is required only in cluster environments.

Use the NUCID parameter to specify the nucleus ID of the Adabas within the cluster to which the new CLOG data set should be dynamically added.

Top of page

Optional Parameters

CLOGDEV

Use the optional CLOGDEV parameter to specify the device type to be used for the new CLOG data set. This parameter is required only if a different device type from the device type specified by the ADARUN DEVICE parameter is to be used. The default is to use the device type specified by the ADARUN DEVICE parameter.

NOUSERABEND: Termination without Abend

When a parameter error or a functional error occurs while this utility function is running, the utility ordinarily prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump). If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.

Note:
When NOUSERABEND is specified, we recommend that it be specified as the first parameter of the utility function (before all other parameters). This is necessary to ensure that its parameter error processing occurs properly.

TEST: Test Syntax

The TEST parameter tests the operation syntax without actually performing the operation. Note that the validity of values and variables cannot be tested: only the syntax of the specified parameters can be tested. See Syntax Checking with the TEST Parameter for more information about using the TEST parameter in ADADBS functions.

Top of page

Examples

In the following example, CLOG data set 3 is dynamically added using a 3390 device.

ADADBS ADDCLOG NUMBER=3,CLOGDEV=3390

In the following example, CLOG data set 6 is dynamically added for the Adabas nucleus 65590 in a cluster environment.

ADADBS ADDCLOG NUMBER=6,NUCID=65590

Top of page