Windows Registry Information › Registry Information › HKEY_LOCAL_MACHINE\Software\CA\CA IDMS Server › Options › Values

Values

cadcdc32.dll=dll_name

Specifies the name of a user-supplied customized character conversion DLL, used by the native client interface to convert between ASCII and EBCDIC. The name can be qualified with a path. DbcsType must be set to a non-zero value, typically 1, to enable the use of the specified DLL.

DbcsPath=dbcs_path

Specifies the path to the DBCS translation tables, typically the direction specified when CA IDMS Server is installed.

DbcsType=dbcs_type

Specifies the integer value identifying the DBCS Language, as defined by the DBCS Types subkey.

JcliTraceWs=0|1

Enables Windows socket trace. This option is not exposed in the IDMS ODBC Administrator application and should only be set under the direction of CA Technical Support.

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.

LogFile=log_file_name

Specifies the name of the log file, if other than the default log name. This value comes from the Log File field on the Log Options tab of the CA IDMS Server ODBC Administrator dialog.

LogFileCount=integer_value

Specifies the maximum number of archive log and enables the log file rollover feature when the LogFileSize value is greater than zero. The default is 0, which indicates a single log file. This value comes from the File Count field on the Log Options tab of the CA IDMS Server ODBC Administrator dialog.

LogFileSize=64-bit integer_value

Specifies the maximum size (in bytes) of the log file when the log file rollover feature is enabled. The default is zero, which indicates no maximum size. This value comes from the Log File field on the Log Options tab of the CA IDMS Server ODBC Administrator dialog.

LoginTimeout=integer_value

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

LogOptions=log_option_values

Specifies log options as a bit mask. The bit flag, 0x0001, appends information to the existing log file, if any.

MultiThread=0|1

Specifies whether CA IDMS Server processes ODBC connections or multiple threads concurrently. A setting of 1 enables multithreaded access, a setting of 0 disables it. The default is 1.

Path=path_name

Specifies the directory where files used by CA IDMS Server are installed.

QueryTimeout

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

SSLCertDir=certificate_directory_name

Specifies the name of the certificate directory. This directory can contain individual certificates (in PEM format), and is searched for the resolution of signing certificates.

SSLClientCert=client_certificate_file_name

Specifies the fully qualified name of the client certificate file. This file is typically generated on the mainframe and transmitted to the Windows client. Use of this field is optional. A client certificate is only needed if client authentication is required for all SSL connections. All certificate files must be in PEM format.

SSLPassword=client_certificate_password

Identifies the password used for the client certificate. This is an optional field and is only necessary when a client certificate is specified. The SSLPassword field is encrypted before it is written to the registry. Users should not attempt to modify this field outside of the CA IDMS ODBC Administrator application.

SSLServer Cert=server_certificate_file_name

Specifies the fully qualified name of the client certificate file. This file is typically generated on the mainframe and transmitted to the Windows client. Use of this field is optional. A client certificate is only needed if client authentication is required for all SSL connections. All certificate files must be in PEM format.

XxxxTrace=integer_value

Specifies the flag bits used to control tracing. Technical Support uses these trace flags to resolve CA IDMS Server problems. The integer_value must be in the range of 0, which signifies all options off, to 65535, which signifies all options on. This value can be specified as a decimal or hexadecimal integer.

WaitTimeOut

Specifies the default system reply timeout for the JDBC driver.

Descriptions of the individual bit flags are as follows:

• CmTrace (IDMSTD0D.DLL):
  • 0x0001 // trace CCI and internal function calls
  • 0x0002 // elapsed CCI call timings
• DnsTrace (IDMSTD0D.DLL):
  • 0x0010 // snap unconverted send data
  • 0x0020 // snap converted send data
  • 0x0040 // snap received data
  • 0x0080 // snap converted received
• DtsTrace (IDMSTD0D.DLL):
  • 0x0002 // trace external calls
  • 0x0004 // trace events
  • 0x0008 // trace events
  • 0x0010 // snap user data arrays
  • 0x0020 // trace events
  • 0x0040 // snap PCE
  • 0x0080 // snap LCE
• FdeTrace (IDMSFDE.DLL):
  • 0x0001 // trace external generate calls (for precompiler)
  • 0x0002 // trace external convert calls
  • 0x0004 // trace external ASCII-EBCDIC conversion calls
  • 0x0010 // trace internal calls
  • 0x0100 // snap format descriptors
  • 0x1000 // snap input (unconverted) data
  • 0x2000 // snap output (converted) data
• JcliTrace (IDMSJCLI.DLL):
  • 0x0001 // trace internal function calls
  • 0x0002 // time all socket sends/recvs
  • 0x0004 // trace all socket calls
  • 0x0008 // trace ssl calls
  • 0x0010 // snap all send & receive buffs
  • 0x0020 // snap conversion functions
  • 0x0040 // Snap SSL packets
• JdbcTrace (ca.idms.*)—Any non-zero value enables tracing
• OdbcTrace (IDMSODBC.DLL):
  • 0x0002 // Trace internal functions
  • 0x0004 // Trace function parms
  • 0x0008 // Trace thread locks
  • 0x0010 // Snap SQL syntax
  • 0x0100 // Snap environment block
  • 0x0200 // Snap connection block
  • 0x0400 // Snap statement block
  • 0x0800 // Snap SQLDA
• SqlTrace ( IDMSQCLI.DLL):
  • 0x0002 // Time SQL calls
  • 0x0004 // Snap SQL SQLSID
  • 0x0008 // Snap SQL DSICB
  • 0x0010 // Snap SQL SQLCA
  • 0x0020 // Snap SQL SQLCIB
  • 0x0040 // Snap SQL SQLPIB
  • 0x0080 // Snap SQL parm buffer
  • 0x0100 // Snap SQL tuple buffer
  • 0x0200 // Snap SQL input SQLDA
  • 0x0400 // Snap SQL output SQLDA
  • 0x0800 // Snap SQL syntax string
  • 0x4000 // Trace server calls
  • 0x8000 // Snap server interface blocks
• UtilTrace (IDMSUTIL.DLL):
  • 0x0001 // Trace external calls
  • 0x0002 // Trace internal calls
  • 0x0004 // Trace DllEntry calls

The ODBC Administrator is usually used to enable and disable tracing. Because tracing can add overhead and affect performance, it should be disabled under normal circumstances.