These instructions show you how to forcefully terminate SharePlex processes in cases where replication must be shut down immediately. In normal circumstances, follow the shutdown instructions in the following topics:

Run SharePlex on Unix and Linux

Run SharePlex on Windows

View and terminate processes on Unix and Linux

On Unix and Linux systems, you can use the ps -ef | grep sp_ command to view the SharePlex processes that are running.

• The sp_cop process is the root process.

• The following child processes are spawned by sp_cop on a source system:

  • Command and Control process (sp_cnc)
  • Capture (sp_ocap)
  • Read (sp_ordr)
  • Export (sp_xport)

• The following child processes are spawned by sp_cop on a target system:

  1. Command and Control process (sp_cnc)

  2. Import (sp_mport)
  3. Post (sp_opst_mt if the database is Oracle or sp_xpst if the database is Open Target)

Each child process has the same -uidentifier as its parent sp_cop process. This makes it easier to identify related processes when multiple session of sp_cop are running.

To terminate a SharePlex process on Unix and Linux

Or...

View and terminate SharePlex processes on Windows

On Windows systems, SharePlex is managed by the NuTCRACKER operating environment, rather than the Windows operating system. However, you can view and terminate SharePlex processes in the normal manner, as you would other Windows programs.

View SharePlex processes on Windows

You can view the SharePlex processes on Windows systems in the following ways:

• From the Command Prompt console using the tlist program provided with the SharePlex software.
• From the Windows Task Manager.

In the Windows Task Manager, SharePlex appears as Sp_Copsrv.exe, representing the SharePlex sp_cop process. The operating system controls the parent Sp_Copsrv.exe service. The parent Sp_Copsrv.exe process spawns child Sp_Copsrv.exe processes — one for each replication process (Capture, Read, Export, Import, Post, sp_ctrl, and so forth.).

For a standard uni-directional configuration replicating through default queues to one target system, there are following processes on a Windows system:

On the source system:

• One parent Sp_Copsrv.exe process.
• One Sp_Ocap or Sp_capture (Capture) process plus one child Sp_Copsrv.exe process.
• One Sp_Ordr (Read) process plus one child Sp_Copsrv.exe process.
• One Sp_Xport (Export) process plus one child Sp_Copsrv.exe process.
• If there are any additional SharePlex processes running, such as sp_ctrl, there is an additional Sp_Copsrv.exe process for each one.

On the target system:

• One parent Sp_Copsrv.exe process.
• One Sp_Mport (Import) process plus one child Sp_Copsrv.exe process.
• One Sp_Opst_Mt (Oracle Post) or Sp_Xpst (Open Target Post) process plus one child Sp_Copsrv.exe process.
• If there are any additional SharePlex processes running, such as sp_ctrl, there is an additional Sp_Copsrv.exe process for each one.

If there are no active replication configurations, the SharePlex processes do not start when you start the service, and just the parent Sp_Copsrv.exe will be running.

To identify the parent Sp_Copsrv.exe process in the Windows Task Manager, look for the one that is using the largest amount of memory. The child Sp_Copsrv.exe processes consume less memory than the parent process.

To identify which replication process is associated with a child Sp_Copsrv.exe process, look in the SharePlex Event Log for the message stating when the replication process started. This entry provides the PID for that process and the PID of the associated Sp_copsvr.exe process.

Terminate SharePlex processes on Windows

You can terminate SharePlex processes on Windows systems as follows:

• Windows Task Manager: Terminate one SharePlex process at a time
• KillSharePlex.bat: Terminate all SharePlex processes at once with a batch file.

To terminate a process with Task Manager

1. Press Control | Alt | Delete.
2. Select Start Task Manager or Task Manager, depending on your Windows version.
3. Select the Processes tab.
4. (Optional) Sort the processes by name.
5. Select the process that you want to kill.
6. Click End Process.

To terminate all processes with KillSharePlex.bat

Run KillSharePlex.bat from the bin sub-directory of the SharePlex product directory.

Note: This tool terminates all SharePlex processes without displaying them. There are no user prompts or confirmation messages.