netcp(1) CLIX netcp(1)
NAME
netcp - Digital Network Protocol (DNP) copy command
SYNOPSIS
netcp [-ilnrtvxz] [-bblocksize] [-u user] [-p password] [-a account]
[nodename::] file1 file2
netcp [-ilnrtvxz] [-bblocksize] [-u user] [-p password] [-a account]
[nodename::] file ... directory
netcp -r
FLAGS
Flags to netcp can be placed anywhere, in any order, on the command line.
The following flags are available:
-i Sets interactive mode. Prompts the user to confirm each file copy
operation.
Enter Y or y to copy the file and continue the interactive file
copy mode.
Enter N or n to not copy the file and continue the interactive file
copy mode.
Enter R or r to copy the file and all the remaining files. This
terminates the interactive file copy mode.
Enter Q or q to quit the interactive session. The interactive
option is particularly useful in a selective transfer with wildcard
specification.
-l Sets logging mode. Prints logging information on the standard
output to indicate the start of data transfer for each file.
-n Sets noisy mode. Prints a message on the standard error stream
indicating when there is an attempt to connect to the remote file
transfer server. This often takes several seconds, and the message
provides a way to monitor the operation.
-r Displays the release number. Specifies the release and revision
numbers of netcp and its components. If the release number switch
is the sole argument to netcp, netcp prints the release information
and terminates.
-t Displays the total number of bytes and files transferred.
-v Sets verbatim mode. Transfers (byte-for-byte) all input files
2/94 - Intergraph Corporation 1
netcp(1) CLIX netcp(1)
without record format conversion and with no bytes lost, altered,
or inserted. Output files are created with a record format
appropriate to their byte-stream nature. On VMS, the output files
always have VARIABLE RECORD format and no record attributes. When
data is copied from one CLIX system to another CLIX system, the
verbatim mode increases copying speed.
-x Submits the input files for execution on the remote system. These
files are deleted after execution. On a VAX system, file is
executed on the default batch queue (SYS$BATCH).
-z Sets append mode. Appends the input files to the destination files
rather than overwriting them.
DESCRIPTION
The netcp command transfers files to, from, and between remote systems.
The command copies files between hosts that support the Digital Network
Architecture (DNA). This includes DECnet and CLIX hosts on a network.
File and specifications can be either simple file specifications of local
files or the lengthy DNP remote file specifications.
2 Intergraph Corporation - 2/94
netcp(1) CLIX netcp(1)
PARAMETERS
The following describes the available parameters:
-bblocksize
Indicates size of the record in bytes. The default is 512 bytes.
Output files on a VMS system are created as follows:
With the -v flag, the file is copied to a fixed length record file.
Without the -v flag, the file is copied to a variable length record
file. The remaining command parameters can be specified in either
of the following ways:
`[nodename ["username [password [account]]"]::] file'
[-u username] [-p password] [-a account] [nodename::] file
The nodename specifies a DECnet or CLIX hostname or address. The optional
information enclosed in double quotation marks (in the first example) or
specified with the -u, -p, or -a option is regarded as the access
information. The remote system uses this information to determine
accessibility on the remote host. The final portion of the syntax is the
file specification on the remote host. The parameter keywords are defined
as follows:
nodename
Specifies a Digital Network Architecture (DNA) hostname or address.
For example, DECnet and CLIX hosts support DNA. The hostname or
address is defined as follows:
A hostname can be up to six characters.
The [area-number.]node-number format specifies an address. The
optional area-number is an integer in the range of 1-63 that
specifies the network area of the host. The node-number is an
integer in the range of 1-1023 that is unique in the network area.
If the remote node-number is in the same local network area, area-
number need not be specified.
username or -u username
Identifies the user on the remote system in whose name the access
will be performed. The NET_USER environment variable, if defined,
is used if no username is specified on the command line.
password or -p password
Specifies a password for username. A null password can be
specified with "".
account or -a account
Indicates the party to be billed for network access time. This
2/94 - Intergraph Corporation 3
netcp(1) CLIX netcp(1)
option is used by some DECnet systems. It is not valid for CLIX
systems. The NET_ACCOUNT environment variable, if defined, is used
if no account is specified on the command line. A null account can
be specified with "".
file Specifies a file conforming to naming conventions on the remote
host. CLIX-, VMS-, and DOS-style file specifications are examples
of some file-naming conventions. Copying files between hosts using
different file-naming conventions may produce unexpected results.
The file can be a wildcard specification.
The standard input device, such as the keyboard, can be used instead of
the source input file by using a -. A standard output device can be used
instead of file2 or directory by using a -.
When multiple source input files are specified, the target directory must
be a remote/local directory or standard output. The output files retain
much of their original names. The destination node may shorten some file
names.
When remote files are copied to a target directory on CLIX, their names
are converted, if necessary, to names that are suitable for use on the
CLIX system. Files are stripped of version numbers, and if the files are
from a non-case-sensitive system like VAX/VMS, they are converted to
lowercase. For example, SYS$SYSDEVICE:[LEE.PROJ1]MYFIL.RNO becomes
myfil.rno on CLIX. The names of files from another CLIX or case-sensitive
system are unchanged.
RELATED INFORMATION
Digital Network Protocol (DNP) User's Guide
4 Intergraph Corporation - 2/94