OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual528611-001
4-11
Procedure Call Descriptions
5 You must enclose the list of parameters in parentheses. Use commas to separate
multiple parameters. In the notation, optional parameters are enclosed in square
brackets ( [ and ] ); these brackets must not appear in the program. If you omit
optional parameters, a placeholder comma ( , ) must be present for each omitted
parameter, except for parameters omitted from the end of the list.
6 The exclamation point indicates that a comment follows. The comment is either I
or O (or both), indicating that the parameter is either an input (I) or an output (O)
parameter (or both). Input parameters are those passing data to the called
procedure; output parameters are those that return data to the calling program.
Input-and-output parameters both pass data to the called procedure and return data
to the program.
7 This line indicates whether the parameter is an input or an output parameter (or
both).
8 This line indicates the parameter type, which begins with one of the following:
INT integer (one word)
INT(32) doubleword integer (two words)
STRING character string (one or more bytes)
Next, the following notation can appear:
.EXT means that the parameter is a reference parameter accessed
by an extended pointer.
For all parameters except returned values, the parameter
type (and .EXT, if present) is followed by a colon. Additional
information after the colon includes:
value means that the actual value or contents of the parameter are
passed.
ref:1 means that this is a reference parameter; that is, the address
of the parameter is passed. (The statements within the
program body must access the actual parameter contents
indirectly through the parameter location.) 1 indicates that
the parameter contains one element.
ref:( ddlname) means that this is a reference parameter and that the
information contained at this address is accessed according
to the data type ddlname. For more information on data
types and structures, refer to Appendix A, DDL Definitions
.
ref:* means that this is a reference parameter; the number of
elements returned varies according to the number of
elements requested.
9 This line describes the information passed or returned in the parameter.