ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatl_5.4.0.1/rzatlcimconfig.htm

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>