Using NS3000/iX Network Services (36920-90008)

Chapter 5 97
Network File Transfer
DSCOPY Intrinsic
3 DSCOPY terminates after first failure.
Use of command file spec enabled.
Primary output disabled.
4 All transfers attempted. Use of
command file spec disabled. Primary
output enabled.
5 DSCOPY terminates after first failure.
Use of command file spec disabled.
Primary output enabled.
6 All transfers attempted. Use of
command file spec enabled. Primary
output enabled.
7 DSCOPY terminates after first failure.
Use of command file spec enabled.
Primary output enabled.
HP recommends that you use the aforementioned
values. Note that although other values can be used,
they must be between 0 and 14 (decimal), inclusive.
spec (input) Logical array, by reference. In the case of a single or
generic transfer request, this parameter should contain
the DSCOPY transfer specification in the same syntax as
the DSCOPY command parameters. The text should be
ASCII characters terminated by a one-byte binary zero
(that is, the ASCII null character). If this parameter
contains the terminating zero (null character) only, the
copy request(s) will be read from a file with the formal
designator DSCOPYI (whose default is $STDIN, the
session terminal). This is a way, in addition to using
“wildcard” characters, of specifying multiple transfer
requests. If DSCOPYI represents an actual file, it must
be unnumbered and its lines must not end with nulls
(zeros).
The spec data type differs slightly from language to
language. See “Programming Language
Considerations” below for data type definitions of
specific languages.
result (output) Two-element array of 16-bit integers, by
reference. Indicates the outcome of the intrinsic call.
The first word of the array indicates whether or not the
transfer was successful. A zero value signifies success;
a nonzero value indicates an NFT error. If the number
is positive, indicating an unsuccessful transfer over an
NS 3000/iX link, bit 2 (where bit 0 is the high-order bit)
indicates which NS 3000 error set the error belongs to:
the HP 3000-specific error set (on) or the generic NFT