Guardian Procedure Calls Reference Manual

$process-name.#su-name

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:length1 !i:i

, filename2:length2 ) ; !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 Management Programming Interfaces

This list summarizes the notation conventions used in the boxed descriptions of programmatic

commands, event messages, and error lists in this manual.

UPPERCASE LETTERS

Uppercase letters indicate names from definition files. Type these names exactly as shown. For

example:

ZCOM-TKN-SUBJ-SERV

lowercase letters

Words in lowercase letters are words that are part of the notation, including Data Definition

Language (DDL) keywords. For example:

token-type

The !r notation following a token or field name indicates that the token or field is required. For

example: