DFSMSrmm: Prepare for the removal of the DFSMSrmm CIM provider

Description

z/OS V2R2 is planned to be the last release to support the DFSMSrmm Common Information Model (CIM) provider. The DFSMSrmm CIM provider uses the DFSMSrmm application programming interface (API) to retrieve information about DFSMSrmm resources in real time.

IBM recommends that you remove the provider registration and its associated files from your system. If you need to retrieve information about DFSMSrmm resources, see Steps to take for alternative methods.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: DFSMSrmm
When change was introduced: See IBM United States Software Announcement 215-267 "IBM z/OS Version 2 Release 2—Fueling the new digital enterprise," dated July 28, 2015.
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before installing z/OS V2R2.
Is the migration action required? Yes, if you configured the DFSMSrmm CIM provider.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM® Health Checker for z/OS® checks: None.

Steps to take

Follow these steps:
  1. Determine whether the DFSMSrmm CIM provider is configured on your system. Check for the following conditions, which must be true if the DFSMSrmm CIM provider is active:
    • Determine whether Java Version 1.5.x is active on your system. This level is the maximum supported Java version for the DFSMSrmm CIM provider. You can use the following shell command: java -version
    • Determine whether the following files exist in z/OS UNIX System Services: 
      /etc/rmm/rmmcust.properties
/var/rmm/rmm.properties
      or equivalent files exist in Linux, for example, in the $RMM_DIR- directory.
    • Determine whether the cimserver process is running under z/OS UNIX, or the CFZCIM started task procedure is running under z/OS.
    • Determine whether any DFSMSrmm providers are registered and running. You can use the following shell command: cimprovider -l -s
  2. For any DFSMSrmm CIM providers that you find, unregister the providers. You can use the following shell command: cimprovider -r -m module_name
  3. Remove the following files from z/OS UNIX or the equivalent files in Linux: 
    /var/rmm/rmm.properties
/etc/rmm/rmmcust.properties
/etc/rmm/rmmlog.properties
If you need to display information about DFSMSrmm resources in real time, you can use DFSMSrmm subcommands or panels. To obtain this information programmatically, for example, to create reports or implement automation, you can retrieve the output through:
  • REXX variables
  • Structured field introducers (SFIs) or XML, by using high-level language APIs or web services.

Reference information

For more information, see the following references:
  • For information about the DFSMSrmm CIM provider, see z/OS DFSMSrmm Implementation and Customization Guide
  • For information about the DFSMSrmm API, see z/OS DFSMSrmm Application Programming Interface
Parent topic: DFSMS actions to perform before installing z/OS V2R2