xenial (1) dntask.1.gz

Provided by: dnet-progs_2.64build2_amd64 bug

NAME

       dntask - Execute VMS command procedures

SYNOPSIS

       dntask [options] command-procedure
       Options:
       [-biVh] [-t timeout]

DESCRIPTION

       dntask runs command procedures on a remote VMS system.
       It  takes advantage of the ability of the TASK object in DECnet to execute an arbitrary command procedure
       located in the users' login directory. The remote command procedure should output to SYS$NET rather  than
       SYS$OUTPUT and (if interactive) read it's input also from SYS$NET.
       The VMS equivalent of the (non-interactive version) command would be

       TYPE node::"TASK=command-procedure"

       For  some example command procedures see the tasks directory of the source distribution.  show_system.com
       is a non-interactive task that simply displays the output of the VMS "SHOW SYSTEM"  command  on  standard
       output.   interactive.com  is an interactive task that allows you to enter DCL commands to be executed on
       the host VMS system. Be careful which commands you enter because they will expect input to come from  the
       network connection, for instance programs that do screen orientated input or output will almost certainly
       not work.
       Task names can be up to 16 characters in length because that's the limit on DECnet object names.

OPTIONS

       -b     Send the output in binary mode. By default the output from  the  DECnet  task  is  assumed  to  be
              records.  This  option  sends the data "as is" so you can put commands like BACKUP in the task and
              backup to your Linux box.

       -i     Interact with the command procedure. The command procedure must be written to  be  interactive  by
              reading  from  and  writing to SYS$NET. Specifying -i for a non-interactive command procedure will
              cause dntask to time-out waiting for input. Not specifying -i for an interactive command procedure
              will cause it to exit prematurely at the VMS end.

       -t timeout
              Specifies the timeout in seconds for interactive command procedures. If no input has been received
              from either standard input or the VMS end in this time then dntask will exit. The  default  is  60
              seconds. If the value 0 is given then dntask will wait forever (or until you kill it).

       -T connect timeout
              Specifies  the  maximum  amount  of  time the command will wait to establish a connection with the
              remote node. a 0 here will cause it to wait forever. The default is 60 seconds

       -h -?  Displays help for using the command.

       -V     Show the version of the tools package that dntask comes from.

NOTES

       The command procedure that you write MUST ALWAYS write something to SYS$NET or you will get a "connection
       refused" message. This is a limitation with DECnet objects.
       eg. If you write a task to start a remote DECterm it would look something like this:

       $ remnode=f$element(0, ":", "''f$trnlnm("sys$rem_node")'")
       $ set display/create/node='remnode'
       $ create/term/detach
       $ def/nolog sys$output sys$net
       $ write sys$output "DECterm started on ''remnode'"
       $ exit

       The "write" command near the end is essential.

EXAMPLES

         dntask 'myvax::show_system'

         dndir -i 'tramp"christine pjc123"::interactive'

         dndir -i 'tramp"christine -"::interactive'

       Specifying "-" in the password field will prompt for the password.

SEE ALSO

       dntype(1), dndir(1), dncopy(1), dndel(1)