New (Dataset constructor)

From m204wiki
Jump to navigation Jump to search

Create a new dataset object (Dataset class)


This constructor creates a new instance of a Dataset object.

Syntax

%dataset = [%(Dataset):]New( string)

Syntax terms

%dataset A variable to receive a reference to the newly created

Dataset object.

%(Dataset) The class name in parentheses denotes a ÝÝNotation conventions for methods#Shared methods|shared¨¨ method.
dsname The name of the dataset or stream to be associated with the Dataset

object. This is a required argument.

Usage notes

  • The dataset name must be 8 characters or shorter and cannot contain leading or intermediate blanks. It also cannot contain other characters not allowed in dataset or stream names. Failure to conform to these rules results in request cancellation.
  • The New constructor does not validate that the Dataset is allocated or the stream defined. This is because a dataset can be allocated or freed before it is actually opened, or a stream could be defined or deleted before it is opened. As such, checking dataset or stream existence at New time wouldn't be a reliable check, so it is not done.

See also