dataset

structure

A Garfield library has a file name which identifies it to the operating system. The file consists internally of a series of members. A member has a name and a type, neither of which needs to be unique, and may optionally also have a remark attached to it for ease of identification.

Additional information on:

file	member
type	remark

DEFAULT

Is very similar to Vax/VMS SET DEFAULT command: it enables setting defaults for any component of Vax/VMS file names (node, disk, directory, file name, file type and version number) and of VM/CMS file names (file name, file type and file mode).

This command can not be issued from within a dataset subsection.

Format:

% DEFAULT file_specification

Examples:

% DEF
% DEF 'VAXODIE::'
%default .GARFLIB

The first example shows the current default, the second tells Garfield that it should try to find the files on the node called VAXODIE (note the quotes, the colons are separators and would be discarded without the quotes). The last example ensures that the libraries to be read and written have extension GARFLIB.

DELETE

Marks a member in a dataset for removal. This makes the member invisible for commands like GET, but does not remove the member from the file.

Removing members physically from a dataset is done by PURGE . RECOVER will undo a %DELETE.

Both the member and the type may be wildcards (a * matches every string).

Format:

%DELETE file member [type]

DUMP-HELP-FILE

Prints the complete contents of the help file, this command does not exist on Vax computers.

Beware ... this command will generate a huge amount of output !

EXIT

Leaves a dataset subsection. You enter a dataset subsection by typing only a % sign with further arguments. Within such a section, no other subsections may be entered, neither may you leave the calling section from within the subsection.

Format:

EXIT

INDEX

Produces a directory listing of members in a file.

The member and type, if you enter them at all, may be wildcards, i.e. a * matches any number of every character. Only the members that match both will be in the list.

Also the INQUIRE_MEMBER procedure can be used to determine whether a member exists in a dataset.

Format:

%INDEX file [member] [type]

LIST

Displays the contents of one or more members contained in a Garfield file. You may optionally request listing of only one type of member.

One can re-rout the output of this command to a file.

Both the member and the type may be of the wildcard type (a * matches any string).

Format:

%LIST file [member] [type]

PACK-HELP-FILE

Packs the readable help file into a direct access file which is used by the on-line help utility. There should be no need to execute this command at CERN. Elsewhere, it has to be executed only once when a new release of the help file is distributed.

The VMS help utility is used on Vax computers. This instruction will therefore create a help library rather than a direct access dataset on such devices.

Before this command is executed, one has to ensure that the readable (or raw) help file is available. It is distributed as:

CMS: GARFIELD RAWHELP
Apollo, Cray, Sun: help_raw$garfield
Vax: GARFIELD.HLP (accessed as HELP_RAW$GARFIELD)

This command is not executed if a direct access help file exists when the command is entered, except on Vax where a new version of the library is generated.

PURGE

This instruction removes deleted members from a file. No recovery is possible, unless you made a backup yourself.

Member and type are not specified on this command.

Format:

%PURGE file

RECOVER

Recovers deleted members from a file that has not yet been purged.

Both the member and the type may be wildcards (a * matches every string).

Format:

%RECOVER file member [type]

Go to the top level, to dataset, to the topic index, to the table of contents, or to the full text.

Formatted on 21/01/18 at 16:55.