SharePlex 8.6.6 - Reference Guide

disable jobs / enable jobs

Use the disable jobs and enable jobs commands to control whether jobs that are performed by the following synchronization commands are allowed to run:

• copy and copy using
• append and append using
• compare and compare using
• repair and repair using

The disable jobs command is a safeguard that ensures that the actions performed by those jobs do not get issued in a peer-to-peer or high-availability configuration. The command prevents the primary (trusted source) data from being overwritten with un-trusted data if a copy, append, repair, or repair using command is issued on the secondary system.

Use the enable jobs command to enable jobs on the primary (trusted) system when it becomes the active system again.

Usage

Syntax

Syntax description

Remote options

These options enable you to issue the command on a remote machine and to script commands that include a login name, password, port number, or combination of those items.

edit

Use the edit command in the following ways:

• To make changes to a SharePlex command that you previously issued. This saves time when you need to issue a command again, but with slightly different syntax, or if you need to correct a syntax mistake.
• To execute commands that contain more than 255 characters, a limitation of the operating system.

The edit command opens a temporary text file in the default text editor from within the sp_ctrl interface. You enter the command in the file, and it automatically executes when you save the file.

To use the edit command

1. If no commands were issued previously in the current session of sp_ctrl, type the first word of the command at the sp_ctrl prompt, then press Enter. Otherwise, skip this step. (Ignore the online help or error that is displayed.)

2. At the sp_ctrl prompt, issue the edit command to open a temporary text file.

   sp_ctrl(sysA)> edit

3. In the text file, use the editor’s standard commands to edit out any unwanted characters and type the command string.
4. Save and exit out of the file using the editor’s standard save command. The command executes immediately

Note: SharePlex provides keyboard shortcuts for the edit command in the for of the up arrow (  ) and the forward slash ( / ) keys.

Usage

Syntax

edit config

Use the edit config command to modify an inactive configuration file. This command opens the configuration in SharePlex’s default text editor. Modify and save the configuration using the tools provided by the editor.

You cannot directly edit an active configuration. You can copy an active configuration with the copy config command, and then edit the copy with the edit config command. When you activate the copy, the original configuration deactivates.

To view a list of configurations on a system, use the list config command. To view the contents of a configuration, use the view config command.

Usage

Syntax

Syntax description

Remote options

These options enable you to issue the command on a remote machine and to script commands that include a login name, password, port number, or combination of those items.

exit

Use the exit command to close the current session of sp_ctrl. Closing sp_ctrl does not shut down replication; all replication processes continue without interruption unless they have been stopped by a user. This command merely discontinues your session with sp_ctrl on that system. To run sp_ctrl again, change to the directory containing the SharePlex binaries and enter the ./sp_ctrl command (for Unix and Linux systems) or double-click the sp_ctrl shortcut (Windows systems).

There are no [on host] options for the exit command. It must be issued on the system where you want to stop running sp_ctrl.

This command is the same as the quit command.

Usage

Syntax