Progress
Database Administration
Guide and Reference
PROSHUT Command
Shuts down the Progress database server and individual processes. Before you shut down the broker, have all application users quit their Progress sessions. If necessary, you can disconnect users by using the PROSHUT command’s Disconnect a User or Unconditional Shutdown parameters.
SYNTAX
Operating System Syntax UNIXWindowsproshut
db-name
[-b|-by
| -bn|-C list
|-C disconnect
usernum
|-F
|-Gw
|-H
host-name
|-S
service-name
|-cpinternal
codepage
|-cpstream
codepage
] ...
db-name
Specifies the database the server is running against.
-b
Directs PROSHUT to perform a batch shutdown. When no client is connected, the database automatically shuts down. When one or more clients are connected, PROSHUT prompts the user to enter “yes” to perform an unconditional batch shutdown and to disconnect all active users; or “no” to perform a batch shutdown only if there are no active users. The -
b
parameter combines the functionality of the -by
or -bn
parameters.-by
Directs PROSHUT to perform an unconditional batch shutdown and to disconnect all active users. Note that PROSHUT does not give users any notice before disconnecting them.
-bn
Directs PROSHUT to perform a batch shutdown only if there are no active users.
-C list
Lists all of the users connected to the database. The list is printed out to the screen without any page breaks.
-C disconnect usernum
Allows you to initiate a disconnect for the specified user. This is similar to option 1 of the PROSHUT menu.
-F
Starts an emergency shutdown. To use this parameter, you must run PROSHUT on the machine where the server resides. This parameter is not applicable for remote shutdowns or DataServer shutdowns.
-Gw
For DataServers, specifies the DataServer broker to shut down.
-H host-name
Specifies the machine where the database server runs. If issuing the shutdown command from a remote machine, specify the host name.
-S service-name
Specifies the database server or broker process. If issuing the shutdown command from a remote machine, specify the service name.
-cpinternal codepage
An internationalization startup parameter that identifies the code page used in memory.
-cpstream codepage
An internationalization startup parameter that identifies the code page used for stream I/O.
When you enter the PROSHUT command without the -
by
, -bn
, or -F
parameters, the following menu appears:
The following table lists the menu options and their actions:
EXAMPLES
- You can shut down using PROMON’s “Shut Down Database” menu option.
- The user who shuts down the server must have started it, or be root (on UNIX).
- When you initiate PROSHUT over a network, the amount of time that it takes to actually shut down all of the Progress processes and to free any ports varies depending on the number of clients, brokers, and servers that must be shut down. The PROSHUT command might return control to the terminal before all of the processes are stopped and resources are freed.
- If you specified a unique value for
-cpinternal
or-cpstream
when you opened the database, you must specify that same value for-cpinternal
or-cpstream
when you close the database with the PROSHUT command. If you do not, PROSHUT uses the values for-cpinternal
and-cpstream
found in the main startup parameter file created during installation (such asDLC/startup.pf
). If the values of-cpinternal
or-cpstream
specified for your database do not match the values specified in the main startup parameter file, you receive the following error message:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |