ASNCOPY, the mobile replication enabler, is the program that controls the execution of the Capture and Apply programs. You can specify parameters to run the mobile replication enabler when you invoke ASNCOPY from the command line. You can also specify mobile replication enabler parameters from the mobile graphical interface. To execute the mobile graphical interface, type ASNMOBIL from the command line. For more information about the mobile graphical interface see "Starting the Mobile Replication Enabler Using the Mobile Graphical Interface"
Table 19 lists the parameters that you can specify for the ASNCOPY command. These
parameters are not case sensitive.
Table 19. ASNCOPY Command Parameters
| Parameter | Explanation |
|---|---|
| -T | Activates the trace option. You can set the trace option on from the Mobile GUI. When the trace is set on, information about all database activity will be written to a file called ASNCOPY.TRC. The Apply program trace is written in a file called <apply_qual>.TRC, where <apply_qual> is the Apply qualifier value, for the OS/2 platform and in a file called APPLYYYYYMMDDHHMMSS.TRC for the Windows NT and 95 platforms. The Capture program trace is written in the trace table called ASN.IBMSNAP_TRACE. |
| -H | Holds the communication line connection even after all answer sets are fetched. When this parameter is not specified, the Apply program disconnects the link between the target and source servers by calling the disconnect user exit program as soon as all of the answer sets are fetched. This is done to minimize the line connection time. If you do not specify this parameter, you might not be able to repeat a copy, which might be needed if the target server log file overflows. This problem is not detected until after the link is disconnected. Retry the failed copy with this parameter specified. If overflow is detected before the link is disconnected repeat copies are attempted regardless of whether this parameter is specified. |
| -L | Specifies that the Apply program call the ASNLOAD user exit program for a
full refresh. In the ASNLOAD user exit program ,you can invoke either the IBM
provided EXPORT/IMPORT or EXPORT/LOAD utilities, or any other programs for a
faster full refresh.
If referential constraints are defined between member tables of a replication subscription, you must use this option to bypass RI constraint checking while the tables go through a full refresh. |
| -F | Specifies the fast path. This parameter tells ASNCOPY not to call the Capture program. If this parameter is not specified, the Capture program is always called regardless of the copy direction. Use this option only if either no changes have been made to the local tables since the last Capture program run or the replication subscription to which all the changed tables belong is not to be copied. Otherwise, the changes will be lost. |
| -C | Specifies that ASNCOPY starts the Capture program with a cold start. If a cold start occurs, then all target tables are refreshed from the source tables and all changes made locally that were not applied to the source server are lost. If this parameter is not specified, ASNCOPY uses the WARMNS start option. The -C parameter is ignored if the fast path (-F) parameter is specified or if the Capture program is not installed. |
| -Q apply_qualifier | You must specify this parameter when the Apply qualifier is not the same as the user id. |
| -S set_name_list | Specifies a list of replication subscription names that you want to copy. |
| -U set_name_list | Specifies the copy up (WHOS_ON_FIRST = F) legs of replica sets. |
| -D set_name_list | Specifies the copy down (WHOS_ON_FIRST = S) legs of replica sets. |