ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.5)
_______________________________________________________________________________
 dq [-a <hexchar>] [-b] [-c <sig_number>] [-i] [-s] [<pid>]
 "kill"
 
 DESCRIPTION:
     The  dq command is used to send an interrupt signal to a  process
     when  running under ceterm.  It can also be used to send  signals
     other  processes.  dq with no parameters and the -a parameter are
     only  valid  in ceterm.  dq also causes any pending input in  the
     Unix  command window to be removed.  It also causes the  terminal
     output window to scroll to the bottom.
     
 PARAMETERS:
     
     -a <hexchar>
        This  option  sends  the   character  hexchar  to  the  shell.
        <hexchar>  can  be  any character valid in an er  (enter  raw)
        command.  This includes two digit hex codes, such as 0C or A3,
        control  constructs  such  as  ^c or ^d, and  C  type  escaped
        characters, such as \t and \r. For example, dq -a ^c forces dq
        to send the hex 03 character as a quit character to the shell.
        This feature is useful on some platforms when using telnet. By
        default  dq  queries  the shells line discipline  to  get  the
        interrupt character and sends this character. Because multiple
        line  disciplines are involved in telnet, the wrong  character
        is  sometimes  returned.  Since interrupt is almost always  ^c
        (see  stty(1V))  this  can  be compensated  for  with  the  -a
        parameter.   This parameter is ignored if a process id (<pid>)
        is specified.

     -b
        Blast.   This parameter causes a SIGKILL to be sent to process
        <pid>.  If <pid> is omitted, the SIGKILL is sent to the ceterm
        shell  process and closes the socket connection to the  shell.
        This should stop the shell in it's tracks.

     -c <sig_number>
        This option sends the signal <sig_number> to process <pid>. If
        <pid>  is  omitted,  the signal is sent to  the  ceterm  shell
        process.   <sig_number>  is a decimal signal number.   If  the
        special  value -1 is used as the signal number, the pipe which
        sends  data  from the ceterm process to the shell is  flushed.
        This  is useful in long Ce command scripts where user input is
        being simulated.

     -i
         Interrupt.   This  parameter  causes a SIGINT to be  sent  to
         process <pid>. If <pid> is omitted, the SIGINT is sent to the
         ceterm shell process. This will usually kill the shell.

     -s
        Stop.   This parameter causes a SIGQUIT to be sent to  process
        <pid>. If <pid> is omitted, a SIGQUIT followed by a SIGKILL is
        sent  to the ceterm shell process.  This will usually kill the
        shell.

     <pid>
        This  is  the process id (number) of the process to  send  the
        signal to. This parameter is optional in a ceterm window. In a
        ce  or  cv window, if no <pid> is specified, the command is  a
        no-op.   If  a <pid> is specified with no other parameters,  a
        SIGTERM signal is sent.

    Normal use for this command is to have it under the key definition
    for ^q.  (kd ^q dq ke).  Users not migrating from Apollo may prefer
    to  move this definition to ^c.  The dq command with no parameters
    differs  from  an  "er ^c" in that the data  is  send  immediately
    rather  than being put in a buffer and no newline is attached when
    it is transmitted to the
     shell.

 RELATED HELP FILES:
     eef           (End of File )     
     
     regionsCon    (marking regions)  
     support       (customer support) 
        

_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.