eagle

EAGLE Agent Control

Used to start, stop, or display status of an eagleagent process.

Keyword

eagle

Permission

The user must be logged in with the user name lsmsadm.

Syntax

$LSMS_DIR/eagle <Action> <CLLI>

Options

None.

Parameters

Action

The function to be performed on the eagleagent process. This mandatory parameter has the following values:

start
stop
status

<CLLI>

Common Language Location Identifier for the network element associated with this eagleagent process. This parameter is required when Action is start or stop. When Action is status, this parameter is optional; if not specified, the status for all eagleagent processes is displayed.

Sample Output

# Stop the EAGLE Agent for the network element whose CLLI is STPM1

$ $LSMS_DIR/eagle stop STPM1

eagle: Stopping...
eagle: eagleagent STPM1 stopped at Thu Mar  7 17:21:05 2002

# Verify that EAGLE Agent has stopped

$ $LSMS_DIR/eagle status STPM1

eagle: eagleagent STPM1 is not running.

# Restart the EAGLE Agent for the network element whose CLLI is STPM1

$ $LSMS_DIR/eagle start STPM1

eagle: Starting...
eagle: eagleagent STPM1 started at Thu Mar  7 17:17:36 2002

# Check the status of the EAGLE Agent for the network element whose CLLI is STPM1

$ $LSMS_DIR/eagle status STPM1

eagleagent:
                CLLI = STPM1
                 Pid = 72
               State = NONE_ACTIVE
              Resync = NO_CONNECTION
        Connection A = DOWN
        Connection B = DOWN
      DCM connection = NONE
                EBDA = IDLE
       Debug logging = OFF
       Pending queue = 0 of 2000000 bytes (0%)
 Keepalive timestamp = Thu Mar  7 17:19:02 EST 2002
      Virtual memory = 14392 K bytes
           CPU usage = 1.1 %

# Check the status of all EAGLE Agents

$ $LSMS_DIR/eagle status

CLLI        Pid   State       Resync        Conn A  Conn B  DCM     EBDA    Debug Queue  Memory  CPU  Timestamp
STPM0       ---   not running
STPM1       72    NONE_ACTIVE NO_CONNECTION DOWN    DOWN    NONE    IDLE     OFF    0 %   14 M  0.4 % 17:19:25 
STPM2       449   B_ACTIVE    IN_PROGRESS   DOWN    ACTIVE  NONE    RUNNING  OFF    0 %   12 M  1.0 % 17:19:23
STPO3       20179 A_ACTIVE    COMPLETE      ACTIVE  STANDBY OK      IDLE     OFF    0 %   14 M  0.3 % 17:19:27

Related Commands

None.

Response Notes

None.

Files

None.

Possible Errors

Table 1. Exit Codes: eagle
Exit Code	Cause	Suggested Recovery
1	Incorrect syntax.	Correct the syntax.
2	Invalid command for current state.	No action necessary.
3	Error in environment.	Verify the environment variables.
4	Unable to create socket.	Contact the My Oracle Support (MOS).
5	Unable to bind socket.	Contact the My Oracle Support (MOS).
6	Fatal application error.	Contact the My Oracle Support (MOS).
7	Operation failed.	Contact the My Oracle Support (MOS).
This command is usually run by scripts; scripts should search for exit codes. When the command is run from the command line, the output indicates suggested recovery.