Close (Dataset subroutine)

From m204wiki
Revision as of 16:56, 20 May 2011 by JAL2 (talk | contribs)
Jump to navigation Jump to search

This subroutine closes a dataset object.

Close syntax

%dataset:close

Syntax terms

%dataset A variable containing a reference to a Dataset object to be closed.

Usage Notes

  • A Close of an output dataset ensures that all output data is written to disk.
  • A Close of a dataset releases any internal locks on the underlying dataset or stream. This allows another thread or user to access the dataset.
  • A dataset object that is Closed can be re-Opened. If the object is re-Opened in input mode, it will be re-opened at the beginning, not where it left off at the time of the Close. If the object is re-opened in output mode, it will either write over the start of the file or append to the end, depending on whether or not the dataset or stream definition indicates append mode (DISP MOD).