OSI/FTAM Programming Reference Manual

MFM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
E-2
Procedure Descriptions
Procedure Descriptions
The names of all MFM procedures start with the characters “MFM_.” Figure 4-1 on
page 4-10 shows the syntax notation used to describe procedure calls in this manual.
This notation gives the syntax for calling the procedures from C or TAL programs. This
appendix provides the syntax and semantics of the MFM procedures, in alphabetic
order. The information about each procedure call includes the following:
•
Description of its use
•
Syntax
•
Parameter descriptions
•
Considerations (added information about the procedure)
MFM_AWAITIOX_
This procedure allows you, when in nowait mode, to check for completion of, and
obtain the information returned from, a previous file-system, APS procedure call, or
FTM procedure call. If your application uses NonStop FTAM procedures, you cannot
call AWAITIOX directly; you must call MFM_AWAITIOX_ instead. Except where stated
otherwise, the parameters to MFM_AWAITIOX_ have the same syntax and use as the
corresponding parameters for AWAITIOX.
For further information about the use of these parameters with file-system files, see the
OSI/FTAM Programming Guide and the description of the AWAITIOX procedure in the
Guardian Procedure Calls Reference Manual.
status output
INT .EXT:ref:1
indicates the outcome of an FTM or APS procedure call. For a list of possible
ZAPS-VAL-STATUS-xxx values, see Table B-1 on page B-2. If the call was to a
file-system procedure rather than an FTM or APS procedure, the value is 0.
filenum input, output
INT .EXT:ref:1
identifies a file number or CEPI for which you are requesting returned information.
CALL MFM_AWAITIOX_ ( status ! O
, filenum ! I/O
,[ buffer-addr ] ! O
,[ count-transferred ] ! O
,[ tag ] ! O
,[ timelimit ] ! I
,[ segment-id ] ); ! O