JAGENT(M)                                  UNIX System V



     Name
          jagent - host control of windowing terminal


     Syntax
          #include <sys/jioctl.h>

          ioctl (cntlfd, JAGENT, &arg)

          int cntlfd
          struct bagent arg


     Description
          The ioctl(S) system call, when performed on an xt(HW) device
          with  the  JAGENT  request,  allows  a  host program to send
          information to a windowing terminal.

          ioctl has three arguments:

          cntlfd    the xt(HW) control channel file descriptor

          JAGENT    the xt(HW) ioctl(S) request to invoke a  windowing
                    terminal agent routine.

          arg       the address of  a  bagent  structure,  defined  in
                    <sys/jioctl.h> as follows:

                    struct    bagent {
                      long  size;  /* size of src in & dest out */
                      char  *src;  /* the source byte string */
                      char  *dest; /* the destination byte string */
                    };

          The src pointer must be  initialized  to  point  to  a  byte
          string   which  is  sent  to  the  windowing  terminal.  See
          layers(M)  for  a  list  of  JAGENT  strings  recognized
          by windowing  terminals.   Likewise,  the  dest pointer must
          be initialized to the address of a buffer  to  receive  a  byte
          string  returned  by the terminal.  When ioctl(S) is called,
          the size argument must be set  to  the  length  of  the  src
          string.   Upon return, size is set by ioctl(S) to the length
          of the destination byte string, dest.


     See Also
          ioctl(S), libwindows(S), layers(M), xt(HW)


     Diagnostics
          Upon successful completion, the size of the destination byte
          string is returned.  If an error occurs, -1 is returned.


     (printed 8/23/89)                                  JAGENT(M)