SET DOCUMENT FORMAT

Sets the format of the application document.

Syntax

SET DOCUMENT FORMAT UTF-8|ANSI|DBCHARSET

Parameters

UTF-8Selects the UTF-8 character set and writes a UTF-8 BOM at the beginning of the file.
ANSISelects the ANSII character set.
DBCHARSETSelects the character set used by the current database.

Comments

Identifies the character set used by application documents.

See Also

$DBCharSet

SET MESSAGES WINDOW

Activates or deactivates the use of the message window for system messages.

Syntax

SET MESSAGES WINDOW ON|OFF

Comments

The MESSAGES WINDOW option is set OFF by default.

When MESSAGES WINDOW is OFF, system messages are displayed line-by-line in the application window (BACKSCREEN). By setting MESSAGES WINDOW ON, you enable a pop-up window for the display of all system messages that are not currently suppressed.

 

See Also

SET ERRORS

SET INFORMATION

SET MESSAGES

SET OUTPUT

SET WARNINGS

SET CURRENTSET

Makes a specified result set the current set.

Syntax

SET CURRENTSET setname

Parameters

setname

The name of an existing result set.

Comments

Normally, the current set is the result set produced as a result of the last FIND command executed. SET CURRENTSET enables you to select another existing result set to use as the current set.

The SET CURRENTSET command takes effect immediately upon parsing or compilation, not just when the compiled program is executed.

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

Example

procedure test3 (a,b)
 if a = b
  find Employees -> EmpSet
 else
  find Departments -> DeptSet
 endif
 if a = b
  set currentset EmpSet
  let a = LastName
 endif

The SET CURRENTSET command ensures that the correct set is recognized as the current set.

SET OUTPUT FIELDLISTWIDTH

Specifies how a field’s ListWidth is treated in a LIST command.

Syntax

SET OUTPUT FIELDLISTWIDTH ON|OFF

Comments

The OUTPUT FIELDLISTWIDTH option is set ON by default.

When OUTPUT FIELDLISTWIDTH is ON, the LIST command formats output according to each field’s established ListWidth. Setting FIELDLISTWIDTH to OFF causes the software to ignore the established ListWidth and to format all fields to their maximum length. Fields with an established ListWidth of -1 therefore appear in the output.

 

See Also

LIST

SELECT

SET SPECIALSCAN

Controls how special characters in unstructured application documents are treated.

Syntax

SET SPECIALSCAN ON|OFF

Comments

The SET SPECIALSCAN command is set ON by default.

When SPECIALSCAN is ON, the backslash () and asterisk (*) characters have special meanings when they appear in an unstructured application document that is being used as a data source in an ADD or CHANGE command. Setting SPECIALSCAN to OFF causes the backslash and asterisk to be treated as normal characters by these commands.

 

See Also

ADD

CHANGE

SET DELIMITER

SET EOLNTRANSLATE

Translates carriage return/line feed sequences.

Syntax

SET EOLNTRANSLATE string

Parameters

string

Any expression that evaluates to a character string from one to five characters in length. If string is longer than five characters, only the first five characters are used.

Comments

If the software encounters a carriage return/line feed combination in a database field when outputting that field to an application document, the carriage return/line feed combination is substituted for string. If the software encounters string during a read of an application document, the string generates a carriage return/line feed combination.

In operations that write data to an application document, the software substitutes the specified EOLTRANSLATE string for each carriage return/line feed sequence detected in the output from a single field. In operations that read data from an application document, the software substitutes a carriage return/line feed sequence for each EOLTRANSLATE string it detects in a single field.

SET RUNTIME

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

SET STRATEGY

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

SET XMLHEADER

Controls the display of a XMLHEADER.

Syntax

SET XMLHEADER ON|OFF

Comments

When outputting data using the XML or XMLSIMPLE formats, a standard ISO header can be attached to the resulting document.

Example

set save

set output format xmlsimple

set XMLHEADER on

set output MyDoc

list 1 Docs

set restore

 

See Also

SET OUTPUT FORMAT

SET CURSOR

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

en_CAEnglish