Please enable JavaScript to view this site.

Navigation: Change Data Capture > IMS z/OS > IMS TM EXIT Capture > Operation

Start / Maintain CDCzLog Publisher

Scroll

How the Publisher Agent is "Started" depends on how it was "Stopped". Before simply resubmitting the JCL configured earlier in sample member SQDZLOGC, we recommend checking the status using the sqdconf utility using JCL similar to the following where the only input is the display command and the Publisher Agent cab file:

//*-----------------------------------

//*-  DISPLAY CONFIG FILE            

//*-----------------------------------

//DISPLAY   EXEC SQDCONF,OWNER=&SYSUID

//SQDPARMS DD *                      

  display /home/sqdata/imspub1/IMSPUB1.cab

//*                                  

 

If the Publisher Agent is "Not Mounted" then it will be necessary to "Mount" the CDCzLog Publisher Agent by submitting the JCL configured earlier in sample member SQDZLOGC but with only the following SQDPARMS input:

//SQDPARMS DD *

  /home/sqdata/imspub1/IMSPUB1.cab

 

Then depending on what you want to accomplish submit one or more sqdconf utility jobs with JCL similar to the following with the desired command and the Publisher Agent cab file. The final job would contain the start command and look like the following:

//*---------------------------------------------------

//*-  UPDATE Publisher AGENT

//*---------------------------------------------------

//START   EXEC SQDCONF,OWNER=&SYSUID                  

//SQDPARMS DD *                                      

  start /home/sqdata/imspub1/IMSPUB1.cab

//

 

Other <command> options include:

1.Add - Add a "source" to the list of items to be captured - Defaults to INACTIVE status, Must be "active" at the "source" level and APPLIED to truly become Active

2.Apply - Commit changes to the active configuration - Must be MOUNTED and STOPPED. Without APPLY even a "restart" does not commit.

3.Modify - Change some information relative to an agent. Changes are inactive until APPLIED.

4.Remove - Remove a "source" from the list of items to be captured. Must be APPLIED to truly become inactive

5.Start - Activates an agent. Must be Mounted and not already Started

Console commands that may be issued, with the proper authority include:

Command Function

Description

P <task_name>

Stops and unmounts the agent immediately

F <task_name>,PAUSE

Pauses the agent

F <task_name>,RESUME

Resumes the agent after a pause

F <task_name>,DISPLAY

Display of the agent cab file with the output being written to SYSPRINT in the running STC

F <task_name>,STOP

Stops the agent but leaves it mounted

F <task_name>,STOP,UNMOUNT

Stops and unmounts the agent (same as P command)

F <task_name>,STOP,FLUSH

Stops the agent after flushing out any UOWs that began before the command was issued, then unmounts

F <task_name>,STOP,FLUSH,FAILOVER

Same as STOP,FLUSH  except that it instructs downstream engines to try to reconnect for up to 10 minutes

F <task_name>,START

Starts an agent that was previously stopped, but still mounted

F <task_name>,APPLY

Applies pending cab file changes to the agent's cab file.  Agent must be mounted, stopped in order to apply