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/imspub.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/imspub.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/imspub.cab
//
Other <command> options include:
- 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.
- Apply - Commit changes to the active configuration - Must be MOUNTED and STOPPED. Without APPLY even a "restart" does not commit.
- Modify - Change some information relative to an agent. Changes are inactive until APPLIED.
- Remove - Remove a "source" from the list of items to be captured. Must be APPLIED to truly become inactive.
- 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 |