SETBKMK - Set bookmark

CAUTION:
Improper use of this command can result in data loss or data duplication. You should only execute this command when directed by IBM Technical Support.

Use this command on your InfoSphere® CDC source system to set the replication position (bookmark) in the stream of change data for a subscription. You can obtain the replication position for a subscription with the showbkmk or dmshowbookmark commands, which is executed on your InfoSphere CDC target system.

Read syntax diagramSkip visual syntax diagram FMODIFY procname.identifier,SETBKMK, NAME=subscription DSN=dataset
NAME=subscription
Identifies the subscription that is to have its bookmark set.

Only one subscription can be specified.

Note: The subscription must be idle in order for this command to run successfully. If SETBKMK is run while the subscription is active, an error message will be issued and the original bookmark will remain in place.
DSN=dataset
Identifies the fully qualified name of the input dataset containing the bookmark

This can be the output of the SHOWBKMK command dataset on z/OS. or the XML output of the dmshowbookmark command on distributed platforms. The XML output from distributed platforms should be transferred as characters, such as when using FTP use ASCII transfers.

Examples

MODIFY CHCAS,SETBKMK,NAME=SUB1,DSN=MYUSER.BOOKMARK.XML

Sets the bookmark for subscription SUB1 from dataset MYUSER.BOOKMARK.XML.