MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 6 269
Command Definitions (FLUSHLOG-GETUSERMODE)
FRELATE
FRELATE
NM and CM callable.
Determines whether a file pair (on any device) is interactive, duplicative, or both
interactive and duplicative.
Syntax
U16 I16V I16V
intordup :=FRELATE( infilenum,listfilenum );
Functional Return
intordup 16-bit unsigned integer (assigned functional return)
Returns values indicating whether the two files referenced are interactive
and/or duplicative:
Bits Value/Meaning
15:1 0
Files specified by infilenum and listfilenum do not form an
interactive pair.
1 Files specified by infilenum and listfilenum form an interactive pair.
0:1 0 Files specified by infilenum and listfilenum do not form an
interactive pair.
1 Files specified by infilenum and listfilenum form an duplicative pair.
Parameters
infilenum 16-bit signed integer by value (required)
Passes the file number of the input file.
listfilenum 16-bit signed integer by value (required)
Passes the file number of the list file.
Operation Notes
A device file is interactive if it requires human intervention for all input operations; this is
necessary to establish the person/machine dialog required to support a session.
A device file is duplicative if all input operations are echoed to a corresponding display
without intervention by the operating system software.
The interactive/duplicative attributes of a file pair do not change between the time the files
are opened and closed.
(KSAM) This intrinsic cannot be used for KSAM files. If called for a file created as a KSAM
file, CCL (1) is returned.