146 lines
9.2 KiB
HTML
146 lines
9.2 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
|
||
|
|
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="concept" />
|
||
|
|
<meta name="DC.Title" content="cimconfig usage information" />
|
||
|
|
<meta name="abstract" content="Configure the startup options for the CIMOM with the cimconfig command." />
|
||
|
|
<meta name="description" content="Configure the startup options for the CIMOM with the cimconfig command." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzatlmngcmd.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzatlsecure.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzatlbackupcert.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzatlmngcmd.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzatlconfig.htm" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzatlcimconfig" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>cimconfig usage information</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzatlcimconfig"><a name="rzatlcimconfig"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">cimconfig usage information</h1>
|
||
|
|
<div><p>Configure the startup options for the CIMOM with the <span class="parmname">cimconfig</span> command.</p>
|
||
|
|
<p><img src="./delta.gif" alt="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.<img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> <img src="./delta.gif" alt="Start of change" />You can run this command from /QIBM/UserData/OS400/CIM.<img src="./deltaend.gif" alt="End of change" /></div>
|
||
|
|
<dl><dt class="dlterm">Name</dt>
|
||
|
|
<dd><samp class="codeph">cimconfig</samp> - get, set, unset or list CIMOM configuration
|
||
|
|
properties.</dd>
|
||
|
|
<dt class="dlterm">Synopsis</dt>
|
||
|
|
<dd>Usage: <ul><li><samp class="codeph">cimconfig -g name [ -c ] [ -d ] [ -p ] [ -q ]</samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig -s name=value [ -c ] [ -p ] [ -q ] </samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig -u name [ -c ] [ -p ] [ -q ] </samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig -l [ -c | -p ]</samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig -h</samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig --help</samp></li>
|
||
|
|
<li><samp class="codeph">cimconfig --version</samp></li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Remarks</dt>
|
||
|
|
<dd>The cimconfig command provides a command-line interface to manage CIMOM
|
||
|
|
configuration properties. <p>The first form of cimconfig provides the current,
|
||
|
|
planned, and default value of the specified configuration property.</p>
|
||
|
|
<p>The
|
||
|
|
second form allows to set the current value and planned value of the specified
|
||
|
|
configuration property to the specified value.</p>
|
||
|
|
<p>The third form allows
|
||
|
|
unsetting the current and planned values of the specified configuration property
|
||
|
|
to its default value.</p>
|
||
|
|
<p>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.</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Options</h4><p>The cimconfig command recognizes the following
|
||
|
|
options:</p>
|
||
|
|
<dl><dt class="dlterm"><img src="./delta.gif" alt="Start of change" />-h, --help<img src="./deltaend.gif" alt="End of change" /></dt>
|
||
|
|
<dd><img src="./delta.gif" alt="Start of change" />Displays command help information<img src="./deltaend.gif" alt="End of change" /></dd>
|
||
|
|
<dt class="dlterm"><img src="./delta.gif" alt="Start of change" />--version<img src="./deltaend.gif" alt="End of change" /></dt>
|
||
|
|
<dd><img src="./delta.gif" alt="Start of change" />Displays CIMOM server version<img src="./deltaend.gif" alt="End of change" /></dd>
|
||
|
|
<dt class="dlterm">-g name</dt>
|
||
|
|
<dd>Gets the current value of the specified configuration property. Returns
|
||
|
|
an error when the CIMOM is not running.</dd>
|
||
|
|
<dt class="dlterm">-g name -c</dt>
|
||
|
|
<dd>Gets the current value of the specified configuration property. Returns
|
||
|
|
an error when the CIMOM is not running.</dd>
|
||
|
|
<dt class="dlterm">-g name -p</dt>
|
||
|
|
<dd>Gets the planned value of the specified configuration property.</dd>
|
||
|
|
<dt class="dlterm">-g name -d</dt>
|
||
|
|
<dd>Gets the default value of the specified configuration property. Returns
|
||
|
|
an error when the CIMOM is not running.</dd>
|
||
|
|
<dt class="dlterm">-s name=value</dt>
|
||
|
|
<dd>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.</dd>
|
||
|
|
<dt class="dlterm">-s name=value -c</dt>
|
||
|
|
<dd>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.</dd>
|
||
|
|
<dt class="dlterm">-s name=value -p</dt>
|
||
|
|
<dd>Indicates that a configuration property is to be added or updated by setting
|
||
|
|
its planned value to the specified value.</dd>
|
||
|
|
<dt class="dlterm">-u name</dt>
|
||
|
|
<dd>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.</dd>
|
||
|
|
<dt class="dlterm">-u name -c</dt>
|
||
|
|
<dd>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.</dd>
|
||
|
|
<dt class="dlterm">-u name -p</dt>
|
||
|
|
<dd>Indicates that the planned value of the specified configuration property
|
||
|
|
is to be reset to the default value.</dd>
|
||
|
|
<dt class="dlterm">-l</dt>
|
||
|
|
<dd>Displays the name of all the configuration properties. Returns an error
|
||
|
|
when the CIMOM is not running.</dd>
|
||
|
|
<dt class="dlterm">-l -c</dt>
|
||
|
|
<dd>Displays the name and value pair of all the current configuration properties.
|
||
|
|
Returns an error when the CIMOM is not running.</dd>
|
||
|
|
<dt class="dlterm">-l -p</dt>
|
||
|
|
<dd>Displays the name and value pair of all the planned configuration properties.</dd>
|
||
|
|
<dt class="dlterm">-q</dt>
|
||
|
|
<dd>Quiet option specifies that no output is sent to standard output or standard
|
||
|
|
error.</dd>
|
||
|
|
</dl>
|
||
|
|
<p><strong>iSeries-specific usage:</strong> On an iSeries™ server, this command requires
|
||
|
|
the user to have *IOSYSCFG and *ALLOBJ authority.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzatlmngcmd.htm" title="The open source Pegasus implementation includes a set of command line utilities that you can use to control or change the Pegasus environment.">Pegasus command-line utilities</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzatlbackupcert.htm" title="Regularly back up the Pegasus repository as part of your existing backup plan. In most cases, you can recover a damaged repository by restoring the last backup copy.">Backup and recovery considerations</a></div>
|
||
|
|
<div><a href="rzatlmngcmd.htm" title="The open source Pegasus implementation includes a set of command line utilities that you can use to control or change the Pegasus environment.">Pegasus command-line utilities</a></div>
|
||
|
|
<div><a href="rzatlconfig.htm" title="The Pegasus CIMOM provides the ability to set a number of configuration options.">Configure Pegasus</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="rzatlsecure.htm" title="Use this topic to find out about the options that are available for ensuring that the CIM server is secure.">Secure Pegasus</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|