+ (Add/Positive)

Indicates a positive value (unary +) or adds two values.

Syntax

[expression1]+expression2

The plus sign (+) adds the expression on the right to the expression on the left.

Parameters

expression1a number or expression that evaluates to a number
expression2a number or expression that evaluates to a number

Comments

Arithmetic operators indicate the sign of a number or perform arithmetic operations (addition, subtraction, multiplication, division, exponentiation).

See Also

About Arithmetic Expressions

Rules of Precedence for Arithmetic Operators

$toupper

Converts alphabetic characters to upper case.

Syntax

$toupper(source)

Parameters

sourceany value, or an expression that yields any value

Return Value

Character string, in which all letters are uppercase.

Comments

$toupper returns a character string in which all letters are upper case. If source is not of a character data type, it is converted to a character data type before the function is applied.

Example

$toupper("the QUICK BROWN fox is 30 years oLD")

Evaluates to “THE QUICK BROWN FOX IS 30 YEARS OLD”.

See Also

$tolower

SET HEADINGS

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

SET DOCLINELENGTH

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

Syntax

SET DOCLINELENGTH num

Parameters

num

Num can be
an integer constant (e.g., 15, 200),
a variable, form field, menu item, or parameter that evaluates to an integer.
Num must be between 1 and 32000.

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

$IsConnected

Tests if Zim is connected to a particular server.

Syntax

$isconnected(string)

Parameters

stringa character string or an expression that evaluates to a character string

Return Value

1-character binary string. Evaluates to 1 ($True) if Zim is connected to the server name contained in string; if the server name is invalid or there is no connection,  evaluates to 0 ($False).

Example

$isconnected("ZIMSERV")

Evaluates to $True if a previous CONNECT statement to ZIMSERV was successfully issued.

See Also

CONNECT

DISCONNECT

$day

Extracts the day number associated with a specified date value.

Syntax

$day(date)

Parameters

datea data, or an expression that evaluates to a date, in the form YYYYMMDD

Return Value

Character string.

Comments

This function extracts day information from standard date values. Date is often the system variable $Date.

Example

$day(19981225)

Evaluates to “25”.

$day($date+7)

Evaluates to “1” when $Date is 19991225.

See Also

$adddays

$Date

$dayname

$month

$monthname

$weekday

$year

SET SQLTRACE

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

SCREEN RESET

Resets the application window (BACKSCREEN) by re-displaying all active windows over it.

Syntax

SCREEN RESET

Comments

The SCREEN RESET command reverses a SCREEN CLEAR command by hiding the application window (BACKSCREEN) beneath all other active windows and making it the least current window.

During an input request, the Ctrl-R key sequence entered by the user has the same effect as SCREEN RESET.

Example

SCREEN RESET

is equivalent to the following sequence of commands:

window clear backscreen

window set not current backscreen

window display backscreen hide

screen clear   % clear prev. data & expose application window

output “Output to printer? (y/n)” ;

input Response

if Response = “y”

set output printer

endif

screen reset

 

See Also

FORM INPUT

pt_BRPortuguese