laygosrv is a 32-bit Windows control program for the LayGO RPC Server. It provides a graphical user interface which allows the user to control and monitor the status of the server. laygosrv runs under Windows 9x or Windows NT, providing access to clients running on any platform which provides a DCE-compatible implementation of RPC.
laygosrv has no special installation requirements. It is implemented as a single file, laygosrv.exe. Of course, the system RPC libraries and the LayGO devices driver and protocol stack libraries must be installed on the same system.
The command-line syntax for laygosrv is:
laygosrv [-a] [-d] [-n] [-r] [-s <stack number>] [cfg file list]
Command-line options are case sensitive.
| Command-Line Options | |
|---|---|
| [ -a ] | By default, laygosrv waits for the user to press the "Start" button before starting the RPC server. The -a option tells laygosrv to start the server automatically at startup. |
| [ -d ] | By default, laygosrv allows any client program to shutdown the server. The -d option disables remote shutdown. When the -d option is used, only laygosrv itself can shutdown the server. |
| [ -n ] | By default, laygosrv configures the server to advertise its services using RPC name service. Clients can then use the name service to locate a particular server. Windows NT provides RPC name service, but Windows 9x does not. A server running under Windows 9x can only use name service if it is provided by a Windows NT machine on the same network. Where this is not possible, the -n option tells laygosrv to start the server without using RPC name service. |
| [ -r ] | By default, laygosrv configures, initializes and enables the LayGO protocol stack before starting the RPC server. The stack is then ready to accept open requests as soon as server startup is complete. The -r option tells laygosrv to start the RPC server without configuring or initializing the stack. These tasks are left to a client program, but laygosrv still uninitializes the stack when the server is stopped. |
| [ -s <stack number> ] | By default, laygosrv registers the server with RPC name service as /:./Laygo/Stack0. The -s option tells laygosrv to register the server using a different stack number. This allows clients to choose which server to connect to if more than one is available. |
| [ cfg file list ] | The LayGO protocol stack is configured using the ordered list of files. |
All program options which can be set on the command-line can also be changed or verified through the Stack Configuration and Server Configuration dialogs accessible from the Options submenu of laygosrv's main menu.
Before starting the server, you can use the Options → Stack Configuration dialog to add, delete and reorder cfg files. You can also enable remote configuration by selecting the Allow remote stack configuration check box. This is the same as adding -r to the command-line.
The Options → Server Configuration dialog lets you disable use of RPC name service under Windows 9x (same as -n), disable remote shutdown (same as -d) and change the server's stack number (same as -s).