Working with running Q Replication and Event Publishing programs by using the MODIFY command

After you start the Q Capture program, the Q Apply program, or the Replication Alert Monitor, you can use the MODIFY command to stop the program or to perform related tasks.

About this task

For descriptions of the parameters that you can use with MODIFY, see asnqccmd: Working with a running Q Capture program, asnqacmd: Working with a running Q Apply program, and asnmcmd: Working with a running Replication Alert Monitor.


Run the MODIFY command from the z/OS® console.
You can use the abbreviation f, as shown in the following syntax example:
Read syntax diagramSkip visual syntax diagramfjobname,Parameters

f jobname , replaces the actual command name: asnqccmd, asnqacmd, or asnmcmd. The operational parameters that apply to each of the commands can be used with the f keyword.


For example, to stop a running Q Apply program that uses the PLS job name, you would use the following command:

F PLS,stop

Table 1 shows the Q Capture commands that you can run with the f keyword. In all examples, the job name is myqcap.

Table 1. Sample MODIFY commands for the Q Capture program
Parameter Sample command that uses f keyword
capstop f myqcap,capstop=qsub_name
ignoretrans f myqcap,ignoretrans=transaction_ID
prune f myqcap,prune
qryparms f myqcap,qryparms
qstatus f mycap,qstatus=send_queue_name
reinit f myqcap,reinit
reinitq f myqcap,reinitq=send_queue_name
startq f myqcap,startq=send_queue_name
startq=all f myqcap,startq=all
f myqcap,stopq=send_queue_name
f myqcap,stopq=send_queue_name captureupto=timestamp|

f myqcap,stopq=send_queue_name stopafter=data_sent|data_applied
f myqcap,stopq=send_queue_name captureupto=timestamp|
  current_timestamp|eol stopafter=data_sent|data_applied
f myqcap,stop
f myqcap,stop captureupto=timestamp|current_timestamp|eol|logs_avail_after_disaster
f myqcap,stop stopafter=data_sent|data_applied
f myqcap,stop captureupto=timestamp|current_timestamp|eol|logs_avail_after_disaster
status f myqcap,status
status show details f myqcap,status show details
f myqcap,chgparms autostop=y|n
f myqcap,chgparms commit_interval=n
f myqcap,chgparms logreuse=y|n
f myqcap,chgparms logstdout=y|n
f myqcap,chgparms maxcapstarts_intload=n
f myqcap,chgparms monitor_interval=n
f myqcap,chgparms monitor_limit=n
f myqcap,chgparms prune_interval=n
f myqcap,chgparms qfull_num_retries=n
f myqcap,chgparms qfull_retry_delay=n
f myqcap,chgparms sleep_interval=n
f myqcap,chgparms signal_limit=n
f myqcap,chgparms term=y|n
f myqcap,chgparms trace_limit=n

Table 2 shows the Q Apply commands that you can run with the f keyword. In all examples, the job name is myqapp.

Table 2. Sample MODIFY commands for the Q Apply program
Parameter Sample command that uses f keyword
applycmd_interval f myqapp,applycmd_interval=n
loaddonesub f myqapp,loaddonesub=receive_queue_name:q_sub_name
mcgsyncon f myqapp,mcgsyncon=queue_name|queue_map_name
mcgsyncoff f myqapp,mcgsyncoff=queue_name|queue_map_name
prune f myqapp,prune
purgeq f myqapp,purgeq=queue_name|queue_map_name [after MCGSYNC]
qmapeventdefs f myqapp,qmapeventdefs=queue_map_name
qryparms f myqapp,qryparms
qstatus f myqapp,qstatus=receive_queue_name
stopsub f myqapp,stopsub=receive_queue_name:q_sub_name
stopq f myqapp,stopq=receive_queue_name
startq f myqapp,startq=receive_queue_name
startq;skiptrans f myqapp,startq=receive_queue_name;skiptrans=transaction_ID
reinitq f myqapp,reinit=receive_queue_name
stop f myqapp,stop
status f myqapp,status
status show details f myqapp,status show details
spillsub f myqapp,spillsub=receive_queue_name:q_sub_name
resumesub f myqapp,resumesub=receive_queue_name:q_sub_name
use_applycmd_table f myqapp,use_applycmd_table=y|n
f myqapp,chgparms autostop=y|n
f myqapp,chgparms dropris=y|n
f myqapp,chgparms deadlock_retries=n
f myqapp,chgparms eif_hbint=n
f myqapp,chgparms event_limit=n
f myqapp,chgparms logreuse=y|n
f myqapp,chgparms logstdout=y|n
f myqapp,chgparms monitor_interval=n
f myqapp,chgparms monitor_limit=n
f myqapp,chgparms prune_interval=n
f myqapp,chgparms term=y|n
f myqapp,chgparms trace_limit=n

Table 3 shows asntrc program commands that you can run with the f keyword. In all examples, the job name is myqcap.

Table 3. Sample MODIFY commands for the asntrc program
Task Sample command that uses f keyword
Start a program trace with the asntrc command
f myqcap,asntrc on
f myqcap,asntrc statlong
Format an asntrc fmt report and direct the output to a z/OS data set F myqcap, asntrc fmt -ofn //'USRT001.TRCFMT'
Format an asntrc flw report and direct the output to a z/OS data set F myqcap, asntrc flw -ofn //'USRT001.TRCFLW'
Stop a program trace F myqcap, asntrc off
Recommendation: Preallocate asntrc flw and fmt output files so that they are large enough to contain the asntrc reports. Use these attributes:
  • Data set name: USRT001.TRCFMT or USRT001.TRCFLW
  • Primary allocated cylinders: 2
  • Normal allocated extents: 1
  • Data class: None (Current utilization)
  • Used cylinders: 2
  • Record format: VB used extents: 1
  • Record length: 1028
  • Block size: 6144
  • 1st extent cylinders: 2
  • Secondary cylinders: 1
  • SMS compressible: NO

Table 4 shows the Replication Alert Monitor commands that you can run with the f keyword. In all examples, the job name is mymon.

Table 4. Sample MODIFY commands for the Replication Alert Monitor program
Parameter Sample command that uses f keyword
reinit f mymon,reinit
status f mymon,status
qryparms f mymon,qryparms
suspend f mymon,suspend
resume f mymon,resume
stop f mymon,stop
f mymon,chgparms monitor_interval=n
f mymon,chgparms autoprune=y
f mymon,chgparms trace_limit=n
f mymon,chgparms alert_prune_limit=n
f mymon,chgparms max_notifications_per_alert=n
f mymon,chgparms max_notifications_minutes=n