Skip to Content

HCHECK0 - FDREPORT Internal Parameter Check

This section describes HCHECK0. 

  • Step 1 disables calls to the FAMS interface by disabling FAMSFREESP and FAMSDIRBLKS and enabling the operand HFSEXCLUDE.
  • This job tests whether your SORT product requires that FDREPORT allocate SORTLIB, SYSOUT, and SORTWKnn DD statements and adjusts the FDREPORT options accordingly.
  • This job must include a JOBLIB DD statement pointing to the FDR program library that is used for the rest of the Health Check jobstreams. The job must have authority to update that library and to update the options.
  • Step 2 sets SORTALLOC=YES as a default, and then executes a job requiring sorting. If an error occurs, step 3 sets SORTALLOC=(SORTMSG,SORTWORK) as the default so that SYSLIB is not allocated and tries again.
  • If step 3 also fails, step 4 sets SORTALLOC=NO as the default. If you SORT product does not automatically allocate any required data sets, you may need to add required DD statements to the other Health Check jobstreams.

Step 1: Disable FAMS Interface Calls 

//JOBLIB   DD DISP=SHR,DSN=fdr.loadlib                        ***CHANGE
//STEP01   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//SYSLIB   DD DISP=SHR,DSN=*.JOBLIB     FDR Program Library
//SYSIN    DD *
***********************************************************************
* THE FOLLOWING DISABLE= AND ENABLE= OPERANDS DISABLE THE CALLS TO
* FAMS. FAMS IS USED TO GET FREESPACE AND DIRECTORY INFORMATION FOR  
* POE, HFS, AND ZFS DATA SETS. HOWEVER, IF THE USER RUNNING FDREPORT
* IS NOT AUTHORIZED TO ACCESS THE DATA SET, SECURITY VIOLATIONS OCCUR
* AND FDR575 MESSAGES ARE ISSUED.
*
* NOTES: 1. THE DISABLE OF FAMSDIRBLKS WILL ONLY WORK RUNNING V54L80
*           AND ABOVE. WITH LOWER VERSIONS, YOU GET FDR099/FDR407.
*
*        2. THE DISABLE OF FAMSDIRBLKS AND/OR FAMSFREESP WITH
*           CHANGE=PERM ONLY STAYS RUNNING V54L80 SPIN=3 AND ABOVE
*           OR WITH V54L80 AND P-54.8042 APPLIED.
***********************************************************************
 DEFAULT  DISABLE=FAMSDIRBLKS,CHANGE=PERM
 DEFAULT  DISABLE=FAMSFREESP,CHANGE=PERM
 DEFAULT  ENABLE=HFSEXCLUDE,CHANGE=PERM

Sample Output

FDR303   CARD IMAGE - *  DEFAULT  DISABLE=FAMSDIRBLKS,CHANGE=PERM
FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB
FDR303   CARD IMAGE - *  DEFAULT  DISABLE=FAMSFREESP,CHANGE=PERM
FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB
FDR303   CARD IMAGE - *  DEFAULT  ENABLE=HFSEXCLUDE,CHANGE=PERM
FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB

Step 2: Set SORTALLOC=YES as Default

//STEP02   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//SYSLIB   DD DISP=SHR,DSN=*.JOBLIB     FDR Program Library
//SYSIN    DD *
***********************************************************************
*IN THE FOLLOWING, REPLACE "storclas" WITH THE NAME OF A STORAGE CLASS
*THAT SUPPORTS LARGE ALLOCATIONS FOR SORTING.
***********************************************************************
 DEFAULT  ENABLE=AUTOMAXONLIN,
          SORTALLOC=(YES,CYL),
          WORKDDNAMES=5,
          SYSUTSPACE=3000,
          WORKSPACE=3000,
          SYSUTSTORCLAS=storclas,                            ***CHANGE
          WORKSTORCLAS=storclas,                             ***CHANGE
          CHANGE=PERM
 SELECT   DSN=(SYS1.NUCLEUS,SYS1.PARMLIB)
 SORT     FIELDS=(VOL),SEQUENCE=(A)   PRINT    DATATYPE=CATALOG,RPTYPE=NONE 

Sample Output 1

FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB 
… 
FDR491   PRINT REPORTS    FUNCTION STARTED - 08.29.35 
FDR336** ALLOCATION FAILED -- CODE=0004-9700 -- DDNAME=SORTWK01 
         PRINT REQUEST CANCELLED 
FDR492   PRINT REPORTS    FUNCTION ENDED   - 08.29.35 - CONDITION CODE 012 

Sample Output 2

FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB 
… 
FDR491   PRINT REPORTS    FUNCTION STARTED - 08.55.24        
FDR346   FILTER SELECTED         2 ENTRIES IN      0.04 SECS 
FDR492   PRINT REPORTS    FUNCTION ENDED   - 08.55.24 - CONDITION CODE 000 

Step 3: Set SORTALLOC=(NO,SORTMSG,SORTWORK) as Default 

//STEP03   EXEC PGM=FDREPORT,REGION=0M,COND=(0,EQ,STEP02) 
//SYSPRINT DD SYSOUT=* 
//SYSLIB   DD DISP=SHR,DSN=*.JOBLIB     FDR Program Library 
//SYSIN    DD * 
  DEFAULT  ENABLE=AUTOMAXONLIN, 
           SORTALLOC=(NO,SORTMSG,SORTWORK), 
           CHANGE=PERM 
  SELECT   DSN=(SYS1.NUCLEUS,SYS1.PARMLIB) 
  SORT     FIELDS=(VOL),SEQUENCE=(A)  

PRINT    DATATYPE=CATALOG,RPTYPE=NONE

Sample Output

FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB 
… 
FDR491   PRINT REPORTS    FUNCTION STARTED - 08.29.35 
FDR336** ALLOCATION FAILED -- CODE=0004-9700 -- DDNAME=SORTWK01 
         PRINT REQUEST CANCELLED 
FDR492   PRINT REPORTS    FUNCTION ENDED   - 08.29.35 - CONDITION CODE 012 

Step 4: Set SORTALLOC=NO as Default 

//STEP04   EXEC PGM=FDREPORT,REGION=0M, 
//              COND=((0,EQ,STEP02`),(0,EQ,STEP03)) 
//SYSPRINT DD SYSOUT=* 
//SYSLIB   DD DISP=SHR,DSN=*.JOBLIB     FDR Program Library 
//SYSIN    DD * 
  DEFAULT  ENABLE=AUTOMAXONLIN, 
           SORTALLOC=(NO),            

CHANGE=PERM

Sample Output

FDR539   MODULE F$REPOPT -- SUCCESSFULLY CHANGED -- SYSLIB  =FDR.LOADLIB 
FDR499   FDREPORT(5.4/82P) PROCESSING COMPLETED 

Step 5: Display All the FDREPORT Defaults 

//STEP05   EXEC PGM=FDREPORT,REGION=0M,COND=EVEN 
//SYSPRINT DD SYSOUT=* 
//SYSLIB   DD DISP=SHR,DSN=*.JOBLIB     FDR Program Library 
//SYSIN    DD * 
  DEFAULT  ENABLE=DISPLAY

Sample Output

Current F$REPOPT Options(Changeable by FDREPORT) --
 AGEACCUM      Number of Summary Aging Accumulators------------------------0
 ALIASLEVEL    Number of Alias Level Qualifications To Be Processed--------1
 ALTDATADDNAME DDname Used When RPTYPE=DATA and DATATYPE=EXTRACT----SYSUT1 …
*GMSORTLEN     Number of Bytes Obtained For Generated SORT Stmt--------12768 …
 SORT          Sort Processing Option (Augments SORT Cmd)-----------------NO
*SORTALLOCATE  Dynamically Allocate Sort Required DDnames----------------YES
*SORTALLOCATE  Allocate SORTLIB DDname-----------------------------------YES
*SORTALLOCATE  Allocate SORT Message DDname------------------------------YES
*SORTALLOCATE  Allocate SORTWKnn DDname(S)-------------------------------YES
 SORTLIB       SORTLIB Data Set Name-------------SYS1.SORTLIB
 SORTMSGDDNAME DDname to Allocate For SORT Messages-----------------SYSOUT …
*SYSUTSPACE    Allocation Quantity For SYSUT2/SYSUT3 DDnames--------3000 CYL
*SYSUTSTORCLAS Allocation Storage Class For SYSUT2/SYSYT3 DDnames---TSTDATA …
*WORKDDNAMES   Number of SORTWKnn DDnames to Dynamically Allocate----------5
*WORKSPACE     Allocation Quantity For SORTWKnn DDnames-------------3000 CYL
*WORKSTORCLAS  Allocation Storage Class For SORTWKnn DDnames--------TSTDATA
 WORKUNIT      Allocation Unit Name For SORTWKnn DDnames------------SYSALLDA …
  Following Are Options of The ENABLE/DISABLE Keywords -- …
    FAMSDIRBLKS   Read POE Directory Blocks when FAMSFREESP is enabled----NO *    FAMSFREESP    Use FAMS To Determine Free Space Of HFS/POE Data Sets---NO …
*HFSEXCLUDE    Exclude HFS Data Sets From FAMS Free Space Processing--YES … 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Storage FDR 6.1