SNAX Connection Manager (SNAX/CM) Manual

General Syntax Notation
Notation Conventions
xiv 097842 Tandem Computers Incorporated
Notation Meaning
Ellipsis ... An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the
enclosed sequence of syntax items any number of times. An ellipsis immediately following a single
syntax item indicates that you can repeat that syntax item any number of times.
Examples:
M address-1 [ , new-value ]...
[ - ] {0|1|2|3|4|5|6|7|8|9}...
" s-char ..."
!i and !o In procedure calls, input parameters (those passing data to the called procedure) are followed by an !i;
output parameters (those that return data to the calling program) are followed by an !o.
Example:
CALL CHECKRESIZESEGMENT ( segment-id !i
, error ) ; !o
!i,o In procedure calls, this comment follows a parameter that is both an input and an output parameter.
You supply an input value before making the call, and the system returns an output value after the
call.
Example:
error := COMPRESSEDIT ( filenum ) ; !i,o
!i:i In procedure calls, this comment follows an input string parameter that has a corresponding parameter
specifying the length of the string in bytes.
Example:
error := FILENAME_COMPARE_ ( filename1 : length !i:i
, filename2 : length ) ; !i:i
!o:i In procedure calls, this comment follows an output buffer parameter that has a corresponding input
parameter specifying the maximum length of the output buffer in bytes.
Example:
error := FILE_GETINFO_ ( filenum !i
, [ filename : maxlen ] ) ; !o:i
Punctuation Parentheses, commas, semicolons, and other symbols not previously described must be entered as
shown. Quotation marks around a symbol such as a bracket or brace indicate the symbol is a
required character that you must enter as shown.
Examples:
error := NEXTFILENAME ( file-name ) ;
LISTOPENS SU $ process-name .# su-name
"[" repetition-constant-list "]"