Previous Topic: Server server_nameNext Topic: Proxy


Options

The [Options] section contains global options, including path information, logging options, and debugging flags. Other than the log and trace options, most can also be specified for a specific data source. The Options section can contain the following parameters:

CacheConfig=0|1

Enables or disables caching of the configuration file in memory. The default value is 1, enabled. The IDMS_CFG_RELOAD environment value can be used to override this setting when necessary to refresh the cache. This is a global option.

DefaultSchema=schema_name

Specifies the name of the default SQL Schema. This is an optional 1-to-18 character field. When specified, this field is used as the schema qualifier for all SQL table references that do not contain an explicit schema qualifier. The default is blank (unspecified).

FetchSize=integer_value

Specifies the maximum size that the JDBC driver attempts to use for a FETCH buffer. The default is 64,000. Depending on the platform and implementation of the CAICCI interface, a smaller buffer may be used. This usually is left at the default setting. Specifying too large a value may cause the Java Virtual Machine to run out of memory.

Note: The name of this option in the configuration file does not correspond exactly to the JDBC object properties in order to remain compatible with previous versions of CA IDMS Server.

LogFile=log_file_path

Specifies the location and name of the log file. A path name should be specified as an absolute path, for example, /idmsdir/log/caidms.log. If the LogFile value ends in a '/', the default file name of caidms.log is appended to the path.

LogFileCount=integer_value

Specifies the maximum number of archive log files to keep. If a value greater than zero is specified, the LogFileSize value must also be greater than zero. The default is 0, which indicates a single log file.

LogFilePid=0|1

When set to 1, the process id is appended to the log file name to make it unique. The default is 0, disabled. In z/OS UNIX System Services, the log file cannot be shared among different processes. This option allows a common configuration file to be used by multiple processes, but still allowing each process to have a unique log file name.

LogFileSize=integer_value

Specifies the maximum size, in bytes, of the active log file. If a value greater than zero is specified, then the LogFileCount value must also be greater than zero. The default is zero, which indicates no maximum size.

LogOptions=integer_value

Specifies log options as a bitmask. The bit flags are:

LoginTimeout=integer_value

Specifies the system loginTimeout used when the JDBC DriverManager or DataSource setLoginTimeout is set to 0.

JdbcTraceId=0|1

Causes the JDBC driver to prefix each line written to the JDBC log writer with the current timestamp and thread name. This can be useful to identify CA IDMS output in a JDBC DataSource.logWriter trace managed by an application server. The default is 0, disabled.

QueryTimeout=integer_value

Specifies the default reply timeout for SQL requests which use a Java Statement object when using the JDBC driver.

WaitTimeOut=integer_value

Specifies the default system reply timeout for the JDBC driver.

XxxxTrace=integer_value

Specifies the flag bits used to control tracing. Customer Support uses these flags to diagnose CA IDMS Server problems. The integer_value is a bit mask used to specify individual trace options. A setting of 0 turns all options off, and a setting of 65535, or 0xFFFF, turns all options on. Specify this value as a decimal or hexadecimal integer. Descriptions of the bit flags are as follows: