File Mapping Configuration

If you'll be using the ISAM Agent, you must provide information about the files to be replicated using the IsamFileMapping property within MasterConfig.json.

File Maping Configuration

{
  "IsamFileMapping": {
    "Logicals": {
      "SIP_DAT": "C:/DEV/SYNERGEX/IntegrationPlatformData/replica",
      "STOW_DATA": "C:/DEV/SYNERGEX/IntegrationPlatformData/replica",
      "LDATAS": "C:/DEV/SYNERGEX/IntegrationPlatformData/replica"
    },
    "Mappings": [
      {
        "Enabled": true,
        "FileName": "EMPLOYEE.ISM",
        "FileSpec": "SIP_DAT:EMPLOYEE.ISM",
        "FileType": "ISAM",
        "RecordLength": 300,
        "FileAttributes": "FIXED,COMPRESS,DENSITY=50,PAGE=1024,TBYTE",
        "IsamKeys": [
          "START=1,LENGTH=8,NAME=EMP_ID,TYPE=DECIMAL,ORDER=A,DENSITY=50,NODUPS,NOMODIFY",
          "START=49,LENGTH=15,NAME=EMP_DEPT,ASCEND,DENSITY=50,DUPS,ATEND,MODIFY",
          "START=29,LENGTH=20,NAME=EMP_LAST_NAME,TYPE=NOCASE,ORDER=A,DENSITY=50,DUPS,ATEND,MODIFY",
          "START=218,LENGTH=2,NAME=STATE_CODE,TYPE=ALPHA,ORDER=A,DENSITY=50,DUPS,ATEND,MODIFY",
          "START=220,LENGTH=5,NAME=ZIP_CODE,TYPE=DECIMAL,ORDER=A,DENSITY=50,DUPS,ATEND,MODIFY"
        ],
        "IsamReplicationKeyNum": 0,
        "RequiresReplicationKey": false,
        "ReplicationKeyPosition": 0,
        "Revision": 1,
        "Created": "20240901000000000000"
      }
    ]
  }
}

The ISAMReplicatorFileInfo utility can help you generate this information.

Configuration Properties

Property	Type	Description
Logicals	String dictionary	A dictionary of logical names to be set in the ISAM Agent environment.
Mappings	Object array	An array of file mapping objects, one per file being replicated.

File Mappings

Property	Type	Description
Enabled	Boolean	Is replication for this file enabled?
FileName	String	The base name of the file being replicated.
FileSpec	String	The full file spec used by the application to access the file. May be case sensitive.
FileType	String	The type of file, ISAM or RELATIVE.
RecordLength	Integer	The length of each record in the file or the maximum record length in a multi-record-format file.
FileAttributes	String	The file attributes string to use when creating an ISAM file with XCALL ISAMC.
IsamKeys	Array of string	The key definition strings to use when creating an ISAM file with XCALL ISAMC.
IsamReplicationKeyNum	Integer	The number of the unique key to use to synchronze changes when processing an ISAM file.
RequiresReplicationKey	Boolean	Do new records require a REPLICATION_KEY to be populated because the ISAM file had no unique keys?
ReplicationKeyPosition	Integer	The position of the REPLICATION_KEY within the record.
Revision	Integer	The revision number of this file mapping definition.
Created	String (datetime)	The date and time (YYYYMMDDHHMMSS) that the file mapping was created.