User Manual

Line Spacing

If the syntax of a command is too long to fit on a single line, each continuation line is indented

three spaces and is separated from the preceding line by a blank line. This spacing distinguishes

items in a continuation line from items in a vertical list of selections. For example:

ALTER [ / OUT file-spec / ] LINE

[ , attribute-spec ]…

!i and !o

In procedure calls, the !i notation follows an input parameter (one that passes data to the called

procedure); the !o notation follows an output parameter (one that returns data to the calling

program). For example:

CALL CHECKRESIZESEGMENT ( segment-id !i

, error ) ; !o

!i,o

In procedure calls, the !i,o notation follows an input/output parameter (one that both passes

data to the called procedure and returns data to the calling program). For example:

error := COMPRESSEDIT ( filenum ) ; !i,o

!i:i

In procedure calls, the !i:i notation follows an input string parameter that has a corresponding

parameter specifying the length of the string in bytes. For example:

error := FILENAME_COMPARE_ ( filename1:length !i:i

, filename2:length ) ; !i:i

!o:i

In procedure calls, the !o:i notation follows an output buffer parameter that has a corresponding

input parameter specifying the maximum length of the output buffer in bytes. For example:

error := FILE_GETINFO_ ( filenum !i

, [ filename:maxlen ] ) ; !o:i

Notation for Messages

This list summarizes the notation conventions for the presentation of displayed messages in this

manual.

Bold Text

Bold text in an example indicates user input typed at the terminal. For example:

ENTER RUN CODE

?123

CODE RECEIVED: 123.00

The user must press the Return key after typing the input.

Nonitalic Text

Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly

as shown. For example:

Backup Up.

Italic Text

Italic text indicates variable items whose values are displayed or returned. For example:

p-register

process-name

[ ] Brackets

Brackets enclose items that are sometimes, but not always, displayed. For example:

Event number = number [ Subject = first-subject-value ]