OSI/FTAM Programming Reference Manual

MFM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
E-3
MFM_AWAITIOX_
When you call this procedure, give the filenum parameter one of the following
values:
•
-1, to show that you want information on the first completion of an FTM, APS,
or file-system procedure.
•
A CEPI, to show that you want information on the first completion of an FTM or
APS procedure for a particular connection.
•
A file-system file number, to show that you want information on the completion
of a file-system call made on a particular file-system open. On completion of
this procedure, the filenum parameter shows the CEPI or file-system file
number of the completed procedure.
On completion of this procedure, the filenum parameter shows the CEPI or
file-system file number of the completed procedure.
buffer-addr output
INT(32) .EXT:ref:1
displays the relative extended address of the buffer specified when the operation
was initiated. For NonStop FTAM operations, this parameter is not relevant and
has the value -1D.
count-transferred output
INT .EXT:ref:1
displays the number of bytes transferred by the associated operation. For NonStop
FTAM operations, this parameter is not relevant and has the value -1.
tag output
INT(32) .EXT:ref:1
displays the application-defined tag that was stored by the file system when the I/O
operation associated with this completion was initiated. If you did not specify a tag
when the operation was initiated, the value of this parameter is -1D.
timelimit input
INT(32):value
specifies the length of time you are willing to wait for a completion.
The following values are possible:
•
0, to check for a completion without waiting.
•
-1, to wait indefinitely for a completion.
•
A positive number n, to wait for n time units for a completion. Do not specify
this value if you specify a CEPI for the filenum parameter. If timelimit is a