A -- Logic Commands

Abort

Terminates current transactions and restores the database.

ABORT [ literal [ literal | object_name] ]

OptionDescription

literal

The message to display as a string expression.

This parameter is restricted to a maximum length of 50 characters.

literal or object_name

The name of an ispec to recall following termination.

Accept

Passes information to a running report from its initiating terminal.

ACCEPT object_name 
OptionDescription

object_name

The variable receiving input.

AccessExt

The AccessExt logic command is not supported on applications deployed to Windows. Enables an MCP-based system user to inquire on a different DMS II database.

ACCESSEXT [ <Database> ] [ <locator> ]
<Database> = DB1 | DB2
<Locator> = <Find> | <Get>
<Find>  :=  FIND “<FindExpression>”
<Get> :=  GET “<GetExpression>” [ variable ]
<FindExpression> := [ FIRST | LAST | NEXT | PRIOR ] { database | dataset | 
index } [ expression | link ]
<GetExpression> := { database | dataset } { alphabetic_item | group_item | 
number_item | real_item | field_item  | count_item | recordtype_item }  
[ [ subscript ] ] 
OptionDescription

FindExpression

The command required to locate and read a record from the database. The data in the record is not directly available to commands.

GetExpression variable

The command required to access data in a database record previously read using a find statement, and to move its value into a variable.

Add

Adds the value of a numeric expression to the value of a number-primitive variable, and stores the result in that variable, or optionally in a specified result variable

ADD expression variable [ GIVING variable ] [ ROUNDED ] [ GS status ]
OptionDescription

expression variable

The numeric expression and qualifier to add together. The qualifier also receives the result if the Giving command option is not specified. If the Giving option is specified then qualifier might be replaced by an expression.

(GIVING or GIV variable)

Directs the result to the specified qualifier.

(ROUNDED or ROU)

Rounds the result when truncation occurs.

GS status

Indicates arithmetic overflow using the specified variable.

Advance

Used in reports to advance a named outputstream, or the default outputstream, to a new page, or by a specified number of lines between frames. It can also be used to advance the outputstream to a specified printer channel number when printed.

ADVANCE { numeric_literal | NEWPAGE | CHANNEL numeric_literal } [AS  outputstream]
OptionDescription

numeric_literal

The number of lines to advance.

NEWPAGE

Advances the report to a new page.

CHANNEL numeric_literal

Advances the outputstream to the channel number specified by the numeric literal.

This command option is restricted to reports directed to an LP device. It is intended for printing on special stationery.

AS outputstream

Restricts the effect of this logic command to the specified outputstream. If omitted, the default outputstream is affected.

Attach

Concatenates the value of a variable or literal to that of a second variable after the last non-whitespace character, and stores the result in the second variable. Embedded whitespace characters in both variables are retained.

ATTACH  string_expression variable
OptionDescription

string_expression

The string or numeric value to attach to the following result qualifier. If a numeric value is used, it is converted to text.

If it is a number-primitive variable, it cannot have decimals declared.

variable

The result variable.

AttachAndSpace

Concatenates the value of a variable or literal to that of a second variable after the last non-whitespace character, inserting a space between the two values, and stores the result in the second variable.

ATTACHANDSPACE string_expression variable
OptionDescription

string_expression

The string or numeric value to attach to the following result qualifier. If a numeric value is used, it is converted to text.

If it is a number-primitive variable, it cannot have decimals declared.

variable

The result variable.

If the value of this variable is equal to Glb.Spaces, the result is the value of the first qualifier or literal (without leading spaces, unless it contains leading spaces).

Attribute

The Attribute logic command is not supported on applications deployed to Windows. It is valid only for MCP-based systems.

ATTRIBUTE BDNAME literal [ usercode ] [ GS status ]
OptionDescription

BDNAME literal 

Expression that holds the BDNAME attribute. Non-literal values must be terminated with a period (.). This is illustrated in the examples of this command.

The maximum length of the BDNAME is 180 characters. For a literal, the maximum length is 58 characters (56 characters if a usercode is supplied).

usercode

Literal that contains a usercode. If omitted, the file is produced with the same usercode with which the Report is running. The Report program must be privileged, or running under a privileged usercode, in order to produce a file under a different usercode (otherwise, the Report terminates).

GS status

Indicates command status using the specified variable.