2 SENDNET

SENDNET is a utility for network updates.

Usage: $ SENDNET:== "$IFP:SENDNETB.EXE"
       $ SENDNET  [ QUALIFIERS....] param1 param2

Example  $  SENDNET/INSTALL  TRY.EXE  IFP:TRY.EXE

3 REACHABLE_NODES
Reachable nodes are found on each node, one node per line, in
file

IFP:SENDNET.'local_node'

or by default in file

IFP:SENDNET.NET

See also /GENERAL_QUAL /LOCAL
                       /NODE
                       /WIDE

3 GENERAL_QUALIFIERS
4 /COMMAND
Some codes require the presence of a DCL command.
When this is such the command is given without the $ sign as:

                     /COMMAND="@KERMIT.INS"
4 /NODE

Either list of nodes   /NODE="R1,R3,R6"

Or                     /NODE=ALL  to use  in order <>'filename'.NET
                                                   <...->SENDNET.NET
                                                   until root
                                          then IFP:SENDNET.'localnode'
                                          then IFP:SENDNET.NET
                                          first found first used
                                          (see also /LOCAL)
Or                     /NODE=WORLD to use in order
                                          IFP:SENDNET.'localnode'
                                     then IFP:SENDNET.NET
4 /WIDE
When cluster of VAXes are present in a network, requests must either
be sent to all nodes of each cluster or to only one node per cluster.

The qualifier /WIDE will create a request for each node of each cluster
The qualifier /NOWIDE, which is the default option will generate
a single request per cluster. 

The cluster topology is found in file IFP:SENDNET.NET which contains:

 NODE1
 NODE2/C1               where C1 and C2 are cluster names.
 NODE3/C1               Note that all nodes of a cluster must 
 NODE4                  follow one another sequentially.
 NODE5/C2
 NODE6/C2
 NODE7/C2
 NODE8
4 /NOLOCAL
When /NODE=ALL or =WORLD is used it is possible to prevent the update
from reaching the current node from which the request is sent.

This is done with the /NOLOCAL qualifier.

The default is /LOCAL.
4 /CLUSTER
The qualifier /CLUSTER will create reqests for 
all nodes of the cluster from which the request is sent.

If the requesting node is not on a cluster, no request is generated.
4 /NOTIFY
A mail will be sent to requester whenever the request is satisfied on
the target node.

  /NONOTIFY is the option per default.
4 /PROTECTION
When copying files, the default protection is (S:REWD,O:REWD,G:REW,W:RE)

These protections can be changed using the /PROT qualifier:

Example    /PROT=(G,W)
4 /UIC
UIC's may be changed providing the original UIC is authorized
in the target directory. 
To change UIC use the qualifier:

                      /UIC=['group','member']
3 OPERATIONS_AVAILABLE
The following are available

    Code    or      Qual               Function
     1                                 copy
     2             /COPY  (default)    copy then purge 
     3                                 copy then purge then  @ (*)
     5             /QUEUE=i            print on queue i of /NODE=n
     7             /INSTALL            copy then INSTALL/REPLACE (*)
     9             /DCL                @ a command
    10                                 Sends to outside HASP site
    11                                 Returns above output 
    12                                 Sends to outside HASP site
                                       connected on the same cluster
    99             /CLEAN              Network clean up of hanging 
                                       requests.
4 /CODE=1
Copies a file onto targets

$ SENDNET /CODE=1   param1  [ param2 ]

 param1 := file to send
 
 param2 := target file beginning with a logical
           defaults to param1



4 /COPY
is the default. It copies then purges the target file.

$ SENDNET   param1   [ param2 ]

 param1 := file to send
 
 param2 := target file beginning with a logical
           defaults to param1

4 /CODE=3
Reserved to priviledge user.

Copies then purges then @ the file

See /COPY
4 /QUEUE=
Prints a file on a remode node.

SENDNET /QUEUE=qqq    filename

 qqq := queue name

Note: the target node corresponding to QUEUE qqq is found in file
      RESEAU:terminaux.dat
4 /INSTALL
Reserved to priviledge user.

It copies then purges the target file then attempts to INSTALL/REPLACE

$ SENDNET /INSTALL   param1  [ param2 ]

 param1 := file to send
 
 param2 := target file beginning with a logical
           defaults to param1
4 /CODE=10_11
Reserved for HASP routing.

CODE=10 one way

CODE=11 return trip
4 /CLEAN
Reserved to priviledge user.

It cleans up an hanging request on a remote node

$ SENDNET /CLEAN /NODE=nnn  request_number

 nnn := node to clean up

 Note that this /CLEAN option doesn't sends a mail to SENDNET_MANAGER
 if it fails to delete the request. 
3 TARGET_LOGICAL
During copy operations, the second parameter must contain a logical.

The following rules are followed:

 1- if PARAM2 is not provided, default to PARAM1
 2- if PARAM2 contains a valid logical then use that logical
 3- look for file SENDNET.TAR which must contain a logical with ":"
   and use that logical if that file exists. This search for that file
   is done going up the tree from the current directory up to the root.
   First file SENDNET.TAR encountered is used.
 4- If no file SENDNET.TAR is found, default to logical "GROUPE" which
   is the most commonly one used.
3 AUTHORIZATIONS
For network updates to be allowed into a diretory, a file SENDNET.DAT must 
exist in that directory. 
It should be created by the owner. It must contain the authorized network
UIC's allowed.

For the time beeing this file only contains the GROUP number of the 
remote Username authorized. One GROUP per line on three caracters.

Example:

  077
  120

3 PRIVILEDGED_USERS
Some operations are reserved to priviledged user's. 
These priviledged users are found in file SYS$MANAGER:SENDNET.PRV
of the originating node.
One username per line .
