OSI/AS Programming Manual

MFM_AWAITIOX_
Module File Management (MFM) Procedure Calls
056783 Tandem Computers Incorporated C–3
tag output
INT(32) .EXT:ref:1
returns 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. For the
possible values of this parameter, see “Considerations.”
segment-id output
INT .EXT:ref:1
returns the segment ID of the extended segment containing the buffer when the
operation was initiated. For OSI operations, this parameter is not relevant and has
the value -1.
Considerations
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 APS or a
file-system procedure. Note that in COBOL programs, you cannot call
MFM_AWAITIOX_ with a filenum of -1.
A CEPI, to show that you want information on the first completion of an 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.
Give the timelimit parameter one of the following values:
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 positive number and filenum is a CEPI, the call is rejected with a status
of ZAPS-VAL-STATUS-NO-RETRY.