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.