141 lines
8.8 KiB
HTML
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>
|