netmv(1)                            CLIX                            netmv(1)



  NAME

    netmv - Digital Network Protocol (DNP) command that moves or renames files

  SYNOPSIS

    netmv [-ilnr] [-u username] [-p password] [-a account] [nodename::]
    source-file destination-file

    netmv [-ilnr] [-u username] [-p password] [-a account] [nodename::]
    source-file ... destination-file

    netmv -r

  FLAGS

    The following flags are available:
    -i     Sets interactive mode.  Prompts the user to confirm the operation
           before each input file is copied, as described in the following:

           Answer Y or y to move the file and continue the interactive file
           move mode.

           Answer N or n to not move the file, but continue the interactive
           file move mode.

           Answer R or r to move the file and all remaining files.  This
           terminates the interactive file move mode.  The interactive option
           is particularly useful in a selective move with wildcard
           specification.

           Answer Q or q to quit the interactive file move mode.

    -l     Sets logging mode.  Displays an acknowledgement on the screen for
           each file moved when the move is successful.

    -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 netmv and its components.  If the release number switch
           is the sole argument to netmv, it prints the release information
           and terminates.

  DESCRIPTION

    The netmv command moves a file or a group of files using the Digital
    Network Protocol (DNP).
     When netmv moves a file, two file specifications are required:  source-



  2/94 - Intergraph Corporation                                              1

  netmv(1)                            CLIX                            netmv(1)



    file, or a number of files, and the destination-file.  A source-file is a
    valid remote file specification as described in netcp(1) that may contain
    wildcards.  A destination-file may contain a directory name, a file name,
    or both.  When multiple files are being moved, the destination must be a
    directory.  In any case, destination-file may not contain a node specifier
    or Access Control Information (ACI) because they are assumed to be the
    same as source-file.

  PARAMETERS

    The remaining command parameters can be specified in either of the
    following ways:

    [-u username] [-p password] [-a account] [nodename::] file

    `[nodename ["username [password [account]]"]::] 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 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



  2                                              Intergraph Corporation - 2/94

  netmv(1)                            CLIX                            netmv(1)



           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 "".

  DIAGNOSTICS

    When an error occurs during netmv command execution, an error message in
    the following form is displayed:

    node::file-spec <error description>


    The error message is displayed even if the logging option was not
    selected.

  RELATED INFORMATION

    Commands:  netcp(1)

    Digital Network Protocol (DNP) User's Guide


































  2/94 - Intergraph Corporation                                              3