6.2 The Driver Shim Configuration File

The driver shim configuration file controls operation of the driver shim.

The default driver shim configuration file is in the IFS /etc directory. So that the exit programs can find the file, its name is the lowercased name of the driver library. For example, if you installed the driver shim into the I5OSDRV library, the configuration file is /etc/i5osdrv.conf.

You can specify the configuration options listed in Table 6-5, one per line.

Table 6-5 Driver Shim Configuration File Statements

Option (Short and Long Forms)

Description

-conn <connString>

-connection <connString>

A string with connection options. Enclose the string in double quotes ("). If you specify more than one option, separate the options with spaces.

  • port= <driverShimPort>
  • ca= <Certificate Authority Key File>

-hp <httpPort>

-httpport <httpPort>

Specifies the HTTP services port number. The default HTTP services port number is 8091.

You can connect to this port to view log files. For details, see Section A.1.2, The Trace File and Section A.1.5, The Status Log.

-i5oslibrary <libraryName>

Specifies the library name where the driver shim is installed. The default is I5OSDRV.

-path <driverPath>

Specifies the IFS path for driver files. The default path is /usr/local/i5osdrv.

-t <traceLevel>

-trace <traceLevel>

Sets the level of debug tracing. 0 is no tracing, and 10 is all tracing. For details, see Section A.1.2, The Trace File.

The output file location is specified by the tracefile option.

-tf <fileName>

-tracefile <fileName>

Sets the trace file location.

The default is logs/trace.log in the driver IFS path.

Example Driver Shim Configuration File

-tracefile /usr/local/i5osdrv/logs/trace.log
-trace 0
-connection "ca=/usr/local/i5osdrv/keys/ca.pem port=8090"
-httpport 8091
-path /usr/local/i5osdrv/