asnacmd: Operating Apply

Use the asnacmd command to operate the Apply program on Linux, UNIX, Windows, and UNIX System Services (USS) on z/OS®. Run this command at an operating system prompt or in a shell script.

For information on using the MVS™ MODIFY command to send commands to a running Apply program on z/OS, see Working with running SQL Replication programs by using the MVS MODIFY command.

Syntax


>>-asnacmd--apply_qual=apply_qualifier-------------------------->

>--+------------------------+--+-status-+----------------------><
   '-control_server=db_name-'  '-stop---'

Parameters

Table 1 defines the invocation parameters.

Table 1. asnacmd invocation parameter definitions for Linux, UNIX, Windows, and z/OS operating systems
Parameter	Definition
apply_qual=`apply_qualifier`	Specifies the Apply qualifier that the Apply program uses to identify the subscriptions sets to be served. You must specify an Apply qualifier. The value that you enter must match the value of the APPLY_QUAL column in the IBMSNAP_SUBS_SET table. The Apply qualifier name is case sensitive and can be a maximum of 18 characters.
control_server=`db_name`	Specifies the name of the Apply control server on which the subscription definitions and Apply control tables reside. z/OS: The control server parameter is the name of the database server that connects to the control server. Linux, UNIX, Windows: If you do not specify an Apply control server, this parameter defaults to the value from the DB2DBDFT environment variable.
status	Specify to receive messages that indicate the state of each thread (administration and worker) in Apply.
stop	Specify to stop the Apply program in an orderly way.

Examples for asnacmd

The following examples illustrate how to use the asnacmd command.

Example 1

To receive messages about the state of each Apply thread:

asnacmd apply_qual=AQ1 control_server=dbx status

Example 2

To stop the Apply program:

asnacmd apply_qual=AQ1 control_server=dbx stop