LOADSERIES

Purpose:

Loads Series1...SeriesN from a Dataset into a list of Windows.

Syntax:

LOADSERIES(W1, ..., WN, "ser1", ..., "serN", overwrite, onewin, usecolor)

W1, ..., WN

Optional. A window list, the list of target Windows to load the series into. Defaults to the current window.

"ser1", ..., "serN"

One or more strings. A list of series to load.

overwrite

Optional. An integer, the overwrite existing Window series flag.

0:	do not overwrite existing series in a Window (default).
1:	overwrite existing series in a Window.

onewin

Optional. An integer, the flag to load the series into the current Window or to load each series into consecutive Windows.

0:	Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, verifies to add the required amount of Windows up to the maximum (Default).
1:	Loads all the series into the specified or default Windows. The result is a multi-column Window. The overwrite flag is ignored.
2:	Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, automatically adds the required amount of Windows (up to the maximum) without verification.
3:	Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, prompts the user to specify the number of Windows to add.
4:	Loads all the series into the specified Window as a multi-channel stripchart.

usecolor

Optional. An integer, the color flag.

0:	load series using the default color (default).
1:	load multiple series with different colors.

Example:

loadseries("MYSERIES.1.SERIES")

loads the series MYSERIES.1.SERIES into the current Window.

Example:

loadseries(W1, W4, W5, "D.1.S1", "D.1.S2", "D.1.S3")

loads D.1.S1, D.1.S2, and D.1.S3 into W1, W4, and W5 respectively.

Example:

loadseries(W2..W5,"D.1.S1","D.1.S2","D.1.S3","D.1.S4",1)

loads the series in W2 through W5 and automatically overwrites the previous series in the Windows if they exist.

Remarks:

The specified series name is case sensitive.

If a specified Window already contains a series, LOADSERIES by default prompts the user for overwrite permission. LOADSERIES also accepts an optional overwrite flag to automatically overwrite existing series in a Window without prompting.

If a version number is not specified in the Dataset name, the series from the last available version for the Dataset is loaded. A version number of –3 also implies last version.

A version number of 0 implies load the series from the first available version of the Dataset.

See LOADDATASET to load all the series in a Dataset into one or more windows.

LOADSERIES

Purpose:

Syntax:

Example:

Example:

Example:

Remarks:

See Also: