Span Parameter File

The first time you run Span on a particular database, it 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 Span created and designate the data sets you want to replicate. When you run Span the second time, it uses the parameter file and replicates the data sets you designated.

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

DATA/SPAN/databasename/CONTROL

For the format of the Span 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 except for data set replication status 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 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 statuses.
• 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 parameter file, read Run the Span Accessory.

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