Cancels a COBOL program.
call "CBL_CANCEL" using by value flags by reference program-name returning status-code
Using call prototype (see Library Routines - Key) | Picture (32-bit systems) | |
---|---|---|
flags | cblt-x4-comp5250 | pic x(4) comp-5 |
program-name | pic x(n) | pic x(n) |
status-code | See Library Routines - Key |
flags | The type of cancel behavior required. You can set the following bits:
| ||||||||||||||||||
program-name | The space- or null-terminated name of the program you want to cancel. The name can contain spaces as long as it starts with a double quote character ("). |
None.
This routine provides finer run-time control of program cancelation than the COBOL CANCEL statement. It always returns zero, whether or not it was successful.
Any imported .dll files are automatically removed from memory when the .dll file which imports them is cancelled.