z/OS HCD User's Guide
Previous topic |
Next topic
|
Contents
|
Index
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS HCD User's Guide
SC34-2669-00
Hardware Configuration Definition User’s Guide
How to send your comments to IBM
If you have a technical problem
Abstract for Hardware Configuration Definition User’s Guide
Summary of changes
Changes made in z/OS Version 2 Release 1
Enhancements of the I/O Autoconfiguration function
HMC-wide activate
Support of PCIe functions
Validation enhancements
New warning message when a CF CIB connection changes due to connectivity updates
Warning message CBDA845I now also issued for ACTIVATE SOFT system command
Enhanced CF Channel Path Connectivity List
OS group change action available for device groups
HCD batch enhancements
Filter parameters for graphical reports created via batch utility
ACTIVATE command now available as an HCD batch command
New profile options
PCHID Summary Report
Verify a configuration by means of I/O Autoconfiguration (zDAC)
Hardware support
Hardware configuration definition - What is it?
What HCD is and how it differs from MVSCP and IOCP
Definition of configuration data
How MVSCP and IOCP worked
What HCD does
Validation of configuration data
How MVSCP and IOCP worked
What HCD does
Reconfiguration of configuration data
How MVSCP and IOCP worked
What HCD does
What HCD offers you
How HCD works
Objects managed in the IODF
IODF used at IPL
Relationship of data sets used by HCD
The environment in which HCD operates
HCD and I/O Operations
Prerequisites
HCD and the coupling facility
Support of System z clusters
Support of the sysplex environment
Migration
Migration overview
Migration roadmap
Security migration
Migration tasks
How to set up, customize and start HCD
Setting up HCD
How to invoke HCD in dialog mode
Tailoring the CLIST CBDCHCD
Starting and ending HCD
Defining an HCD profile
Working with the HCD Profile Options dialog
Keywords
Volume serial number to allocate output data sets
Volume serial numbers to allocate log data sets and HCM MCF data set
Automatic activity logging
Allow or prohibit mixed esoterics
HLQ for exporting IODFs
Allocation space for data sets allocated due to HCM requests
Extending allocation space
Name and volume serial number for UIM library
Load VM UIMs
Options for text reports
Layout of graphical reports
Color settings for graphical display function
Support of TSO option NOPREFIX
Esoteric token when migrating MVSCP input data sets
Control unit type when migrating IOCP input data sets
Extended migration
Bypass IODF information update for SNA processor
Display information during ACTIVATE
Loading an IODF into a data space
IODF name verification for batch jobs
IODF checker automation
Delay device regrouping
Default settings for OS parameters
Extension of the attachable device list of a control unit
Show partition defaults in IOCP statements
Export/import additional configuration objects
Unconditional generation of D/R site OS configurations
HMC-wide activation
Example
Customizing HCD EXEC procedures
How to work with I/O definition files (IODF)
IODF naming convention
Work IODF
Production IODF
Associated data sets
Create or specify an IODF
Multi-user access
Sharing IODFs
Deciding on the number of IODFs
The master IODF concept
How HCD arranges devices into groups in an IODF
Change to another IODF
Change a production IODF / Create a work IODF based on a production IODF
View active IODF
Backup work or production IODFs
Maintain IODFs
Delete an IODF
Copy an IODF
Change IODF attributes
View an IODF
Export an IODF
User authentication for unattended mode
Import an IODF
Upgrade an IODF
Work with configuration packages
Define a configuration package
Edit a configuration package
Delete a configuration package
Work with configuration package objects
Add a configuration package object
Merging changes into a master work IODF
Delete configuration package objects
Transmit a configuration package
Activity logging and change logging
Rules for automatic activity logging
Actions performed on IODFs and related activity and change log files
IODF release level compatibility
How to use the dialog
Window layout
Working with lists
Numbered selection lists
Unnumbered single selection lists
Unnumbered multiple selection lists
Action lists
Using the context menu
Using the action code
Action codes and selection markers
Typing over existing data
Message lists
Promptable fields
Commands and function keys
Getting help
Navigating through the dialog
Moving forward and backward within a task
Fast path
Using the action bar choice
Using the GOTO command
Examples
Filtering
Job statement information used in panels
How to define, modify, or view a configuration
Creating new objects
Add
Add like
Repeat (copy)
Navigating through HCD
Centralized navigation
Hierarchical navigation
Graphical navigation
Navigation map
Control Unit list and Device list
Suggested sequence to define a configuration
Working with operating system configurations
Defining operating system configurations
D/R site OS configurations
Changing operating system configurations
Changing the operating system configuration ID
Repeating (copying) operating system configurations
Deleting operating system configurations
Working with EDTs
Defining EDTs
Changing EDTs
Changing the EDT ID
Repeating (copying) EDTs
Deleting EDTs
Working with generics
Working with esoteric groups
Defining esoteric groups
Assigning devices to esoterics
Changing esoteric groups
Adding devices to esoterics
While defining devices
While modifying esoterics
Repeating (copying) esoteric groups
Deleting esoteric groups
Working with processors
Defining processors
Changing processors
Changing the processor ID
Repeating (copying) processors
Copying an SMP processor to an XMP channel subsystem
Priming processor data
Deleting processors
Working with channel subsystems
Defining channel subsystems
Repeating (copying) channel subsystems
Copying/repeating channel subsystems with CTC connections
Copying a channel subsystem to an SMP processor
Changing channel subsystems
Changing the channel subsystem ID
Deleting channel subsystems
Working with partitions
Defining partitions
Defining reserved partitions
Changing partitions
Repeating (copying) partitions
Transferring partition configurations
Explicit device candidate lists
CF channel paths
Deleting partitions
Working with PCIe functions
Defining PCIe functions
Changing PCIe functions
Deleting PCIe functions
Working with channel paths
Using Multiple Image Facility
More about spanned channel paths in multiple LCSSs
Defining channel paths
Defining special channel path characteristics
Defining managed channel paths
Defining multiple channel paths in one step
Connecting a channel path to a switch
Defining IQD channel parameters
Defining more than 160 TCP/IP stacks
Defining an OSD channel path to physical networks
Defining or editing a CIB channel
Defining spanned channel paths
Over-defining a CHPID
Establishing coupling facility channel path connections
Defining Server Time Protocol (STP) links
Disconnecting coupling facility channel path connections
Changing channel paths
Changing the ID of a channel path
Changing the type of a channel path
Changing the type of a coupling facility channel path
Changing the operation mode of a channel path
Changing the operation mode of a channel path to SPAN
Changing the operation mode of CF channel paths
Changing a coupling facility connection
Aggregating channel paths
Deleting channel paths
Working with control units
Defining control units
Defining the control unit characteristics
Defining switch connections
Defining processor attachment data
Upgrading to two-byte link addresses
Changing control units
Changing control unit attachment parameters for multiple processors
Disconnecting control units from a processor
Priming control unit data
Deleting control units
Working with devices
Defining devices
Defining device data
Defining multiple devices in one step
Use and definition of serial number of device
Defining CSS-related definitions for a device
Defining the subchannel set for a device
Restricting Partition Access for Devices
Null device candidate list for XMP processors
Defining OS-related definitions for a device
Changing devices
Changing CSS-related definitions of a group of devices
Changing esoterics for a group of devices
Changing OS-related definitions of a group of devices
Changing the DYNAMIC, LOCANY or OFFLINE parameter of a group of devices
Changing type/model of a group of devices
Changing the subchannel set placement for a group of devices
Changing the device number
Disconnecting devices from an operating system
Showing or hiding parameter/feature definitions of devices
Priming device data
Deleting devices
Working with operating system consoles
Changing operating system consoles
Deleting operating system consoles
Working on IODFs enabled for multi-user access
Simultaneously updating and viewing an IODF
Concurrently updating an IODF
Immediately reflecting changes during concurrent updates
Viewing information
Viewing object definitions
Viewing full definition of an object
Viewing additional object lists
Graphical view
Viewing logical control units
Viewing coupling facility information
Viewing CTC connections
ESCON channel-to-channel support
FICON channel-to-channel support
Restrictions applying to the CTC Connection List
CTC connections with shared channels
How to view CTC connections
Incomplete CTC definitions
Displaying more detailed information
Filtering CTC definitions
Printing CTC connection lists
Displaying diagnostic messages
How to work with switches
Possibilities of switch connections
Advantages of switch definitions with HCD
Defining switches
Working with switches
Defining switch characteristics
Changing switch data
Priming switch data
Moving ports
Deleting switches
Working with connections to switches
Defining connections to switches
Connecting a channel path
Connecting a control unit
Connecting another switch
Priming switch port data
Additional actions on the port list
Changing ports to installed or uninstalled
Changing ports to occupied or not occupied
Establishing dedicated connections and blocking ports
Working with switch configurations
Defining switch configuration data
Establishing dedicated connections
Blocking ports
Dynamic connection ports
Changing the switch configuration ID
Generating a switch matrix
Deleting switch configurations
Migrating existing switch configurations
Prerequisites
Migration steps
Changing port names
Changing hardware status of a port
Activating switch configuration data
Prerequisites
Activation steps
Single switch activation
Multiple switch activation
Saving switch configuration data
How to work with I/O Autoconfiguration
How to define autoconfiguration policies
How to set keywords for autoconfiguration policies
Exclude CHPIDs from the discovery
Include CHPIDs for the discovery
Control unit number should match base device number
Alternate subchannel set for proposed alias devices
Subchannel set device numbering scheme
Control unit number range for auto proposal
Device number range for auto proposal
Number of static CHPIDs to be assigned
Maximum number of dynamic CHPIDs
LP group for autoconfiguration
OS group for autoconfiguration
Exclude switch addresses from the discovery
Include switch addresses for the discovery
How to change autoconfiguration policies during the autoconfiguration process
How to define logical partition groups for autoconfiguration
How to define OS groups for autoconfiguration
How to perform automatic I/O configuration
How to apply updates to the autoconfiguration proposals
How to work in unattended mode
Prerequisites and operational considerations for using I/O Autoconfiguration
How to activate or process configuration data
Build a production IODF
Build an IOCDS
Build System z cluster IOCDSs
Manage System z cluster IPL attributes
Build an IOCP input data set
How to build an IOCP data set
IOCP enhancements
IOCP input data sets using extended migration
Prerequisites to exploit the extended migration
Example of an IOCP input data set
Using the IOCP data set as input for the CHPID Mapping Tool
How to interact with the CHPID Mapping Tool
Process overview
How to insert or update PCHIDs
Create JES3 initialization stream checker data
Build I/O configuration data
Verify an I/O configuration
Verifying a configuration against the local system
Verifying a configuration against a system in the sysplex
The I/O path list
Activate a configuration dynamically
View active configuration
How to activate if hardware and software changes are allowed
Configure channel path online to the partition
If dynamic activation fails
Detection of illegal split/merge of LCU
How to activate if software-only changes are allowed
If dynamic activation fails
Activate a configuration sysplex-wide
Displaying active sysplex members
Activate software configuration changes only
If dynamic activation fails
Activate software and hardware configuration changes
If Dynamic Activation Fails
Switch IOCDS for the next POR
Activate a configuration HMC-wide
Available configuration activation actions
How HCD processes Activate actions
How HCD processes system commands
Establishing connectivity to remote systems
Prerequisites for working with CPC images
Build a CONFIGxx member
Process the Display M=CONFIG(xx) command
Switch IOCDS for next POR
Switch IOCDS for processor without SNA address
Switch IOCDS for processors in a System z cluster with SNA address defined
Switch IOCDS for systems in a sysplex
Specify an IODF for IPL
IODF processing at IPL
How to print and compare configuration data
Print configuration reports
Channel Subsystem Report
Switch Report
Operating System Report
CTC Connection Report
I/O Path Report
Supported Hardware Report
I/O Definition Reference
How to print a textual report
Create or view graphical configuration reports
Prerequisites
For printing
For viewing
How to create a graphical configuration report
Using the 'Create or View Graphical Configuration Report' option
Printing the output
Viewing the output
Save command
Locate Command
Locating multiple objects with the same ID
Example
Refresh Command
How to print list panels
HCD compare functions
Compare IODFs
How to print a Compare IODFs Report
Compare CSS / operating system views
View and print the HCD activity log
How to query supported hardware and installed UIMs
Query supported processors
Query supported switches
Query supported control units
Query supported devices
Query installed UIMs
How to migrate existing input data sets
Migration sequence
LPAR considerations
Preparing your input data sets for migration
Data requiring attention
Control unit types
Control unit models
Protocol support for control units
Device types
For IOCP input data sets
For MVSCP input data sets
For HCPRIO input data sets
Esoteric token
Assembler statements
Preparing additional input data sets for migration
Migrating additional IOCP input data sets
The same control unit number is already defined in the IODF
The same control unit number is not yet defined in the IODF
Migrating additional MVSCP or HCPRIO input data sets
Migrating input data sets using the HCD dialog
Step 1: Specify the work IODF
Step 2: Migrate the input data sets
Step 3: Analyze errors and correct the input data
Step 4: Update configuration data
Migrating input data sets using the batch utility
Step 1: Create the work IODF
Step 2: Migrate input data set
Step 3: Analyze errors and correct the input data
Step 4: Build production IODF
Changing I/O configurations by editing data sets
Additional parameters and statements
Operating system
Example
NIP consoles
Example
EDT
Example
Esoteric
Example
Generic
Example
Switch
Example
Port
Example
Switch configuration
Example
Port configuration
Example
Processor
Example
Channel subsystem and partition
Example
PCIe function
Example
Channel path
Examples for a XMP processors
Control unit
Example for an XMP processor
Device
OS parameters/features
Example for an XMP processor
Updating parts of a configuration by migrating input data sets
Possible actions on objects using the incremental update
How to invoke the incremental update
Example 1: Adding a partition
Example 2: Replacing a channel path and attached control unit
Example 3: Replacing a channel path with a new control unit
Example 4: Replacing a control unit that attaches to two processors
Example 5: Updating an operating system
Resolving migration errors
Errors detected during assembly process
Example 1
Example 2
Example 3
Errors detected during validation process
Example 1
Example 2
Example 3
Insufficient data set sizes
How to invoke HCD batch utility functions
Input parameter string
Start the dialog
Initialize IODF
Batch invocation
Upgrade IODF
Batch invocation
Migrate I/O configuration statements
Batch invocation
Build a Production IODF
Batch invocation
Build a work IODF from a production IODF
Batch invocation
Build an IOCDS or an IOCP input data set
Batch invocation
Activate a production IODF
Batch invocation
Build an HCPRIO input data set
Batch invocation
Build I/O configuration data
Batch invocation
Copy IODF
Batch invocation
Print configuration reports
Batch invocation
Create a graphical configuration report
Batch invocation
Compare IODFs or CSS/OS Reports
Batch invocation
Import an IODF
Batch invocation
Export an IODF
Batch invocation
Batch IODF copy example
List of standard DD names
List of alternate DD names
Security and other considerations
Security-related considerations
Defining RACF profiles
Giving users access authority
Access to data set profiles
Access to profile MVS.ACTIVATE
Access to profile CBD.CPC.IPLPARM
Access to profile CBD.CPC.IOCDS
Access to HWI.* profiles
How to set up PassTickets for working with CPC images on z/OS
How to set up PassTickets for working with CPC images on z/VM
Providing additional security for devices
Catalog considerations
Data sets cataloged with an esoteric device group name
SMS-related considerations
ISPF-related considerations
z/VM-related considerations
How to provide LDAP support for HCD
Introduction to LDAP
HCD LDAP backend: Structure and mode of operation
Plugging the HCD LDAP backend into the IBM Tivoli Directory Server for z/OS
Performing the setup
Setting up the IBM Tivoli Directory Server for z/OS
Setting up the HCD LDAP backend
Integrating the LDAP schema for HCD
Customizing the HCD LDAP backend
Configuration file parameters
LDAP debug level
Message translation
Accessing IODF information
The IODF directory information tree
Performing LDAP requests on IODFs
Operational behavior
Restrictions for search and update requests
Search
Add
Delete
Modify
Transactions
Prerequisites and method of functioning
How to initiate, extend and close a transaction
Appendix A. How to navigate through the dialog
Appendix B. Configuration reports
Textual configuration reports
Channel subsystem reports
Processor Summary Report
Channel Subsystem Summary Report
PCIE Function Summary Report
PCHID Summary Report
Partition Report
IOCDS Report
Channel Path Summary Report
Channel Path Detail Report
CF Channel Path Connectivity Report
Control Unit Summary Report
Control Unit Detail Report
Device Summary Report
Device Detail Report
Switch reports
Switch Summary Report
Switch Detail Report
Switch Configuration Summary Report
Switch Configuration Detail Report
Operating System reports
Operating System Summary Report
MVS Device Report
MVS Device Detail Report
Eligible Device Table Report
NIP Console Report
VM Device Report
VM Device Detail Report
VM Console Report
CTC Connection Report
Diagnostic messages
I/O Path Report
Supported Hardware Report
I/O Definition Reference
Graphical configuration reports
LCU Report
IODF compare reports
Processor Compare Report
Channel Subsystem Compare Report
PCIe Function Compare Report
Partition Compare Report
Channel Path Compare Report
Control Unit Attachment Compare Report
Device Attachment Compare Report
Control Unit Compare Report
Device Compare Report
Switch Compare Report
Switch Detail Compare Report
Switch Configuration Compare Report
Switch Configuration Detail Compare Report
Esoteric Compare Report
Operating System Compare Report
OS Device Compare Report
OS Console Compare Report
CSS / OS Device Compare Report
Appendix C. Problem determination for HCD
Identifying problems
HCD abnormal termination
Diagnosing system abend code '00F'
ISPF list file and abend panel
Diagnosing system abend other than '00F'
Error during IPL (Wait State Codes)
Problems with panels and function key assignment
Problems with help information provided by HCD
Problem with content, wording, mismatch
Problem shown by help messages CBDA400I or CBDA405I
Problem shown by help messages other than CBDA400I and CBDA405I
Problems with output of HCD textual reports
Problems with output of HCD graphical reports
Screen shows four dots
Incorrect DCF, GDF, or GML format in output data set
Illegible printout when using DCF or GML
Output exceeds page boundary
Box characters are not correct
Problems during initialization of HCD
Initialization continues
Initialization is terminated
Message CBDA041I
Problems with UIMs
Messages during initialization of HCD
UIM problems after initialization of HCD
HCD internal problems
Problems with the Transmit Configuration Package action
Job steps of the Transmit Procedure
Temporary data sets created by the Transmit Procedure
Authorization problems
Job is not submitted
Job is not completed
Customization unsuccessful
LDAP problem determination
HCD LDAP backend abnormal termination
IBM Tivoli Directory Server for z/OS address space
HCD instance address space
Adverse LDAP return code from the HCD LDAP Backend
Error in the HCD LDAP backend
HCD Instance Startup Fails
HCD instance user ID switch fails
Diagnostic information and tools
HCD messages
Terminal messages
Message log
Migration log
LDAP response messages
IBM Tivoli Directory Server for z/OS started task log
HCD trace facility
Data Set
Trace records
E S T A E
Activating the trace
TRACE command
Trace command via HCD profile
IODF dump
Repair an IODF
MVS dumps and traces
IPCS reports
Searching problem reporting data bases and reporting problems
Sending an IODF to a different location
Appendix D. HCD object management services
How to invoke the HOM services
Data input and output areas
Request block (HRB)
Functions
Example
Return codes
Reason codes
Appendix E. Establishing the host communication
Setting up TCP/IP definitions for z/OS
Controlling access to HCD services
Skeleton used to start the HCD agent
Starting the HCD dispatcher as a started task
Creating a user ID
Starting the HCD dispatcher as a batch job
Stopping the HCD dispatcher
Define an HCD profile
Allocate the HCD trace data set for remote HCD sessions
Verifying TCP/IP host communication
TCP/IP problem determination
Appendix F. IODF data model
IODF object class definitions within LDAP
IODF attribute table
Appendix G. Accessibility
Using assistive technologies
Keyboard navigation of the user interface
Appendix H. Dotted decimal syntax diagrams
Trademarks
Programming interface information
Index for the HCD User’s Guide
Copyright IBM Corporation 1990, 2014