TOP

Moves the current member pointer to the first member in a result set.

Syntax

TOP [setname]

Parameters

setname

The name of a result set. If setname is omitted, the current set is used.

Comments

The TOP command moves the current member pointer to the first record in the current set.

 

See Also

$currentmember

BOTTOM

DOWN

LOCATE

NEXT

PREVIOUS

UP

SLEEP

Suspends the execution of an application for a specified period of time.

Syntax

SLEEP seconds

Parameters

seconds

A number, or an expression that evaluates to a number, representing the number of seconds to “sleep”.

Comments

When the SLEEP command is encountered in a procedure, execution is suspended for the specified number of seconds. If seconds is negative, zero, or $Null, execution is not suspended.

 

See Also

PAUSE

PAUSE

Causes execution to be halted and a message to be output.

Syntax

PAUSE

Comments

When the software encounters a PAUSE command, it halts execution (pauses) and displays the message:

Press to continue.

Pressing Enter causes execution of the current application program to resume at the command that follows the PAUSE.

The SET PAUSE command governs pauses during output from the LIST and OUTPUT commands. A PAUSE feature is also built into the REPORT FROM command.

The PAUSE message can be altered using the Language Customizer utility.

 

See Also

FORM INPUT

INPUT

SLEEP

STOP

Ends execution of an application program and returns to the main prompt level.

Syntax

STOP

Comments

The STOP command stops execution of the current application program and returns control to the main prompt level (i.e., outside any application program). STOP is equivalent to BYE when used in a fully compiled application running under the Runtime system.

Example

find all Employees where Salary > 10000

if $setcount = 0

 stop

endif

The preceding command returns control to the main prompt level when no set results from the execution of a FIND command.

 

See Also

BYE

RETURN

TRANSFORM

QUITTRANSACTION

Marks the end of a transaction in progress, discarding the results.

Syntax

QUITTRANSACTION

Comments

The QUITTRANSACTION command ends the explicit transaction in progress and discards any changes or updates made to the database since the TRANSACTION command was issued.

The QUITTRANSACTION command is ignored in single-user environments. In multi-user systems, QUITTRANSACTION takes effect only if an explicit transaction is in progress.

The QUITTRANSACTION command sets the system variable $InTransaction to “0” ($False).

 

See Also

BEGIN WORK

COMMIT WORK

ENDTRANSACTION

ROLLBACK WORK

SET TRANSACTION FLOW

CONTINUE

Restarts a WHILE loop.

Syntax

CONTINUE

Comments

Any IF or CASE statements that are still open when a CONTINUE command is executed are automatically closed off when execution returns to the start of the WHILE loop.

Example

while Salary > 20000

  … other commands …

if var1 = 1

continue

else

  … more commands …

endif

… still more commands …

endwhile…

commands after the while loop …

If var1 is currently set to 1, execution returns to the WHILE command. All commands between CONTINUE and ENDWHILE are ignored, and the “open” IF statement is automatically closed.

 

See Also

BREAK (Loops)

GOTO

NOT

Performs a Boolean NOT of a logic expression.

Syntax

NOT expression

Parameters

expression

A logic expression using conditional and Boolean operators. If the expression is complex, it must be enclosed in parentheses.

Return Value

Logical.

Comments

If expression is logically true, the entire expression, including the NOT, is logically false.

If expression is logically false, the entire expression, including the NOT, is logically true.

Example

not Population > 250000

 

See Also

Boolean Expressions

Conditional Expressions

UNCOMPILE

Uncompiles an application program.

Syntax

UNCOMPILE progdocname

Parameters

progdocname

The name of the application document containing the program to be “uncompiled”.

Comments

The UNCOMPILE command marks the specified application program as “not compiled”. If progdocname had not been compiled (using the COMPILE command) when the UNCOMPILE was issued, the software raises a warning.

The UNCOMPILE command has no effect on the disk file that contains the compiled version of the program, but prevents the file from ever being used.

 

See Also

$compilestatus

COMPILE

SET RUNTIME

SET SQLCOMPILE

pt_BRPortuguese