Server Commands

In this section: ? Command ? USERS Command STOP Command HX Command

Server commands are commands entered at the command line while the server is running. All of these commands are intercepted by CMS immediate command support and are processed by an immediate command exit and an ECB POST. Server commands include:

Command	Function
STOP [END]	Shuts down the server. The END option is needed if users are still active on the server and an immediate shutdown is required.
GO	Resets STOP command, if STOP has not yet completed.
HX	Shuts down the server immediately (like STOP END).

The following are server query commands. Query commands begin with a question mark:

Command	Function
?	Displays list of valid query commands
? RELEASE	Displays server release information.
? SERVER	Displays server status information.
? SU or ? USERS	Lists users on a sink machine. See ? USERS Command.

? Command

Issuing the ? command or pressing Enter twice generates a list of valid commands:

? USERS Command

The ? USERS command displays the source machine user IDs and the file IDs of the sink machine databases they are accessing. For example:

USERID  FILEID         QUEUE

JBP     CAR    FOCUS A   
NNA     CAR    FOCUS A

This list shows that user IDs JBP and NNA are now accessing the file CAR FOCUS A. The QUEUE column is not used. (You can also obtain this list from a source machine if you are using the FOCUS language. See SU and the FOCUS Language.)

Before you shut down the sink machine, display this list to determine if users are still accessing the sink machine. After this list displays, the sink machine resumes processing, allowing users who were interrupted to continue from the point they left off. You can then either shut down the sink machine or disconnect the terminal and allow SU mode to continue. Both alternatives are explained in the following sections.

STOP Command

The STOP command allows the current queue of pending source machine requests to be processed and refuses any new ones. It then closes down normally and returns control to CMS.

If the you issue the STOP command and there are no users connected, the following message displays:

No open FCBs. Shutting down the Server.

If the you issue the STOP command and there are still users connected, the following message displays:

There are open FCBs. Suspending the Server.

The sink machine will continue to process existing users until they have all disconnected (either by issuing a USE CLEAR command or a FIN command to exit FOCUS).

If you want to shut down without waiting for the user requests to complete, you can issue the STOP END command or the HX command.

HX Command

The HX command immediately terminates the sink machine without processing any of the source machine requests currently in the queue or writing the records in the buffers to the database. It is the same as issuing the STOP END command.