Customizing FATS, FATAR, and FATSCOPY

There are no customizable default options in FATS and FATAR. All options for these two products are set via control statement operands. If you have only these two products, you may skip to Security.

The default values of many FATSCOPY’s COPY/SIM keywords are stored in the FATSCOPY Global Options Table. The original values of these defaults are shown as “delivered defaults” in the keyword descriptions in COPY/SIM Statement. Each FATSCOPY job reads this table to determine the current default values for each keyword. 

Displaying and modifying FATSCOPY defaults

The current default values can be displayed and changed using the FATZAPOP program that is provided with FATSCOPY. The keywords for which the default values can be changed are listed COPY/SIM Statement with asterisks (*), and are also listed below. FATZAPOP displays and/or modifies the FATSCOPY Global Options Table.

You must run FATZAPOP at least one time to define your tape management system to FATSCOPY, as described Activating the Tape Management Interface.

FATZAPOP JCL

To execute FATZAPOP as a batch job, use the following JCL:

FATZAPOP will write messages and a report to SYSPRINT.

Copy Options from a previous version (4.9.26 Or Later)

When you upgrade to a new release of FATSCOPY you will usually want to copy all FATSCOPY default options from the version that you are currently using. FATZAPOP’s COPY command statement will copy all defaults from the library whose DD statement is the operand of the FROMDD= keyword:

You can copy default options from releases 4.9.26 or later. Earlier versions of FATSCOPY  did not have an Option Table from which to copy values.

FATZAPOP command statements

The following command statements can be used with the FATZAPOP program:

• COPY ALL,FROMDD=oldlibrarydd – Copy default values from another version of FATSCOPY. This is described in detail above.
• ZAP keyword1=value1,keyword2=value2,… – Changes the default value of each option to the new value. Multiple ZAP command statements may be specified. In most cases, except at noted below, the allowed keywords and values for ZAP are the same as the corresponding keywords and values for the FATSCOPY  COPY/SIM statement.
• PRINT – Display the current values of all options in the FATSCOPY Global Options Table. Values that have been changed from their delivered defaults (the values shown COPY/SIM Statement section) will be marked with asterisks.
• AUDIT – Display the current values of the options in the FATSCOPY Global Options Table that have been changed from their delivered defaults. Options that have not had their values changed will not be displayed.
• RESET – Resets the values of all options in the FATSCOPY Global Options Table to their delivered default values. The resulting defaults will all match the values shown in this space unless RESET is followed by ZAP statements.

Setting defaults with the ZAP statement

The following FATZAPOP keywords are used with the ZAP command statement to save FATSCOPY defaults in the Global Options Table:

ZAP keyword=value is used to set FATSCOPY default values. The ZAP command takes the same keywords as the corresponding FATSCOPY keywords, and the allowed values are those listed in COPY/SIM Statement for each keyword, except for the following:

• To set “ABEND” as the FATSCOPY default, use ZAP ABEND=U0888. Or, to set “RETCODE” as the FATSCOPY default, use ZAP ABEND=RETCODE. (You cannot use ZAP RETCODE.)
• To set “SUPULAB” as the FATSCOPY default, use ZAP SUPULAB=YES. Or, to set “NOSUPULAB” as the FATSCOPY default, use ZAP SUPULAB=NO. (You cannot use ZAP NOSUPULAB.)
• ZAP EXCLUDE=dsn is used to save a DSN/mask into the Option Table that will prevent FATSCOPY from selecting a data set matching that name or mask. Up to 15 EXCLUDE defaults may be specified. ZAP UNEXCLUDE= is used to remove an existing EXCLUDE entry from the Option Table.
  
  To exclude or un-exclude multiple DSNs or masks, you may specify multiple ZAP statements, or you may specify a list of DSNs/masks on a single ZAP statement, enclosed in parentheses and separated by commas.
  
  Example:
  ZAP EXCLUDE=(NOT.THESE.**,NOT.THOSE.**)
• If you are using Control-M/Tape tape management, you must specify several data sets from your Control-M/Tape configuration:
  • CTTIOAPARM= Control-M/Tape IOA.PARM library name
  • CTTIOAENV= Control-M/Tape IOA.IOAENV library name
  • CTTMDB= Control-M/Tape Media Database Data File name
  • CTTMDI= Control-M/Tape Media Database Index File name
  • CTTSTKD= Control-M/Tape Stacking Statistics Data File name
  • CTTSTKI= Control-M/Tape Stacking Statistics Index File name
  • CTTTRC= Control-M/Tape Trace File name

To set value to a blank, code ‘ ‘ (single quote, blank, single quote) after the equals sign.

Example: ZAP HSMMIGMASK= ‘ ‘

Use ZAP VMFDSN=tlms.vmf.name only when you have TLMS tape management, as described Activating the Tape Management Interface.

You should carefully consider the implications of changing the defaults for CAT, TMSINPUT, and SORT. It is recommended to not changing the defaults for these three parameters. Changing these defaults may result in unexpected results for the cataloging (CAT) and retention (TMSINPUT) of data sets, and in the number of tape mounts required (SORT).

FATZAPOP Example

The following example sets the tape management interface to RMM, and then changes the default values for MULTIFILE, ECHO, and ABRARC. It also uses PRINT to display the new default values for all the options in the Global Options Table.