You are here: Available Utilities > A > ARCRET > Using the Plug-ins > PLGGenArc

Using the PLGGenArc Plug-in

This plug-in accepts output from the ARCRET utility and executes the GenArc program to archive your transactions to another system.

Note

For this discussion, source refers to archive system where the ARCRET utility is reading transactions. Destination refers to the new archive system where the GenArc program will save transactions retrieved from the source.

Before you use this plug-in, make sure your system can successfully...

Retrieve transactions from your source archive system. This involves INI options in a file which this discussion refers to as the FSIOLD.INI file.
Add transactions to your destination archive system. This involves INI options in a file which this discussion refers to as the FSINEW.INI file.

Make sure the TriggerToArchive control group is in the (source) FSIOLD.INI file and that you map the archive index fields defined in the APPIDX.DFD file to the corresponding fields in the TRNDFDFL.DFD file. The field names between the two DFD files don't have to be the same. In the FSIOLD.INI, add these options:

< ArcRet >

PlugInMod = PLGW32.DLL

PlugInFunc = PLGGenArc

< GenArcPlugIn >

INIFile = FSINEW.INI

The options in the ArcRet control group identify the plug-in function the ARCRET utility will use. The INIFile option in the GenArcPlugIn control group identifies the INI file that should be supplied to the GenArc program by the plug-in.

Use a command similar to this one to run the ARCRET utility:

ARCRET /INI=FSIOLD.INI

This tells the ARCRET utility to use the correct INI file to retrieve from your source archive. When the plug-in is called, the batch files created by the ARCRET utility are automatically added to the INI file you named. In part, the changes will be to several options in the Data control group, such as those shown here:

< Data >

NAFile =

NewTrn =

POLFile =

The plug-in then starts a GenArc session and sends to it a temporary INI file created by combining these options. If you have successfully tested your GenArc program setup using the INI file you named, it should work without further intervention.