Span Accessory Parameter File

The first time you run the Span Accessory on a particular database, the Span Accessory creates a parameter file for that database. This parameter file contains audit synchronization information (STATEINFO) for every data set in the database. You can then edit the parameter file that the Span Accessory created and designate the data sets you want to replicate. When you run the Span Accessory the second time, it uses the parameter file and replicates the data sets you designated.

The Span Accessory uses the parameter file to keep track of which data has been replicated. The parameter file also contains options that affect how the Span Accessory processes the records. The default title for the Span Accessory parameter file is as follows:

DATA/SPAN/databasename/CONTROL

For the format of the Span Accessory parameter file, note the following:

• For all TRUE entries, you can use the synonym YES; likewise, for all FALSE entries, you can use the synonym NO.
• You can enter the parameters in the parameter file in any order.
• You can enter multiple parameters on a single line.
• You can split parameters across multiple lines.
• There is no termination character.
• There is no continuation character.
• The comment character is the percent sign (%). The comment character can appear anywhere on a line and anything after the comment character is ignored.
• If you have a file name or family name that is the same as a parameter file keyword, enclose the file name or family name in quotation marks. For example, if you have a family named SUPPORT (which is also the name of an option in the Span Accessory parameter file) and you want to enter that for the AUDIT ON option, enclose SUPPORT in quotation marks, as follows:

  AUDIT ON "SUPPORT"

  This means that the audit files are on a family called SUPPORT.

• All parameters are optional except for the list of data set replication status.
• If a data set name has a hyphen, you must enclose the data set name in quotation marks.

  The remainder of this section describes the syntax and semantics of each parameter. However, before you edit or create a Span Accessory parameter file, read Running the Span Accessory.

  The first part of the parameter file contains all of the Span Accessory options listed in this section. Edit these as necessary.