Created On:  29 July 2011

Problem:

There is a problem with the Visual COBOL R4 documentation for using the RM compatible C$RERR routine.

The documentation states:

Configuring the RM/COBOL File Handler 

In acurmfm.cfg, set the file handler.

DEFAULT_FILESYSTEM RMFM
To retrieve RMFM file status codes or call C$RERR in your COBOL programs:
In acurmfm.cfg, set the following environment variables.

set CONVERTSTATUS=rmstat
set COBCONFIG=cobconfig.cfg  *> cobconfig.cfg is your MF COBOL run-time configuration file.
In cobconfig.cfg, set the following environment variable:

set ACU_LIBRARY=TRUE
-------------------------------------------------------
This does not work.

Resolution:

The COBCONFIG and CONVERTSTATUS environment variables must actually be set in the computers environment instead of in the acurmfm.cfg file.  If you follow the instructions in the documentation you will get a Runtime Error 173 on the call to C$RERR.

If the COBCONFIG and CONVERTSTATUS environment variables are set in the computers environment using Control Panel > System > Advanced > Environment Variables then everything works fine.
Incident #2527262