Setting the CIM server environment variables

Environment variables are set in file cimserver.env, if the CIM server runs as started task. If you use the CIM server from the UNIX System Services command prompt, the environment variables are set in UNIX System Services .profile in the home path of the user ID which starts the CIM server.

Setting the trace variables is not required for normal operation.

Note that changes to the environment variables become effective only after a restart of the CIM server.

The environment variable file cimserver.env is located in the hierarchical file system at /etc/wbem/. After installation, you can still find the originally shipped version in /usr/lpp/wbem/. The default environment variable file profile.add to customize the shell is located in /usr/lpp/wbem/install.

UNIX

Set the following environment variables contained in this file to start the CIM server: 

_CEE_RUNOPTS

Customized to fit the Language Environment® to the CIM server and tools need. Automatic text conversion for untagged UNIX(R) files system files enabled and automatic tagging activated.

This setting is related to the ASCII-EBCDIC conversion. See Converting data to ASCII, EBCDIC and UTF-8 .

It is also adjusted for optimized initial memory and stack settings of the Language Environment. For the proposed default value of this variable, please look at /usr/lpp/wbem/cimserver.env or /usr/lpp/whem/install/profile.add. A more detailed description of the values for this environment variable you will find in book z/OS Language Environment Customization.

Note:

The recommended default settings of _CEE_RUNOPTS can interfere with other programs.

_BPX_SHAREAS

The default value is NO. It ensures that the CIM server run-time environment runs in a "clean" address space.

_BPXK_AUTOCVT

The default value is ON. Activates automatic text conversion of tagged UNIX(R) file system files.

This setting is related to the ASCII-EBCDIC conversion. See Converting data to ASCII, EBCDIC and UTF-8 .

_TAG_REDIR_ERR

_TAG_REDIR_IN

_TAG_REDIR_OUT

The default value is TXT. Enables tagging of tcsh shell's stdin, stdout, or stderr redirection based on the existing file tags.

For additional information refer to the z/OS UNIX System Services Command Reference book.

PEGASUS_HOME

Must be set to the hierarchical file system directory where the CIM server is installed. By default this is /usr/lpp/wbem.

LIBPATH

Must include the CIM server's lib and provider hierarchical file system directory paths. By default this is set to

• /usr/lpp/wbem/lib:/usr/lpp/wbem/provider:/usr/lib

OSBASE_TRACE

Defines the trace level for the z/OS OS management CIM instrumentation. Valid values range from 0 through 4, where 4 provides the most details.

OSBASE_TRACE_FILE

Defines the filename for the z/OS CIM instrumentation traces.

PATH

Only for running the CIM server or any of the CIM server command-line utilities in UNIX System Services. Must include the CIM server's bin hierarchical file system directory path so that the CIM server's executable programs are automatically found when you enter the according command at the UNIX System Services command prompt. By default this is set to /usr/lpp/wbem/bin.

The following variables starting with RMF_ only apply when RMF™ is installed and you use the RMF monitoring providers:

RMF_CIM_PROVIDER

Used to control the behavior of the RMF CIM providers when RMF is installed. By default, the RMF CIM provider is enabled. To disable the RMF CIM provider, set the environment variable RMF_CIM_PROVIDER=DISABLE.

RMF_CIM_HOST

Defines the target TCP/IP address or hostname of the z/OS MVS™ image on which the DDS responsible for this system is running. Beginning with z/OS 1.11 the use of this environment variable is no longer required, but it will be used if defined. If omitted, the CIM monitoring providers can automatically locate an active RMF DDS in the sysplex, provided all systems in the sysplex run z/OS 1.10 or higher.

RMF_CIM_PORT

Defines the TCP/IP port number of the DDS (default: 8803). Starting with z/OS 1.11 no longer required, but used when defined.

RMF_CIM_TRACE

Defines the trace level of the RMF CIM provider. Valid values range from 0 through 4, with 0 providing no trace and 4 providing all information possible.

RMF_CIM_TRACE_FILE

Defines the file name for storing the trace data for the z/OS RMF CIM instrumentation.

RMF_CIM_BENCH

Is used for performance benchmarks, for example, to identify the response time of the underlying RMF infrastructure. If this variable is set to 1, the RMF CIM provider will print some benchmarking information about various RMF operations, suitable for RMF development.

The following variables starting with WLM_ only apply when Workload Manager (WLM) is installed and you use the WLM providers:

WLM_CIMPROVIDER_TRACE_FILE

Defines the output file name for z/OS WLM provider traces. The default trace file is /var/wlmprovider.trc.

WLM_CIMPROVIDER_TRACE_LEVEL

Defines the trace level for the z/OS WLM provider. Valid values range from 0 through 5, where 5 provides the most details. The default is 0, meaning that no trace is written.