CXML-RELEASE-PARSER

Releases memory allocated by parsing.

Syntax:

CALL "C$XML" USING CXML-RELEASE-PARSER, handle

Parameters:

CXML-RELEASE-PARSER Op-code 2. Numeric data item that specifies the operation to perform. Each operation is defined in acucobol.def, which is included with your system.
handle USAGE handle

On Entry:

CXML-RELEASE-PARSER Value 2
handle The parser handle returned by CXML-PARSE-FILE, CXML-OPEN-FILE, CXML-PARSE-STRING, or CXML-NEW-PARSER.

On Exit:

None  

Comments:

This operation releases memory allocated by parsing. The passed handle is zeroed by this call.

Note: Failing to call with this op-code results in a memory leak.

Example:

working-storage section.
01 parser-handle usage is handle.
COPY "acucobol.def".
procedure division.
main-logic.  
*Release parser 
   call "C$XML" using CXML-RELEASE-PARSER, parser-handle