Overview | Package | Class | Use | Tree | Deprecated | Index | Help
|  | BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

WebLogic Server 8.1 API Reference

## weblogic.common
Interface AdminServicesDef

Deprecated. Deprecated in WebLogic Server 6.1.

public interface AdminServicesDef

The AdminServicesDef defines the interface for administrative services in WebLogic.

Author:
  Copyright © 2004 BEA Systems, Inc. All Rights Reserved.

Method Summary
`java.lang.String` | `cancelShut()` Deprecated. Deprecated in WebLogic Server 6.1.
`void` | `disableWatchDog()` Deprecated. Deprecated in WebLogic Server 6.1.
`void` | `enableWatchDog(int intervalSecs)` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `licenses()` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `lockServer(java.lang.String message)` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `ping(byte[] echo)` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `shut()` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `shut(int waitSecs)` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `shut(java.lang.String message, int waitSecs)` Deprecated. Deprecated in WebLogic Server 6.1.
`void` | `threadDump()` Deprecated. Deprecated in WebLogic Server 6.1.
`java.lang.String` | `unlockServer()` Deprecated. Unlocks the Server after a lock operation, to make it available for logins by all users.
`java.lang.String` | `version()` Deprecated. Deprecated in WebLogic Server 6.1.

Method Detail

### ping

    public java.lang.String ping(byte[] echo)
                          throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Pings a WebLogic Server with the specified array of bytes as a ping message.

  Parameters:
    `echo` - Byte array to ping the server with
  Returns:
    An administrator message that returns the success status of the ping
  Throws:
    java.lang.Exception - if there is an error

### shut

    public java.lang.String shut(int waitSecs)
                          throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Shuts down a WebLogic Server from a T3Client after a certain period of time.

  This is a privileged method that can only be invoked on a T3Client that has specified the T3User "system".

  Parameters:
    `waitSecs` - Number of seconds to wait before shutting down
  Returns:
    Message indicating status of the shutdown request
  Throws:
    java.lang.Exception - if there is an error

### shut

    public java.lang.String shut()
                          throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Shuts down a WebLogic Server from a T3Client immediately.

  This is a privileged method that can only be invoked on a T3Client that has specified the T3User "system".

  Returns:
    Message indicating status of the shutdown request
  Throws:
    java.lang.Exception - if there is an error

### shut

    public java.lang.String shut(java.lang.String message,
                                 int waitSecs)
                          throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Shuts down the WebLogic Server with the specified message after the specified time interval.

  Parameters:
    `message` - Message to include in the exception for subsequent login attempts
    `waitSecs` - Number of seconds to wait before shutting down
  Throws:
    java.lang.Exception - if there is an error

### cancelShut

    public java.lang.String cancelShut()
                                throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Cancels a pending shutdown of a WebLogic Server.

  This is a privileged method that can only be invoked by a T3Client that has connected with the T3User "system" and the system user's password.

  Returns:
    Message indicating status of the cancel request
  Throws:
    java.lang.Exception - if there is an error

### lockServer

    public java.lang.String lockServer(java.lang.String message)
                                throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Locks the Server against all non-privileged logins. All subsequent logins will get an exception with the specified "message" string in it. Currently logged in users are unaffected.

  Parameters:
    `message` - Message string to include in the exception for subsequent login attempts
  Returns:
    Message indicating status of lock request
  Throws:
    java.lang.Exception - if there is an error

### unlockServer

    public java.lang.String unlockServer()
                                  throws java.lang.Exception

  Deprecated.
  Unlocks the Server after a lock operation, to make it available for logins by all users.

  Returns:
    Message indicating status of unlock request
  Throws:
    java.lang.Exception - if there is an error

### licenses

    public java.lang.String licenses()
                              throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Gets information about the licenses of a WebLogic Server.

  Returns:
    License information
  Throws:
    java.lang.Exception - if there is an error

### version

    public java.lang.String version()
                             throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Gets the version of a WebLogic Server from a T3Client.

  Returns:
    Version information
  Throws:
    java.lang.Exception - if there is an error

### enableWatchDog

    public void enableWatchDog(int intervalSecs)
                        throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Enables a T3Client as an administrative WatchDog.

  When a client is a WatchDog, the client is responsible for invoking the ping() method every intervalSecs seconds. The ping() will check that the WebLogic Server is still alive and reset the WebLogic Server's internal WatchDog timer. If the WebLogic Server fails to receive a ping within this interval, it will restart itself.

  It is bad form to only call ping() every intervalSecs. If there is a transient network problem, then you will have squandered your only chance to restart the server. In practice, a WatchDog should send a ping three or four times per intervalSecs. So, if intervalSecs is 60, you probably want to invoke ping() every 15-20 seconds.

  Note that the T3Administrator can (and probably should) invoke T3Client.setSoftDisconnectTimeoutMins(int minutes) to some number greater than intervalSecs*60, and then periodically T3Client.disconnect(), and then instantiate a new T3Client with the same workspaceID. This will permit the WatchDog to not only test the existing socket to the WebLogic Server, but also the ability of T3Clients to connect to WebLogic.

  This is a privileged method, and can only be invoked on a T3Client that has specified a T3User of "system" and supplies the system password.

  Parameters:
    `int` - Seconds between ping
  Throws:
    java.lang.Exception - if there is an error

### disableWatchDog

    public void disableWatchDog()
                         throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.
  Disables this T3Client as an administrative WatchDog. You must do this before you exit your program or permanently disconnect(), otherwise the WebLogic Server will restart itself.

  This is a privileged method, and can only be invoked on a T3Client that has specified a T3User of "system".

  Throws:
    java.lang.Exception - if there is an error

### threadDump

    public void threadDump()
                    throws java.lang.Exception

  Deprecated. Deprecated in WebLogic Server 6.1.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Documentation is available at http://e-docs.bea.com/wls/docs81
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD