!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
The following 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.
lowercase italic letters
. Lowercase italic letters indicate 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 ]
A group of items enclosed in brackets is a list of all possible items that can be displayed, of which
one or none might actually be displayed. The items in the list might be arranged either vertically,
with aligned brackets on each side of the list, or horizontally, enclosed in a pair of brackets and
separated by vertical lines. For example:
proc-name trapped [ in SQL | in SQL file system ]
{ } Braces
. A group of items enclosed in braces is a list of all possible items that can be displayed,
of which one is actually displayed. The items in the list might be arranged either vertically, with
aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated
by vertical lines. For example:
obj-type obj-name state changed to state, caused by
{ Object | Operator | Service }
process-name State changed from old-objstate to objstate
{ Operator Request. }
{ Operator Request. }
| Vertical Line
. A vertical line separates alternatives in a horizontal list that is enclosed in brackets
or braces. For example:
Transfer status: { OK | Failed }
% Percent Sign.
A percent sign precedes a number that is not in decimal notation. The % notation
precedes an octal number. The %B notation precedes a binary number. The %H notation precedes
a hexadecimal number. For example:
%005400
%B101111
%H2F
P=%p-register E=%e-register
22
