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

141 lines
8.8 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="cimprovider usage information" />
<meta name="abstract" content="Enable or disable a registered provider, primarily during testing with this command. The CIMOM must be running to use this command." />
<meta name="description" content="Enable or disable a registered provider, primarily during testing with this command. The CIMOM must be running to use this command." />
<meta name="DC.Relation" scheme="URI" content="rzatlmngcmd.htm" />
<meta name="DC.Relation" scheme="URI" content="rzatlmngcmd.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzatlcimprovider" />
<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>cimprovider usage information</title>
</head>
<body id="rzatlcimprovider"><a name="rzatlcimprovider"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">cimprovider usage information</h1>
<div><p>Enable or disable a registered provider, primarily during testing
with this command. The CIMOM must be running to use this command.</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">cimprovider</samp> - disable, enable, remove or list registered
CIM providers or CIM provider modules and module status.</dd>
<dt class="dlterm">Synopsis</dt>
<dd>Usage: <ul><li><samp class="codeph">cimprovider -d -m module [ -q ]</samp></li>
<li><samp class="codeph">cimprovider -e -m module [ -q ]</samp></li>
<li><samp class="codeph">cimprovider -r -m module [ -p provider ] [ -q ]</samp></li>
<li><samp class="codeph">cimprovider -l [ -s | -m module ]</samp></li>
<li><samp class="codeph">cimprovider -h</samp></li>
<li><samp class="codeph">cimprovider --help</samp></li>
</ul>
</dd>
<dt class="dlterm">Limitations</dt>
<dd>This command disables, enables, or removes only one CIM provider module
or CIM provider at a time.</dd>
<dt class="dlterm">Description</dt>
<dd> <p>The cimprovider command provides a command-line interface to disable,
enable, unregister, and list registered CIM providers. If a CIM provider is
disabled, the CIMOM rejects any requests to the provider. If a CIM provider
is enabled, the CIMOM forwards requests to the provider. And if a CIM provider
is unregistered, the CIMOM will no longer have any information about the provider.
In order to use the cimprovider command, cimserver has to be running and the
specified provider module (a grouping of providers in the same *SVRPGM) or
provider has to be registered with the CIMOM.</p>
<p>The first form of cimprovider
disables the specified provider module. When a specified provider module is
in the disabled state, any new requests to the providers that are contained
in the specified provider module will be rejected.</p>
<p>The second form of
cimprovider enables the providers that are contained in the specified provider
module. The providers that are contained in the specified provider module
are now ready to accept new request.</p>
<p>The third form of cimprovider removes
(unregisters) the specified provider module and all of its contained providers
or the specified provider in the specified provider module. Once removed a
provider or provider module, must be reregistered (typically by loading its
registration schema using the cimmofl command).</p>
<p>The last form of cimprovider
lists all the registered provider modules and module status or all the providers
in the specified provider module. To list all providers in all modules, issue
a cimprovider -l command, followed by cimprovider -l -m for each listed module.</p>
</dd>
</dl>
<div class="section"><h4 class="sectiontitle">Options</h4><p>The cimprovider 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 the CIMOM server version.<img src="./deltaend.gif" alt="End of change" /></dd>
<dt class="dlterm">-d</dt>
<dd>Disables the specified CIM provider module. If the module is already disabled,
an error message is returned.</dd>
<dt class="dlterm">-e</dt>
<dd>Enables the specified CIM provider module. If the module is already enabled
or is currently being disabled, an error message is returned.</dd>
<dt class="dlterm">-r</dt>
<dd>Removes the specified provider module and all of its contained providers.
If a provider is specified, removes the specified provider in the specified
provider module without affecting any other providers in that module.</dd>
<dt class="dlterm">-l</dt>
<dd>Displays all the registered provider modules.</dd>
<dt class="dlterm">-m Module</dt>
<dd>Specifies the provider module for the operation.</dd>
<dt class="dlterm">-p Provider</dt>
<dd>Specifies the provider for the operation.</dd>
<dt class="dlterm">-q</dt>
<dd>Quiet option specifies no output is sent to standard output or standard
error.</dd>
<dt class="dlterm">-s</dt>
<dd>Displays the status of provider modules.</dd>
</dl>
</div>
<div class="example"><h4 class="sectiontitle">Examples</h4><dl><dt class="dlterm"><kbd class="userinput">cimprovider -d -m myProviderModule</kbd></dt>
<dd>Disable provider module <samp class="codeph">myProviderModule</samp> and all of its
contained providers (placing them in a stopped state).</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -e -m myProviderModule</kbd></dt>
<dd>Enable provider module <samp class="codeph">myProviderModule</samp> and all of its
contained providers (placing them in a OK state).</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -r -m myProviderModule</kbd></dt>
<dd>Remove (unregister) the <samp class="codeph">myProviderModule</samp> provider module
and all of its contained providers.</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -r -m myProviderModule -p MyProvider</kbd></dt>
<dd>Remove (unregister) the <samp class="codeph">MyProvider</samp> provider that is contained
in the <samp class="codeph">myProviderModule</samp> provider module.</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -l</kbd></dt>
<dd>List the registered provider modules.</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -l -s</kbd></dt>
<dd>List the registered provider modules and their status (such as OK, Stopping,
Stopped).</dd>
<dt class="dlterm"><kbd class="userinput">cimprovider -l -m myProvider</kbd></dt>
<dd>List the registered providers that are in the <samp class="codeph">myProviderModule</samp> provider
module.</dd>
</dl>
<p><strong>iSeries™ server-specific usage:</strong> On an iSeries server,
this command requires the user to have *IOSYSCFG and *ALLOBJ authority.</p>
</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="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>
</body>
</html>