Enable or disable a registered provider, primarily during testing with this command. The CIMOM must be running to use this command.
You can run this command from /QIBM/UserData/OS400/CIM.
- Name
- cimprovider - disable, enable, remove or list registered CIM providers or CIM provider modules and module status.
- Synopsis
- Usage:
- cimprovider -d -m module [ -q ]
- cimprovider -e -m module [ -q ]
- cimprovider -r -m module [ -p provider ] [ -q ]
- cimprovider -l [ -s | -m module ]
- cimprovider -h
- cimprovider --help
- Limitations
- This command disables, enables, or removes only one CIM provider module or CIM provider at a time.
- Description
-
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.
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.
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.
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).
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.
Options
The cimprovider command recognizes the following options:
- -h, --help
- Displays command help information.
- --version
- Displays the CIMOM server version.
- -d
- Disables the specified CIM provider module. If the module is already disabled, an error message is returned.
- -e
- Enables the specified CIM provider module. If the module is already enabled or is currently being disabled, an error message is returned.
- -r
- 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.
- -l
- Displays all the registered provider modules.
- -m Module
- Specifies the provider module for the operation.
- -p Provider
- Specifies the provider for the operation.
- -q
- Quiet option specifies no output is sent to standard output or standard error.
- -s
- Displays the status of provider modules.
Examples
- cimprovider -d -m myProviderModule
- Disable provider module myProviderModule and all of its contained providers (placing them in a stopped state).
- cimprovider -e -m myProviderModule
- Enable provider module myProviderModule and all of its contained providers (placing them in a OK state).
- cimprovider -r -m myProviderModule
- Remove (unregister) the myProviderModule provider module and all of its contained providers.
- cimprovider -r -m myProviderModule -p MyProvider
- Remove (unregister) the MyProvider provider that is contained in the myProviderModule provider module.
- cimprovider -l
- List the registered provider modules.
- cimprovider -l -s
- List the registered provider modules and their status (such as OK, Stopping, Stopped).
- cimprovider -l -m myProvider
- List the registered providers that are in the myProviderModule provider module.
iSeries™ server-specific usage: On an iSeries server, this command requires the user to have *IOSYSCFG and *ALLOBJ authority.