Table of Contents (exploded view)
Abstract for Common Information Model User's Guide
Purpose of this information
Who should read this information
Summary of changes
Summary of changes for z/OS Common Information Model User's Guide for Version 2 Release 2 (V2R2)
Summary of changes for z/OS Version 2 Release 2
Introduction and concepts
Introduction
CIM indication concept
Indication delivery retry
How indications work
z/OS CIM security concept
Installation and setup
Installation
Migration from z/OS 1.13 or z/OS 2.1 to z/OS 2.2
Fallback from z/OS 2.2 to z/OS 1.13 or z/OS 2.1
Quick guide: CIM server setup and verification
Step 1: Setting up the security for the CIM server
Quick security setup for RACF
Security setup for a production environment
Step 2: Customizing the file systems and directories
Step 3: Using default TCP/IP ports 5988 and 5989
Step 4: Starting the CIM server
Step 5: Customizing the UNIX System Services shell
Step 6: Running the installation verification program (IVP)
CIM server security setup
Defining a RACF class and profile for the CIM server
Defining a CIM server user ID
Configuring the resource authorization model of the CIM server
Enabling the must-stay-clean feature
Setting up program control
Granting clients and administrators access to the CIM server
Switching identity (surrogate)
Configuring the CIM server HTTPS connection using AT-TLS
Example: Configuring AT-TLS for secure communication
Prerequisite: Common certificate setup
SSL protection only
SSL protection including certificate based authentication
SSL protected indication delivery
Defining the CFZAPPL profile for the APPL class
Defining an encryption key for PassTicket validation
Setting up multilevel security (MLS) support
Considering Automatic Restart Manager security
CIM provider setup and security
Setting up the CIM server for RMF monitoring
Setting up the CIM server for network providers
Setting up the CIM server for Cluster, CoupleDataset, and JES2-JES3Jobs providers
PARMLIB updates
RACF setup
Sysplex couple dataset formatting
JES authorities
Setting up the CIM server for WLM management
Setting up the CIM server for storage management
Running providers in a designated user context
Utilizing the provider based authorization model
Customization
Configuring the ports for the CIM server
Customizing CFZRCUST
Prerequisites
Option 1: Placing /var/wbem in a separate file system
Option 2: Using an existing file system for /var/wbem
System specific directories
Considerations for customizing CIM Server in a z/OS Sysplex
Customizing the CIM server startup
Customizing the started task procedure CFZCIM
Customizing the UNIX System Services shell
Setting the CIM server environment variables
Selecting a WLM service class for z/OS CIM priority
CIM server configuration
Setup verification
Administration and operation
CIM server administration
Starting and stopping the CIM server
Running the CIM server as started task
Running the CIM server from the UNIX System Services command prompt
Running providers in separate address spaces
Changing current configuration properties
Changing planned configuration properties
Tracing
Logging
Using the syslog daemon for CIM server logging
Audit logging with SMF record 86
Backing up the CIM server configuration
Automatically restarting the CIM server
ARM policy considerations
Backing up the CIM server repository
CIM server command-line utilities and console commands
cimmof
Purpose
Syntax
Main diagram:
Options:
Options
Examples
cimconfig
Purpose
Syntax
Options
Examples
cimprovider
Purpose
Syntax
Options
Limitations
Examples
cimcli
Purpose
Syntax
Main diagram:
Operation:
Options
cimcli a (associators)
cimcli an (associatorNames)
cimcli ci (createInstance)
cimcli dc (deleteClass)
cimcli di (deleteInstance)
cimcli dq (deleteQualifier)
cimcli ec (enumerateClasses)
cimcli ei (enumerateInstances)
cimcli eq (enumerateQualifiers)
cimcli gc (getClass)
cimcli gi (getInstance)
cimcli gq (getQualifier)
cimcli im (invokeMethod)
cimcli mi (modifyInstance)
cimcli nc (enumerateClassNames)
cimcli ni (enumerateInstanceNames)
cimcli ns (enumerateNamespaces)
cimcli r (references)
cimcli rn (referenceNames)
cimcli sp (setProperty)
cimcli ti (testInstance)
cimcli xq (execQuery)
cimcli Options
cimcli Instance name
cimsub
Purpose
Syntax
Main diagram:
list:
enable:
disable:
remove:
Filter:
Handler:
Options
Examples
MODIFY console command
Syntax
Options
Examples
Provider reference
Profiles
SMI-S profiles
Host Discovered Resources profile
Used CIM elements
SB Multipath Management profile
Storage HBA profile
HBA Hot Swap Events
Used CIM elements
z/OS Management Instrumentation for CIM
Supported CIM operations
OS management Base classes
CIM_ComputerSystem
CIM_OperatingSystem
CIM_OSProcess
CIM_Process
CIM_RunningOS
IBMzOS_ComputerSystem
IBMzOS_OperatingSystem
IBMzOS_OSProcess
IBMzOS_Process
IBMzOS_RunningOS
IBMzOS_UnixProcess
OS management BaseBoard classes
IBM_BaseBoard
IBMzOS_BaseBoard
Association CIM_ComputerSystemPackage
Association IBMzOS_CSBaseBoard
OS management Processor classes
CIM_Processor
Association CIM_SystemDevice
IBMzOS_Processor
OS management Logical Disk classes
CIM_LogicalDisk
IBMzOS_LogicalDisk
OS management File System classes
CIM_LocalFileSystem
CIM_RemoteFileSystem
Association CIM_HostedFileSystem
IBMzOS_UnixLocalFileSystem
IBMzOS_NFS
OS management Network classes
CIM_EthernetPort
CIM_IPProtocolEndpoint
CIM_PortImplementsEndpoint
Association CIM_SystemDevice
IBMzOS_EthernetPort
IBMzOS_IPProtocolEndpoint
OS management Job classes
IBMzOS_JES2Job
IBMzOS_JES3Job
IBMzOS_JES2SysoutDataset
IBMzOS_JES3SysoutDataset
IBMzOS_Job
IBMzOS_JobsManagementSettings
IBMzOS_Subsystem
IBMzOS_SysoutDataset
Association IBMzOS_SubsystemJES2Jobs
Association IBMzOS_SubsystemJES3Jobs
Association IBMzOS_UsesJES2SysoutDatasets
Association IBMzOS_UsesJES3SysoutDatasets
OS management Cluster classes
IBMzOS_CFRMCoupleDataset
IBMzOS_CFRMPolicy
IBMzOS_CFStructure
IBMzOS_CFStructureConnector
IBMzOS_CoupleDataset
IBMzOS_CouplingFacility
IBMzOS_CouplingFunction
IBMzOS_SFMAttributes
IBMzOS_Sysplex
IBMzOS_SysplexCoupleDataset
IBMzOS_SysplexNode
Association IBMzOS_CFStrDependsOn
Association IBMzOS_CollectionOfCFs
Association IBMzOS_CollectionOfSysplexNodes
Association IBMzOS_HostedCFStructure
Association IBMzOS_HostedCFStrConnector
Association IBMzOS_UsesCFs
Association IBMzOS_UsesCFRMCoupleDatasets
Association IBMzOS_UsesCFRMPolicies
Association IBMzOS_UsesCouplingFunctions
Association IBMzOS_UsesSysplexCoupleDatasets
Storage management classes
CIM_FCPort
CIM_FCPortStatistics
CIM_PortController
CIM_Product
CIM_ProtocolEndpoint
CIM_SoftwareIdentity
CIM_StorageExtent
Association CIM_ControlledBy
Association CIM_DeviceSAPImplementation
Association CIM_ElementSoftwareIdentity
Association CIM_ElementStatisticalData
Association CIM_HostedAccessPoint
Association CIM_InitiatorTargetLogicalUnitPath
Association CIM_InstalledSoftwareIdentity
Association CIM_ProductElementComponent
Association CIM_SystemDevice
IBMzOS_FCCUPort
IBMzOS_FCPort
IBMzOS_FCPortStatistics
IBMzOS_FCSBPort
IBMzOS_PortController
IBMzOS_Product
IBMzOS_SBProtocolEndpoint
IBMzOS_SoftwareIdentity
Association IBMzOS_ControlledBy
Association IBMzOS_CSFCPort
Association IBMzOS_CSFCPortController
Association IBMzOS_ElementSoftwareIdentity
Association IBMzOS_FCPortStatisticalData
Association IBMzOS_InstalledSoftwareIdentity
Association IBMzOS_ProductElementComponent
Association IBMzOS_SBDeviceSAPImplementation
Association IBMzOS_SBHostedAccessPoint
Association IBMzOS_SBInitiatorTargetLogicalUnitPath
WLM classes
IBMzOS_WLM
Association IBMzOS_WLMOS
Developer's guide
CMPI provider development for z/OS
Obtaining the required header files
Following general aspects of developing a provider
Preparing provider initialization and function signatures
Instance provider functions
Method provider functions
Association provider functions
Indication provider functions
Planning provider security
Converting data to ASCII, EBCDIC and UTF-8
Provider installation
Installing providers and dependent load modules
Customizing the CIM server environment for third-party providers
Registering a provider with the CIM server
PG_Provider
PG_ProviderModule
PG_ProviderCapabilities
Using the out-of-process support for providers
Samples
CIM indications
CIM indication class hierarchy
CIM_ProcessIndication
CIM_InstIndication (Lifecycle Event)
CIM_InstModification
CIM subscription mechanism
CIM_IndicationFilter
CIM_ListenerDestinationCIMXML
CIM_IndicationSubscription
Messages
z/OS specific messages
CEZ-prefix messages
CEZ02000I
CFZ-prefix messages
CFZ00409E
Troubleshooting
Garbage on the screen
Typical error scenarios
Step-by-step explanation of the CFZSEC job
Step BASICSUP
Step CRUSR
Step CRWBEM
Step PEUSR
Step PEAPPL
Step SETARM
Step ENSTC
Step PECEA
Step ENCLCDS
Step ENSMIS
Step ENTCPIP
Step ENWLM
Step ENRMF
CEA reason codes
Related links
Legend for graphics showing class structures
How to read syntax diagrams
Symbols
Syntax items
Syntax examples
Dotted decimal syntax diagrams