Version 2 Release 3 z/OS · z/OS Version 2 Release 3 IBM Health Checker for z/OS User's Guide IBM...

z/OSVersion 2 Release 3

IBM Health Checker for z/OSUser's Guide

IBM

SC23-6843-30

Note

Before using this information and the product it supports, read the information in “Notices” on page681.

This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.

Last updated: 2019-06-24© Copyright International Business Machines Corporation 2006, 2019.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

Figures................................................................................................................ xv

Tables................................................................................................................xvii

About this information........................................................................................ xxiWho should use this document.................................................................................................................xxi

How to send your comments to IBM................................................................... xxiiiIf you have a technical problem.............................................................................................................. xxiii

Summary of changes.......................................................................................... xxvSummary of changes for z/OS V2R3........................................................................................................ xxvSummary of changes for z/OS V2R2 as updated September 2016....................................................... xxviSummary of changes for z/OS V2R2....................................................................................................... xxviSummary of changes for z/OS V2R2 as updated March 2016.............................................................. xxviiSummary of changes for z/OS V2R2...................................................................................................... xxviiSummary of changes for z/OS V2R1 as updated September 2014....................................................... xxixSummary of changes for z/OS V2R1 as updated March 2014............................................................... xxixSummary of changes for z/OS V2R1 ....................................................................................................... xxx

Exploitation of the Flash Express feature..........................................................................................xxxi

Part 1. Using IBM Health Checker for z/OS.............................................................1

Chapter 1. Introduction............................................................................................................................... 3What is a check?..................................................................................................................................... 4For more information, see our IBM Redpaper publication....................................................................5Background for IBM's checks.................................................................................................................5

Chapter 2. Setting up IBM Health Checker for z/OS................................................................................... 7Stopping and starting IBM Health Checker for z/OS manually............................................................. 7Sharing critical IBM Health Checker for z/OS information between systems at different levels.........7

Sharing IEASYSxx..............................................................................................................................8Sharing the HZSPROC procedure..................................................................................................... 8Sharing HZSPRMxx............................................................................................................................8

Steps for optimizing IBM Health Checker for z/OS................................................................................8In a rush? Use these basic steps...................................................................................................... 9

Software requirements...........................................................................................................................9Software requirement for running REXX checks..............................................................................9

Customizing the IBM Health Checker for z/OS procedure ................................................................. 10Allocate the HZSPDATA data set to save check data between restarts............................................. 10

Monitoring and sizing the HZSPDATA data set...............................................................................11Optionally set up the HZSPRINT utility............................................................................................... 11Optionally define log streams to keep a record of the check output..................................................11Create security definitions................................................................................................................... 13

Setting up security for the IBM Health Checker for z/OS started task..........................................14Setting up security for the HZSPRINT utility..................................................................................16Setting up security for IBM Health Checker for SDSF support......................................................19

Create multilevel security definitions.................................................................................................. 19Create HZSPRMxx parmlib members.................................................................................................. 20

iii

Tell the system which HZSPRMxx members you want to use....................................................... 20Assign IBM Health Checker for z/OS to a WLM service class..............................................................22Obtain checks for IBM Health Checker for z/OS..................................................................................22

Chapter 3. Working with check output ..................................................................................................... 23Hey! My system has been configured like this for years, and now I'm receiving exceptions!........... 24Understanding system data issued with the check messages........................................................... 25Understanding exception messages....................................................................................................26Evaluating check output and resolving exceptions............................................................................. 27Customizing check exceptions with dynamically varying severity..................................................... 28Approaches to automation with IBM Health Checker for z/OS...........................................................29

More automation ideas................................................................................................................... 29Using HZS exception messages for automation............................................................................ 30

Understanding check state and status................................................................................................ 31User controlled states.....................................................................................................................32IBM Health Checker for z/OS controlled states............................................................................. 32Understanding check state combinations: ACTIVE(DISABLED) and INACTIVE(ENABLED)........ 33Check status....................................................................................................................................34

Using the HZSPRINT utility.................................................................................................................. 34Example of HZSPRINT output........................................................................................................ 36HZSPRINT utility completion codes...............................................................................................36

Chapter 4. Managing checks......................................................................................................................39Making dynamic, temporary changes to checks .................................................................................40

Using SDSF to manage checks....................................................................................................... 41Managing checks with the MODIFY hzsproc command.................................................................42

Making persistent changes to checks..................................................................................................48Using WHEN to apply statements conditionally............................................................................ 48

Creating and maintaining IBM Health Checker for z/OS policies........................................................50How IBM Health Checker for z/OS builds policies from policy statements.................................. 52

Can I create policy statements using the MODIFY command?.......................................................... 56Can I put non-policy statements in my HZSPRMxx member?............................................................ 56Using SYNCVAL in a policy to specify the time of day that a check runs............................................ 57

Examples: Making SYNCVAL work for you..................................................................................... 57Fine points of how SYNCVAL works................................................................................................58SYNCVAL restrictions......................................................................................................................59

Policy statement examples..................................................................................................................59Specifying the HZSPRMxx members you want the system to use......................................................60Using HZSPRMxx and MODIFY hzsproc command............................................................................. 62

Guidelines for HZSPRMxx parmlib members.................................................................................63Syntax and parameters for HZSPRMxx and MODIFY hzsproc.......................................................65Examples of DISPLAY output......................................................................................................... 86

Part 2. Developing checks for IBM Health Checker for z/OS...................................89

Chapter 5. Planning checks....................................................................................................................... 91Identifying potential checks................................................................................................................ 92The life-cycle of a check - check terminology..................................................................................... 92What kind of check do you want to write?........................................................................................... 93

Local checks....................................................................................................................................93Remote checks................................................................................................................................94Writing local and remote checks in Metal C................................................................................... 95REXX checks................................................................................................................................... 95Summary of checks—differences and similarities......................................................................... 96

Issuing messages for your check - message table checks versus DIRECTMSG checks....................98Where to next? A road map for developing your check.......................................................................98

iv

Chapter 6. Writing local check routines.................................................................................................. 101Metal C or assembler?........................................................................................................................101Sample local checks...........................................................................................................................102Local check routine basics.................................................................................................................102Defining a local check to IBM Health Checker for z/OS.................................................................... 104Programming considerations.............................................................................................................104

Environment..................................................................................................................................104Requirements............................................................................................................................... 105Restrictions................................................................................................................................... 105Gotchas......................................................................................................................................... 105Input Registers............................................................................................................................. 105Output Registers...........................................................................................................................105Establishing a recovery routine for a check................................................................................. 106Assembler reentrant entry and exit linkage.................................................................................106

Supporting check parameters for local checks.................................................................................106Using the check parameter parsing service (HZSCPARS) for local checks...................................... 107Using the HZSPQE data area in your local check routine................................................................. 107Function codes for local check routines............................................................................................109Creating and using data saved between restarts..............................................................................111Using ENF event code 67 to listen for check status changes........................................................... 112Issuing messages in your local check routine with the HZSFMSG macro........................................112

Reporting check exceptions......................................................................................................... 113Defining the variables for your messages......................................................................................... 115

Using default HZSMGB data area format (MGBFORMAT=0)....................................................... 116Using HZSMGB data area format MGBFORMAT=1...................................................................... 118

Writing a check with dynamic severity levels....................................................................................119Controlling check exception message WTOs and their automation consequences........................ 120The well-behaved local check routine - recommendations and recovery considerations.............. 121Building Metal C checks..................................................................................................................... 124Debugging checks.............................................................................................................................. 126

Chapter 7. Writing remote check routines.............................................................................................. 129Metal C or assembler?........................................................................................................................129Sample checks................................................................................................................................... 130Remote check routine basics.............................................................................................................130Programming considerations.............................................................................................................132

Environment..................................................................................................................................132Requirements............................................................................................................................... 132Restrictions................................................................................................................................... 132Establishing a recovery routine for a check................................................................................. 132

Preparing for check definition - making sure IBM Health Checker for z/OS is up and running....... 132Using ENF event code 67 to listen for IBM Health Checker for z/OS availability....................... 132

Allocate a pause element token using IEAVAPE............................................................................... 133Issue the HZSADDCK macro to define a remote check to IBM Health Checker for z/OS................ 134

Example of an HZSADDCK macro call for a remote check.......................................................... 135Pause the remote check routine with IEAVPSE................................................................................ 136Using HZSCHECK REQUEST=OPSTART and REQUEST=OPCOMPLETE to communicate check

start and stop to IBM Health Checker for z/OS............................................................................ 136Supporting check parameters for remote checks.............................................................................136Using the check parameter parsing service (HZSCPARS) for remote checks.................................. 137Using the HZSPQE data area in your remote check routine............................................................. 137Release codes for remote check routines......................................................................................... 138Ending a check that is coupled with an application.......................................................................... 140Creating and using data saved between restarts..............................................................................141Issuing messages in your remote check routine with the HZSFMSG macro....................................142

Reporting check exceptions......................................................................................................... 144Defining the variables for your messages......................................................................................... 145

v

Using default HZSMGB data area format (MGBFORMAT=0)....................................................... 146Using HZSMGB data area format MGBFORMAT=1...................................................................... 148

Writing a check with dynamic severity levels....................................................................................149Controlling check exception message WTOs and their automation consequences........................ 150Recommendations and recovery considerations for remote checks............................................... 151Building Metal C checks..................................................................................................................... 153Debugging checks.............................................................................................................................. 155

Chapter 8. Writing REXX checks..............................................................................................................157Sample REXX checks......................................................................................................................... 157REXX check basics............................................................................................................................. 157Using input data sets in a TSO-environment REXX check................................................................ 161Supporting check parameters for REXX checks................................................................................161Using REXXIN data sets..................................................................................................................... 162

REXXIN data set naming conventions......................................................................................... 162Using REXXOUT data sets..................................................................................................................162

REXXOUT data set naming conventions...................................................................................... 163Examples: Capturing error data in REXXOUT.............................................................................. 163

Defining a REXX check to IBM Health Checker for z/OS................................................................... 165Creating and using data saved between restarts in a REXX check...................................................166Using ENF event code 67 to listen for check status changes........................................................... 167Issuing messages from your REXX check with the HZSLFMSG function......................................... 168

Reporting check exceptions......................................................................................................... 170Writing a check with dynamic severity levels....................................................................................171Controlling check exception message WTOs and their automation consequences........................ 173The well-behaved REXX check - recommendations and recovery considerations..........................174Debugging REXX checks.................................................................................................................... 175

Chapter 9. Writing an HZSADDCHECK exit routine.................................................................................177Programming considerations for the HZSADDCHECK exit routine...................................................179

Environment..................................................................................................................................179Input Registers............................................................................................................................. 179Output Registers...........................................................................................................................180

Defining multiple local or REXX checks in a single HZSADDCHECK exit routine............................. 180Dynamically adding local or REXX exec checks to IBM Health Checker for z/OS............................ 181

Using operator commands to add checks to the system dynamically........................................181Using a routine to add checks to the system dynamically.......................................................... 182

Debugging HZSADDCHECK exit routine abends............................................................................... 182Creating product code that automatically registers checks at initialization.................................... 182Creating product code that deletes checks as it goes down............................................................ 183

Chapter 10. Creating the message input for your check ....................................................................... 185How messages and message variables are issued at check runtime...............................................186Planning your check messages..........................................................................................................187

Planning your exception messages..............................................................................................188Planning your information messages...........................................................................................188Planning your report messages....................................................................................................189Planning your debug messages....................................................................................................189Decide what release your check will run on................................................................................ 189Decide whether to translate your check exception messages into other national languages... 189Rely on IBM Health Checker for z/OS to issue basic check information for you........................ 190

Creating the message table............................................................................................................... 190Examples of message input......................................................................................................... 191

Syntax of message input....................................................................................................................198Message input tags.......................................................................................................................198Special formatting tags for the message table............................................................................ 206How messages are formatted in the message buffer..................................................................208Using symbols in the message table............................................................................................209

vi

Generating the compilable assembler CSECT for the message table.............................................. 213Support for translating messages to other languages...................................................................... 214

Guidelines for coding translatable exception message text lines...............................................215

Chapter 11. IBM Health Checker for z/OS System REXX Functions...................................................... 217HZSLFMSG function........................................................................................................................... 218

HZSLFMSG input variables........................................................................................................... 218HZSLFMSG output variables.........................................................................................................230HZSLFMSG return codes.............................................................................................................. 234

HZSLPDRD function........................................................................................................................... 234HZSLPDRD input variables........................................................................................................... 235HZSLPDRD output variables.........................................................................................................236HZSLPDRD abend codes.............................................................................................................. 237HZSLPDRD return codes...............................................................................................................237

HZSLPDWR function...........................................................................................................................238HZSLPDWR input variables.......................................................................................................... 238HZSLPDWR output variables........................................................................................................ 239HZSLPDWR abend codes..............................................................................................................239HZSLPDWR return codes..............................................................................................................240

HZSLSTOP function............................................................................................................................ 241HZSLSTOP input variables............................................................................................................241HZSLSTOP output variables......................................................................................................... 241HZSLSTOP return codes............................................................................................................... 242

HZSLSTRT function............................................................................................................................ 244HZSLSTRT input variables............................................................................................................ 244HZSLSTRS output variables..........................................................................................................244HZSLSTRT return codes................................................................................................................247

Chapter 12. IBM Health Checker for z/OS HZS macros......................................................................... 249HZSADDCK macro — HZS add a check.............................................................................................. 250

Description....................................................................................................................................250HZSCHECK macro — HZS Check command request......................................................................... 268

Description....................................................................................................................................268HZSCPARS macro — HZS Check Parameter Parsing......................................................................... 282

Description....................................................................................................................................282HZSFMSG macro — Issue a formatted check message.................................................................... 294

Description....................................................................................................................................294HZSPREAD macro — Read Check Persistent Data............................................................................ 325

Description....................................................................................................................................325HZSPWRIT macro — Write Check Persistent Data............................................................................ 336

Description....................................................................................................................................336HZSQUERY macro — HZS Query........................................................................................................ 344

Description....................................................................................................................................344

Part 3. Check Descriptions................................................................................. 365

Chapter 13. IBM Health Checker for z/OS checks..................................................................................367Where are the migration checks?...................................................................................................... 367Allocation checks (IBMALLOC).......................................................................................................... 367

ALLOC_ALLC_OFFLN_POLICY...................................................................................................... 367ALLOC_SPEC_WAIT_POLICY........................................................................................................369ALLOC_TAPELIB_PREF................................................................................................................. 370ALLOC_TIOT_SIZE........................................................................................................................ 371

ASM checks (IBMASM).......................................................................................................................373ASM_LOCAL_SLOT_USAGE.......................................................................................................... 373ASM_NUMBER_LOCAL_DATASETS..............................................................................................374ASM_PAGE_ADD...........................................................................................................................375

vii

ASM_PLPA_COMMON_SIZE.........................................................................................................376ASM_PLPA_COMMON_USAGE..................................................................................................... 377

Catalog checks (IBMCATALOG)..........................................................................................................379CATALOG_ATTRIBUTE_CHECK ................................................................................................... 379CATALOG_IMBED_REPLICATE..................................................................................................... 379CATALOG_RNLS............................................................................................................................ 381

CICS Transaction Server checks (IBMCICS)......................................................................................382Communications Server checks (IBMCS)..........................................................................................382

CSAPP_FTPD_ANONYMOUS_JES.................................................................................................382CSAPP_MVRSHD_RHOSTS_DATA.................................................................................................383CSAPP_SMTPD_MAIL_RELAY.......................................................................................................384CSAPP_SNMPAGENT_PUBLIC_COMMUNITY...............................................................................384CSRES_AUTOQ_GLOBALTCPIPDATA ........................................................................................... 385CSRES_AUTOQ_RESOLVEVIA...................................................................................................... 386CSRES_AUTOQ_TIMEOUT............................................................................................................ 387CSTCP_CINET_PORTRNG_RSV_tcpipstackname.........................................................................388CSTCP_IPMAXRT4_tcpipstackname............................................................................................ 389CSTCP_IPMAXRT6_tcpipstackname............................................................................................ 390CSTCP_IWQ_IPSEC_tcpipstackname...........................................................................................391CSTCP_SYSTCPIP_CTRACE_tcpipstackname...............................................................................392CSTCP_SYSPLEXMON_RECOV_tcpipstackname..........................................................................393CSTCP_TCPMAXRCVBUFRSIZE_tcpipstackname........................................................................ 394CSVTAM_CSM_STG_LIMIT........................................................................................................... 395CSVTAM_T1BUF_T2BUF_EE......................................................................................................... 396CSVTAM_T1BUF_T2BUF_NOEE.................................................................................................... 397CSVTAM_VIT_OPT_ALL.................................................................................................................398CSVTAM_VIT_OPT_STDOPTS....................................................................................................... 398ZOSMIGV2R1_CS_GATEWAY....................................................................................................... 399ZOSMIGV2R1_CS_LEGACYDEVICE..............................................................................................400ZOSMIGV2R2_NEXT_CS_LEGACYDEVICE...................................................................................402ZOSMIGV2R2_Next_CS_TFTP......................................................................................................403ZOSMIGV2R2_Next_CS_SENDMAILCLIEN..................................................................................404ZOSMIGV2R2_Next_CS_SENDMAILDAEMN................................................................................405ZOSMIGV2R2_Next_CS_SENDMAILMSA.....................................................................................406ZOSMIGV2R2_Next_CS_SENDMAILMTA.....................................................................................407ZOSMIGV2R2_Next_CS_SMTPDDAEMON................................................................................... 408ZOSMIGV2R2_Next_CS_SMTPDMTA...........................................................................................409ZOSMIGV2R4PREV_CS_IWQSC_tcpipstackname....................................................................... 410

Component trace checks (IBMCTRACE)............................................................................................411CTRACE_DEFAULT_OR_MIN........................................................................................................ 411

Consoles checks (IBMCNZ)............................................................................................................... 412CNZ_AMRF_Eventual_Action_Msgs............................................................................................ 412CNZ_Console_MasterAuth_Cmdsys.............................................................................................413CNZ_Console_Mscope_And_Routcode....................................................................................... 413CNZ_Console_Operating_Mode................................................................................................... 414CNZ_Console_Routcode_11........................................................................................................ 415CNZ_EMCS_Hardcopy_Mscope....................................................................................................415CNZ_EMCS_Inactive_Consoles....................................................................................................416CNZ_OBSOLETE_MSGFLD_AUTOMATION...................................................................................417CNZ_Syscons_Allowcmd..............................................................................................................418CNZ_Syscons_Mscope................................................................................................................. 419CNZ_Syscons_PD_Mode.............................................................................................................. 419CNZ_Syscons_Routcode.............................................................................................................. 420CNZ_Task_Table........................................................................................................................... 421ZOSMIGV1R13_CNZ_Cons_Oper_Mode...................................................................................... 422

Contents supervision checks (IBMCSV)............................................................................................ 422CSV_APF_EXISTS..........................................................................................................................422CSV_LNKLST_NEWEXTENTS........................................................................................................ 424

viii

CSV_LNKLST_SPACE.....................................................................................................................425CSV_LPA_CHANGES..................................................................................................................... 426

DAE checks (IBMDAE)........................................................................................................................428DAE_SHAREDSN........................................................................................................................... 428DAE_SUPPRESSING..................................................................................................................... 429

Device Manager checks (IBMDMO)................................................................................................... 430DMO_TAPE_LIBRARY_INIT_ERRORS.......................................................................................... 430DMO_REFUCB............................................................................................................................... 430

DFSMS OPEN/CLOSE/EOV checks (IBMOCE) ...................................................................................431OCE_XTIOT_CHECK......................................................................................................................431

Geographically Dispersed Parallel Sysplex checks (IBMGDPS) ...................................................... 433Global Resource Serialization checks (IBMGRS).............................................................................. 433

GRS_AUTHQLVL_SETTING...........................................................................................................433GRS_CONVERT_RESERVES.......................................................................................................... 434GRS_EXIT_PERFORMANCE..........................................................................................................435GRS_GRSQ_SETTING................................................................................................................... 435GRS_Mode.................................................................................................................................... 436GRS_RNL_IGNORED_CONV......................................................................................................... 437GRS_SYNCHRES........................................................................................................................... 438

HSM checks (IBMHSM)...................................................................................................................... 438HSM_CDSB_BACKUP_COPIES......................................................................................................438HSM_CDSB_DASD_BACKUPS.......................................................................................................439HSM_CDSB_VALID_BACKUPS...................................................................................................... 440

ICSF checks (IBMICSF)......................................................................................................................441ICSF_COPROCESSOR_STATE_NEGCHANGE................................................................................441ICSF_DEPRECATED_SERV_WARNINGS....................................................................................... 442ICSF_KEY_EXPIRATION............................................................................................................... 443ICSF_MASTER_KEY_CONSISTENCY............................................................................................ 445ICSFMIG7731_ICSF_PKDS_TO_4096BIT................................................................................... 446ICSFMIG7731_ICSF_RETAINED_RSAKEY...................................................................................447ICSFMIG77A1_COPROCESSOR_ACTIVE.....................................................................................448ICSFMIG77A1_TKDS_OBJECT.....................................................................................................449ICSFMIG77A1_UNSUPPORTED_HW........................................................................................... 450ICSF_OPTIONS_CHECKS.............................................................................................................. 451ICSF_UNSUPPORTED_CCA_KEYS ............................................................................................... 452

Infoprint Server checks (IBMINFOPRINT)........................................................................................ 454INFOPRINT_PRINTWAY_MODE................................................................................................... 454INFOPRINT_V2DB_CHECK........................................................................................................... 455ZOSMIGV1R12_INFOPRINT_INVSIZE........................................................................................ 457

IOS checks (IBMIOS)......................................................................................................................... 458Write your own IOS single point of failure detection checks!..................................................... 458IOS_BUFFER_CREDITS................................................................................................................ 466IOS_CAPTUCB_PROTECT............................................................................................................. 468IOS_CMRTIME_MONITOR............................................................................................................469IOS_DYNAMIC_ROUTING............................................................................................................ 471IOS_FABRIC_MONITOR............................................................................................................... 472IOS_HSWAP_CRITICAL_PAGING.................................................................................................473IOS_IORATE_MONITOR............................................................................................................... 474IOS_MIDAW.................................................................................................................................. 476IOS_PORT_SPEED.........................................................................................................................477IOS_STORAGE_IOSBLKS..............................................................................................................479

ISPF checks (IBMISPF)......................................................................................................................480ISPF_WSA......................................................................................................................................480

JES checks (IBMJES) ........................................................................................................................ 481JES_NJE_SECURITY and JES_NJE_SECURITY_ssname.............................................................481

JES2 checks (IBMJES2).....................................................................................................................489JES2_UPGRADE_CKPT_LEVEL_JES2...........................................................................................489

JES3 checks (IBMJES3).....................................................................................................................490

ix

JES3_DATASET_INTEGRITY........................................................................................................ 490JES3_DOT_POOL_USAGE............................................................................................................ 491JES3_JET_POOL_USAGE............................................................................................................. 492JES3_OST_POOL_USAGE............................................................................................................. 493JES3_SEE_POOL_USAGE.............................................................................................................495

Loadwait/Restart checks (IBMSVA)...................................................................................................496SVA_AUTOIPL_DEFINED............................................................................................................. 496SVA_AUTOIPL_DEV_VALIDATION............................................................................................... 497

PDSE checks (IBMPDSE)....................................................................................................................498PDSE_SMSPDSE1......................................................................................................................... 498

Predictive failure analysis checks (IBMPFA)..................................................................................... 499RACF checks (IBMRACF)....................................................................................................................499

Write your own RACF resource checks!....................................................................................... 499RACF_AIM_STAGE........................................................................................................................ 503RACF_BATCHALLRACF..................................................................................................................505RACF_CERTIFICATE_EXPIRATION...............................................................................................505RACF_classname_ACTIVE............................................................................................................507RACF_ENCRYPTION_ALGORITHM...............................................................................................509RACF_GRS_RNL.............................................................................................................................511RACF_IBMUSER_REVOKED..........................................................................................................516RACF_ICHAUTAB_NONLPA.......................................................................................................... 517RACF_PASSWORD_CONTROLS.....................................................................................................519RACF_RRSF_RESOURCES.............................................................................................................521RACF_SENSITIVE_RESOURCES................................................................................................... 524RACF_UNIX_ID............................................................................................................................. 529ZOSMIGV2R1_DEFAULT_UNIX_ID.............................................................................................. 533

Reconfiguration checks (IBMRCF).....................................................................................................537RCF_PCCA_ABOVE_16M..............................................................................................................537ZOSMIGV1R12_RCF_PCCA_ABOVE_16M .................................................................................. 538

RMM checks (IBMRMM)..................................................................................................................... 539ZOSMIGV1R10_RMM_REJECTS_DEFINED................................................................................. 539ZOSMIGV1R10_RMM_VOL_REPLACE_LIM.................................................................................540ZOSMIGV1R10_RMM_VRS_DELETED......................................................................................... 541ZOSMIGV1R11_RMM_DUPLICATE_GDG.....................................................................................542ZOSMIGV1R11_RMM_REXX_STEM.............................................................................................543ZOSMIGV1R11_RMM_VRSEL_OLD..............................................................................................544

RRS checks (IBMRRS)........................................................................................................................545RRS_ArchiveCFStructure..............................................................................................................545RRS_DUROffloadSize....................................................................................................................546RRS_MUROffloadSize................................................................................................................... 546RRS_RMDataLogDuplexMode...................................................................................................... 547RRS_RMDOffloadSize................................................................................................................... 548RRS_RSTOffloadSize.................................................................................................................... 548RRS_Storage_NumLargeLOGBlks................................................................................................ 549RRS_Storage_NumLargeMSGBlks................................................................................................550RRS_Storage_NumServerReqs.....................................................................................................551RRS_Storage_NumTransBlks....................................................................................................... 552

RSM checks (IBMRSM).......................................................................................................................554RSM_AFQ...................................................................................................................................... 554RSM_HVCOMMON........................................................................................................................ 555RSM_HVSHARE.............................................................................................................................556RSM_MAXCADS............................................................................................................................ 557RSM_MEMLIMIT........................................................................................................................... 557RSM_REAL.................................................................................................................................... 558RSM_RSU...................................................................................................................................... 559ZOSMIGV2R3_RSM_INCLUDE1MAFC......................................................................................... 559ZOSMIGV2R3_RSM_MINIMUM_REAL........................................................................................ 560

RTM checks (IBMRTM).......................................................................................................................561

x

RTM_IEAVTRML............................................................................................................................561SDSF checks (IBMSDSF)....................................................................................................................562

SDSF_CLASS_SDSF_ACTIVE......................................................................................................... 562SDSF_ISFPARMS_IN_USE............................................................................................................563

SDUMP checks (IBMSDUMP)............................................................................................................. 564SDUMP_AUTO_ALLOCATION........................................................................................................564SDUMP_AVAILABLE......................................................................................................................565

Serviceability checks (IBMSLIP)........................................................................................................565SLIP_PER.......................................................................................................................................565

SMB checks (IBMSMB).......................................................................................................................566SMB_NO_ZFS_SYSPLEX_AWARE.................................................................................................566ZOSMIGREC_SMB_RPC................................................................................................................567

SMS checks (IBMSMS)....................................................................................................................... 568SMS_CDS_REUSE_OPTION.......................................................................................................... 568SMS_CDS_SEPARATE_VOLUMES..................................................................................................569

Supervisor checks (IBMSUP)............................................................................................................. 569IEA_ASIDS....................................................................................................................................569IEA_LXS........................................................................................................................................ 570SUP_HIPERDISPATCH.................................................................................................................. 571SUP_HiperDispatchCPUConfig..................................................................................................... 573SUP_LCCA_ABOVE_16M.............................................................................................................. 574SUP_SYSTEM_SYMBOL_TABLE_SIZE.......................................................................................... 575ZOSMIGV1R12_SUP_LCCA_ABOVE_16M................................................................................... 577

System logger checks (IBMIXGLOGR)...............................................................................................578IXGLOGR_ENTRYTHRESHOLD..................................................................................................... 578IXGLOGR_STAGINGDSFULL......................................................................................................... 580IXGLOGR_STRUCTUREFULL.........................................................................................................583ZOSMIGV2R2_NEXT_IXG_REMOVE_DRXRC.............................................................................. 585

System trace checks (IBMSYSTRACE)...............................................................................................588SYSTRACE_BRANCH.................................................................................................................... 588SYSTRACE_MODE.........................................................................................................................589

Timer supervisor checks (IBMTIMER)...............................................................................................590ZOSMIGREC_SUP_TIMER_INUSE................................................................................................ 590

TSO/E (IBMTSOE)...............................................................................................................................591TSOE_OPERSEWAIT_SETTING.................................................................................................... 591TSOE_PARMLIB_ERROR.............................................................................................................. 592TSOE_USERLOGS..........................................................................................................................593

z/OS UNIX System Services checks (IBMUSS)................................................................................. 594USS_AUTOMOUNT_DELAY........................................................................................................... 594USS_CLIENT_MOUNTS................................................................................................................. 595USS_FILESYS_CONFIG................................................................................................................. 596USS_HFS_DETECTED................................................................................................................... 598USS_INETD_UNSECURE_SERVICES............................................................................................ 599USS_KERNEL_PVTSTG_THRESHOLD.......................................................................................... 600USS_KERNEL_RESOURCES_THRESHOLD................................................................................... 602USS_KERNEL_STACKS_THRESHOLD........................................................................................... 603USS_MAXSOCKETS_MAXFILEPROC............................................................................................ 604USS_PARMLIB.............................................................................................................................. 605USS_PARMLIB_MOUNTS..............................................................................................................608USS_SUPERUSER..........................................................................................................................610ZOSMIGREC_ROOT_FS_SIZE.......................................................................................................611ZOSMIGV1R13_RO_SYMLINKS................................................................................................... 612

ZOSMIGV2R3_NEXT_USS_SMB_DETECTED.....................................................................................613VLF checks (IBMVLF)......................................................................................................................... 614

VLF_MAXVIRT............................................................................................................................... 614VSAM checks (IBMVSAM).................................................................................................................. 616

VSAM_INDEX_TRAP..................................................................................................................... 616VSAM RLS checks (IBMVSAMRLS).....................................................................................................617

xi

VSAMRLS_CFCACHE_MINIMUM_SIZE........................................................................................ 617VSAMRLS_CFLS_FALSE_CONTENTION........................................................................................618VSAMRLS_DIAG_CONTENTION................................................................................................... 619VSAMRLS_QUIESCE_STATUS....................................................................................................... 620VSAMRLS_SHCDS_CONSISTENCY............................................................................................... 620VSAMRLS_SHCDS_MINIMUM_SIZE............................................................................................ 621VSAMRLS_SINGLE_POINT_FAILURE...........................................................................................622VSAMRLS_TVS_ENABLED.............................................................................................................623

VSM checks (IBMVSM).......................................................................................................................624VSM_ALLOWUSERKEYCSA........................................................................................................... 624VSM_CSA_LARGEST_FREE...........................................................................................................625VSM_CSA_LIMIT...........................................................................................................................627VSM_SQA_LIMIT.......................................................................................................................... 628VSM_PVT_LIMIT........................................................................................................................... 628VSM_CSA_THRESHOLD................................................................................................................ 629VSM_SQA_THRESHOLD................................................................................................................632VSM_CSA_CHANGE...................................................................................................................... 634ZOSMIGV2R3_NEXT_VSM_USERKEYCOMM................................................................................634

XCF checks (IBMXCF)........................................................................................................................ 635XCF_CDS_MAXSYSTEM.................................................................................................................635XCF_CDS_SEPARATION................................................................................................................ 636XCF_CDS_SPOF............................................................................................................................. 637XCF_CF_ALLOCATION_PERMITTED............................................................................................. 638XCF_CF_CONNECTIVITY............................................................................................................... 639XCF_CF_MEMORY_UTILIZATION..................................................................................................639XCF_CF_PROCESSORS..................................................................................................................640XCF_CF_SCM_UTILIZATION......................................................................................................... 641XCF_CF_STR_AVAILABILITY........................................................................................................ 643XCF_CF_STR_DUPLEX...................................................................................................................644XCF_CF_STR_ENCRYPT.................................................................................................................644XCF_CF_STR_EXCLLIST................................................................................................................ 645XCF_CF_STR_MAXSCM................................................................................................................. 646XCF_CF_STR_MAXSPACE..............................................................................................................647XCF_CF_STR_NONVOLATILE........................................................................................................ 648XCF_CF_STR_POLICYSIZE............................................................................................................ 648XCF_CF_STR_PREFLIST................................................................................................................ 650XCF_CF_STR_SCM_AUGMENTED................................................................................................. 650XCF_CF_STR_SCMMAXSIZE..........................................................................................................651XCF_CF_STR_SCM_MINCOUNTS..................................................................................................652XCF_CF_SYSPLEX_CONNECTIVITY.............................................................................................. 653XCF_CFRM_MSGBASED................................................................................................................654XCF_CLEANUP_VALUE...................................................................................................................655XCF_DEFAULT_MAXMSG.............................................................................................................. 655XCF_FDI ........................................................................................................................................656XCF_MAXMSG_NUMBUF_RATIO ................................................................................................. 657XCF_SFM_ACTIVE.........................................................................................................................657XCF_SFM_CFSTRHANGTIME........................................................................................................ 658XCF_SFM_CONNFAIL.................................................................................................................... 659XCF_SFM_SSUMLIMIT.................................................................................................................. 660XCF_SFM_SUM_ACTION.............................................................................................................. 661XCF_SIG_CONNECTIVITY.............................................................................................................661XCF_SIG_PATH_SEPARATION......................................................................................................662XCF_CF_STR_SCM_UTILIZATION.................................................................................................663XCF_SIG_STR_SIZE...................................................................................................................... 664XCF_SYSPLEX_CDS_CAPACITY ....................................................................................................665XCF_SYSSTATDET_PARTITIONING.............................................................................................. 666XCF_TCLASS_CLASSLEN............................................................................................................... 667XCF_TCLASS_CONNECTIVITY...................................................................................................... 668

xii

XCF_TCLASS_HAS_UNDESIG....................................................................................................... 669z/OS File System checks (IBMZFS)................................................................................................... 669

ZFS_CACHE_REMOVALS.............................................................................................................. 669ZFS_VERIFY_COMPRESSION_HEALTH........................................................................................671ZOSMIGV2R1_ZFS_VERIFY_CACHESIZE.................................................................................... 671ZOSMIGV1R11_ZFS_INTERFACELEVEL......................................................................................673ZOSMIGV1R11_ZFS_RM_MULTIFS............................................................................................. 673ZFS_VERIFY_CACHESIZE............................................................................................................. 674

Appendix A. Accessibility...................................................................................677Accessibility features.............................................................................................................................. 677Consult assistive technologies................................................................................................................ 677Keyboard navigation of the user interface.............................................................................................. 677Dotted decimal syntax diagrams.............................................................................................................677

Notices..............................................................................................................681Terms and conditions for product documentation................................................................................. 682IBM Online Privacy Statement................................................................................................................ 683Policy for unsupported hardware............................................................................................................683Minimum supported hardware................................................................................................................684

Trademarks....................................................................................................... 685

Index................................................................................................................ 687

xiii

Figures

1. IBM Health Checker for z/OS with a local check.......................................................................................... 3

2. Creating a policy in multiple HZSPRMxx members.................................................................................... 52

3. Creating multiple policies in one HZSPRMxx member...............................................................................53

4. The parts of a local check........................................................................................................................... 94

5. The parts of a remote check....................................................................................................................... 95

6. The parts of a REXX check ......................................................................................................................... 96

7. Example of issuing a message with variables in an assembler check.....................................................117

8. Example of issuing a message with variables using MGBFORMAT=1..................................................... 118

9. Example of issuing a message with variables in an assembler check.....................................................147

10. Example of issuing a message with variables using MGBFORMAT=1...................................................148

11. Assembler example: Defining the HZSADDCHECK exit routine adding checks....................................182

12. Inputs and outputs for creating a complete message table..................................................................186

13. Message and variable resolution at runtime..........................................................................................187

14. Example of a setup data set that defines symbols used in the message table.................................... 212

xv

Tables

1. Access required for printing check output from the message buffer using HZSPRINT............................17

2. Interaction of HZSPRMxx settings specified in HZSPROC and IEASYSxx................................................. 22

3. User controlled states................................................................................................................................. 32

4. States controlled by IBM Health Checker for z/OS.................................................................................... 32

5. Check state combinations...........................................................................................................................33

6. When do I use which interface to manage checks?................................................................................... 40

7. F hzsproc command examples................................................................................................................... 43

8. Summary of local, remote, and REXX checks.............................................................................................96

9. Correlation between IBM Health Checker for z/OS mapping macros and Metal C header files.............101

10. Important fields in the HZSPQE data area for a local check routine.....................................................107

11. Summary of function codes for local checks......................................................................................... 109

12. Important MGBFORMAT=0 fields in the HZSMGB data area for check message variables................. 117


14. Correlation between IBM Health Checker for z/OS mapping macros and Metal C header files.......... 130

15. Important fields in the HZSPQE data area for a remote check routine.................................................138

16. Summary of release codes for remote checks.......................................................................................139



19. Important HZSPQE information used in a REXX check from HZSLSTRT variables...............................159

20. A summary of message types for IBM Health Checker for z/OS........................................................... 200

21. Variable input and output lengths and alignment:.................................................................................203

22. Which variables allow maxlen?.............................................................................................................. 203

23. Description of classes required for all message explanations...........................................205

xvii

24. How messages are formatted in the message buffer............................................................................ 208

25. A summary of pre-defined symbols that resolve when the check runs................................................210

26. A summary of pre-defined symbols that resolve when you generate the CSECT for the messagetable..........................................................................................................................................................211

27. HZSLFMSG input variables..................................................................................................................... 218

28. HZSLFMSG_REQUEST='CHECKMSG' input variables............................................................................ 219

29. HZSLFMSG_REQUEST='DIRECTMSG' required input variables............................................................ 221

30. HZSLFMSG_REQUEST='DIRECTMSG' optional input variables forHZSLFMSG_REASON='CHECKEXCEPTION'............................................................................................ 222

31. HZSLFMSG_REQUEST='HZSMSG' input variables.................................................................................223

32. HZSLFMSG_REQUEST='STOP' input variables...................................................................................... 229

33. HZSLFMSG output variables...................................................................................................................230

34. HZSLPDRD input variables..................................................................................................................... 235

35. HZSLPDRD input variables..................................................................................................................... 235

36. HZSLPDRD optional input variables....................................................................................................... 235

37. HZSLPDRD output variables................................................................................................................... 236

38. HZSLPDWR input variables.....................................................................................................................238

39. HZSLPDWR input variables.....................................................................................................................238

40. HZSLPDRD output variables................................................................................................................... 239

41. HZSLSTOP input variable........................................................................................................................241

42. HZSLSTOP output variables....................................................................................................................242

43. HZSLSTRT input variable........................................................................................................................ 244

44. HZSLSTRT output variables.................................................................................................................... 245

45. Return and Reason Codes for the HZSADDCK Macro............................................................................ 263

46. Return and Reason Codes for the HZSCHECK Macro............................................................................ 278

47. Return and Reason Codes for the HZSCPARS Macro.............................................................................292

48. Return and Reason Codes for the HZSFMSG Macro.............................................................................. 321

xviii

49. Return and Reason Codes for the HZSPREAD Macro............................................................................ 331

50. Return and Reason Codes for the HZSPWRIT Macro.............................................................................341

51. Return and Reason Codes for the HZSQUERY Macro............................................................................ 360

52. ICSF_KEY_EXPIRATION attributes.........................................................................................................443

53. RACF_CERTIFICATE_EXPIRATION report columns...............................................................................506

54. RACF_CERTIFICATE_EXPIRED attributes.............................................................................................. 506

55. Systems Level ENQs that RACF_GRS_RNL checks.................................................................................512

56. System Level ENQs that RACF_GRS_RNL checks.................................................................................. 512

57. RACF_PASSWORD_CONTROLS report columns..................................................................................... 521

58. RACF_RRSF_RESOURCES report columns............................................................................................. 523

59. Discrete and “Sensitive” General Resources for RACF_SENSITIVE_RESOURCES............................... 524

60. RACF_UNIX_ID check actions based on whether the BPX.UNIQUE.USER and BPX.DEFAULT.USERprofiles are defined in the FACILITY class.............................................................................................. 530

61. ZOSMIGV2R1_DEFAULT_UNIX_ID check actions and migration actions.............................................534

62. Synonyms of Parameters........................................................................................................................626

xix

About this information

This document presents the information you need to install, use, and develop checks for IBM® HealthChecker for z/OS®. IBM Health Checker for z/OS is a component of MVS™ that identifies potential problemsbefore they impact your availability or, in worst cases, cause outages. It checks the current active z/OSand sysplex settings and definitions for a system and compares the values to those suggested by IBM ordefined by you. It is not meant to be a diagnostic or monitoring tool, but rather a continuously runningpreventative that finds deviations from best practices. IBM Health Checker for z/OS produces output inthe form of detailed messages to let you know of both potential problems and suggested actions to take.

Who should use this documentThis document is intended for two separate audiences:

• People using IBM Health Checker for z/OS to find potential problems in their installation. Part 1, “ UsingIBM Health Checker for z/OS,” on page 1 describes how to setup IBM Health Checker for z/OS, workwith check output and manage checks. Part 3, “Check Descriptions,” on page 365 also includesinformation that an IBM Health Checker for z/OS user will need, including check descriptions and IBMHealth Checker for z/OS framework HZS messages.

• People developing their own IBM Health Checker for z/OS checks. Part 2, “Developing checks for IBMHealth Checker for z/OS,” on page 89 includes information on planning checks, developing a checkroutine, developing messages for your check, and getting your check into the IBM Health Checker forz/OS framework. Part 3, “Check Descriptions,” on page 365 also includes information about IBM HealthChecker for z/OS macros for use in developing checks.

© Copyright IBM Corp. 2006, 2019 xxi

xxii z/OS: IBM Health Checker for z/OS User's Guide

How to send your comments to IBM

We invite you to submit comments about the z/OS product documentation. Your valuable feedback helpsto ensure accurate and high-quality information.

Important: If your comment regards a technical question or problem, see instead “If you have a technicalproblem” on page xxiii.

Submit your feedback by using the appropriate method for your type of comment or question:Feedback on z/OS function

If your comment or question is about z/OS itself, submit a request through the IBM RFE Community(www.ibm.com/developerworks/rfe/).

Feedback on IBM Knowledge Center functionIf your comment or question is about the IBM Knowledge Center functionality, for example searchcapabilities or how to arrange the browser view, send a detailed email to IBM Knowledge CenterSupport at [email protected].

Feedback on the z/OS product documentation and contentIf your comment is about the information that is provided in the z/OS product documentation library,send a detailed email to [email protected]. We welcome any feedback that you have, includingcomments on the clarity, accuracy, or completeness of the information.

To help us better process your submission, include the following information:

• Your name, company/university/institution name, and email address• The following deliverable title and order number: IBM Health Checker for z/OS User's Guide,

SC23-6843-30• The section title of the specific information t

Version 2 Release 3 z/OS · z/OS Version 2 Release 3 IBM Health Checker for z/OS User's Guide IBM...

Documents

Transcript of Version 2 Release 3 z/OS · z/OS Version 2 Release 3 IBM Health Checker for z/OS User's Guide IBM...