MODIFY CATALOG,DUMPON Syntax

Answer

• • • Description:
      
      MODIFY or F CATALOG, DUMPON or DUMPOFF specifies whether catalog address space dynamic dumping is to occur. Dynamic dumping by the catalog address space does not occur unless you specify DUMPON.
    • 
      MODIFY CATALOG,DUMPON
      MODIFY CATALOG,DUMPON(xxx,yyy,zz)
      MODIFY CATALOG,DUMPON(xxx,yyy,zz,nnn)
      
      
      Where:
      
      xxx is the catalog return code in decimal (000-255), or ***
      yyy is the catalog reason code in decimal (000-255), or ***
      zz is the catalog module identifier in the catalog address space, or **
      nnn is the limit number in decimal (000-999)
      
      Options in parentheses that follow the DUMPON parameter can be used to create a dump whenever a given return code, reason code, and module identifier occur. This dump can prove valuable to service personnel in solving problems.
      Normally, the return code, reason code, and module identifier are available on return from the catalog address space and are printed by IDCAMS.
      The module identifier corresponds to the last two characters in the catalog module name. For example, the module identifier is A3 for catalog module IGG0CLA3.
      
      The return code, reason code, and module identifiers can be specified as a string of asterisks to indicate any value encountered will match the value of that field.
    • This is referred to as a generic match. All three fields can not be simultaneously specified as asterisks. Whenever a generic match is specified for a particular field, it will be assumed that field always matches the value being returned by catalog for a catalog request. As an example:
      
      MODIFY CATALOG,DUMPON(008,042,**)
      
      Will create a dump for any return code 8, reason code 42, regardless of the module that detected the error.
      
      An option has been provided for a match count to obtain the nth occurrence of a return code, reason code, and module identifier. The match count decrements by one each time a return code, reason code, and module identifier is set in the catalog address space, if this option is not specified or is set to 000, then the first occurrence causes a dump.
      
      Only one set of return codes, reason codes and module identifiers can be set at a time. Each entry overwrites the previous information.
    • Once a match occurs, the information is cleared and the original DUMPON status is maintained.
    • If DUMPON is entered without the additional options, certain conditions will produce dumps automatically. If then a DUMPON with options is entered, a match will cause a dump and the return code, reason code and module identifier will be cleared. The
      DUMPON status will remain on.
      
      MODIFY CATALOG,REPORT,DUMP can be used to view the settings.
      
      The header for the catalog dynamic dump will contain the return code and reason code in hex. For example:
      
      CAS DYNAMIC DUMP-IGG0CLA9 RCX'08' RSNX'00'
      
      
      
      Resolution:
      
      For additional description on using the DUMPON command, see the links beneath
      
      DFSMS Managing catalogs
      modify catalog command syntax
      
      z/OS MVS System Commands
      modify catalog command syntax