Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-27
FILE_COMPLETE_
Completes one previously initiated I/O operation for a Guardian file or returns ready
information for one Open System Services (OSS) file. The Guardian or OSS file is from
a set of files that was previously enabled for completion by one or more calls to the
FILE_COMPLETE_SET_ procedure.
0 Rewind and unload; do not wait for completion.
1 Rewind and take offline; do not wait for completion.
2 Rewind and leave online; do not wait for completion.
3 Rewind and leave online; wait for completion.
4 Do not rewind; leave online.
status := FILE_COMPLETE_ ( completion-info
,[ timelimit ]
,[ complete-element-list ]
,[ num-complete-elements ]
,[ error-complete-element ] );
status, INT returned value
completion-info, INT
.EXT:ref:*(ZSYS^DDL^COMPLETION^INFO^DEF)
output
timelimit, INT(32):value input
>0D Wait for completion. The timelimit parameter specifies the maximum
time (in 0.01-second units) from the time of the FILE_COMPLETE_ call
that the caller can wait for completion.
= 0D Check for completion. FILE_COMPLETE_ immediately returns to the
caller, regardless of whether completion has occurred.
= -1D Wait indefinitely.
< -1D An invalid value (file-system error 590 occurs).
omitted Wait indefinitely.
complete-element-list, INT
.EXT:ref:*(ZSYS^DDL^COMPLETE^ELEMENT^DEF)
input
num-complete-elements, INT input
error-complete-element, INT .EXT output