I’m running ADCD z/OS on zD&T, and wanted to see what was in my HCD (Hardware Configuration Definition). There are some ISPF panels, which allow you to print things, but they had some “required” parameters which I didn’t have and didn’t need.
This post shows the JCL I used, and gives a quick overview of the output
The JCL to create a batch report. This uses program CBDMGHCP. This parameters are described here. Note you can have the output created in XML format.
//IBMHCD JOB MSGCLASS=H
//GCREP EXEC PGM=CBDMGHCP,
// PARM='REPORT,CSMEN,,,,,00'
//HCDIODFS DD DSN=SYS1.IODF99,DISP=SHR
//HCDRPT DD SYSOUT=,
// DCB=(RECFM=FBA,LRECL=200,BLKSIZE=6400)
//HCDMLOG DD SYSOUT=,
// DCB=(RECFM=FBA,LRECL=200,BLKSIZE=6400)
The output data sets require the DCB information. If this is not provided you get messages like
IEC141I 013-34,IGG0199G,IBMHCD,GCREP,HCDRPT.
The output of the report in HCDRPT
At the top is
TIME: 16:46 DATE: 2021-07-12
IODF NAME: SYS1.IODF99
IODF TYPE: Production
IODF VERSION: 5
IODF VOLUME: A4SYS1
DESCRIPTION: m3000 with SCSI 08-0B only
It lists the sections
PROCESSOR SUMMARY REPORT A PARTITION REPORT B IOCDS REPORT C CHANNEL PATH SUMMARY REPORT D CONTROL UNIT SUMMARY REPORT G DEVICE SUMMARY REPORT I SWITCH SUMMARY REPORT K SWITCH DETAIL REPORT L SWITCH CONFIGURATION SUMMARY REPORT M SWITCH CONFIGURATION DETAIL REPORT N OPERATING SYSTEM SUMMARY REPORT O OS DEVICE REPORT P OS DEVICE DETAIL REPORT Q EDT REPORT (MVS ONLY) R OS CONSOLE REPORT S
Component reports heading
Following the list of sections are the data. Each section has a header like
CONTROL UNIT SUMMARY REPORT TIME:... DATE:... PAGE G- 1
Where the title (CONTROL UNIT SUMMARY REPORT) and the character following the PAGE match the list of sections, which has “CONTROL UNIT SUMMARY REPORT G”.
To go to a section use Find ‘PAGE G’ .
CONTROL UNIT SUMMARY REPORT
CONTROL UNIT NUMBER TYPE-MODEL _____________________ - - - - - - - - 0700 3174 - - - - - - - - 0A80 3990 0A81 3990 0A82 3990 0A83 3990
Where 0700 is a console, and 0a80 is disk on an emulated 3990.
DEVICE SUMMARY REPORT
--- DEVICE --- DEVICE NUMBER,RANGE TYPE-MODEL ATTACHING CONTROL UNITS ______________ _____________ |____|___ 0700 3270-X 0700 0A80 3390 0A80
OPERATING SYSTEM SUMMARY REPORT
OPERATING SYSTEM ID TYPE GEN DESCRIPTION _________ ________ ___ _______________ OS390 MVS ADCD ZOS IODF
MVS DEVICE REPORT
DEV#,RANGE TYPE-MODEL ... __________ __________ ... 0700,64 3270-X.... 0A80,112 3390 ....
Followed by columns of data with headings ( given in the report)
KEY KEY DESCRIPTION --- --------------- DEV#,RANGE - DEVICE NUMBER, COUNT OF DEVICES (DECIMAL) TYPE-MODEL - DEVICE TYPE AND MODEL SS - SUBCHANNEL SET ID BASE - BASE DEVICE NUMBER FOR MULTIPLE EXPOSURE DEVICES UCB-TYPE - UCB TYPE BYTES ERP-NAME - ERROR RECOVERY PROGRAM DDT-NAME - DEVICE DESCRIPTOR TABLE MLT-NAME - MODULE LIST TABLE OPT - OPTIONAL MLT INDICATOR UIM-NAME - UNIT INFORMATION MODULE SUPPORTING THE DEVICE ATI - ATTENTION TABLE INDEX (UCBATI) AL - ALTERNATE CONTROL UNIT (UCBALTCU) SH - SHARED UP OPTION (UCBSHRUP) SW - DEVICE CAN BE SWAPPED BY DDR (UCBSWAPF) MX - DEVICE HAS MULTIPLE EXPOSURES (UCBMTPXP) MI - MIH PROCESSING SHOULD BE BYPASSED (UCBMIHPB) O - MLT IS OPTIONAL Y - DEVICE SUPPORTS THIS FEATURE BLANK - DEVICE DOES NOT SUPPORT THIS FEATURE
The UIM is a an object with parameters defined for the device type. They are defined here. The options are defined here. For example a 3270 can have a selector pen!. a 3800 printer can have a burster.
There is a summary of devices.
TOTAL NUMBER OF DEVICES BY CLASS -------------------------------- CLASS NAME CLASS TYPE DEVICE COUNT ---------- ---------- ------------ TAPE 80 64 COMMUNICATION DEVICES 40 0 C-T-C 41 24 DASD 20 1001 GRAPHICS 10 95 UNIT RECORD 08 3 CHARACTER READERS 04 0 TOTAL NUMBER OF I/O DEVICES DEFINED BY THIS I/O CONFIGURATION 1187
MVS DEVICE DETAIL REPORT
NUMBER,RANGE TYPE SS PARAMETER FEATURE ____________ ______ __ _______________________________ _______ 0700,64 3270-X 0 OFFLINE=NO SELPEN,... 0A80,112 3390 0 OFFLINE=NO,DYNAMIC=YES,LOCANY=NO SHARED
E D T REPORT
The Eligible Device Table Report has
AFFINITY ALLOCATION NAME TYPE VIO TOKEN PREF INDEX DEVICE TYPE DEVICE NUMBER LIST _________ ___ _____ ______ ________ ___________ ___________________ GENERIC 280 FFFF 3010200F ... 0A80- 0AFF ... GENERIC 3800 FFFF 12001009 0700- 073F
N I P Console REPORT
The Nucleus IP l Console Report has
DEVICE # TYPE-MODEL ________ _____________ 0700 3270-X 0701 3270-X