netsub(1) CLIX netsub(1)
NAME
netsub - Digital Network Protocol (DNP) command to execute files on a
remote system
SYNOPSIS
netsub [-ilnr] [-u user] [-p password] [-a account] batch-file(s)
FLAGS
-i Sets interactive mode. Before each input file is copied, the user
is prompted to confirm the operation by entering either Y, y, T, t,
or 1 (yes or true). Any other response skips the current file and
proceeds to the next file. The interactive option is particularly
useful in a selective move with wildcard specification.
-l Prints logging information to the terminal to indicate the start of
the operation. The logging message contains the following format:
remote node{node"ACI"::filename} queued
-n Sets noisy mode. A message is printed on the standard error stream
indicating when there is an attempt to connect to FAL, the remote
file transfer server. This often takes several seconds, and the
message provides a way to monitor the operation.
-r Displays release number. This option is used to specify the release
and revision numbers of netsub and its components. If the release
number switch is the sole argument to netsub, it prints the release
information and terminates.
DESCRIPTION
The DNP netsub command command allows CLIX users to execute files on a
remote system. Functionally, netsub locates the designated file on the
remote system and sends an access message to the remote system to submit
that file as a batch file. After completion of the batch file, the
submitted file remains unchanged. On a VAX/VMS system, the file is
executed on the system default batch queue (SYS$BATCH).
PARAMETERS
Command parameters can be specified in either of the following ways:
[-u username] [-p password] [-a account] [nodename::] batch-file(s)
`[nodename ["username [password [account]]"]::] batch-file(s)'
The nodename specifies a DECnet or CLIX hostname or address. The optional
2/94 - Intergraph Corporation 1
netsub(1) CLIX netsub(1)
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 infomation 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
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 "".
batch-file(s)
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.
RELATED INFORMATION
Commands: ncp(l), netcp(l), netlpr(l), netls(l), netmv(l), netrm(l),
sethost(l).
Digital Network Protocol User's Guide
2 Intergraph Corporation - 2/94