FLMCNTRL macro

Use this macro to specify project-specific control options. This macro can appear only once in any project definition.

If FLMCNTRL is not specified, it defaults to this definition for any group that does not have internal data sets explicitly defined through the FLMALTC macro:

   FLMCNTRL ACCT=project.ACCOUNT.FILE

Macro format


>>-+------------------------------------+----------------------->
   '-ACCT=-+-primary_account_data_set-+-'   
           '-project_account_file-----'     

>--+-----------------------------------+------------------------>
   '-,ACCT2=secondary_account_data_set-'   

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

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

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

>--+-------------------+--+--------------------------+---------->
   |           .-NO--. |  '-,VERPDS=version_pds_name-'   
   '-,VSAMRLS=-+-YES-+-'                                 

>--+----------------------------+------------------------------->
   '-,VERCOUNT=number_to_retain-'   

>--+------------------------------+----------------------------->
   '-,DSNAME=dataset_name_pattern-'   

>--+-------------------------------+---------------------------->
   |            .-SYSALLDA-------. |   
   '-,DASDUNIT=-+-DASD_unit_name-+-'   

>--+-----------------------------+------------------------------>
   |           .-VIO-----------. |   
   '-,VIOUNIT=-+-VIO_unit_name-+-'   

>--+------------------------------+----------------------------->
   |           .-60-------------. |   
   '-,MAXLINE=-+-max_line_count-+-'   

>--+----------------------------+--+-----------------+---------->
   |          .-5000----------. |  |           .-Y-. |   
   '-,MAXVIO=-+-max_vio_count-+-'  '-,OPTOVER=-+-N-+-'   

>--+-----------------+--+---------------------------+----------->
   |           .-N-. |  '-,CONTROL=control_data_set-'   
   '-,MEMLOCK=-+-Y-+-'                                  

>--+---------------------------------------+-------------------->
   '-,NPROMBK=not_promoted_backup_data_set-'   

>--+-------------------------------+---------------------------->
   '-,ADMINID=administrator_userid-'   

>--+----------------------------+------------------------------->
   '-,VERCC=change_code_routine-'   

>--+------------------------------+--+----------------------+--->
   '-,VERCCDS=change_code_dataset-'  |           .-LINK---. |   
                                     '-,VERCCCM=-+-ATTACH-+-'   
                                                 +-TSOLNK-+     
                                                 '-ISPLNK-'     

>--+------------------------------+----------------------------->
   '-,VERCCOP=change_code_options-'   

>--+-----------------------------------------+------------------>
   '-,CCVFY=initial_change_code_exit_routine-'   

>--+-------------------------------------------+---------------->
   '-,CCVFYDS=initial_change_code_exit_dataset-'   

>--+----------------------+------------------------------------->
   |           .-LINK---. |   
   '-,CCVFYCM=-+-ATTACH-+-'   
               +-TSOLNK-+     
               '-ISPLNK-'     

>--+-------------------------------------------+---------------->
   '-,CCVFYOP=initial_change_code_exit_options-'   

>--+---------------------------------------+-------------------->
   '-,CCSAVE=save_change_code_exit_routine-'   

>--+----------------------------------------+------------------->
   '-,CCSAVDS=save_change_code_exit_dataset-'   

>--+----------------------+------------------------------------->
   |           .-LINK---. |   
   '-,CCSAVCM=-+-ATTACH-+-'   
               +-TSOLNK-+     
               '-ISPLNK-'     

>--+----------------------------------------+------------------->
   '-,CCSAVOP=save_change_code_exit_options-'   

>--+--------------------------------------------------+--------->
   '-,AVDVFY=verify_audit_version_delete_exit_routine-'   

>--+----------------------------------------------------+------->
   '-,AVDVFYDS=verify_audit_version_delete_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,AVDVFYCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+----------------------------------------------------+------->
   '-,AVDVFYOP=verify_audit_version_delete_exit_options-'   

>--+--------------------------------------------------+--------->
   '-,AVDNTF=notify_audit_version_delete_exit_routine-'   

>--+----------------------------------------------------+------->
   '-,AVDNTFDS=notify_audit_version_delete_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,AVDNTFCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+----------------------------------------------------+------->
   '-,AVDNTFOP=notify_audit_version_delete_exit_options-'   

>--+------------------------------------------+----------------->
   '-,BLDINIT=build_initial_user_exit_routine-'   

>--+-------------------------------------------+---------------->
   '-,BLDINIDS=build_initial_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,BLDINICM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+-------------------------------------------+---------------->
   '-,BLDINIOP=build_initial_user_exit_options-'   

>--+----------------------------------------+------------------->
   '-,BLDNTF=build_notify_user_exit_routine-'   

>--+------------------------------------------+----------------->
   '-,BLDNTFDS=build_notify_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,BLDNTFCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+------------------------------------------+----------------->
   '-,BLDNTFOP=build_notify_user_exit_options-'   

>--+--------------------------------------------+--------------->
   '-,PRMINIT=promote_initial_user_exit_routine-'   

>--+---------------------------------------------+-------------->
   '-,PRMINIDS=promote_initial_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,PRMINICM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+---------------------------------------------+-------------->
   '-,PRMINIOP=promote_initial_user_exit_options-'   

>--+------------------------------------------+----------------->
   '-,PRMVFY=promote_verify_user_exit_routine-'   

>--+--------------------------------------------+--------------->
   '-,PRMVFYDS=promote_verify_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,PRMVFYCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+--------------------------------------------+--------------->
   '-,PRMVFYOP=promote_verify_user_exit_options-'   

>--+-----------------------------------------+------------------>
   '-,PRMCOPY=promote_copy_user_exit_routine-'   

>--+------------------------------------------+----------------->
   '-,PRMCPYDS=promote_copy_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,PRMCPYCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+------------------------------------------+----------------->
   '-,PRMCPYOP=promote_copy_user_exit_options-'   

>--+-------------------------------------------+---------------->
   '-,PRMPURGE=promote_purge_user_exit_routine-'   

>--+-------------------------------------------+---------------->
   '-,PRMPRGDS=promote_purge_user_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,PRMPRGCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+-------------------------------------------+---------------->
   '-,PRMPRGOP=promote_purge_user_exit_options-'   

>--+--------------------------------------+--------------------->
   '-,DELINIT=initial_delete_exit_routine-'   

>--+---------------------------------------+-------------------->
   '-,DELINIDS=initial_delete_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,DELINICM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+---------------------------------------+-------------------->
   '-,DELINIOP=initial_delete_exit_options-'   

>--+------------------------------------+----------------------->
   '-,DELVFY=verify_delete_exit_routine-'   

>--+--------------------------------------+--------------------->
   '-,DELVFYDS=verify_delete_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,DELVFYCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+--------------------------------------+--------------------->
   '-,DELVFYOP=verify_delete_exit_options-'   

>--+------------------------------------+----------------------->
   '-,DELNTF=notify_delete_exit_routine-'   

>--+--------------------------------------+--------------------->
   '-,DELNTFDS=notify_delete_exit_dataset-'   

>--+-----------------------+------------------------------------>
   |            .-LINK---. |   
   '-,DELNTFCM=-+-ATTACH-+-'   
                +-TSOLNK-+     
                '-ISPLNK-'     

>--+--------------------------------------+--------------------->
   '-,DELNTFOP=notify_delete_exit_options-'   

>--+------------------------------+--+-----------------+-------><
   '-,XDEP=-+-xdep_data_set-----+-'  '-,XDEPDYN=-+-Y-+-'   
            '-project.XDEP.FILE-'                '-N-'

Parameters

ACCT=primary_account_data_set|project.ACCOUNT.FILE

The name of the primary accounting data set for the project. The data set you specify must be the name of the VSAM cluster you want to use. The default accounting data set name is project.ACCOUNT.FILE, where project is the project name specified on the FLMABEG macro. The ACCT parameter on the FLMALTC macro can be used to override the primary accounting data set for a specific group or set of groups. No SCLM variables can be used for this parameter.

,ACCT2=secondary_account_data_set

The name of a secondary accounting data set for the project. 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. The ACCT2 parameter on the FLMALTC macro can be used to override the secondary VSAM accounting data set for a specific group or set of groups.

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

,EXPACCT=export_account_data_set

The name of the export accounting data set used for exporting or importing project accounting information. 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. The default is no export accounting data set. The EXPACCT parameter on the FLMALTC macro can be used to override the export accounting data set for a specific group or set of groups. 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 for the project. This parameter is required to perform audit and versioning for groups that do not reference an FLMALTC macro with VERS specified. If you specify the VERS keyword and omit the primary_audit_control_data_set name, errors occur later during processing. The default is no audit control data set.

,VERS2=secondary_audit_control_data_set

The name of the secondary audit control data set for the project. If you specify the VERS2 keyword and omit the secondary_audit_control_data_set name, errors occur later during processing. The default is no secondary audit control data set. The VERS2 parameter on the FLMALTC macro can be used to override the secondary audit control data set for a specific group or set of groups.

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.

,VSAMRLS=NO|YES

Indicates whether SCLM should allow the VSAM data sets to be shared across systems when the level of DFSMS installed is 1.3 or later. The default is NO.

SCLM uses VSAM Record Level Sharing (RLS) to allow the sharing of the VSAM data sets. To maintain the integrity of the VSAM data sets in a shared environment, the VSAM data sets must be allocated for RLS and all hardware and software to support RLS must be in place for the system. (See the DFSMS documentation for hardware and software requirements.)

The VSAM data sets cannot be shared under any other condition. Accessing any of the VSAM data sets from multiple systems when VSAM RLS is not available can result in the corruption of data, system errors, or other integrity problems. To avoid these problems, the project manager must allocate the VSAM data sets so that they cannot be accessed from multiple systems.

,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, and @@FLMTYP, or @@FLMDSN. For example:

VERPDS=@@FLMPRJ.@@FLMGRP.@@FLMTYP.VERSION
VERPDS=@@FLMDSN.VERSION
VERPDS=@@FLMPRJ.VERSIO.@@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 not valid. 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.

,VERCOUNT=number_to_retain

The number of versions to keep in the version partitioned data set. If you specify a value of 0 (the default), all versions associated with a member will be kept. If you specify a value of 2 or more, each time a member is saved or promoted, the latest copy of the version is stored and the earliest copy is disposed. Any audit records that were associated with the version are retained but will no longer indicate that a version of the member exists. If you do specify a value of 2 or more, allocate a separate VERPDS for each combination of group and type that has versioning enabled.

Note: Failure to allocate a separate VERPDS for each combination of group and type can cause retrieval problems. Use the FLMALTC macro, or use the @@FLMGRP variable in the VERPDS name.

If you specify a value of 1, an error will occur when the project definition is assembled. The only version maintained in this case would be a full source copy of the member that exists in the project hierarchy.

,DSNAME=dataset_name

This parameter lets you specify the data set naming conventions for the project 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 FLMCNTRL 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 verify the uniqueness of partitioned data set names.

The DSNAME parameter on the FLMALTC macro can be used to override the data set naming conventions for a specific group or set of groups.

The variables can appear in any location within the DSNAME parameter. Any user-specified qualifiers can also be used. The preceding SCLM variables can contain values up to 8 characters.

Examples of data set name lengths are:

APPL4.@@FLMGRP.@@FLMTYP is 5 + 1 + 8 + 1 + 8 = 23
REL30.COMMON2A.@@FLMGRP.@@FLMTYP is 5 + 1 + 8 + 1 + 8 + 1 + 8 = 32

The resulting 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, then errors occur during SCLM functions (for example, Build or Promote).

,DASDUNIT=dasd_unit_name|SYSALLDA

The name of the unit where DASD data sets will reside. The maximum DASD unit name length is 8 characters. The default is SYSALLDA.

,VIOUNIT=VIO_unit_name|VIO

The name of the unit where a temporary VIO data set will reside. The maximum VIO unit name length is 8 characters. The default is VIO. For more information on MAXVIO, see MAXVIO ,MAXVIO=max_vio_count|5000.

,MAXLINE=max_line_count|60

An integer value indicating the maximum number of lines per page for all SCLM reports. The minimum value you can specify is 35, and the default is 60.

,MAXVIO=max_vio_count|5000

An integer value indicating the maximum number of records permitted for VIO allocation. The default is 5000. The maximum value is 2147483647.

,OPTOVER=N|Y

Indicates whether translator option overrides are allowed or disallowed. If OPTOVER=Y, developers can override the translator options by specifying the keyword PARMx in the architecture member followed by the new options. The default is Y. See the PARMx parameter for more information.

,MEMLOCK=N|Y

Specifies whether member level locking is in enabled. If MEMLOCK=Y, the member can't be updated by another SCLM user. The default is N.

,CONTROL=control_data_set

Specifies the VSAM data set where the SCLM administrator information and control information is stored. If MEMLOCK=Y, or a value for NOPROMBK is specified, this parameter must be specified

,NPROMBK=not_promoted_backup_data_set

The name of the partitioned data set to contain a backup of unpromoted members. This parameter is optional. If you do not specify a NOPROMBK value, promoted members are not backed up. No SCLM variables can be used for this parameter.

If the NPROMBK parameter is coded, the CONTROL parameter on FLMCNTRL must be specified.

,ADMINID=administrator_userid

Specifies the user ID of the default SCLM administrator.

,VERCC=change_code_routine

The member name of the change code verification routine. Specify the data set containing the member in the VERCCDS parameter. If you do not specify the VERCC parameter, then SCLM does not invoke the exit routine.

,VERCCDS=change_code_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the VERCC parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,VERCCCM=LINK|ATTACH|TSOLNK|ISPLNK

Indicates whether the translator is to be linked, attached, or invoked by the TSO service facility routine or called through ISPF services. Use ATTACH for load modules unless you need access to ISPF variables or services. In that case, use LINK. Using LINK can result in loops or out-of-space abends because storage is not freed between calls to the translators.

TSOLNK is for translators written as REXX execs. TSOLNK results in the translator being invoked from IKJEFTSR (TSO service facility routine) with parameter 1 of x'00010001'. This parameter indicates that the TSO service facility should invoke the requested translator from an unauthorized environment and that the translator can be a TSO command, REXX exec, or CLIST.

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the VERCC parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the VERCCOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the VERCCOP parameter.

The default is LINK.

,VERCCOP=change_code_options

Option list to be passed to the VERCC user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, VERCCCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,CCVFY=verify_change_code_exit_routine

The name of the verify change code exit routine. If you do not specify the CCVFY parameter, SCLM does not invoke the exit routine.

,CCVFYDS=verify_change_code_exit_dataset

The name of the data set containing the translator load module, REXX exec or CLIST specified by the CCVFY parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters.

,CCVFYCM=LINK|ATTACH|TSOLNK|ISPLNK

Indicates whether the exit routine is to be linked, attached, invoked by the TSO service facility routine or called through ISPF services. Use ATTACH for load modules unless you need access to ISPF variables or services; in that case, use LINK. Using LINK can result in loops or out-of-space abends because storage is not freed between calls to the translators.

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the CCVFY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the CCVFYOP parameter. The name of the load module, CLIST, REXX exec or other command is also specified as part of the CCVFYOP parameter.

The default is LINK.

,CCVFYOP=verify_change_code_exit_options

Option list to be passed to the CCVFY user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, CCVFYCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For a description of the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,CCSAVE=save_change_code_exit_routine

The name of the save change code exit routine. If you do not specify the CCSAVE parameter, SCLM does not invoke the exit routine.

,CCSAVDS=save_change_code_exit_dataset

The name of the data set containing the translator load module, REXX exec or CLIST specified by the CCSAVE parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters.

,CCSAVCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the CCSAVE parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the CCSAVOP parameter. The name of the load module, CLIST, REXX exec or other command is also specified as part of the CCSAVOP parameter.

The default is LINK.

,CCSAVOP=save_change_code_exit_options

Option list to be passed to the CCSAVE user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, CCSAVCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For a description of the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,AVDVFY=verify_audit_version_delete_exit_routine

The name of the audit version delete verification exit routine. If you do not specify the DELVFY parameter, SCLM does not invoke the exit routine.

,AVDVFYDS=verify_audit_version_delete_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the AVDVFY parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,AVDVFYCM=LINK|ATTACH|TSOLNK|ISPLNK

Indicates whether the exit routine is to be linked, attached, invoked by the TSO service facility routine, or called through ISPF services. Use ATTACH for load modules unless you need access to ISPF variables or services. In that case, use LINK. Using LINK can result in loops or out-of-space abends because storage is not freed between calls to the translators.

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the AVDVFY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the AVDVFYOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the AVDVFYOP parameter.

The default is LINK.

,AVDVFYOP=verify_audit_version_delete_exit_options

Option list to be passed to the AVDVFY user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, AVDVFYCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,AVDNTF=notify_audit_version_delete_exit_routine

The name of the audit version delete notification exit routine. If you do not specify the AVDNTF parameter, SCLM does not invoke the exit routine.

,AVDNTFDS=notify_audit_version_delete_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the AVDNTF parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,AVDNTFCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the AVDVFY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the AVDNTFOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the AVDNTFOP parameter.

The default is LINK.

,AVDNTFOP=verify_audit_version_delete_exit_options

Option list to be passed to the AVDNTF user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, AVDNTFCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,BLDINIT=build_initial_user_exit_routine

The member name of the Build Initial user exit routine. SCLM invokes the routine at the beginning of the build process during initialization. Specify the data set containing the member using the BLDINIDS parameter. If you do not specify the BLDINIT parameter, then SCLM does not invoke the exit routine.

,BLDINIDS=build_initial_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the BLDINIT parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,BLDINICM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the BLDINIT parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the BLDINIOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the BLDINIOP parameter.

The default is LINK.

,BLDINIOP=build_initial_user_exit_options

Option list to be passed to the BLDINIT user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, BLDINICM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,BLDNTF=build_notify_user_exit_routine

The member name of the build notification user exit routine. SCLM invokes the routine at the end of the build process after the build has taken place. Specify the data set containing the member using the BLDNTFDS parameter. If you do not specify the BLDNTF parameter, then SCLM does not invoke the exit routine.

Note: The original format for this user exit, using the BLDEXT1 parameter, is still supported by SCLM. However, parameters used with this exit routine must be either ALL in the old format or ALL in the new format. Specifying the user exit routine in both the old and new formats, or mixing old and new format parameters for the same exit causes errors when the project definition is assembled.

,BLDNTFDS=build_notify_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the BLDNTF parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,BLDNTFCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the BLDNTF parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the BLDNTFOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the BLDNTFOP parameter.

The default is LINK.

,BLDNTFOP=build_notify_user_exit_options

Option list to be passed to the BLDNTF user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, BLDNTFCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,PRMINIT=promote_initial_user_exit_routine

The member name of the initial promote user exit routine. SCLM invokes this routine at the beginning of the promote process during initialization. Specify the data set containing the member in the PRMINIDS parameter. If you do not specify the PRMINIT parameter, then SCLM does not invoke the exit routine.

,PRMINIDS=promote_initial_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the PRMINIT parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,PRMINICM=LINK|ATTACH|TSOLNK|ISPLNK

Indicates whether the translator is to be linked, attached, or invoked by the TSO service facility routine or called through ISPF services. Use ATTACH for load modules unless you need access to ISPF variables or services. In that case, use LINK. Using LINK can result in loops or out_of_space abends because storage is not freed between calls to the translators.

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the PRMINIT parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the PRMINIOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the PRMINIOP parameter.

The default is LINK.

,PRMINIOP=promote_initial_user_exit_options

Option list to be passed to the PRMINIT user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, PRMINICM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,PRMVFY=promote_verify_user_exit_routine

The member name of the promote verification user exit routine. SCLM invokes this routine at the end of the verification phase of the promote process. Specify the data set containing the member in the PRMVFYDS parameter. If you do not specify the PRMVFY parameter, then SCLM does not invoke the exit routine.

Note: The original format for this user exit, using the PRMEXT1 parameter, is still supported by SCLM. However, parameters used with this exit routine must be either ALL in the old format or ALL in the new format. Specifying the user exit routine in both the old and new formats, or mixing old and new format parameters for the same exit causes errors when the project definition is assembled.

,PRMVFYDS=promote_verify_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the PRMVFY parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,PRMVFYCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the PRMVFY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the PRMVFYOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the PRMVFYOP parameter.

The default is LINK.

,PRMVFYOP=promote_verify_user_exit_options

Option list to be passed to the PRMVFY user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, PRMVFYCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,PRMCOPY=promote_copy_user_exit_routine

The member name of the Promote Copy user exit routine. SCLM invokes this routine at the end of the copy phase of the promote process. Specify the data set containing the member in the PRMCPYDS parameter. If you do not specify the PRMCOPY parameter, then SCLM does not invoke the exit routine.

Note: The original format for this user exit, using the PRMEXT2 parameter, is still supported by SCLM. However, parameters used with this exit routine must be either ALL in the old format or ALL in the new format. Specifying the user exit routine in both the old and new formats, or mixing old and new format parameters for the same exit causes errors when the project definition is assembled.

,PRMCPYDS=promote_copy_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the PRMCOPY parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,PRMCPYCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the PRMCOPY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the PRMCPYOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the PRMCPYOP parameter.

The default is LINK.

,PRMCPYOP=promote_copy_user_exit_options

Option list to be passed to the PRMCOPY user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, PRMCPYCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,PRMPURGE=promote_purge_user_exit_routine

The member name of the promote purge user exit routine. SCLM invokes this routine at the end of the copy phase of the promote process. Specify the data set containing the member in the PRMPRGDS parameter. If you do not specify the PRMPURGE parameter, then SCLM does not invoke the exit routine.

Note: The original format for this user exit, using the PRMEXT3 parameter, is still supported by SCLM. However, parameters used with this exit routine must be either ALL in the old format or ALL in the new format. Specifying the user exit routine in both the old and new formats, or mixing old and new format parameters for the same exit causes errors when the project definition is assembled.

,PRMPRGDS=promote_purge_user_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the PRMPURGE parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,PRMPRGCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the PRMPURGE parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the PRMPRGOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the PRMPRGOP parameter.

The default is LINK.

,PRMPRGOP=promote_purge_user_exit_options

Option list to be passed to the PRMPURGE user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, PRMPRGCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,DELINIT=initial_delete_exit_routine

The name of the initial delete exit routine. If you do not specify the DELINIT parameter, then SCLM does not invoke the exit routine. This routine is only invoked for the DELGROUP service or Delete from Group dialog (ISPF Option 10.3.9).

,DELINIDS=initial_delete_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the DELINIT parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,DELINICM=LINK|ATTACH|TSOLNK|ISPLNK

Indicates whether the translator is to be linked, attached, or invoked by the TSO service facility routine or called through ISPF services. Use ATTACH for load modules unless you need access to ISPF variables or services. In that case, use LINK. Using LINK can result in loops or out_of_space abends because storage is not freed between calls to the translators.

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the DELINIT parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the DELINIOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the DELINIOP parameter.

The default is LINK.

,DELINIOP=initial_delete_exit_options

Option list to be passed to the DELINIT user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, DELINICM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,DELVFY=verify_delete_exit_routine

The name of the delete verification exit routine. If you do not specify the DELVFY parameter, then SCLM does not invoke the exit routine. This exit routine is invoked for Library Utility Delete (ISPF Option 10.3.1) or the Delete service.

,DELVFYDS=verify_delete_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the DELVFY parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,DELVFYCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the DELVFY parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the DELVFYOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the DELVFYOP parameter.

The default is LINK.

,DELVFYOP=verify_delete_exit_options

Option list to be passed to the DELVFY user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, DELVFYCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

,DELNTF=notify_delete_exit_routine

The name of the delete notification exit routine. If you do not specify the DELNTF parameter, then SCLM does not invoke the exit routine. This exit is invoked for Library Utility Delete (ISPF Option 10.3.1), the DELGROUP service or Delete from Group dialog (ISPF Option 10.3.9) or Delete service.

,DELNTFDS=notify_delete_exit_dataset

The name of the data set containing the translator load module, REXX exec, or CLIST specified by the DELNTF parameter. The data set name is not required when the translator resides in one of the system concatenation libraries. The data set name can be up to 44 characters long.

,DELNTFCM=LINK|ATTACH|TSOLNK|ISPLNK

ISPLNK is for translators that must have access to ISPF variables or services. The value specified on the DELNTF parameter is the ISPF service that is used to call the translator. The only supported value is SELECT. The keywords, including the command to run, are specified in the DELNTFOP parameter. The name of the load module, CLIST, REXX exec, or other command is also specified as part of the DELNTFOP parameter.

The default is LINK.

,DELNTFOP=notify_delete_exit_options

Option list to be passed to the DELNTF user exit routine. You can specify a maximum of 255 characters for the options, including delimiters. Enclose the option string in parentheses or single quotes. The options string precedes the list of parameters passed to the exit routine by SCLM. SCLM removes any trailing blanks and does not add a delimiter between the option string and the SCLM parameters. End the options string with a nonblank delimiter so that the options and parameters can be identified by the exit routine.

When the call method for the exit routine, DELNTFCM, is ISPLNK, the options string must contain the keywords and parameters for the ISPF SELECT service. The options must be in the format expected by the service. For more information about the ISPF SELECT service, refer to the z/OS ISPF Services Guide.

XDEP=xdep_data_set|project.XDEP.FILE

The name of the cross-dependency file for the project. The name you specify must be the name of the VSAM cluster you want to use. The default cross-dependency file name is project.XDEP.FILE, where project is the name specified on the FLMABEG macro. The XDEP parameter on the FLMALTC macro can be used to override the cross-dependency file name for a specific group or set of groups. No SCLM variables can be used for this parameter.

Note: The XDEP data set name supplied on the FLMCNTRL macro is used if the XDEP parameter is not specified on any FLMALTC macros. If one FLMALTC macro supplies an XDEP data set name, then all FLMALTC macros must supply an XDEP data set name if no XDEP value is specified on the FLMCNTRL macro.

XDEPDYN=Y|N

Indicates whether the Cross-dependency data set is to kept in sync with the accounting data set. If Y is specified, then when each accounting data set record is updated the changes are analysed and one or more cross-dependency records may be updated. Maintaining the Cross-dependency database dynamically requires additional I/O operations. Specify N if the extra I/O activity creates performance problems. If N is specified, then it is necessary to run the XDEPUPDT service to synchronise the cross-dependency data from the accounting data set.

Example

This information has been specified: the accounting data set, allocation of data sets using VIO if the FLMALLOC macro RECNUM parameter is not greater than 10000 and a verify change code exit routine that is called using ISPLNK.

      FLMCNTRL ACCT=PROJ1.ACCOUNT.FILE,                             X
            CCVFY=SELECT,                                           X
            CCVFYCM=ISPLNK,                                         X
            CCVFYOP='CMD(SAYPARM ,',                                X
            MAXVIO=10000

This information has been specified: the accounting data set, the versioning VSAM database, the versioning PDS, the maximum number of versions to be kept for any member, allocation of data sets using VIO if the FLMALLOC macro RECNUM parameter is not greater than 999,999, and the unit for any VIO data sets is VIO.

      FLMCNTRL ACCT=PROD1.ACCOUNT.FILE,                             X
            VERS=PROD1.VERSION.FILE,                                X
            VERPDS=PROD1.VERSION.PDS,                               X
            VERCOUNT=5,                                             X
            MAXVIO=999999,                                          X
            VIOUNIT=VIO

Here is an example using member level locking:

This information has been specified: the accounting data set, the member level locking control data set, member level locking is turned on, and the administrator ID for member level locking is SHELLY.

      FLMCNTRL ACCT=PROD1.ACCOUNT.FILE,                             X
            CONTROL=PROD1.CONTROL.FILE,                             X
            MEMLOCK=Y,                                              X
            ADMINID=SHELLY