:CLOSE_PROCESS

Use the :CLOSE_PROCESS script statement to discard a data sequence in a script. Discarding the data sequence releases memory and lets you assign new values to script variables that include a reference to a data sequence. After you have closed a process, the script variable is empty again.

This script statement is important for complex processing in scripts where you use data sequences within data sequences.

For an overview of script elements that retrieve data sequences, see Script Elements for Data Sequences.

Syntax

:CLOSE_PROCESS Data sequence reference

Parameters

• :CLOSE_PROCESS
  Discards a data sequence

• Data sequence reference
  Script variable that references the data sequence to discard
  Format: script variable

Example

The following script stores a reference to a data sequence in a script variable (&HND#), writes the retrieved content into a file for a subsequent job, and then discards the data sequence.

:SET &HND# = PREP_PROCESS_VAR('TEST.VAR')

:SET &RET# = WRITE_PROCESS(&HND#, &fullfile#, &agent#, &login#)

:CLOSE_PROCESS &HND#

See also: