LIST directive

Lists details of the data structures currently available within Genstat.

Options

PRINT = string tokens What to print (identifier, attributes); default iden,attr
CHANNEL = identifier Channel number of file, or identifier of a text to store output; default current output file
SYSTEM = string token Whether to include “system” structures with prefix _ (yes, no); default no
SCOPE = string token When used within a procedure, this allows the listing of structures in the program that called the procedure (SCOPE=external), or in the main program itself (SCOPE=global), rather than those within the procedure (local, external, global); default loca

Parameter

    strings Types of structure to list (all, ASAVE, diagonal, dummy, expression, factor, formula, lrv, matrix, pointer, RSAVE, scalar, sspm, symmetric, table, text, tree, TSAVE, tsm, variate, VSAVE); default all

Description

The LIST directive can be used to lists the data structures that are currently available. It is particularly useful when you are working interactively to remind you about the data structures that you have set up, and the identifiers that you have used.

By default LIST prints details of relevant attributes, as well as the identifiers, but this can be controlled using the PRINT option.

The CHANNEL option can be set to a scalar to divert the output to another output channel. Alternatively, it can specify the identifier of text data structure to store the output (and in fact an undeclared structure will be defined as a text, automatically).

The SYSTEM option of LIST controls whether structures whose identifiers begin with the underscore character _ are listed; this character is used as a prefix for example for the specialized structures set up by the Client program in Genstat for Windows, so their inclusion could be confusing.

The SCOPE option can be used within a procedure to list the data structures in the program that called the procedure (SCOPE=external) or in the outermost part of the program (SCOPE=global).

Options: PRINT, CHANNEL, SYSTEM, SCOPE.

Parameter: unnamed.

See also

Directives: DUMP, GETATTRIBUTE.

Commands for: Data structures.

Example

" Example 1:2.11.1 "
VARIATE   [NVALUES=12] Count,Dose
READ      Count,Dose
     3   100   247   600     6   200   171   400
     8   200     5   200   615   600   153   400
     2   100     4   100    38   400   214   600  :
CALCULATE Logcount = LOG10(Count+1)
VARIATE   [NVALUES=12] Fitted
GROUP     Dose; Dgroup
LIST      variate
LIST      factor
Updated on January 16, 2018

Was this article helpful?