StopServer

Halts server processing.

Library:LibC
Classification:NetWare OS
Service:NetWare Platform

Syntax

  #include <netware.h>
  
  int StopServer (
     scr_t         scrID,
     uint8_t       forceDown,
     uint32_t      reserved1,
     void         *reserved2,
     const char   *alternateMessage,
     uint32_t      reserved3);

Parameters

scrID

Specifies a screen, such as your own private screen (if that is where management is being controlled from), or a system console screen ID.

forceDown

Specifies whether to bring the server down without sending a notification to NLM applications that have registered for a “down server event” notification:

  • TRUE nonzero Do not send notifications.
  • FALSE zero Send notifications.
reserved1

Is reserved. Pass zero.

reserved2

Is reserved. Pass NULL.

alternateMessage

Points to a null-terminated ASCII string that contains a message to send to all logged-in remote connections. If NULL is passed, the default message (“File Server %s is down. Connection terminated.”) is broadcast to each logged-in client. This string must be shorter than 100 characters.

reserved3

Is reserved. Pass zero.

Remarks

StopServer must be called before calling RestartServer.

The following is an example of how you might call StopServer:

  StopServer(systemConsoleScreen, TRUE, 0, NULL, NULL, 0);

See Also