nlsrequest(3N)        (Networking Support Utilities)         nlsrequest(3N)


   NAME
         nlsrequest - format and send listener service request message

   SYNOPSIS
         #include <listen.h>

         int nlsrequest (int fd, char *servicecode);

         extern int nlslog, terrno;
         extern char *nlsrmsg;

   DESCRIPTION
         Given a virtual circuit to a listener process (fd) and a service code
         of a server process, nlsrequest formats and sends a service request
         message to the remote listener process requesting that it start the
         given service. nlsrequest waits for the remote listener process to
         return a service request response message, which is made available to
         the caller in the static, null terminated data buffer pointed to by
         nlsrmsg.  The service request response message includes a success or
         failure code and a text message.  The entire message is printable.

   SEE ALSO
         nlsadmin(1), t_error(3).

   FILES
         /usr/lib/libnls.a
         /usr/lib/libnsls.a

   DIAGNOSTICS
         The success or failure code is the integer return code from
         nlsrequest.  Zero indicates success, other negative values indicate
         nlsrequest failures as follows:

              -1:Error encountered by nlsrequest, see t_errno.

         Postive values are error return codes from the listener process.
         Mnemonics for these codes are defined in <listen.h>.

              2: Request message not interpretable.
              3: Request service code unknown.
              4: Service code known, but currently disabled.

         If non-null, nlsrmsg contains a pointer to a static, null terminated
         character buffer containing the service request response message.
         Note that both nlsrmsg and the data buffer are overwritten by each
         call to nlsrequest.

         If nlslog is non-zero, nlsrequest prints error messages on stderr.
         Initially, nlslog is zero.




   7/91                                                                 Page 1

   nlsrequest(3N)        (Networking Support Utilities)         nlsrequest(3N)


   WARNING
         nlsrequest cannot always be certain that the remote server process
         has been successfully started.  In this case, nlsrequest returns with
         no indication of an error and the caller will receive notification of
         a disconnect event via a TLOOK error before or during the first
         tsnd or trcv call.















































   Page 2                                                                 7/91