|
add (zLog) |
Scroll |
Next, the configuration file must be updated by adding an entry for each target Engine using the add command.
Syntax
sqdconf add <cab_file_name>
--key=<name>
--datastore=<url>
[--active | --inactive]
Note, only one source --key and target --datastore (subscription) can be added at a time.
Keyword and Parameter Descriptions
<cab_file_name> - Must be specified and must match the name specified in the previous create command.
--key=<name> - Source object name. That will be the VSAMDD in the CICS File Control Table (FCT) for the VSAM Capture and the RECALIAS parm from the Keyed FIle Compare Capture. The IMS Log Captured provide more flexibility:
•<DBD> | < DBD.segment> Short system name for IMS Database Description and Segment as defined in IMS.
•< DBD.Area> Short system name for IMS Database Description and Area as defined in IMS.
•< DBD.Partition> Short system name for IMS Database Description and Partition as defined in IMS.
•< PSB.DBD> Short system name for IMS PSB and Database Description as defined in IMS.
•< SSID.DBD> Short system name for IMS Source System ID and Database Description as defined in IMS.
Note: When used with TM Exit Capture, must be a subset of the Object Source Routing provided in the XPARM.
--datastore=<url> | -d <url> - While most references to the term datastore describe physical entities, a datastore URL represents a target subscription and takes the form: cdc:///<target_name> where
<target_name> is the subscriber name presented in the connection "URL" cdc://<host_name>/<agent_alias>/<target_name> by a requesting target agent. Often referred to as the Engine or subscription name. The name provided here must be in the connection "URL" but may not match the one specified in a local Controller Daemonsqdagents.cfg configuration file because it is usually a parameter supplied when the engine is parsed (SQDPARSE) or run (SQDENG).
[--active | --inactive] - Mark a source object as active or in-active for publishing. The source object will remain in the current state until the publisher is stopped, applied and re-started. The default is --inactive.
Note:
1.It is important to develop a standard for how Datastores also known as target subscriptions will be identified, particularly if a large number of Datastores will be defined.
2.--key - Precisely recommends using the DBD Name for each IMS DBD when using the IMS TM Exit Capture because the XPARM can accommodates Subset Routing where wild cards may have been specified.
3.The use of the --key parm to effectively Filter the data based on various IMS database attributes can also be supplemented by use of the IMS Log Reader Capture Filter Exit.
