The IMS Interface › Interface Operation

Interface Operation

The IMS Interface translates IMS log data from its data collection format to the input format required for the Report Writer. The interface uses the IMS log data set as input.

Output from the interface typically occupies a small fraction of the tape that the input IMS data occupies.

The interface has the ability to compress the IMS log tape. It only translates IMS accounting records. Using the compress function causes only these records to be copied to an output data set.

The following JCL executes the interface.

//IMSIVP   JOB (ACCTINFO),'PROGRAMMER INFO',
//             MSGCLASS=X,CLASS=A
//*********************************************************************
//STEP1    EXEC PGM=JSIIMT00,REGION=4M
//*
//STEPLIB   DD DISP=SHR,DSN=CAI.CAJRLOAD
//SYSUDUMP  DD SYSOUT=*
//CAIJRSO   DD SYSOUT=*
//CAIJRII   DD DISP=SHR,DSN=IMS.LOG.DATA      <- IMS LOG DATA INPUT
//CAIJRIO   DD DSN=JARS.HISTORY.FROM.IMS,     <- HISTORY FILE OUT
//             DISP=(NEW,PASS,DELETE),
//             UNIT=SYSDA,
//             SPACE=(CYL,(30,5),RLSE)
//CAIJRCM   DD DUMMY                          <- COMPRESSED FILE OUT
//*
//* UNCOMMENT CAIJSACT TO PRODUCE EXTDATA
//*CAIJSACT  DD DSN=JARS.EXTDATA.FILE,        <- EXTDATA OUT
//*             DISP=(NEW,CATLG,CATLG),
//*             UNIT=SYSDA,
//*             SPACE=(CYL,(30,5),RLSE)
//*             DCB=(RECFM=VB,LRECL=8188,BLKSIZE=8192)
//CAIJRPR   DD SYSOUT=*                       <- GRAPHS, CONTROL OUT
//CAIJRCD   DD *
         .                                                              00007000
         .                                                              00007000
         .                                                              00007000
         Code COMPRESS, DEFAULT, FFGRAPH, KEYWORD and TRANSLATE         00010000
         commands for your configuration.  Refer to the examples
         later in this chapter.
         Note that to create EXTDATA, you must have a valid
         TRANSLATE command and uncomment the CAIJSACT DDNAME.
         .                                                              00013000
         .                                                              00013000
         .                                                              00013000
/*

The interface executes COMPRESS, DEFAULT, FFGRAPH, KEYWORD, and TRANSLATE commands in the order that they are encountered. Execution of each command is indicated by printed output from the interface.

Execution of a COMPRESS command is recorded with a one-page report, giving the number of input records examined and the number of IMS log accounting records written to the compressed file. Execution of the FFGRAPH command causes the requested graphs to be printed. Execution of the TRANSLATE command causes a Translate Control Report to be printed.

The Control Report

The IMS Interface prints a Control Report upon successful execution of a TRANSLATE command. The NORMAL END OF PROCESSING message immediately follows this report.

The Control Report shows total counts of all records processed by the interface. The following statistics are shown:

IMS RECORDS READ

Number of valid type 07 accounting records.

RECORDS REJECTED

Number of type 07 accounting records rejected, primarily because of invalid date/time fields.

JARS JOB RECORDS WRITTEN

Number of translated records created from the input data.

EXTDATA RECORDS WRITTEN

Number of EXTDATA records written to the CAIJSACT DD.

The interface requires several interrelated files to execute. The following list describes these data sets and their functions: