An initial-state definition defines an initial-state request for data from the target application. Initial-state definitions identify the subscription, destination, and specific Adabas files to use in an Event Replicator for Adabas run; at least one subscription, destination, or file must be specified.
Initial-state data can contain any subset of the data on the Adabas database, based on the specifications in the initial-state definition and parameters supplied in the initial-state request. Records can be selected for initial-state processing in one of the following manners:
The complete file can be selected.
Records are selected from the file based on an ISN list.
Records are selected from the file based on specified selection criteria.
Note:
Each replicated initial-state record contains the related data storage
after image. No before image is replicated for an initial-state record.
This document covers the following topics:
In addition, you can populate a database with initial-state data using the Adabas Event Replicator Subsystem or from a client application. For more information on populating a database with initial-state data from the Adabas Event Replicator Subsystem, read Populating a Database With Initial-State Data, in Adabas Event Replicator Subsystem User's Guide. For more information on populating a database with initial-state data from a client application, read Event Replicator Client Requests, in Event Replicator for Adabas Programmer's Reference Guide.
To use Event Replicator Administration to list the initial-state definitions stored in the
Replicator system file:
Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.
Click and expand Replication Definitions in tree-view under the selected database.
Click on Initial States in the tree-view under Replication Definitions.
A table listing the initial-state definitions in the Replicator system file appears in detail-view.
This section describes the steps you must complete to use Event Replicator Administration to add an initial-state definition to the Replicator system file:
Step 1. Access the Initial-State Definition Area of Event Replicator Administration
Step 3. Select Destinations, Subscriptions, and Files for the Initial-State Definition
To access the initial-state definition area of Event Replicator Administration:
List the initial-state definitions in Event Replicator Administration, as described in Listing Initial-State Definitions.
The initial-state definitions are listed in detail-view.
Right-click on Initial States in the tree-view under Replication Definitions.
A drop-down menu appears.
Click on Create New Initial-State in the drop-down menu.
A blank Initial State panel appears in detail-view.
To supply a name and the number of concurrent initial-state requests
possible for the initial-state definition:
In the table on the blank Initial State panel, use the Value columns to supply values for the following parameters:
Note:
The Initial State Destinations,
Initial State Subscriptions, and Initial State
Files parameters are not available immediately. These must be set by
modifying the initial-state definition after it is created.
Click to add the initial-state definition to the Replicator system file.
At least one subscription, destination, or file must be specified for an initial-state definition; all three may be specified, but at least one must be.
When one or more DBID/file combinations are specified in an initial-state definition, and one or more destinations or subscriptions are also defined, the initial-state data for the specified DBID/files are sent only to the specified destinations or as described by the specified subscriptions. In other words, delivery of the initial-state data in the files is restricted by the destination and subscription definitions. If no DBID/file combinations are specified in the initial-state definition, the specified destination and subscription definitions are used to construct a list of related DBID/files that should be used for the run.
This step describes how to:
To select destination definitions for the initial-state
definition:
The destination definitions must be previously defined.
Click to modify the initial-state definition.
The Initial State panel refreshes, allowing you to specify destinations, subscriptions, and files for the initial-state definition.
Click on the check mark in the Value column for the Initial State Destinations parameter (IDESTINATION parameter) .
The Destination List selection panel appears and allows you to select (and remove) destinations for the replicated data that will be generated by this initial-state request. The destination definitions must be previously defined.
Select and remove destination definitions in the table on the Destination List panel:
To select a destination for the initial-state definition, click on the name of a destination in the Destinations Available table and then click the right arrow button. The selected destination appears in the Destinations Selected table.
To remove a destination from the initial-state definition, click on the name of the destination in the Destinations Selected table and then click the left arrow button. The selected destination appears in the Destinations Available table.
When the destinations appear correctly in the two tables of the Destination List selection panel, click to approve the selections. The Initial State panel appears again in detail-view.
To select subscription definitions for the initial-state
definition:
The subscription definitions must be previously defined.
Click to modify the initial-state definition.
The Initial State panel refreshes, allowing you to specify destinations, subscriptions, and files for the initial-state definition.
Click on the check mark in the Value column for the Initial State Subscriptions parameter (ISUBSCRIPTION parameter) .
The Subscription List selection panel appears and allows you to select (and remove) subscriptions for the replicated data that will be generated by this initial-state request. The subscription definition must be previously defined.
Select and remove subscription definitions in the table on the Subscription List panel:
To select a subscription for the initial-state definition, click on the name of a subscription in the Subscriptions Available table and then click the right arrow button. The selected subscription appears in the Subscriptions Selected table.
To remove a subscription from the initial-state definition, click on the name of the subscription in the Subscriptions Selected table and then click the left arrow button. The selected subscription appears in the Subscriptions Available table.
When the subscriptions appear correctly in the two tables of the Subscription List selection panel, click to approve the selections. The Initial State panel appears again in detail-view.
To select files for the initial-state definition:
Click to modify the initial-state definition.
The Initial State panel refreshes, allowing you to specify destinations, subscriptions, and files for the initial-state definition.
Click on the check mark in the Value column for the Initial State Files parameter (IDBID, IFILE, ISNLIST, and SELCRIT parameters ) .
The IFILE List selection panel appears and allows you to select (and remove) database files for the replicated data that will be generated by this initial-state request.
Select and remove database files on the IFILE List panel.
To select a database file for the initial-state definition, click on the button. A blank line appears. Supply the following information for the database file
In the IDBID column, specify the database ID associated with an input file you want used for this initial-state definition. The database ID is numeric and can range from one to 65535. There is no default.
In the IFile column, specify the file number of an input file you want used for this initial-state definition. There is no default.
In the Filter Method column, specify what filter method will be used to process data from this input file. Valid values are All (no filter method is used; all records from the input file are processed and replicated), ISN List (the only records processed are those with the ISNs you specify in the initial-state request), and Selection Criteria (the only records processed are those that meet the search criteria you specify in the Selection Criteria column). If you elect to use an ISN list, be sure to supply an ISN list when you submit the initial-state request. The ISN list can be specified using the Adabas Event Replicator Subsystem (read Populating a Database With Initial-State Data , in Adabas Event Replicator Subsystem User's Guide) or in the client request (read ISN List Format in the section entitled Initial-State Requests in Event Replicator for Adabas Programmer's Reference Guide).
In the Selection Criteria column, specify any Adabas search criteria you want to use to select input data for processing (if Filter Method was set to Selection Criteria). If you specify search criteria, only the records in the input file that satisfy the search criteria will be processed. A maximum of a 60-byte search buffer is provided. There is no default.
To delete a database file from the list, click the check box in the corresponding All column to select it and then click the button.
When the database files appear correctly in the table of the IFILE List selection panel, click to approve the selections. The Initial State panel appears again in detail-view.
When all specifications have been made to your satisfaction, click to save the initial-state definition.
To use Event Replicator Administration to modify an initial-state definition in the Replicator
system file:
List the initial-state definitions in Event Replicator Administration, as described in Listing Initial-State Definitions.
The initial-state definitions are listed in detail-view.
Locate the definition you want to modify in the table in detail-view and click on it.
The Initial State panel appears in detail-view listing the current settings for the initial-state definition you selected.
Click the button.
The initial-state parameters you can modify become editable in detail-view. For information on modifying these parameters, read the description of Adding Initial-State Definitions.
When all modifications have been made, click to save the changes or click to cancel the changes.
To use Event Replicator Administration to copy an initial-state definition in the Replicator
system file:
List the initial-state definitions in Event Replicator Administration, as described in Listing Initial-State Definitions.
The initial-state definitions are listed in detail-view.
Locate the definition you want to copy in the table in detail-view and click on it.
The Initial State panel appears in detail-view listing the current settings for the initial-state definition you selected.
Click the button.
A copy of the initial-state definition is created and its parameter values appear in detail-view.
Specify a new, unique name for the copy of the initial-state definition in the Value column for the Initial-State Name parameter.
If you wish, modify any other parameters for the new copy in detail-view. For information on modifying the parameters, read the description of Adding Initial-State Definitions.
When all modifications have been made, click to save the changes or click to cancel the copy.
To use Event Replicator Administration to delete an initial-state definition in the Replicator
system file:
List the initial-state definitions in Event Replicator Administration, as described in Listing Initial-State Definitions.
The initial-state definitions are listed in detail-view.
Locate the definition you want to delete in the table in detail-view and click on it.
The Initial State panel appears in detail-view listing the current settings for the initial-state definition you selected.
Click the button.
A confirmation panel appears verifying that you want to delete the definition. If you click (indicating that you do want to delete the definition), the definition is deleted. If you click (indicating that you do not want to delete the definition), the definition is not deleted.
