Stopping jAgent

This section helps you to shutdown the running Agents using the normal OS options.

Agent as Background Process

You can stop the Agent, which is running as background process in the following platforms:

• Windows - Stop the services from services.msc or use the net stop command
• Unix - Use the kill command

Agent as Foreground Process

You can stop the Agent, which is running as foreground process by:

• Pressing Ctrl-C
• Closing the agent window in the case of Windows
• Using the tafc_agent_shutdown command

tafc_agent_shutdown Command

When a tafc_agent is run either as a service or process, it spawns child processes, which inherits the same listener port number as the agent.

When a service is stopped, it’s spawned processes are also stopped. When an agent is run in the foreground, the spawned children are not always shutdown with it.

Operating system prevents the creation of another application, which uses the same listener port credentials. So, if agent needs to be restarted and child processes have this PORT number, then the agent will be prevented from starting up.

You can shutdown the spawned children of a particular jAgent with the tafc_agent_shutdown command.

You can start the jAgent with the –p option as shown below.

Commands			Description
jbase_agent –p 54321	or	tafc_agent –p 54321	54321 is the listener port
tafc_agent	or	jbase_agent	Starts the agent on the default port 20002

Stopping Spawned Children

You can stop the spawned children using the following commands.

Commands			Description
jbase_agent –p 54321	or	tafc_agent –p 54321	54321 is the listener port
tafc_agent	or	jbase_agent	Starts the agent on the default port 20002
To stop spawned children, execute the following commands.
jbase_agent_shutdown <port_number>	or	tafc_agent_shutdown <port_number>	For example, <port_number> is 54321.
stafc_agent_shutdown 20002	or	jbase_agent_shutdown 20002	Possible output if child process has been stopped
logoff.exe -1 PID = 3068

The shutdown command uses the following to get process related information.

• Process Status (ps) in the case of Unix based systems
• Windows Management Instrumentation Comand (wmic) in the case of Windows based systems

If the Unix command ps or the Windows command wmic.exe is not in its default place, then the location can be overridden with the following environment settings.

• In case of Windows,

  WMIC_PATH=c:\windows\system32\wbem\wmic.exe

• In case of Linux,

  PS_PATH=/bin/ps