DBUTLTY EDIT shows CC=0 even if *****- ERROR or *** INVALID KEYWORD is produced


Article ID: 4285


Updated On:


CA Datacom CA DATACOM - AD CA CIS CA Common Services for z/OS CA 90s Services CA Database Management Solutions for DB2 for z/OS CA Common Product Services Component CA Common Services CA Datacom/AD CA ecoMeter Server Component FOC CA Easytrieve Report Generator for Common Services CA Infocai Maintenance CA IPC Unicenter CA-JCLCheck Common Component CA Mainframe VM Product Manager CA Chorus Software Manager CA On Demand Portal CA Service Desk Manager - Unified Self Service CA PAM Client for Linux for zSeries CA Mainframe Connector for Linux on System z CA Graphical Management Interface CA Web Administrator for Top Secret CA CA- Xpertware


In DBUTLTY, each function will produce its own completion code. Here, since the EDIT function itself completed successfully, even if the results of the EDIT showed problems, the completion code will be zero. The output of the EDIT function should be seen as a report, with any *****- ERROR or *** INVALID KEYWORD items seen as details on that report.



Release: DBCISF00200-15.1-Datacom-Database-Option for CICS Services


While having a different completion code for errors could make it easier to identify some syntax problems, it is important to note that not every possible failure can be tested with EDIT (due to files and databases not being opened). Therefore, using a CC of other than zero to indicate a problem can set a false expectation, as an EDIT can complete with CC=0 but the command could later fail upon execution.

As the description of EDIT says, "This function does not attempt to verify that any database, area, or table specified in the input actually exists. The editing is for most conditions, but not every edit occurs when the function is completely processed."

Additional Information

For more information about the DBUTLTY EDIT function, please see the following documentation:

CA Datacom/DB Version 14.02 DBUTLTY Reference Guide, in the section "EDIT (Validate Syntax)"

CA Datacom/DB Version 15.0 Docops Space, on the page "> Reference > DBUTLTY Reference > Utility Function Summary > EDIT (Validate Syntax)"

CA Datacom/DB Version 15.1 Docops Space, on the page "> Reference > DBUTLTY Reference > Utility Function Summary > EDIT (Validate Syntax)"

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