lsms

NPAC Agent Control

Lets you start, stop, or display status of an instance of the NPAC Agent for a particular region.

Keyword

lsms

Permission

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

Restrictions

Do not start an NPAC agent unless you have already created a regional database for it (see “npac_db_setup”).

Syntax

$LSMS_DIR/lsms <Action> <Region>

Options

None.

Parameters

Action

Function to perform on npacagent process. This is a mandatory parameter with the following values:

start
stop
status

Region

NPAC region associated with this npacagent process. This is a mandatory parameter with the following values:

Canada
Midwest
MidAtlantic
Southeast
Southwest
Northeast
Western
WestCoast

Sample Output

# Stop the NPAC Agent for the Canada NPAC
$ $LSMS_DIR/lsms stop Canada
Checking if npacagent is running....Yes.
 
Stopping npacagent....
OK.
 
npacagent stopped:   Wed Nov 30  16:28:26 2005
 
Command complete.
$
# Verify that NPAC Agent has terminated
$ $LSMS_DIR/lsms status Canada
Checking if npacagent is running. .. .No.
Command Complete.
# Restart the NPAC Agent for the Canada NPAC
>
$ $LSMS_DIR/lsms start Canada
Checking if npacagent is already running....No
 
Starting npacagent....
 
Verifying....OK.
 
npacagent started:   Wed Nov 30  16:29:45 2005
 
Command complete.

Possible Errors

Error Messages: lsms
Exit Code	Message	Cause	Suggested Recovery
1	Checking if npacagent is already running....Yes. npacagent is already running	Operator tried to startnpacagentwhen it was already running	No action necessary.
1	Checking if npacagent is running....No. npacagent is not running.	Operator tried to stopnpacagentwhen it was already stopped	No action necessary.
3	lsms: bind: errornumber	Attempt to bind UDP socket failed. errornumber is the error returned by bind.	Contact the My Oracle Support (MOS).
3	lsms: exec: errornumber	Attempt to exec npacagent process failed. errornumber is the error returned by exec.	Contact the My Oracle Support (MOS).
1	lsms: Failed to start npacagent	Execution of npacagent failed	Contact the My Oracle Support (MOS).
1	lsms: Failed to stop npacagent	Attempt to stop npacagent failed	Contact the My Oracle Support (MOS).
2	lsms:LSMS_DIR is not defined	LSMS_DIR environment variable is not set	Verify the environment variables.
3	lsms: send: errornumber	Attempt to send command to agent failed. errornumber is the error returned by send.	Contact the My Oracle Support (MOS).
3	lsms: socket: errornumber	Attempt to open UDP socket failed. errornumber is the error returned by socket.	Contact the My Oracle Support (MOS).
2	npacagent: Permission denied for npacagent or executable not found.	Operator does not have permission to execute this command or executable could not be found. The operator must be an lsmsadm user.	Change user to lsmsadm or lsmsall and try the command again. If the error persists, contact the My Oracle Support (MOS).
2	Unknown region ==>< region name > must be one of the following: Canada MidAtlantic Midwest Northeast Southeast Southwest WestCoast Western	Invalid NPAC region specified	Try the command again with a valid region name.
2	Usage: lsms [ start \| stop ] <region>	Invalid action specified	Try the command again with correct syntax.