How to manage PXX Master List dumps in Datacom

Products

• Datacom/DB
• Datacom/AD

Issue/Introduction

All of the Return Codes used in Datacom have a corresponding default setting for whether PXX Master List dumps and buffer dumps are produced. This article explains how to change those settings at MUF startup and during MUF operation

Environment

Release: All
  Datacom/DB
  Datacom/AD

 

Resolution

To change the current setting of a Return Code MasterList dump in the MUF, you can either run a DBUTLTY function to change them during operation, or you can change the MUF Startup Options so they have the new settings at the next startup.

In order to change them during MUF operation, execute the DBUTLTY program with this input:
//SYSIN    DD  *
 COMM OPTION=ALTER,RCERROR=eeiii,BUFFERS=bbb,MASTERL=mmm
/*
Where:

ee	The Datacom Return Code
iii	The Datacom internal return code in Decimal (not the Hex value)
bbb	YES to produce or NO to not produce a dump of Master List buffers
mmm	YES to produce or NO to not produce a Master List dump

To change this setting at the MUF startup for a Return Code, add the following to your MUF Startup Options:
RCERROR   mmmm,bbbb,eeiii
or
RCERROR   mmmm,bbbb,eeiii-eeiii
Where

mmmm	YES to produce or NO to not produce a Master List dump for the selected return codes. You can also specify FAIL (at the direction of Support) to have the MUF abend and produce a System dump if the selected return codes are received, and MINIMAL to produce an abbreviated dump for application program debugging (this is not sufficient for Support debugging).
bbbb	YES to produce or NO to not produce a dump of Master List buffers for the selected return codes. You can also specify FAIL (at the direction of Support) to have the MUF abend and produce a System dump if the selected return codes are received.
ee	The Datacom Return Code
iii	The Datacom internal return code in Decimal (not the Hex value)
eeiii-eeiii	A range of Datacom Return codes and internal return codes, separated by a hyphen

Additional Information

For further information on the DBUTLTY COMM function for altering the RCERROR setting, please refer to the following documentation.
DATACOM CORE 15.1:  Reference > DBUTLTY Reference > Utility Function Summary > COMM (Communicate with MUF) > COMM ALTER (Modify Error Table)


For further information on the RCERROR MUF Startup Option, please refer to the following documentation.
DATACOM CORE 15.1: Administrating > Datacom/DB Database and System Administration > Using the Multi-User Facility > Modifying MUF Startup Options > RCERROR