Determines if compiled versions of application programs are to be executed.

Syntax

SET [LOCAL] RUNTIME ON|OFF

Comments

Specifies if the Runtime system is to be available for program execution. When RUNTIME is set OFF, compiled programs are treated as if they are not compiled.

A SET LOCAL RUNTIME command can be used inside a program to make the Runtime system locally available to that program when RUNTIME is globally switched off. If that program subsequently calls another program, however, the Runtime system is unavailable within the second program.

The SET RUNTIME command is not affected by the SET RESET and SET RESTORE commands.

See Also

COMPILE

TRANSFORM

UNCOMPILE

Controls tracing of retrieval strategy information.

Syntax

SET STRATEGY ON|OFF

Comments

The SET STRATEGY command is OFF by default.

When SET STRATEGY is set ON, the software displays the chosen retrieval strategy for each command that accesses the database (i.e., FIND, COMPUTE, LIST, REPORT FROM, CHANGE, ADD, DELETE, SELECT, UPDATE). The retrieval strategy information is written to the destination specified in the last SET TRACE OUTPUT command.

See Also

ADD

CHANGE

DELETE

FIND

LIST

REPORT FROM

SELECT

SET SELECTIVITY

SET SIZE

SET TRACEOUTPUT

UPDATE

Switches the display of the text-entry cursor on or off.

Syntax

SET CURSOR ON|OFF

Comments

The CURSOR option is set ON by default.

When CURSOR is ON, the text-entry cursor is displayed on the screen when a text form field has focus. You can switch the text-entry cursor off when its logical location is already indicated by enhanced display attributes in the form field (specified using the FORM SET command). For example, you could switch the text-entry cursor off in menus.

Some terminal types do not enable the text-entry cursor to be switched off; in these cases, SET CURSOR OFF has no effect. In some environments with attached terminals, the sequences that turn the text-entry cursor on and off must be included in your terminal description file.

See Also

CURSOR

SET SQLTRACE

Controls the tracing of software-generated SQL commands.

Syntax

SET SQLTRACE ON|OFF

Comments

The SQLTRACE option is set OFF by default.

When SQLTRACE is switched ON, all SQL statements generated are displayed at the terminal. SQL statements are generated during command or program parsing, interactive or interpretive execution, and compiling, if a command statement refers to an EntitySet or relationship identified as being managed by an SQL database server.

Example

> set sqltrace on
> list all Customers format CC LastName
select cc, lastname from customers

When the software parses, executes, or compiles the statement list all Customers format CC LastName with SQL tracing set on, select cc, lastname from customers appears at the terminal.

See Also

COMPILE

PARSE

SET COMPILEMODE

SET EXECUTEMODE

UNCOMPILE

Adjusts the size of the internal data buffer used to read unstructured application documents.

Syntax

SET DOCLINELENGTH num

Parameters

Comments

At the start of an application session, DOCLINELENGTH is determined by the applicable document line length configuration option. If no document line length is explicitly specified, 256 is used by default.

The current value of DOCLINELENGTH is saved by the SET SAVE command, and restored by the SET RESTORE command. The SET RESET command resets DOCLINELENGTH to its configured or default value.

See Also

SET SPECIALSCAN

Controls the display or suppression of headings in LIST command output.

Syntax

SET HEADINGS ON|OFF

Comments

The HEADINGS option is set ON by default.

When you set HEADINGS OFF, output from the LIST and SELECT commands omits field headings from the columns displaying each field’s contents.

The HEADINGS setting affects the width of the columns output by LIST and SELECT. When headings are ON, the longer of the field’s width or its heading is used as the character width of the column in which the field’s content appears. When headings are OFF, the field’s width is always used to set the character width of the column.

Example

set output ExportDoc
set headings off
list all Employees
set output terminal

The SET HEADINGS command is used to suppress headings when the output of a LIST command is being sent to a file.

See Also

LIST

SET PAGESIZE

SET PAUSE

Steps through a procedure one command at a time, halting after each command.

Syntax

SET SINGLESTEP ON|OFF

Comments

When SINGLESTEP is switched ON, execution is halted (by the HALT utility) after each command executed. To resume execution after the HALT, press Enter at the HALT prompt (>>).

Compiled application programs are not affected by SET SINGLESTEP.

The SET SINGLESTEP command is not affected by the SET RESET and SET RESTORE commands.

Example

To switch to singlestep, use

> set trace on
> set singlestep on

Now, if you execute an application program, it looks like this:

> DoCusts (“edit”)
procedure DoCusts (in ExMode)
>>output $setcount
35
>>(carriage return)
let dp = $true
>>.
.
.

See Also

SET STOP ERRORS

Controls command tracing.

Syntax

SET [LOCAL] TRACE ON|OFF

Parameters

Comments

The SET TRACE command controls command tracing. When TRACE is switched ON, each line of a procedure is displayed as it is executed. Each line is preceded by the procedure name and document line number as shown in the following example:

pCustReport[19] report from Customers

SET TRACE has no effect on compiled application programs.
SET TRACE is not affected by the SET RESET and SET RESTORE commands.

Example

To display the instructions in the procedure MyProg as they are executed, use

set trace on
MyProg

See Also

SET COMMANDTIMING

SET LEXTRACE

SET TRACEOUTPUT

Specifies an end-of-file indicator for application documents.

Syntax

SET EOFVALUE character_constant|OFF

Parameters

Comments

The EOFVALUE option is set OFF by default (no character is recognized as an end-of-file).

The EOFVALUE option enables you to specify one or more characters that are to be recognized as an end-of-file indicator when the software reads an application document.

When reading input from the terminal as an application document, the software always recognizes a zero-length line as an end-of-file. The software also recognizes real end-of-file conditions, independent of the setting of EOFVALUE.

Example

set eofvalue “xyz”
add DataCollected from SerDevice
set eofvalue off
% batch complete – do something else

Assume that a device attached to your computer has been defined as an application document called SerDevice. The device is collecting data and sending it to your computer in batches that are terminated with a record containing the characters “xyz”. The above commands read the data without waiting between batches.

Controls required field checking for EntitySets and relationships with fields.

Syntax

SET CHECKNULLS ON|OFF

Comments

The CHECKNULLS option is set ON by default.
When CHECKNULLS is ON, an error results if a Required field is assigned the $Null property during an ADD, CHANGE, INSERT, or UPDATE command. Normally, you should always leave CHECKNULLS set ON.
Even if you switch null checking OFF, you should always explicitly or implicitly assign some value to every required field.

Note: A field is Required if its definition in the Object Dictionary specifies yes for Reqd.

See Also

ADD

CHANGE

INSERT

UPDATE