Using NS3000/iX Network Services (36920-90008)

96 Chapter 5
Network File Transfer
DSCOPY Intrinsic
DSCOPY Intrinsic
Transfers or copies a file from one node to another (or within a single
node).
Syntax
DSCOPY (opt,spec,result)
Parameters
opt (input) 16-bit integer, by reference. Enables/disables the
primary output (to $STDLIST) and determines whether
to continue after first transfer failure. The following
bits of the opt parameter are significant (all others are
reserved):
bit 15 Used to determine whether DSCOPY
should terminate after the first
transfer failure during a multiple
transfer.
0 = attempt all transfers, even after a
failure
1 = terminate DSCOPY after first failure
bit 14 Allows addition of a command file name
in spec array for multiple file transfer.
0 = disables use of command file
1 = enables use of command file
bit 13 Enables/disables primary output.
0 = primary output disabled
1 = primary output enabled
<+>Recommended values:
0 All transfers attempted. Primary
output disabled.
1 DSCOPY terminates after first failure.
Primary output disabled.
2 All transfers attempted. Use of
command file spec enabled. Primary
output disabled.