Create the accounting data sets

The accounting data sets contain information about the application programs in the hierarchy, including statistics, dependency information, and build maps. SCLM functions use the accounting information to control and track members in the project partitioned data sets. Each project must have at least one primary accounting data set.

An optional secondary accounting data set can be created. The secondary accounting data set is a backup for the primary accounting data set. It allows for the restoration of accounting information if the primary data set becomes corrupted, for example due to a disk failure. This data set name must be unique. The secondary accounting data set should be stored on a different volume than the primary accounting data set. If a secondary data set is used, the performance of SCLM will be degraded, because updates are made to both the primary and secondary data sets. The information in both data sets should be compared periodically to ensure the integrity of the accounting information.

Both the primary and secondary accounting data sets are created the same way. Each accounting data set for the project must be a VSAM cluster. Use the IDCAMS utility to define accounting data sets. If accounting information for different groups is to be kept in separate accounting data sets, additional accounting data sets must be created. An example of the JCL used to define an accounting data set follows:

Note: This example is called FLM02ACT and is in the data set ISP.SISPSAMP that is included with ISPF. ISP.SISPSAMP also contains a sample for the allocation of the data set for Record Level Sharing. It is called FLM02RLS.

Figure 1. Accounting File Example (Part 1 of 2)

//jobname  JOB (wkpkg,dpt,bin),'name'
//* code additional JOBCARD statements here
//*********************************************************************
//*
//*  THIS JCL EXAMPLE DEFINES A VSAM CLUSTER TO BE USED AS THE SCLM
//*    ACCOUNTING FILE FOR A GIVEN PROJECT.
//*  THE HIGH-LEVEL QUALIFIER MUST BE AN ENTRY IN A VSAM USER CATALOG
//*    IN ORDER TO CREATE THIS CLUSTER.
//*  TO SPECIFY THE FILE, CHANGE THE DEFINE CLUSTER STATEMENT BELOW
//*    AS FOLLOWS:
//*
//*    1) ADD THE FOLLOWING LINE OF JCL TO DELETE THE VSAM CLUSTER
//*       BEFORE THE ALLOCATION IF THE DATA SET ALREADY EXISTS
//*       AND IT NEEDS TO BE DELETED:
//*       DELETE 'project.account.file' CLUSTER
//*       ADD THIS STATEMENT BETWEEN THE //SYSIN ALLOCATION AND THE
//*       DEFINE CLUSTER LINE OF JCL.
//*    2) CHANGE ALL project.account.file TO THE DESIRED FILE NAME.
//*        THIS VALUE IS SPECIFIED ON THE FLMCNTRL AND FLMALTC
//*        MACROS.  IF MORE THAN ONE VSAM ACCOUNTING DATA SET IS
//*        SPECIFIED ON THE FLMCNTRL AND FLMALTC MACROS, MULTIPLE
//*        IDCAMS DEFINE STEPS ARE REQUIRED.
//*        ACCOUNTING DATASET NAMES ARE USUALLY CHOSEN IN THE FOLLOWING
//*        MANNER - "PROJECT.ACCOUNT.FILE" (WHICH IS THE DEFAULT
//*        USED IN THE PROJECT DEFINITION IF NONE IS SPECIFIED).
//*    3) MODIFY CYLINDERS (PRIMARY SECONDARY)
//*    4) SPECIFY THE VOLUME VVVVVV ON WHICH IT WILL BE ALLOCATED
//*
//*  A JOB STEP IS THEN EXECUTED TO INITIALIZE THE FILE.
//*
//**********************************************************************
//STEP1   EXEC PGM=IDCAMS
//*
//SYSPRINT  DD SYSOUT=H
//*
//SYSIN     DD *
     DEFINE CLUSTER +
        (NAME('project.account.file') +
         CYLINDERS(4 1) +
         VOLUMES(VVVVVV) +
         KEYS(26 0) +
         RECORDSIZE(264 32000) +
         SHAREOPTIONS(4,3) +
         SPEED +
         SPANNED +
         UNIQUE) +
         INDEX(NAME('project.account.file.INDEX') -
         ) +
         DATA(NAME('project.account.file.DATA') -
         CISZ(2048) +
         FREESPACE(50 50) +
         )
/*

Figure 2. Accounting File Example (Part 2 of 2)

//*********************************************************************
//*
//*  INITIALIZE THE ACCOUNTING FILE
//*
//**********************************************************************
//STEP2    EXEC PGM=IDCAMS
//INPUT  DD *
                        SCLM ACCOUNTING FILE INITIALIZATION RECORD
/*
//OUTPUT DD DSN=project.account.file,DISP=SHR
//SYSPRINT  DD SYSOUT=H
//SYSIN     DD *
     REPRO INFILE(INPUT) OUTFILE(OUTPUT)
/*
//*
)CM 5665-402 (C) COPYRIGHT IBM CORP 1980, 1989