error_c_text(3ncs) [ultrix man page]

error_c_text(3ncs)														error_c_text(3ncs)

Name
       error_c_text - return an error message for a status code

Syntax
       void error_$c_text(status, message, messagemax)
       status_$t status;
       char *message;
       int messagemax;

Arguments
       status	      A status code in status_$t format.

       message	      A character string.  The error message represented by the status code.

       messagemax     The maximum number of bytes to be returned in message.

Description
       The  routine  returns a null terminated error message for reporting the completion status of a routine.	The error message is composed from
       predefined text strings that describe the subsystem, the module, and the error represented by the status  code.	 See  the  reference  page
       which lists all of the possible diagnostics that could be returned in

Files
See Also
       intro(3ncs)

																error_c_text(3ncs)

rrpc_shutdown(3ncs)													       rrpc_shutdown(3ncs)

Name
       rrpc_shutdown - shut down a server

Syntax
       #include <idl/c/rrpc.h>

       void rrpc_$shutdown(handle, status)
       handle_t handle;
       status_$t *status;

Arguments
       handle A remote procedure call (RPC) handle.

       status The completion status.  If the completion status returned in is equal to status_$ok , then the routine that supplied it was success-
	      ful.

Description
       The routine shuts down a server, if the server allows it.  A server can use the routine to allow or disallow remote shutdown.

Diagnostics
       This section lists status codes for errors returned by this routine in

       rrpc_$shutdown_not_allowd
	      You send an request to a server that has not issued an call.

Restrictions
       On the client side, because of the way the calls are defined and implemented in the run-time library you  must  explicitly  call  into  the
       entry  point  vector  table  for  the  interface to send an request across the network. The following is an example of a call that works as
       desired:
       (*rrpc_$client_epv.rrpc_$shutdown)(handle, &status);

       The server side stub routine calls the entry point on behalf of the client.  The results of the call are then passed back to the client.

       Before making the shutdown call, the server must have previously executed the following call:
       rpc_$allow_remote_shutdown((unsigned long) TRUE,NULL,&status);

       If the server has not allowed remote shutdown, the call returns an status code.

Files
See Also
       intro(3ncs), rpc_allow_remote_shutdown(3ncs), rpc_shutdown(3ncs)

															       rrpc_shutdown(3ncs)