How to manage PXX Master List dumps in CA Datacom

Document ID : KB000103458
Last Modified Date : 26/06/2018
Show Technical Document Details
Introduction:
All of the Return Codes used in CA 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
Instructions:
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:
eeThe Datacom Return Code
iiiThe Datacom internal return code in Decimal (not the Hex value)
bbbYES to produce or NO to not produce a dump of Master List buffers
mmmYES 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
mmmmYES 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 CA 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 CA Support debugging).
bbbbYES 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 CA Support) to have the MUF abend and produce a System dump if the selected return codes are received.
eeThe Datacom Return Code
iiiThe Datacom internal return code in Decimal (not the Hex value)
eeiii-eeiiiA 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.
For Version 15.1:  Reference > DBUTLTY Reference > Utility Function Summary > COMM (Communicate with MUF) > COMM ALTER (Modify Error Table)
For Version 15.0:  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.
For Version 15.1Administrating > CA Datacom/DB Database and System Administration > Using the Multi-User Facility > Modifying MUF Startup Options > RCERROR
For Version 15.0Administrating > CA Datacom/DB Database and System Administration > Using the Multi-User Facility > Modifying MUF Startup Options > RCERROR

As always, please contact CA Technologies support for CA Datacom if you have further questions.