dglope(3G)

NAME
     dglope - opens a Graphics Library connection to a graphics server

FORTRAN 77 SPECIFICATION
     integer*4 dglope(svname, length, type)
     character*(*) svname
     integer*4 length, type

PARAMETERS
     svname   expects a variable containing the name of the graphics server to
              which you want to open a connection.

              For a successful connection, the client host must have
              permission to connect to the graphics server.  Authentication is
              accomplished via the same mechanisms as for X clients.  See
              xhost(1) for further details.

              The svname parameter has the following syntax:

              [[username ]password@]hostname[:server[.screen]]

              where hostname is an internet host name recognized by
              gethostname(3N).  server and screen are ignored, and both are
              set to 0.

              For DECnet connections, if the server account has a password,
              this password must be specified by including username and
              password.  This password is used only for opening the DECnet
              connection; the local and remote accounts must still be
              equivalent in the rlogin sense.

     length   expects the length of the string in svname.

     type     expects a symbolic constant that specifies the kind of
              connection.  There are three defined constants for this
              parameter:

              DGLLOC indicates a direct connection to the local graphics
              hardware.  This type of connection is not supported on client
              machines without IRIS graphics hardware.

              DGLTSO indicates a remote connection via TCP/IP.

              DGL4DD indicates a remote connection via DECnet.

FUNCTION RETURN VALUE
     If the connection succeeds, the returned value of the function is a non-
     negative integer, serverid, that identifies the graphics server.  If the
     connection failed, the returned value for the function is a negative
     integer.  The absolute value of a negative returned value is either a
     standard error value (defined in <errno.h>) or one of several error
     returns associated specifically with dglope:
     ENODEV      type is not a valid connection type.

     EACCES      login incorrect or permission denied.

     EMFILE      too many graphics connections are currently open.

     ENOPROTOOPT DGL service not found in /etc/services.

     ERANGE      invalid or unrecognizable number representation.

     EPROTONOSUPPORT
                 DGL version mismatch.

     ESRCH       the window manager is not running on the server.

DESCRIPTION
     dglope opens a Graphics Library connection to a graphics server (svname).
     After a connection is open, all graphics preferences, input, and output
     are directed to that connection.  This direction is continued until
     either the connection is closed, another connection is opened, or a
     different connection is selected.  A different connection can be selected
     by calling a subroutine that takes a graphics window identifier as an
     input parameter, e.g. winset.  The server connection associated with that
     graphics window identifier becomes the current connection.  To close a
     connection, call dglclo with the server identifier returned by dglope.

     If a remote server error occurs, the graphics application may exit with a
     status value EIO and produce the following error message:

          dgl error (comm): read returned 0

SEE ALSO
     dglclo, finish, gflush, winope, winset, scrnse

     rlogin(1C), gethostbyname(3N) in the IRIS-4D User's Reference Manual

NOTES
     This routine is available only in immediate mode.

     This routine is available in both the GL and DGL libraries.  However, the
     DGLLOC connection type is not supported by the DGL library.