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
Release: DATABB00200-14.0-Datacom/AD
Component:
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 |
| 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 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). |
| 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 CA 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 |
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.1: Administrating > CA Datacom/DB Database and System Administration > Using the Multi-User Facility > Modifying MUF Startup Options > RCERROR
For Version 15.0: Administrating > 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.