Operating Instructions

The CA Roscoe Interface › Operating Instructions

Operating Instructions

The region size suggested to execute the interface is approximately 4096K. The interface to Roscoe reads a required input control statement to determine the type of input. The control statement is read in through CAIJRIN in the following format:

Control Statement Layout - Roscoe Release 5.4 and earlier:

Field Name	Field Position	Field Length	FMT	Description
Statement Type	1-5	5	a	'Input'
	6-9	5	a	Filler
Input Type	10-12	3	a	'LOG' - Roscoe Journal File 'SMF' - SMF input
SMF Type	13-15	3	/n	blank - If input type = LOG (Roscoe Journal File) 'nnn' - If input type = SMF, with 'nnn' the user record type for Roscoe records

Control Statement Layout - Roscoe Release 5.5 and later:

Field Name	Field Position	Field Length	FMT	Description
Statement Type	1-5	5	a	'Input'
	6-9	4	-	Filler
Input Type	10-12	3	a	'5.5'
SMF Type	13-15	3	/n	blank - For Roscoe Journal File 'nnn' - For SMF input, with 'nnn' the user record type for Roscoe records.

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

CAIJFPR

The CAIJFPR statement describes the SYSOUT data set for generated display messages.

CAIJFSN

The CAIJFSN statement describes a SYSOUT data set for generated SNAP dumps. The SNAP limit is 100, however, you can change this 2 byte binary limit count at offset 000032, to any number between 0001 and 7FFF. The number of records SNAPed is one less than the number specified. If you want no records SNAPed, set ZAP offset 000032=0001.

CAIJRHST

The CAIJRHST statement describes the output file written by the Roscoe Interface. This is the file that is later input to the Report Writer. This file must have the following attributes:

RECFM=VB
LRECL=612
BLKSIZE=6233

CAIJRIN

The CAIJRIN statement describes the data set that contains the Roscoe control statement.

CAIJRROS

The CAIJRROS statement describes the input file to be processed by the Roscoe Interface, either a Roscoe Journal File or an SMF file.

CAIJSACT

This optional DD statement indicates to the interdace that EXTDATA records are to be written as well. The file must have these attributes:

RECFM=VB
LRECL=8188
BLKSIZE=8192 or higher

SORTMSG

The SORT message output.

SORTWKnn

Temporary data set used as sort work areas.

STEPLIB

The STEPLIB statement describes the load library that was loaded from the distribution tape.

SYSUDUMP

The SYSUDUMP statement describes a SYSOUT data set for dump output in the case of an abnormal termination.

The following JCL illustrates a run deck for executing the interface to Roscoe Interface.

Sample JCL for Interface to Roscoe

//ROSRUN   JOB ,'RUN Roscoe INTERFACE',CLASS=A,MSGCLASS=M
//*
//* DOC:   THIS JOB EXECUTES THE Roscoe INTERFACE PROGRAM.
//*
//*        YOU MUST CHANGE THE VOLUME AND UNIT DESIGNATORS IN THIS
//*        JCL TO DESCRIBE THE ACTUAL VOLUMES ON WHICH YOUR DATA
//*        SETS RESIDE. YOU MUST ALSO CHANGE THE RESPECTIVE
//*        DATA SET NAMES.
//*
//*        THIS JCL REFERS TO DATA SET NAME CA.JARS.PRODLIB ON
//*        THE STEPLIB DD. THIS NAME MUST MATCH THE ONE WITH WHICH
//*        YOU LOADED THE LOAD LIBRARY FROM THE DISTRIBUTION TAPE.
//*
//*        CAIJFPR   DD   Roscoe OUTPUT
//*        CAIJFSN   DD   SNAPED RECORDS
//*        CAIJRIN   DD   CONTROL CARD INPUT
//*                       (INPUT CONTROL CARD REQUIRED)
//*        CAIJRROS  DD   Roscoe OR SMF INPUT DATA
//*        CAIJRHST  DD   JARS HISTORY FILE
//*        SORTWKnn  DD   TEMP SORT WORK AREA
//*
//JSSS01   EXEC PGM=JSI,PARM='XXXX0080,JSMA0000'
//STEPLIB  DD   DSN=CAI.CAJRLOAD,DISP=SHR
//*
//CAIJFPR  DD   SYSOUT=*
//CAIJFSN  DD   SYSOUT=*
//SORTWK01 DD   UNIT=SYSDA, SPACE=(CYL,(3))
//SORTWK02 DD   UNIT=SYSDA, SPACE=(CYL,(3))
//SORTWK03 DD   UNIT=SYSDN, SPACE=(CYL,(3))
//SORTMSG  DD   SYSOUT=*
//*
//CAIJRIN  DD   *
INPUT    SMF248
 OR
INPUT    LOG
 OR
INPUT    5.5248
 OR
INPUT    5.5
/*
//CAIJRROS DD   DSN=SMF.DAILY,DISP=SHR,UNIT=3350,
//         DCB=(RECFM=VBS,LRECL=32759,BLKSIZE=4096)
//CAIJRHST DD   DSN=JARS.Roscoe.HISTORY,DISP=(NEW,CATLG,DELETE),
//         UNIT=3350,VOL=SER=WORK01,SPACE=(TRK,(5,5)),
//         DCB=(RECFM=VB,LRECL=612,BLKSIZE=6233),SPACE=(TRK,(5,5))
//CAIJSACT  DD DSN=CAI.ROSCOE.EXTDATA,
//          DISP=(NEW,CATLG,DELETE),
//          UNIT=uuuu,
//          SPACE=(CYL,(pp,ss),RLSE),
//          DCB=(RECFM=VB,LRECL=8188,BLKSIZE=bbbb),
//          VOL=SER=vvvvvv
//*
//

The following JCL illustrates a run deck for producing a Roscoe Session Analysis Report using the Report Writer. This JCL is included as member ROSJARS1 in CAJRJCL.

Sample JCL for Interface to Roscoe Session Analysis Report

//JARS1 JOB (CAI,GXB),CMSGXB,CLASS=A,MSGCLASS=M
//*
//* DOC:   THIS JOB EXECUTES THE CA JARS REPORT PROGRAM TO
//*              PRODUCE A Roscoe SESSION ANALYSIS REPORT, USING
//*              A Roscoe HISTORY FILE AS INPUT.
//*
//*
//JARS      EXEC PGM=JSIMAIN
//STEPLIB   DD DSN=CAI.CAJRLOAD,DISP=SHR
//*
//CAIJSPRT  DD SYSOUT=*
//SYSUDUMP  DD SYSOUT=*
//CAIJSNAP  DD SYSOUT=*
//SORTWK01  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK02  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK03  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK04  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK05  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK06  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//CAIJSCT2  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(TRK,(10,1))
//CAIJSCT1  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(TRK,(10,1))
//CAIJSACT  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(CYL,(10,5))
//*
//CAIJRHST  DD  DSN=JARS.Roscoe.HISTORY,DISP=(OLD,KEEP),
//          UNIT=3350,VOL=SER=WORK01
//*
//*
//CAIJSCIN  DD *
 CONFIG  OTHE01F
 SELECT       1                                   B
BHEADER     R O S C O E   S E S S I O N   A N A L Y S I S
BSORT    05722A2                                 1
BDISPLAY MA0582603613132B02261391382A53113B6
/*

The following JCL illustrates a run deck for producing a Roscoe User Charge Summary Report using the Report Writer. This JCL is included as member ROSJARS2 in CAJRJCL.

Sample JCL For Roscoe User Charge Summary Report

//JARS2 JOB (CAI,GXB),CMSGXB,CLASS=A,MSGCLASS=M
//*
//* DOC:   THIS JOB EXECUTES THE CA JARS REPORT PROGRAM TO
//*              PRODUCE A Roscoe SESSION ANALYSIS REPORT, USING
//*              A Roscoe HISTORY FILE AS INPUT.
//JARS      EXEC PGM=JSIMAIN
//STEPLIB   DD DSN=CAI.CAJRLOAD,DISP=SHR
//*
//CAIJSPRT  DD SYSOUT=*
//SYSUDUMP  DD SYSOUT=*
//CAIJSNAP  DD SYSOUT=*
//SORTWK01  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK02  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK03  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK04  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK05  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//SORTWK06  DD UNIT=SYSDA,
//             SPACE=(CYL,(5))
//CAIJSCT2  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(TRK,(10,1))
//CAIJSCT1  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(TRK,(10,1))
//CAIJSACT  DD UNIT=SYSDA,DISP=(,DELETE,DELETE),
//             SPACE=(CYL,(10,5))
//*
//CAIJSHST  DD  DSN=JARS.Roscoe.HISTORY,DISP=(OLD,KEEP),
//          UNIT=3350,VOL=SER=WORK01
//*
//CAIJSCIN  DD *
 CONFIG  OTHE01F
 SELECT       1                                   A
AHEADER     R O S C O E   U S E R   C H A R G E   S U M M A R Y
ASORT    05703A3105720A  00412A                  1
ADISPLAY MA0022581602612B3244245246
ATSORATE  1000500    1000   100            100100                        0100
ADESCRIPT1ROS     PRODUCT DEVELEPMENT
ADESCRIPT1110     SYSTEMS
ADESCRIPT1210     ACCOUNTING
ADESCRIPT1219     PRODUCTION CONTROL
ADESCRIPT1221     ADVERTISING
ADESCRIPT1222     SALES - EAST
ADESCRIPT1223     SALES - CENTRAL
ADESCRIPT1227     SALES - WEST
ADESCRIPT1231     FINANCE
/*