Controlling the CIM server

In addition to the cimconfig command-line utility, see z/OS Common Information Model User's Guide, starting with z/OS 1.10 the CIM server configuration can be changed from the z/OS system console using the MODIFY command. The general syntax for using the MODIFY command to pass information to a UNIX System Services Application is described in Passing information to a z/OS UNIX System Services application.

Following is the specific syntax for using the MODIFY command to pass configuration changes to the CIM server. Between the options, no spaces are allowed:

 
F jobname ,APPL=CONFIG,property=[value|'value'][,PLANNED]

Basically the CIM server accepts the same options for the MODIFY command as for the cimconfig utility.

jobname
The name of the job that runs the CIM server. When the CIM server is run as a started task, this will usually be CFZCIM.
APPL=CONFIG
This is the indicator for the CIM server that a configuration change was requested through the z/OS system console.
property
The name of the configuration property to be changed. For a complete list of CIM server configuration properties see z/OS Common Information Model User's Guide. Typically, the only current configuration properties that you can change dynamically are the shutdownTimeout property and the logging and tracing properties. Permanent changes require a CIM server restart. They are indicated using the PLANNED keyword at the end of the MODIFY command string.
value
The new value for the configuration property to be changed. For values that contain a comma or for case sensitive property values such as path names the value needs to be enclosed in single quotes ('). To reset a property to its default value, omit the value parameter.
PLANNED
Indicates that the configuration change should be made permanently. This means that the change will only become effective after a CIM server restart, and that the change will also persist further restarts until it is changed again. If PLANNED was not specified at the end of the command, the changes will only stay in effect until the next restart of the CIM server.
Example:
F CFZCIM,APPL=CONFIG,traceComponents=xmlio
F CFZCIM,APPL=CONFIG,traceLevel=4
Turns on tracing of the CIM server's XML traffic.
F CFZCIM,APPL=CONFIG,enableRemotePrivilegedUserAccess=true,PLANNED
Permanently enables superusers (UID=0) to issue requests against the CIM server from a remote system.