NC.RESET

Resets one or more named common sections.

Syntax

NC.RESET {[name {...} || * ]}

nameThe name of a named common section.

Note

Do not include the slashes that are used to specify the common section when declaring variables (see COMMON statement).

* Specifies all named common sections.

If used with no parameters, NC.RESET uses the active select list, if any.

Limited to SYS2 privilege. Only valid in the base context; that is, it has no effect in a PERFORM statement.

NC.RESET clears the specified named common sections, removing any variables they contain. When next used, the variables concerned will be unassigned.

:NC.RESET NC2
Named common 'NC2' has been reset.

Resets named common section NC2.

:NC.RESET *
Named common 'NC1' has been reset.
Named common 'NC2' has been reset.
Named common 'NC3' has been reset.

Resets all named common sections.

:NC.RESET NC1 NC4
Named common 'NC1' has been reset.
Named common 'NC4' is not in use.

Attempts to reset the named common sections NC1 and NC4. The latter does not exist and cannot be reset.