cobrescanenv

Causes the run-time system to rescan the environment for COBOL environment strings.

Syntax:
#include "cobenv.h"

int cobrescanenv(void);
Parameters:

None.

Comments:

This function causes the run-time system to rescan the environment for COBOL environment strings, such as file-name mapping entries (that is, dd_ entries). This can be useful if the environment has been changed without the knowledge of the run-time system.

A value of zero is returned on success; any other value indicates an unsuccessful call.

Equivalent COBOL Syntax:

None.

Example:

The following code shows how to set a dd_ environment variable so that an open of file abc will instead open xyz:

cobputenv("dd_abc=xyz"); 
cobrescanenv();
See Also:

The section Filename Mapping in the chapter Filenames in your File Handling book.