Progress
DataServer
for ORACLE Guide
PROSHUT Command
Shuts down the Progress database server and individual Progress processes. Before you shut down the server, 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 UNIX
NT proshut db-name [ -b
| -by
| -bn
| -H host-name
| -S service-name
| -N network-type
| -F
| -Gw
| -C list
| -C disconnect usernum
] ...
PARAMETERS
db-name
Specifies the database the server is running against.
-b
Directs Progress 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 Progress to perform an unconditional batch shutdown and to disconnect all active users.
Using -by in conjunction with -F causes an emergency shutdown.
-bn
Directs Progress to perform a batch shutdown only if there are no active users.
-H host-name
Specifies the machine where the database server runs. You must specify the host name if you issue the shutdown command from a machine other than the host.
-N network-type
Specifies the networking protocol used by the requesting application to connect to the Progress DataServer. This optional parameter is always TCP.
-S service-name
Specifies the database server or broker process. You must specify the service name if you issue the shutdown command from a machine other than the host.
-F
Starts an emergency shutdown. To use this parameter, you must run PROSHUT on the machine where the server resides, and on UNIX systems. This parameter is not applicable for remote shutdowns or DataServer shutdowns.
-Gw
For DataServers, specifies the DataServer broker to shut down.
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:
-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.
NOTES
- The PROSHUT command runs the following executable:
- You can access PROSHUT from the PROMON utility by using the Shut Down Database qualifier.
- 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 utility might return control to the terminal before all of the processes are stopped and resources are freed.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |