FLMGROUP macro

Use this macro to define each group in the project definition. This macro is required and can be used multiple times.

Macro format


>>-name--FLMGROUP--+-----------------+-------------------------->
                   |      .-,----.   |   
                   |      V      |   |   
                   '-AC=(---code-+-)-'   

>--+-----------------------------+--+-------------------+------->
   '-,ALTC=group_control_options-'  '-,BKGRP=group_name-'   

>--+------------------+--+-------------+------------------------>
   |            .-N-. |  |       .-Y-. |   
   '-,BKMBRLVL=-+-Y-+-'  '-,KEY=-+-N-+-'   

>--+---------------------+-------------------------------------><
   '-,PROMOTE=next_group-'

Parameters

name

An 8-character group name.

AC=(code)

A list of authorization codes and authorization groups that defines the authorization codes for the given group. If any item in the list is an authorization group, you must have previously defined it with the FLMAGRP macro.

The first authorization code you specify is the default authorization code used when a member is introduced to SCLM in this group. Each authorization code can be up to 8 characters and cannot contain commas. The maximum number of characters allowed for the authorization code list is 255, including commas and the delimiting parentheses.

If you omit this parameter, you cannot edit any members in this group. In addition, no editable members can be promoted into or out of this group.

,ALTC=group_control_options

Specifies an alternate set of control options to be used for this group. The name must match the name of an FLMALTC macro in the project definition. The data sets defined on the referenced FLMALTC macro are used to store the information for this group instead of the data sets specified on the FLMCNTRL macro. If this parameter is not specified, the group uses the data sets specified on the FLMCNTRL macro.

,BKGRP=group_name

Specifies the group to which this FLMGROUP is backed up.

,BKMBRLVL=N|Y

Defines whether member-level restore is activated.

,KEY=N|Y

Defines whether the group is a key group or a non-key group. The default is Y. The KEY parameter does not apply to groups specified with the EXLIBID parameter.

,PROMOTE=next group

Defines the next higher group within the hierarchy for this group. If you do not specify it, SCLM does not allow any promotions out of this group.

Example 1

Seven groups are defined for this project definition. The hierarchy consists of five layers. Groups DEV1 and DEV2 are defined as development groups because no groups promote to them. All groups except for the TEST group are defined as key groups. A list of authorization codes are assigned to each group. Group RELEASE is defined as the highest group in the hierarchy because it does not specify the PROMOTE parameter.

DEV1     FLMGROUP AC=(R6M0),KEY=Y,PROMOTE=STAGE1
DEV2     FLMGROUP AC=(R7M0),KEY=Y,PROMOTE=STAGE2
STAGE1   FLMGROUP AC=(R6M0,R7M0),KEY=Y,PROMOTE=INT
STAGE2   FLMGROUP AC=(R6M0,R7M0),KEY=Y,PROMOTE=INT
INT      FLMGROUP AC=(R6M0,R7M0),KEY=Y,PROMOTE=TEST
TEST     FLMGROUP AC=(R6M0,R7M0),KEY=N,PROMOTE=RELEASE
RELEASE  FLMGROUP AC=(R6M0),KEY=Y

Example 2

In this example:

The ALTC parameter of the DEV group specifies that the control information defined by the FLMALTC macro DEVCNTL is used instead of the control information defined by the FLMCNTRL macro. The PDS data sets associated with this group have the naming convention SWDEV.PROJXYZ.DEV.type.
The INT group uses the control information defined by the FLMCNTRL macro. The data set name used for SCLM-controlled PDS data sets defaults to @@FLMPRJ.@@FLMGRP.@@FLMTYP, resulting in a naming convention of PROJXYZ.INT.type for these data sets.
The accounting database used by the REL group is PROJ2.ACCT.DATABASE as defined by the RELCNTL FLMALTC macro. The naming convention used for the PDS data sets is RELEASE.PROJ2.REL.type.

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

         FLMAEND