Abstract for Hardware Configuration Manager User's Guide
Summary of changes for Version 2 Release 1 (V2R1) as updated February, 2015
Changes made in z/OS Version 2 Release 1
Enhancements of the I/O Autoconfiguration function
Support of PCIe functions
PCHID Summary Report
Hardware support
Changes made in z/VM Version 6 Release 3
Changes made in z/VM Version 6 Release 2
Changes made in z/VM Version 6 Release 1
Overview
Physical and logical data in one place
Easy to use
Accurate system configuration
Support for different user groups
Installing HCM
Prerequisites
Workstation hardware requirements
Software requirements
Workstation
Operating system
HCM installation
Host
Communication
Browsing performance data
I/O Operations functions
Installing HCM on your workstation
Purpose and location of the HCM INI file
Installation problems
Installing service levels
Installing HCM in a LAN environment
Establishing the host communication
Setting up TCP/IP definitions for z/OS
Skeleton used to start the HCM agent
Starting the HCM dispatcher as a started task
Creating a user ID
Starting the HCM dispatcher as a batch job
Stopping the HCM dispatcher
Define an HCD profile
Allocate the HCM trace data set
Specifying TCP/IP on your workstation
Setting up TCP/IP definitions for z/VM
Setting up the service virtual machine
Required minidisks
CP directory entry for service virtual machine
Setting up the z/VM HCD TCP/IP Dispatcher for HCM
How to set up required files
Setting up Security
How to set up security with native CP
How to set up security using an external security manager
Client Authentication
Setting up security with RACF/VM
Verifying TCP/IP host communication
TCP/IP problem determination
Uninstalling HCM
Getting started
Starting and stopping HCM for z/OS
Starting and stopping HCM for z/VM
Working with the user interface
Keyboard
Mouse
Dialogs
Online help
User data fields
Messages
HCD messages
HCM messages
Maintaining the configuration diagram
Filtering your view
Connections in the diagram
Hiding connections
Saving views
Vertical view of XMP processors
Visualizing ESCON or FICON switch and crossbar switch configurations
Showing page breaks
Zooming the view
Scrolling the view
Controlling text detail
Setting preferences
Showing screen elements
Specifying options
Showing system status information
Receiving visual warnings
Printing the configuration diagram
Selecting objects
Locating objects
Filtering objects
Creating objects
Editing objects
Deleting objects
Reversing an action
Ordering objects
Building your configuration
HCM and HCD
Relation of configuration files and IODFs
Characteristics of the production and work configuration file
Production configuration file
Work configuration file
Data integrity between IODF and configuration file
Concurrent use by multiple users
The IODF load / resync process
Resynchronizing configuration files and IODFs
Introduction to the master configuration file concept
Physical and logical objects in HCM
Graphical representation of physical objects
How PDFs are assigned to objects
Creating a new configuration from an IODF
Preparing the IODF
Loading the IODF
Loading a work IODF with associated MCF
Loading a production IODF with associated MCF
Working with multi-user access enabled IODFs
Specifying a high-level qualifier for z/OS
Choosing alternate processor definitions
Inspecting the initial configuration
Adding physical data to the configuration
Creating a new configuration from scratch
Opening an existing configuration
Opening an existing configuration file and associated IODF
Opening an existing configuration file with a new IODF
Upgrading configuration files
Upgrading the associated IODF from version 4 to version 5 format
Working with your IODFs and configuration files
Copying an existing IODF
Making a work or a production IODF
Using the CHPID Mapping Tool Support utility
Creating work and production IODFs without the associated configuration files
Exporting and importing IODFs
Deleting an existing IODF
Checking a configuration
Copying a configuration
Creating work and production IODFs with the associated configuration files
Compressing configuration files
Naming convention of your configuration files and IODFs
Deleting a configuration file
Saving and closing your configuration
Using the master configuration file (MCF)
Enabling/disabling a configuration for MCF-sharing
Granting access to the MCF on the host
How to work with MCF-enabled configurations: Scenarios
Loading an IODF with associated MCF
Opening an MCF-enabled configuration
Opening a configuration that was MCF-disabled by another user
Processing an MCF-enabled configuration stand-alone and connected
Version checking: using an old HCM version
Version checking: using an old HCD version
How to resolve physical mismatches in a shared configuration
Recommendations and guidelines for mismatch resolution
How to work with configuration packages
How to create and edit a configuration package
How to work with configuration package objects
How to transmit a configuration package
How to send a package to an unattended node
Stand-alone mode
Invoking the stand-alone mode
Working with the stand-alone mode
Creating objects
Viewing objects
Printing reports, diagrams, cable labels
No host connection
Work configuration file
Production configuration file
Upgrading
Resynchronizing
VOLSER reconciliation
Modifying objects in your configuration
General concepts of the copy wizards
How HCM handles connections when using the copy wizards
Mapping CHPIDs
Rules for CHPID mapping when CF connections are involved
Connections in the Upgrade scenario
Logical connections
Moving existing physical connections
Rules for CTC connections
Rules for CF connections
Remarks on converters
Exception
Remarks on visual warnings
Connections in the Repeat scenario
Logical connections in the Repeat scenario
Assigning new connections
Rules for CTC connections
Rules for CF connections
Processors
Creating a processor
Choosing a support level
Copying a processor using a wizard
Editing a processor
Adding user data to a processor
Deleting a processor
Managing PCIe functions
Channel subsystems
Creating or editing a channel subsystem
Copying a channel subsystem
Deleting a channel subsystem
Partitions
Creating a partition
Partitions for dynamic I/O configuration
Granting I/O devices access to the new partition
Copying a partition
Editing a partition
Adding user data to a partition
Deleting a partition
CHPIDs
CHPID interface type
CHPID operation mode
More about spanned channel paths in multiple LCSSs
CHPID operation mode symbols
Unmanaged/managed CHPIDs
Selecting a CHPID to view details
Editing objects connected to a CHPID
Ordering objects connected to a CHPID
Create CHPIDs
Defining IQD channel parameters
Defining more than 160 TCP/IP stacks
Defining or editing a CIB channel
Over-defining a CHPID
Editing a CHPID
Deleting a CHPID
Assigning CHPIDs to partitions
Support of spanned CHPIDs
Physical and logical aspects of spanned CHPIDs
Visualizing spanned CHPIDs
Navigating with spanned CHPIDs
Support of spanned CHPIDs in the HCM dialog
Aggregating CHPIDs
Controllers
Creating a controller
Choosing a physical description
Adding control units to controller segments
Ordering strings connected to the controller
Editing a controller
Creating a new physical description file for a controller
Adding user data to a controller
Choosing a physical description
Arranging controller components
Changing the number of adapters
Changing the number of interfaces
Changing the order of controller interfaces
Arranging control units and connections in a controller
Editing labels of adapters and interfaces
Grouping controllers into subsystems
Editing the fiber links above the controller
Changing the channel interface type
Deleting a controller
Control units
Creating a control unit
Choosing a controller segment to assign the control unit
Editing a control unit
Deleting a control unit
Deleting a switch 's control unit
Moving an existing switch 's control unit into a switch
Strings
Creating a string
Choose physical description
Editing a string
Adding user data to a string
Assigning devices to units in the string
Changing the physical description
Ordering string interfaces
Changing the number of string interfaces
Deleting a string
Units
Creating a unit
Editing a unit
Adding user data to a unit
Deleting a unit
I/O devices
Creating an I/O device in a string
Editing an I/O device
Defining devices to OS configurations
Deleting an I/O device
Changing the subchannel set for devices
Converters
Creating a converter
Deleting a converter
Editing a converter
Replacing a converter
Switches
Creating a switch
Editing a switch
Editing switch attributes
Editing switch port attributes
Applying default port names
Editing fiber links above the switch
Moving Ports
Deleting a switch
Managing switch configurations
Creating a switch configuration
Editing a switch configuration
Editing a port matrix
Changing the view of the matrix
Editing port-to-port connections
Visualizing a switch configuration
Applying switch port names
Editing switch ports in a configuration
Activating a switch configuration for z/OS
Deleting a Switch Configuration
Crossbar switches
Creating a crossbar switch
Editing a crossbar switch
Adding user data to a crossbar switch
Recording Crossbar Configurations
Setting the size of a crossbar switch
Editing controllers connected to crossbar control unit interfaces
Ordering controllers connected to a crossbar
Ordering crossbar channel or control unit interfaces
Visualizing a crossbar switch configuration
Deleting a crossbar switch
Cabinets
Creating a cabinet
Editing a cabinet
Adding user data to a cabinet
Deleting a cabinet
Patchports
Cabinet dialog controls
Syntax of the user-defined patchport/general box port naming format
General boxes
Creating a general box
Editing a general box
Deleting a general box
Connecting objects in your configuration
Connecting objects
Positioning objects along daisy-chained connections
Connecting devices to controllers
Creating a string under a controller
Selecting an existing string under a controller
Connecting the string to a controller device interface
Making a physical connection
Making a standard connection
Making a custom connection
Explicit device and null device candidate lists
Disconnecting the string interface from a device interface
Connecting controllers to processors and switches
Selecting a channel interface for a controller
Connecting the channel interface to a CHPID
Making a physical connection
Making a standard connection
Editing logical definitions between controller and processor
Connecting multiple control units to multiple CHPIDs
Disconnecting the channel interface from a CHPID
Connecting controllers to controllers (PPRC connections)
Physically connecting a channel interface to a channel interface of another controller
Creating a PPRC connection
Editing a PPRC connection
Importing and exporting PPRC connections
Deleting a PPRC connection
Disconnecting a channel interface from a channel interface
Connecting switches to processors or other switches
Disconnecting the switch port from a target interface
Connecting CHPIDs via CTC connections
Creating a CTC connection
Editing a CTC connection
Viewing a connectivity report for a CTC connection
Deleting a CTC connection
Editing the fiber links for CTC connections
Viewing and deleting unused CTC control units, devices, and connections to CHPIDs
Validating CTC connections
CTC connection report
View CTC connection details
View unused CTC control units, devices, and CHPID connections
Create / establish CTC connections after loading an IODF
Connecting CHPIDs via coupling facility connections
Creating a coupling facility connection
Deleting a coupling facility connection
Physical connections
Managing physical cables
Assigning cables to connections
Viewing cables and connections
Creating or editing cables
Transferring unused cables to inventory
Deleting cables
Other ways to assign cables
Creating and editing cables
Creating a new cable to assign to a connection
Reusing an existing cable for a connection
Removing a cable from a connection
Printing cable labels
Editing fiber links
Infrastructure connections
Disconnecting permanent connections from patchports
Jumper connections
Editing fiber links in the dialog
Adding a patchport to the fiber link
Removing a patchport from the fiber link
Assigning cables between the objects in a fiber link
Disconnecting a fiber link
Connecting crossbar switches
Connecting a crossbar switch
Positioning a crossbar switch on a daisy-chain
Disconnecting a crossbar channel interface
Utilities
Performing I/O Autoconfiguration
How to start I/O Autoconfiguration
How to define the scope and mode of discovery
How to work with discovered controllers
How to work with proposed control units
How to work with proposed devices
How to apply your own numbering scheme for PAV devices
How to work on the Summary page
How to define autoconfiguration policies
How changed control units may affect HCM
Moving port connections
Implied ports
Procedure
Aggregating CHPIDs
Converting CNC channels to FICON channels
Priming the IODF with sensed data
Changing the CHPID link address format
Creating/Copying/Editing an I/O subsystem
Invocation
Using the utility to create an I/O subsystem
Using the utility to copy an I/O subsystem
Using the utility to edit an I/O subsystem
Exporting IOCP or I/O configuration statements
Importing I/O configuration statements
Browsing performance data
Objects that provide performance data
Using the WWPN Prediction Tool Support
Operating system configurations
Listing the OS configuration-EDT-esoteric hierarchy
Creating an OS configuration
D/R site OS configurations
Editing an OS configuration
Copying an OS configuration
Deleting an OS configuration
Listing devices for an OS configuration
Adding devices to an OS configuration
Removing devices from an OS configuration
Editing device <=> OS configuration parameters
Listing OS configurations to which devices are defined
Selecting OS configurations to which to define devices
Selecting OS configurations from which to remove devices
Adding devices to an esoteric within the OS configuration
Listing consoles for an OS configuration
Adding a console to an OS configuration
Removing a console from an OS configuration
Editing a console for an OS configuration
Eligible device tables (EDTs)
Creating an EDT
Editing an EDT
Copying an EDT
Deleting an EDT
Esoteric device groups (esoterics)
Creating an esoteric
Editing an esoteric
Copying an esoteric
Deleting an esoteric
Listing devices for an esoteric
Adding devices to an esoteric
Removing devices from an esoteric
Generic device groups (generics)
Listing system-defined generics
Listing devices for a system-defined generic
Listing user-defined generics
Listing devices for a user-defined generic
Editing a user-defined generic
User interface to I/O Operations
Viewing the active sysplex and its status
Operations menu
Color dialog
Manipulating and activating switch matrices
Issuing I/O Operations commands
Reports and diagrams
Printing configuration diagrams
Generating text reports and diagram reports
Sample text reports and diagram reports
Printed sample reports
Sample cable labels
Viewing HCD configuration reports
Viewing HCD compare reports
Viewing IODF compare reports
Viewing CSS/OS compare reports
Comparing HCM configurations
Scenarios
Scenario I – Adding and connecting new equipment
Add four new channels to an existing processor
Connect the new CHPIDs to patchports
Add a new FICON switch
Connect the new switch to one of the new CHPIDs
Connect another switch to the second new CHPID
Add a new controller
Connect the controller to CHPIDs
Connect the controller to the FICON switches
Define the fiber links for the connections
Add some strings to the new controller
Define the devices to the operating system
Scenario II – Defining a CTC connection
Connect a switch to the CHPIDs
Create the first CTC connection
Create the second CTC connection
Create the third CTC connection
Create the last CTC connection
Define the CTC devices to the OS configuration
Scenario III – Defining a fiber cabling infrastructure
Create the cabinets
Trunk the two cabinets together
Trunk the zone cabinet to the processor
Connect a switch to CHPIDs through the patchport cabinets
Assign a cable to the new connection
Connect a controller to the CHPID via the switch
Scenario IV – Configuration changes for installing a FICON bridge card in a 9032–5 ESCON director
Scenario V – Establish a PPRC connection consisting of several PPRC links
HCD-only tasks
Defining and viewing configuration data
Adding similar objects to a configuration
Copying configurations and merging IODFs
Transferring partition configurations
Upgrade an IODF from an earlier version of HCD
Querying supported hardware and installed UIMs
Viewing and printing the activity log
Support of large IODFs
Activating and processing configuration data
Building IOCDSs
Managing IPL attributes
Dynamic activate
Build configuration data sets
Building and processing CONFIGxx members
Importing and exporting data
Data format for importing and exporting
File structure
Record structure
Column formats
Hierarchical object keys
Unique key
Future compatibility and extensibility
Working with the import and export function
Importing data
Exporting data
Importing in stand-alone mode
Exporting in stand-alone mode
Using import as a migration aid
Table summary
Detailed table formats
PROC table
PART table
CHPID table
Sparse CHPID mapping for OPPP processors
OPPP and shadow processor CHPID/path mapping issues
DIR table
PORT table
CONTRLLR table
Interfaces on controllers
Controller channel interface (CCI) table
Controller device interface (CDI) table
CU table
STRING table
String interface (SI) table
UNIT table
DEVICE table
XBAR table
XBARCFG table
Crossbar channel interface (XCI) table
Crossbar control unit interface (XCUI) table
CABINET table
PANEL table
PATCHPRT table
CONVERTR table
CABLE table
LOGLINK table
Each LOGLINK row represents a "Logically Complete" series
Valid sources for a "Logically Complete" series
Valid targets
Special considerations for daisy-chained connections
Special considerations for converters
Order of processing
Connections from CHPIDs on OPPP processors
CONNECT table
Source and target optional qualifiers
Valid sources and targets
Connections involving ports on switches
Order of processing
PPRCLINK table
DEVCU table (export-only)
CUCHPID table (export-only)
DEVIMAGE table (export-only)
Physical description files (PDF)
Loading PDFs
Customizing PDFs
PDF syntax
Controller PDF syntax
String PDF syntax
Problem determination
Identifying and handling problems
Product identifiers
Application error
Controlled exit at the workstation
Communication problems using TCP/IP under z/OS
Communication problems using TCP/IP under z/VM
Message problems
Incorrect results
Incorrect configuration diagram
Problems printing reports/configuration diagrams
Abnormal termination of HCD host
HCD host problems
Out of memory condition
Problems when using I/O Operations
Problems when using the RMF DDS
Problems with HCM User's Guide
Exporting an MCF
Incorrect help information
Problems with UIM-provided help
Using the HCD trace facility
Using the z/VM HCD TCP/IP Dispatcher for HCM trace facility
z/VM HCD TCP/IP Dispatcher for HCM commands
The HCMERR.LOG PC file
Searching problem reporting databases and reporting problems
Reporting problems to IBM
HCM messages
EEQ0000T
Alternate processor definitions
Managing shadow processors during an HCM session
Creating a new processor under a machine
Deleting a processor from a machine
Changing the processor style
Making a processor primary or alternate
Assigning processors to machines during IODF load/resync
One Processor Per Partition (OPPP) machines
IODF load and resync
Creating and deleting OPPP machines
Editing OPPP processors
CHPIDs, channels, and CHPID mapping
Connecting OPPP machines
CTC connections to OPPP machines
Naming conventions in dialogs and reports
Cable descriptions
Menu bar choices summary
File menu
Edit menu
View menu
Locate menu
Create menu
Operations menu
Utilities
Options menu
Help menu
Special setup considerations for z/OS
HCM client: configurable login parameters
Host messages
HCM Client: TCP/IP related messages
Trademarks
Accessing licensed books on the web (z/OS)
Accessing licensed books on the web (z/VM)