1. Home
  2. RECORD directive

RECORD directive

Dumps a job so that it can later be restarted by a RESUME statement.

Option

CHANNEL = scalar Channel number of the backing-store file where information is to be dumped; default 1

No parameters

Description

The RECORD directive sends all the relevant information about the current state of your Genstat job to the backing-store file specified by the CHANNEL option. You can then use the RESUME directive, either later in your program, or during a completely different Genstat run, to recover all this information and continue your use of Genstat from that point. This can be useful if you need to abandon an analysis and resume it at some later date, or if you want to save the current state of a program in case your next operations turn out to be unsuccessful. The information includes the attributes and values of all your data structures, procedures, and the current graphics settings, but no details are kept of the files that are open on any of the channels. If you use RECORD with the same channel number again, the earlier information is overwritten.

Option: CHANNEL.

Parameters: none.

See also

Directives: RESUME, OPEN.

Commands for: Input and output.

Example

" Example 1:3.6.2 "
OPEN 'DUMP.GBS'; CHANNEL=1; FILETYPE=backingstore
VARIATE [VALUES=1,2] A
RECORD
PRINT A
CLOSE 1; FILETYPE=backingstore
ENDJOB
OPEN 'DUMP.GBS'; CHANNEL=1; FILETYPE=backingstore
RESUME
CALCULATE A = A+1
PRINT A
CLOSE 1; FILETYPE=backingstore; DELETE=yes
Updated on March 6, 2019

Was this article helpful?