cimconfig usage information

Configure the startup options for the CIMOM with the cimconfig command.

Start of change If you change any configuration properties that are in the planned configuration settings, changes will not take effect until the CIM server is restarted. End of change

Note:

You can run this command from /QIBM/UserData/OS400/CIM. End of change

Name

cimconfig - get, set, unset or list CIMOM configuration properties.

Synopsis

Usage:

cimconfig -g name [ -c ] [ -d ] [ -p ] [ -q ]
cimconfig -s name=value [ -c ] [ -p ] [ -q ]
cimconfig -u name [ -c ] [ -p ] [ -q ]
cimconfig -l [ -c | -p ]
cimconfig -h
cimconfig --help
cimconfig --version

Remarks

The cimconfig command provides a command-line interface to manage CIMOM configuration properties.

The first form of cimconfig provides the current, planned, and default value of the specified configuration property.

The second form allows to set the current value and planned value of the specified configuration property to the specified value.

The third form allows unsetting the current and planned values of the specified configuration property to its default value.

The last form of this command allows for all the configuration properties to be listed. Specifying the -c or -p options, will provide a listing of all the current or planned configuration property names and values.

Options

The cimconfig command recognizes the following options:

-h, --help: Displays command help information
--version: Displays CIMOM server version
-g name: Gets the current value of the specified configuration property. Returns an error when the CIMOM is not running.
-g name -c: Gets the current value of the specified configuration property. Returns an error when the CIMOM is not running.
-g name -p: Gets the planned value of the specified configuration property.
-g name -d: Gets the default value of the specified configuration property. Returns an error when the CIMOM is not running.
-s name=value: Indicates that a configuration property is to be added or updated by setting its current value to the specified value. Returns an error when the CIMOM is not running or the specified property cannot be updated dynamically.
-s name=value -c: Indicates that a configuration property is to be added or updated by setting its current value to the specified value. Returns an error when the CIMOM is not running or the specified property cannot be updated dynamically.
-s name=value -p: Indicates that a configuration property is to be added or updated by setting its planned value to the specified value.
-u name: Indicates that the current value of the specified configuration property is to be reset to the default value. Returns an error when the CIMOM is not running or the specified property cannot be updated dynamically.
-u name -c: Indicates that the current value of the specified configuration property is to be reset to the default value. Returns an error when the CIMOM is not running or the specified property cannot be updated dynamically.
-u name -p: Indicates that the planned value of the specified configuration property is to be reset to the default value.
-l: Displays the name of all the configuration properties. Returns an error when the CIMOM is not running.
-l -c: Displays the name and value pair of all the current configuration properties. Returns an error when the CIMOM is not running.
-l -p: Displays the name and value pair of all the planned configuration properties.
-q: Quiet option specifies that no output is sent to standard output or standard error.

iSeries-specific usage: On an iSeries™ server, this command requires the user to have *IOSYSCFG and *ALLOBJ authority.

Note: You can use the cimconfig command to set the current or planned configuration properties of the CIMOM. You can update the current configuration properties only while the CIMOM is running. All of the properties can be changed in the planned configuration properties, whether the CIMOM is running or stopped. If the planned configuration properties are changed, those changes will not take effect until the CIMOM is restarted. When the CIMOM is started, the planned configuration properties become the current configuration properties.