Cancels a program previously loaded by the COBOL run-time system.
Restriction: This function is supported for native COBOL only.
Syntax:
#include "cobcall.h"
void cobcancel (const cobchar_t *name);
Parameters:
|
name
|
A null terminated string that specifies the name of the COBOL program to be canceled. |
Equivalent COBOL Syntax:
cancel "name"
Example:
To cancel the COBOL entry point cobep:
cobcancel("cobep");
Comments:
If name is a COBOL program, the data contained in the program is returned to its initial state as defined for the COBOL CANCEL verb.
If name is a C function then its data is unchanged.
If name does not correspond to any loaded COBOL entry point or C function no action occurs and this function returns as normal.