With this macro, you can specify control information that is different from that specified by FLMCNTRL. You can specify different VSAM databases or flexible data set naming conventions to associate with a group.

When the ALTC parameter of the FLMGROUP macro matches the name of the FLMALTC macro, only the control information for the VSAM databases and data set naming conventions defined in the FLMALTC macro are used for that group.

The FLMALTC macro values override the ACCT, ACCT2, DSNAME, EXPACCT, VERS, VERS2, and VERPDS values from the FLMCNTRL macro. The FLMALTC macro does not use these values from the FLMCNTRL macro so you must specify all the parameters you want on the FLMALTC macro statement. Any values not available to the FLMALTC macro are taken from the FLMCNTRL macro.

Any number of FLMGROUP macros can reference a single FLMALTC macro. SCLM issues a warning if an FLMALTC macro is defined that is not referenced by any FLMGROUP macro.

Macro format

>>-name--FLMALTC--ACCT=primary_accounting_data_set-------------->

>--+--------------------------------------+--------------------->
   '-,ACCT2=secondary_accounting_data_set-'   

>--+----------------------+------------------------------------->
   '-,DSNAME=dataset_name-'   

>--+----------------------------------+------------------------->
   '-,EXPACCT=export_account_data_set-'   

>--+--------------------------------------+--------------------->
   '-,VERS=primary_audit_control_data_set-'   

>--+-----------------------------------------+------------------>
   '-,VERS2=secondary_audit_control_data_set-'   

>--+--------------------------+--+---------------------+-------><
   '-,VERPDS=version_pds_name-'  '-,XDEP=xdep_data_set-'   

Parameters

name

A unique 8-character name used to identify the control information defined by the FLMALTC macro. The name must be used in conjunction with the ALTC parameter of an FLMGROUP macro to indicate which set of information should be used for that group.

ACCT=primary_accounting_data_set

The name of the primary accounting data set to be used by any group referencing this FLMALTC macro. The data set you specify must be the name of the VSAM cluster you want to use. No SCLM variables can be used for this parameter.

,ACCT2=secondary_accounting_data_set

The name of the secondary accounting data set to be used by any group referencing this FLMALTC macro. Allocate this secondary VSAM data set following the same criteria as the primary accounting data set. Choose a unique name for this data set. It should reside on a different volume than the primary one. If a severe problem occurs with the primary data set (for example, a head crash on that disk), you can use this backup data set to restore the primary data set. The default is no secondary accounting data set.

Because additional accounting updates take place if you use this option, the updates will degrade performance. No SCLM variables can be used for this parameter.

,DSNAME=dataset_name

This parameter lets you specify the data set naming conventions for the partitioned data sets controlled by SCLM. The naming convention is specified as a pattern that can include a subset of the SCLM variables.

The only SCLM variables that can be used in the DSNAME parameter of FLMALTC are:

• @@FLMPRJ
• @@FLMGRP
• @@FLMTYP

The value specified in this parameter is used to resolve the SCLM variable @@FLMDSN. If this parameter is not specified, the data set name pattern defaults to @@FLMPRJ.@@FLMGRP.@@FLMTYP. You can enter up to 44 characters for this parameter, including the SCLM variables and the periods.

If a data set name is specified, it must include the SCLM variable @@FLMTYP. It is also recommended that the variable @@FLMGRP be used in the data set name pattern. This helps prevent data from one group overwriting data in another group.

Attention: SCLM does not enforce or guarantee the uniqueness of partitioned data set names.

The variables can appear in any location within the DSNAME parameter. Any user-specified qualifiers can also be used. The preceding SCLM variables will be substituted with values that range from 1 to 8 characters. When determining the length of the final data set name, assume that the SCLM variables will contain values that are the maximum (8) number of characters.

Examples of data set name lengths are:

• APPL1.@@FLMGRP.@@FLMTYP is 5 + 1 + 8 + 1 + 8 = 23
• @@FLMPRJ.@@FLMGRP.@@FLMTYP.COMMON is 8 + 1 + 8 + 1 + 8 + 1 + 6 = 33

The data set name must meet all of the requirements specified by the MVS™ data set naming conventions. If the data set name is too long or it does not meet MVS data set naming conventions, errors occur during SCLM functions (for example, build or promote).

,EXPACCT=export_account_data_set

The name of the export accounting data set used by any group referencing this FLMALTC macro. The data set you specify must be the name of the VSAM cluster you want to use and must have a different name from any ACCT or ACCT2 parameter specified in FLMCNTRL or any FLMALTC macro. These variables can be used in specifying the name of the export accounting data set name:

• @@FLMPRJ
• @@FLMGRP
• @@FLMUID

,VERS=primary_audit_control_data_set

The name of the primary audit control data set to be used by any group referencing this FLMALTC macro. If you do not specify a VERS value, audit and versioning operations are not performed for the group. If you specify the VERS keyword and omit the primary_audit_control_data_set name, SCLM does not verify the name, and errors occur later during processing. If you do not specify a name, the value is blank.

,VERS2=secondary_audit_control_data_set

The name of the secondary audit control data set to be used by any group in the project referencing this FLMALTC macro. If you specify the VERS2 keyword and omit the secondary_audit_control_data_set name, SCLM does not verify the name, and errors occur later during processing. If you do not specify a name, the value is blank.

Because additional audit record updates occur if this option is used, be aware that overall performance will degrade. Do not specify VERS2 unless you have specified VERS. If you do, an error will occur when the project definition is assembled.

,VERPDS=version_pds_name

The name of the partitioned data set to contain the version data. These variables can be used when specifying the name of the partitioned data set: @@FLMPRJ, @@FLMGRP, @@FLMTYP, and @@FLMDSN. For example:

• VERPDS=@@FLMPRJ.@@FLMGRP.@@FLMTYP.VERSION
• VERPDS=@@FLMDSN.VERSION
• VERPDS=@@FLMPRJ.VERSION.@@FLMGRP

This parameter is optional. If you do not specify a value, the value @@FLMDSN.VERSION is assigned to the parameter (even if versioning is not active). See the description of the DSNAME parameter for more information about the value of @@FLMDSN.

If @@FLMDSN is used, it must be specified in the first 8 characters of the VERPDS= statement. For example, VERPDS=@@FLMDSN.VERSN12 is valid, but VERPDS=@@FLMPRJ.@@FLMDSN.VERSN12 is invalid. The VERPDS parameter on the FLMALTC macro can be used to override the version data partitioned data set for a specific group or set of groups.

You can have only one VERPDS data set per group and type at a time. However, you can respecify the VERPDS data set name to control the size of the version data sets. If the VERS=primary audit control data set name remains the same, a pointer to the VERPDS that holds a particular version allows you to retrieve and delete versions of members, even if you have changed the name of the VERPDS data set.

The FLMATVER macro must be used to enable versioning for particular groups. If you specify a value of 2 or more for the VERCOUNT parameter on the FLMCNTRL macro, you must specify a separate VERPDS for each combination of group and type that you intend to version.

Note: Failure to specify a separate VERPDS for each combination of group and type can cause retrieval problems.

XDEP=xdep_data_set

The name of the cross-dependency file to be used to by any group referencing this FLMALTC macro. The name you specify must be the name of the VSAM cluster you want to use. No SCLM variables can be used for this parameter.

If one FLMALTC macro supplies an XDEP data set name, then all FLMALTC macros must supply an XDEP data set name if an XDEP data set name is not specified on the FLMCNTRL macro.

Example

PROJXYZ   FLMABEG

          FLMCNTRL ACCT=PROJXYZ.ACCT.DATABASE

RELCNTL   FLMALTC  ACCT=PROJ2.ACCT.DATABASE,                           C
                DSNAME=RELEASE.PROJ2.@@FLMGRP.@@FLMTYP

DEVCNTL   FLMALTC  ACCT=PROJDEV.ACCT.DATABASE,                         C
                DSNAME=SWDEV.@@FLMPRJ.@@FLMGRP.@@FLMTYP

REL       FLMGROUP KEY=Y,ALTC=RELCNTL
INT       FLMGROUP KEY=Y,PROMOTE=REL
DEV       FLMGROUP KEY=Y,PROMOTE=INT,ALTC=DEVCNTL