Maintaining Initial-State Definitions

#### Search Results

Search

# Maintaining Initial-State Definitions

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:

- Listing Initial-State Definitions

- Adding Initial-State Definitions

- Modifying Initial-State Definitions

- Copying Initial-State Definitions

- Deleting Initial-State Definitions

You can populate a database with initial-state data using the Adabas Event Replicator Subsystem. For more information, read Populating a Database With Initial-State Data.

In addition, you can populate a database with initial-state data from a client application. For more information, read Event Replicator Client Requests.

## Listing Initial-State Definitions

To use the Adabas Event Replicator Subsystem to list the initial-state definitions stored in the Replicator system file:

- Select option I from the Adabas Event Replicator Subsystem Main Menu.

  The List of Initial-State Definitions screen appears showing all of the initial-state definitions in the Adabas Event Replicator Subsystem.

      15:12:32      ***** A D A B A S  EVENT REPLICATOR SUBSYSTEM *****    2013-02-28
                            List of Initial-State Definitions              M-RP1500

       Sel   Name         Sel   Name         Sel   Name         Sel   Name
       --------------     --------------     --------------     -------------
        _  I040155         _                  _                  _
        _  I042060         _                  _                  _
        _  I042200         _                  _                  _
        _  I046088         _                  _                  _
        _  I062026         _                  _                  _
        _  I062029         _                  _                  _
        _  I062035         _                  _                  _
        _  I062055         _                  _                  _
        _  I062079         _                  _                  _
        _  I062143         _                  _                  _
        _  I064121         _                  _                  _
        _  I120248         _                  _                  _
        _  I215168         _                  _                  _
        _                  _                  _                  _

      Command ==>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Repos Exit  Add                -     +                      Menu

The function keys on this screen perform the following functions:

Function Key | Description
--- | ---
PF1/F1 (Help) | Provides you with help for this screen.
PF2/F2 (Repos) | Provides you with a pop-up panel that allows you to specify the name of the definition you want to locate in the list. Once you have specified a name on the pop-up panel and pressed Enter, the list is repositioned so the name you selected appears first. You can use an asterisk as a wild card character at the end of the definition name or partial definition name you specify on the pop-up panel. Or, you can simply enter the first few characters of the name to reposition the list to the first occurrence in the list of a name starting with those characters.
PF3/F3 (Exit) | Returns you to the previous screen.
PF4/F4 (Add) | Allows you to add a new definition. A new screen appears.
PF7/F7 (-) | Allows you to scroll backwards through the list of definitions.
PF8/F8 (+) | Allows you to scroll forwards through the list of definitions.
PF12/F12 (Menu) | Returns you to the main menu.

## Adding Initial-State Definitions

This section describes the steps you must complete to use the Adabas Event Replicator Subsystem to add an initial-state definition to the Replicator system file:

- Step 1. Access the Initial-State Definition Area of the Adabas Event Replicator Subsystem

- Step 2. Supply a Name for the Initial-State Definition

- Step 3. Specify the Number of Concurrent Initial-State Requests Possible for the Initial-State Definition

- Step 4. Select Destinations, Subscriptions, and Files for the Initial-State Definition

- Step 5. Save the Initial-State Definition

### Step 1. Access the Initial-State Definition Area of the Adabas Event Replicator Subsystem

To access the initial-state definition area of the Adabas Event Replicator Subsystem:

1. Select option I from the Adabas Event Replicator Subsystem Main Menu.

   The List of Initial-State Definitions screen appears.

2. Press PF4 on the List of Initial-State Definitions.

   The Initial-State Definition screen appears.

       15:13:07      ***** A D A B A S  EVENT REPLICATOR SUBSYSTEM *****    2013-02-28
                                  Initial-State Definition                  M-RP1510

              Initial-State Name .............................. ________
                 Initial-State Destinations ................... _
                 Initial-State Subscriptions .................. _
                 Num of Concurrent Initial-State Requests ..... _________1

       Sel IDBID IFile I  Selection Criteria
       ------------------------------------------------------------------------------
        _  _____ ____  _ ____________________________________________________________
        _  _____ ____  _ ____________________________________________________________
        _  _____ ____  _ ____________________________________________________________
        _  _____ ____  _ ____________________________________________________________
        _  _____ ____  _ ____________________________________________________________

       Command ==>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit        Save        -     +                       Menu

### Step 2. Supply a Name for the Initial-State Definition

On the Initial-State Definition screen, tab to the Initial-State Name field and specify a unique name for the initial-state definition. The name must use alphanumeric characters and be between one and 8 characters long.

### Step 3. Specify the Number of Concurrent Initial-State Requests Possible for the Initial-State Definition

On the Initial-State Definition screen, tab to the Num of Concurrent Initial State Requests field and specify the number of concurrent initial-state requests that can occur in a given instance of this initial-state definition. Valid values range from 1 to 2,147,483,647. The default is 1. This is the same as specifying the IMAXREQ parameter directly in the Event Replicator Server startup job.

### Step 4. Select Destinations, Subscriptions, and Files for the Initial-State Definition

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:

- Select Destinations for the Initial-State Definition
- Select Subscriptions for the Initial-State Definition
- Select Files for the Initial-State Definition

#### Select Destinations for the Initial-State Definition

To select destination definitions for the initial-state definition:

The destination definitions must be previously defined.

1. On the Initial-State Definition screen, enter an S in the Initial-State Destinations field.

   The Initial-State Destination List screen appears allowing you to select destinations for the replicated data that will be generated by this initial-state request.

       15:14:23      ***** A D A B A S  EVENT REPLICATOR SUBSYSTEM *****    2013-02-28
                               Initial-State Destination List               M-RP1520
                                          TEST

        Name            Name            Name            Name            Name
       -------------   -------------   -------------   -------------   -------------
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________

       Command ==>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit        Save  Sel                                 Menu

2. Tab to the Name field and specify the name of a destination definition to use for this initial-state definition. The destination definition must be previously defined.

   Or:
   Press the PF6 key to bring up a list of destination definitions already defined. Using this list you can select definitions for use by the initial-state definition. Simply place an S next to the destinations you want to use in the list. When all destinations are selected, press the PF5 key to accept your selections and close the list. The selected destinations will appear on the Initial-State Destination List screen.

   For more information about creating destination definitions, read Maintaining Destination Definitions.

3. Repeat Steps 1-2 until all destinations for this initial-state definition have been specified. Use PF7 and PF8 to scroll through the destinations you have added.

4. Press PF5 to save the destination list. Then press PF3 to return to the Initial-State Definition screen.

#### Select Subscriptions for the Initial-State Definition

To select subscription definitions for the initial-state definition:

The subscription definitions must be previously defined.

1. On the Initial-State Definition screen, enter an S in the Initial-State Subscriptions field.

   The Initial-State Subscription List appears allowing you to select subscriptions for the replicated data that will be generated by this initial-state request.

       15:15:29      ***** A D A B A S  EVENT REPLICATOR SUBSYSTEM *****    2013-02-28
                              Initial-State Subscription List               M-RP1530
                                          TEST

        Name            Name            Name            Name            Name
       -------------   -------------   -------------   -------------   -------------
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________

       Command ==>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit        Save  Sel                                 Menu

2. Tab to the Name field and specify the name of the subscription definition to use for this initial-state definition. The subscription must be previously defined.

   Or:
   Press the PF6 key to bring up a list of subscription definitions already defined. Using this list you can select definitions for use by the initial-state definition. Simply place an S next to the subscriptions you want to use in the list. When all subscriptions are selected, press the PF5 key to accept your selections and close the list. The selected subscriptions will appear on the Initial-State Subscription List screen.

   For more information about creating subscription definitions, read Adding Subscription Definitions.

3. Repeat Step 2 until all subscriptions for this initial-state definition have been specified. Use PF7 and PF8 to scroll through the subscriptions you have added.

4. Press PF5 to save the subscription list. Then press PF3 to return to the Initial-State Definition screen.

#### Select Files for the Initial-State Definition

To select files for the initial-state definition:

1. On the Initial-State Definition screen, tab to the IDBID field and 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.

2. Remaining on the same line, tab to the IFile field and specify the file number of an input file you want used for this initial-state definition. There is no default.

3. Tab to the I field and specify the filter method that should be used to process data from this input file. Valid values are:

   Value | Description
   --- | ---
   A | No filter method is used. All records from the input file are processed and replicated.
   I | Only records with ISNs that match those specified in the initial-state request will be replicated. 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) or in the client request (read ISN List Format).
   <blank> | If this field is left blank, the records are filtered based on Adabas search criteria you specify in the Selection Criteria field. Only records that meet the criteria are processed and replicated.

4. If you left the I field blank in the previous step, use the Selection Criteria field to specify any Adabas search criteria you want to use to select input data for processing. 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. The search criteria you specify should be in the same format used to specify an Adabas S1 command. For more information about the S1 command, read the Adabas command reference documentation.

5. Repeat Steps 1 through 4 until all the file specifications you want have been added to the initial-state definition. Use the PF7 and PF8 to scroll through the input database/file specifications for this initial-state definition.

   Use the Sel column to delete or copy file specifications in the initial-state definition. To copy a file specification, type a "C" in the Sel column. To delete a file specification, type a "D" in the Sel column.

6. Press PF5 to save the initial-state definition.

### Step 5. Save the Initial-State Definition

Press PF5 to save the initial-state definition.

## Modifying Initial-State Definitions

To use the Adabas Event Replicator Subsystem to modify an initial-state definition in the Replicator system file:

1. List the initial-state definitions in the Adabas Event Replicator Subsystem, as described in Listing Initial-State Definitions.

   The initial state definitions are listed on the List of Initial-State Definitions screen.

2. Locate the definition you want to modify on the screen and enter an M in the Sel column for that definition.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the name of the definition to which the list should be repositioned.

   The Initial-State Definition screen appears with the settings for the initial-state definition you selected. For information on modifying this screen, read the description of Adding Initial-State Definitions.

3. When all modifications have been made, press PF5 to save the changes.

## Copying Initial-State Definitions

To use the Adabas Event Replicator Subsystem to copy an initial-state definition in the Replicator system file:

1. List the initial-state definitions in the Adabas Event Replicator Subsystem, as described in Listing Initial-State Definitions.

   The initial state definitions are listed on the List of Initial-State Definitions screen.

2. Locate the definition you want to copy on the screen and enter a C in the Sel column for that definition.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the name of the definition to which the list should be repositioned.

   A dialog appears requesting a name for the copy of the initial-state definition.

        Enter new name: ________
        or press PF3 to cancel

3. Specify a new, unique name for the copy of the initial-state definition and press Enter.

   The initial-state definition is copied and the copy appears on the List of Initial-State Definitions screen.

## Deleting Initial-State Definitions

To use the Adabas Event Replicator Subsystem to delete an initial-state definition in the Replicator system file:

1. List the initial-state definitions in the Adabas Event Replicator Subsystem, as described in Listing Initial-State Definitions.

   The initial state definitions are listed on the List of Initial-State Definitions screen.

2. Locate the definition you want to delete on the screen and enter a D in the Sel column for that definition.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the name of the definition to which the list should be repositioned.

   The initial-state definition is deleted.

### On this page

- Listing Initial-State Definitions
- Adding Initial-State Definitions
- Modifying Initial-State Definitions
- Copying Initial-State Definitions
- Deleting Initial-State Definitions