Previous Topic: The Index File Record

Next Topic: Getting Started


Creating CA NSM CSV Files Using CA Earl

You can create CSV files from the CA Earl Report Writer in a format compatible with CA NSM APIs that can create performance cubes from CSV files. See the Network and Systems Management (NSM) Database Performance Monitor Option guide, Using the Performance Agent, for more detailed information.

Creating a CSV file from the CA Earl Report Writer is accomplished by specifying members ERXT0262 through ERXT0269 on the SYSIN DD statement and adding CAIJSCSV and CAIJSIDX DD statements to the CA Earl execution JCL. Input to this process is your RMF data. The PDS used to store CSV files must be separate from the one used to store other CSV files created by CA JARS, as the record formats are different.

The CA Earl print exit program builds and maintains the index data set that keeps track of the location of CSV files. Again, this data set may not be the same as the one used by the CA JARS Report Writer, due to an incompatible record format.

On the next page is an example CA Earl program that creates a CSV file as output. Statements that can be modified by the user are documented following the program example. The example shows only part of the program. A complete listing of the program can be found in the CAJREARL library in member ERXT0269.

--------------------------------------------------------------------------------
NOTE ****************************************************************** 00010000
NOTE *  REPORT ID:      ERXT0269                                      * 00020008
NOTE *  REPORT NAME:    XCF SYSTEM ACTIVITY CSV                       * 00030008
NOTE *  DESCRIPTION:    CSV OF CROSS SYSTEM COUPLING FACILITY         * 00040008
NOTE *                  ACTIVITY.                                     * 00050008
NOTE *  RECORD TYPES:   MRXTHDR,                                      * 00060000
NOTE *                  MRXT74S         ( TYPE 74-2)                  * 00070008
NOTE ****************************************************************** 00100000
!OPTION LIST OFF                                                        00110000
OPTION PRINTER   = 216                                                  00120000
OPTION PRTEXIT   = JSICSVT                                              00130000
OPTION PAGE      = 99999                                                00140000
OPTION PRECISION = ALL                                                  00150000
OPTION CPAGE = 60                                                       00160000
OPTION EXCLUDE                                                          00170000
OPTION OMIT ALL BLANK LINES                                             00180000
OPTION WORKFILES                                                        00190000
    .
    .
    .
SET MEM        = 'CSVM'        !MEM CAN ONLY BE 4 CHARACTERS LONG       00990000
!                               PRINT EXIT WILL START WITH 01CC SUFFIX  01000000
!                               AND INCREMENT FOR EACH DATE CHANGE      01010000
!                               MEM WILL BE TRUNCATED TO 4 BY PRTEXIT   01020000
!                                                                       01030000
SET SELVAR001 = '4SD ' !DURATION WITHIN INTERVAL           (XCF  - 74S) 01040004
SET SELVAR002 = 'MSR ' !MSGS PER SECOND REJECTED           (XCF  - 74S) 01050004
SET SELVAR003 = 'MST ' !MSGS PER SECOND TOTAL              (XCF  - 74S) 01060004
SET SELVAR004 = 'XMB ' !BIG MSGS EXCEEDING OPTIMUM LENGTH  (XCF  - 74S) 01070004
SET SELVAR005 = 'XMF ' !MSGS FITTING DEFINED BUFFER        (XCF  - 74S) 01080004
SET SELVAR006 = 'XML ' !MSGS LARGER THAN DEFINED BUFFER    (XCF  - 74S) 01090004
SET SELVAR007 = 'XMR ' !MSGS REJECTED                      (XCF  - 74S) 01100004
SET SELVAR008 = 'XMS ' !MSGS SMALLER THAN DEFINED BUFFER   (XCF  - 74S) 01110004
SET SELVAR009 = 'XMT ' !MSGS - TOTAL                       (XCF  - 74S) 01120004
SET SELVAR010 = 'XMX ' !ACCUM MAX MSG BUFR SPACE (1K BLKS) (XCF  - 74S) 01130004
SET SELVAR011 = 'XNP ' !MSGS MIGRATED NO PATH              (XCF  - 74S) 01140004
SET SELVAR012 = 'XPS ' !PATHS IN SERVICE                   (XCF  - 74S) 01150004
SET SELVAR013 = 'XTC ' !ACCUM TRANSPORT CLASS MSG LENGTH   (XCF  - 74S) 01160004
    .
    .
    .
PRINT TOTALS ONLY                                                       03280000
 ' M='  0 PMEM 0 '         S=' 0 PSID      0 ' R=' 0 PRESOURCE 0        03290000
 ' RS=' 0 PRESOURCESUB 0 ' I=' 0 PINSTANCE 0 ' D=' 0 PDATE     0        03300000
 ' H='  0 PHOUR        0 ' V=' 0 PVALUE                                 03310000
!                                                                       03320004
END                                                                     03330000
Header comments

Please pay particular attention to these, as there are requirements documented in some of them which may not be intuitive.

OPTION Statements

No modification to OPTION statements is required. You may change LIST OFF to LIST ON to view the CA Earl program in your output.

SET MEM = 'CSVM'

This is the prefix of your CSV PDS members. Set this prefix to any valid four character combination. With the default prefix, members will be named CSVM01CC, CSVM02CC, and so on. The CC suffix is hard-coded and may not be changed.

SET SELVAR0xx =

These are the user-selectable metrics for inclusion in the CSV output file. To include this metric in your output, ensure the line is not commented out. If you do not desire a particular metric, insert an exclamation point (!) in position 1 of that line.

PRINT TOTALS ONLY

The PRINT statement must not be modified by the user. These programs are coded to construct the CSV file in a particular format for NSM Database Performance Management option.

There are no other statements that can be modified.