|
|
|
The sample batch JCL that CA Auditor generates follows. Descriptions of the required JCL statements follow this sample.
//TSTUSER1 JOB 00000100 //* 00000300 //* 00000400 //* 00000500 //********************************************************************* 00000600 //* 00000700 //* THE FOLLOWING BATCH JCL HAS BEEN BUILT FROM FILES ALLOCATED TO 00000800 //* YOUR TSO SESSION. SOME FILES MAY NOT BE NECESSARY FOR CORRECT 00000900 //* EXECUTION OF BATCH Auditor. SOME FILES MAY NOT HAVE BEEN 00001000 //* CORRECTLY CONCATENATED IF YOUR SITE USES THE "LIBDEF" FACILITY OF 00001100 //* ISPF. REVIEW THIS JCL CAREFULLY BEFORE USING IT! 00001200 //* 00001300 //********************************************************************* 00001400 //* 00001500 //STEP1 EXEC PGM=IEBCOPY,REGION=1056K 00001600 //* 00001700 //********************************************************************* 00001800 //* 00001900 //* COPY THE USER ISPF PROFILE DATASET TO A TEMPORARY PDS 00002000 //* 00002100 //********************************************************************* 00002200 //* 00002300 //SYSPRINT DD SYSOUT=* 00002400 //OUTPR DD DSN=&&PROF,SPACE=(CYL,(2,1,18),RLSE), 00002500 // UNIT=SYSALLDA,DISP=(,PASS,DELETE) 00002600 //INPR DD DISP=SHR,DSN=TSTUSER.ISPF.ISPPROF 00002700 //SYSIN DD * 00002800 COPY OUTDD=OUTPR,INDD=INPR 00002900 /* 00003000 //STEP2 EXEC PGM=IKJEFT01,REGION=4096K 00003100 //* 00003200 //********************************************************************* 00003300 //* 00003400 //* EXECUTE BATCH TSO. CHECK ALL DDS AND COMMENTS CAREFULLY! 00003500 //* 00003600 //********************************************************************* 00003700 //* 00003800 //* 00003900 //********************************************************************* 00004000 //* 00004100 //* STEPLIB LOAD LIBRARIES 00004200 //* 00004300 //********************************************************************* 00004400 //* 00004500 //* 00005900 //********************************************************************* 00006000 //* 00006100 //* TSO HELP LIBRARIES 00006200 //* 00006300 //********************************************************************* 00006400 //* 00006500 //SYSHELP DD DSN=SYS1.HELP, 00006600 // DISP=SHR 00006700 //* 00007000 //********************************************************************* 00007100 //* 00007200 //* ISPF LOAD LIBRARIES--SHOULD INCLUDE 'QUAL.EXAMINE.LOAD' 00007300 //* 00007400 //********************************************************************* 00007500 //* 00007600 //ISPLLIB DD DSN=CAI.EXAMINE.CAILOAD, 00007700 // DISP=SHR 00007800 //* 00008000 //********************************************************************* 00008100 //* 00008200 //* ISPF MESSAGES LIBRARIES--SHOULD INCLUDE 'QUAL.EXAMINE.MESSAGES' 00008300 //* 00008400 //********************************************************************* 00008500 //* 00008600 //ISPMLIB DD DSN=CAI.EXAMINE.CAIMSG0, 00008700 // DISP=SHR 00008800 //* THE DATASET ABOVE HAS BEEN ALLOCATED TO THE USER'S TSO SESSION 00008900 //* WITH THE 'LIBDEF' FACILITY OF ISPF. 00009000 // DD DSN=SYS2.ISPMLIB, 00009100 // DISP=SHR 00009200 // DD DSN=ISP.SISPMENU, 00009300 // DISP=SHR 00009400 // DD DSN=ISF.SISFMLIB, 00009500 // DISP=SHR 00009600 //* 00010500 //********************************************************************* 00010600 //* 00010700 //* ISPF SKELETON LIBRARIES 00010800 //* 00010900 //********************************************************************* 00011000 //* 00011100 //ISPSLIB DD DSN=ISP.SISPSENU, 00011500 // DISP=SHR 00011600 // DD DSN=ISP.SISPSLIB, 00011700 // DISP=SHR 00011800 //* 00012300 //********************************************************************* 00012400 //* 00012500 //* ISPF USER PROFILE LIBRARY 00012600 //* 00012700 //********************************************************************* 00012800 //* 00012900 //ISPPROF DD DSN=*.STEP1.OUTPR,DISP=(OLD,PASS) 00013000 //* 00013100 //* 00013200 //********************************************************************* 00013300 //* 00013400 //* ISPF TABLE OUTPUT LIBRARIES 00013500 //* 00013600 //********************************************************************* 00013700 //* 00013800 //ISPTABL DD DSN=TSTUSER.ISPF.ISPPROF, 00013900 // DISP=SHR 00014000 //* 00014100 //********************************************************************* 00014200 //* 00014300 //* ISPF TABLE INPUT LIBRARIES--SHOULD INCLUDE 'QUAL.EXAMINE.TABLES' 00014400 //* 00014500 //********************************************************************* 00014600 //* 00014700 //ISPTLIB DD DSN=TSTUSER.ISPF.ISPPROF, 00014800 // DISP=SHR 00014900 // DD DSN=SYS2.ISPTLIB, 00015100 // DISP=SHR 00015200 // DD DSN=ISP.SISPTENU, 00015300 // DISP=SHR 00015400 // DD DSN=ISF.SISFTLIB, 00015500 // DISP=SHR 00015600 //* 00016300 //********************************************************************* 00016400 //* 00016500 //* ISPF PANEL LIBRARIES--SHOULD INCLUDE 'QUAL.EXAMINE.PANELS' 00016600 //* 00016700 //********************************************************************* 00016800 //* 00016900 //ISPPLIB DD DSN=CAI.EXAMINE.CAIPNL0, 00017000 // DISP=SHR 00017100 //* THE DATASET ABOVE HAS BEEN ALLOCATED TO THE USER'S TSO SESSION 00017200 //* WITH THE 'LIBDEF' FACILITY OF ISPF. 00017300 // DD DSN=SYS2.ISPPLIB, 00017400 // DISP=SHR 00017500 // DD DSN=ISP.SISPPENU, 00017600 // DISP=SHR 00017700 // DD DSN=ISF.SISFPLIB, 00017800 // DISP=SHR 00017900 //* 00018800 //********************************************************************* 00018900 //* 00019000 //* AUDITOR DBASE1 LIBRARY 00019100 //* 00019200 //********************************************************************* 00019300 //* 00019400 //DBASE1 DD DSN=TSTUSER.CAIDBS1, 00019500 // DISP=SHR 00019600 //* 00019800 //********************************************************************* 00019900 //* 00020000 //* AUDITOR DBASE2 LIBRARY 00020100 //* 00020200 //********************************************************************* 00020300 //* 00020400 //DBASE2 DD DSN=CAI.EXAMINE.CAIDBS2, 00020500 // DISP=SHR 00020600 //* 00020800 //********************************************************************* 00020900 //* 00021000 //* TSO CLIST LIBRARIES--MUST INCLUDE 'QUAL.EXAMINE.CLIST' 00021100 //* 00021200 //********************************************************************* 00021300 //* 00021400 //SYSPROC DD DSN=CAI.EXAMINE.CAICLS0, 00021500 // DISP=SHR 00021600 // DD DSN=TSTUSER.CLIST, 00021800 // DISP=SHR 00021900 // DD DSN=SYS1.CLIST, 00022000 // DISP=SHR 00022100 // DD DSN=SYS2.CLIST, 00022200 // DISP=SHR 00022300 // DD DSN=ISP.SISPCLIB, 00022400 // DISP=SHR 00022500 //* 00023400 //********************************************************************* 00023500 //* 00023600 //* THE LIBRARY OR LIBRARIES BELOW MAY HAVE BEEN ALLOCATED TO YOUR 00023700 //* ISPF SESSION WITH THE 'LIBDEF' COMMAND. AUDITOR CANNOT TELL 00023800 //* TO WHICH DD NAME THEY SHOULD BE CONCATENATED. BY INSPECTING THE 00023900 //* DATASET(S) BELOW, DETERMINE TO WHICH DD NAME (IF ANY) THEY SHOULD 00024000 //* BE CONCATENATED: 00024100 //* ISPLLIB, ISPPLIB, ISPTLIB, 00024200 //* ISPMLIB, ISPSLIB, ISPTABL, OR ISPFILE. 00024300 //* 00024400 //* //ISP15333 DD DSN=TSTUSER.TST1SP02.CAIPNL0, 00024500 //* // DISP=SHR 00024600 //* //ISP15332 DD DSN=TSTUSER.XE61.SPFLOG1.LIST, 00024800 //* // DISP=SHR 00024900 //* //ISP15334 DD DSN=TSTUSER.TST1SP02.CAIMSG0, 00025100 //* // DISP=SHR 00025200 //* 00025400 //********************************************************************* 00025500 //* 00025600 //* 00025700 //********************************************************************* 00025800 //* 00025900 //* THE FOLLOWING DDNAMES ARE NOT STANDARD ISPF DDNAMES. THE DATASETS 00026000 //* ALLOCATED TO THEM MAY OR MAY NOT BE NECESSARY FOR SUCCESSFUL 00026100 //* EXECUTION OF ISPF IN BATCH MODE. IT IS POSSIBLE THAT YOUR SITE 00026200 //* USES THE 'LIBDEF' FACILITY OF ISPF TO ALLOCATE THESE DDNAMES TO 00026300 //* ISPF FOR YOUR USE. CHECK WITH YOUR ISPF ADMINISTRATOR IF YOU 00026400 //* ARE NOT SURE OF THE USE OF THESE DDNAMES AND DATASETS. 00026500 //* 00026600 //* //RES DD DSN=SYS1.LINKLIB, 00026700 //* // DISP=SHR 00026800 //* //LIB DD DSN=SYS2.LINKLIB, 00026900 //* // DISP=SHR 00027000 //* //OMVPROC DD DSN=SYS1.SBPXEXEC, 00027100 //* // DISP=SHR 00027200 //* //OMVPLIB DD DSN=SYS1.SBPXPENU, 00027300 //* // DISP=SHR 00027400 /* //OMVMLIB DD DSN=SYS1.SBPXMENU, 00027500 /* // DISP=SHR 00027600 /* //OMVTLIB DD DSN=SYS1.SBPXTENU, 00027700 /* // DISP=SHR 00027800 /* //SYS00059 DD DSN=CAI.EXAMINE.CAICLS0, 00027900 /* // DISP=SHR 00028000 /* //SYSEXEC DD DSN=ISP.SISPEXEC, 00028100 //* // DISP=SHR 00028200 //* 00029200 //********************************************************************* 00029300 //* 00029400 //* 00029500 /********************************************************************** 00029600 /* 00029700 //* ISPF LOG DATASET 00029800 //* 00029900 /********************************************************************** 00030000 /* 00030100 /ISPLOG DD SYSOUT=*,DCB=(LRECL=125,BLKSIZE=129,RECFM=VA) 00030200 //* 00030300 //* 00030400 //********************************************************************* 00030500 //* 00030600 //* USE THE SYSABEND DD STATEMENT ONLY WITH THE DIRECTION OF 00030700 //* CA AUDITOR TECHNICAL SUPPORT. 00030800 //*SYSABEND DD SYSOUT=* 00030900 //* 00031000 //********************************************************************* 00031100 //* 00031200 //* 00031300 //* 00031400 //********************************************************************* 00031500 //* 00031600 //* IF YOU DESIRE YOUR OUTPUT GO TO A DATASET OR SYSOUT CLASS OF 00031700 //* YOUR CHOICE, MAKE A REAL DD CARD OF THE FOLLOWING COMMENT. 00031800 //*EXAM$OUT DD DSN=YOUR.DSNAME 00031900 //* 00032000 //********************************************************************* 00032100 //* 00032200 //* 00032300 //* 00032400 //********************************************************************* 00032500 //* 00032600 //* TSO OUTPUT DATASET -- REQUIRED FOR BATCH EXECUTION. 00032700 //* 00032800 /********************************************************************** 00032900 /* 00033000 /SYSTSPRT DD SYSOUT=* 00033100 //* 00033200 //* 00033300 //********************************************************************* 00033400 /* 00033500 //* TSO INPUT DATASET -- REQUIRED FOR BATCH EXECUTION. 00033600 //* 00033700 //********************************************************************* 00033800 /* 00033900 //SYSTSIN DD * 00034000 PROFILE PREFIX(TSTUSER) 00034100 ISPSTART CMD(%EXAMBATX) BDISPMAX(1000) 00034200 /* 00034300 //* 00034400 //********************************************************************* 00034500 //* 00034600 //* FILL IN THE FOLLOWING DD STATEMENT WITH THE DATASET NAME OF THE 00034700 //* SCRIPT FILE YOU CREATED WITH THE SCRIPT-CREATE FUNCTION. 00034800 //* 00034900 //********************************************************************* 00035000 //* 00035100 //EXAMSCRP DD DISP=SHR, 00035200 // DSN=TSTUSER.BATCHJCL(SCRIPT) 00035300 /* 00035400
The following explains the JCL and ddnames required to execute ISPF/PDF and CA Auditor:
This is the first JCL statement in the batch job. If you created a JOB statement for ISPF/PDF option 0.2 (ISPF/PDF Log and List defaults), CA Auditor uses that JOB statement in your batch JCL. If not, a JOB statement skeleton is supplied. Check the JOB statement for the correct accounting, job class, message class, and other information.
This ddname is a standard JCL statement. It tells the system where to direct your output.
The first step (STEP1) of your batch job executes program IEBCOPY, a standard IBM utility, to make a temporary copy of your ISPF/PDF Profile data set (ISPPROF). You must allocate your ISPPROF data set as DISP=SHR to use this temporary copy to perform ISPF/PDF functions online while running CA Auditor in batch.
ISPF/PDF writes its log information to the ISPLOG data set. Refer to this data set for possible error messages when a batch job does not produce the reports that you expected.
This ddname routes your report to a different SYSOUT class or a destination other than that defined by your report options. To change the destination, create a DD statement with the ddname of EXAM$OUT and supply whatever DD information you like. You can route CA Auditor reports to network node destinations or a sequential data set on disk.
Without the EXAM$OUT DD statement, your output is written to a dynamically allocated SYSOUT file. The Select Report Options display controls many of the attributes of this SYSOUT file.
Batch TSO uses the SYSTSPRT data set for its output messages. Frequently, the same messages that ISPF/PDF writes to ISPLOG is displayed in the SYSTSPRT data set. TSO also writes its own operational and error messages to SYSTSPRT. If problems occur with the CA Auditor batch run, CA International, Inc. (CA) technical support might need to refer to SYSTSPRT.
This data set is the input driver for the batch TSO session. These two TSO commands, needed to start batch ISPF/PDF with batch CA Auditor, appear directly after the //SYSTSIN DD statement:
PROFILE PREFIX(userid) ISPSTART CMD(%EXAMBATX) BDISPMAX(1000)
Supplies your TSO logon ID as the high‑level qualifier for any unqualified data set names that you specify. Your batch CA Auditor job also uses this prefix to locate your personal profile records in the CA Auditor DBASE1 data set. For this reason, you alone should use the JCL that you create to run a batch CA Auditor job.
Starts ISPF/PDF and tells it to execute CA Auditor. The CMD operand tells ISPF/PDF to execute the EXAMBATX CLIST after ISPF/PDF is initialized. The BDISPMAX operand limits the number of panel displays your job can perform. This limit is set at 1000. Do not modify this number without first consulting with CA Auditor technical support.
This ddname points to the script that directs the CA Auditor job.
The following required ddnames are explained in the Installation Guide:
CA Auditor DBASE1 data set.
CA Auditor DBASE2 data set.
ISPF/PDF load libraries and CA Auditor load library.
ISPF/PDF panel libraries and CA Auditor panel library.
ISPF/PDF message libraries and CA Auditor message library.
ISPF/PDF table input libraries and CA Auditor table library.
TSO CLIST libraries and CA Auditor CLIST library.
Some sites use the LIBDEF facility to dynamically reallocate data sets to ISPF/PDF based on the requirements of the ISPF/PDF function performed. LIBDEF can simplify TSO logon procedures used at your site and cut down on needless allocations of data sets. However, it can also make it difficult for CA Auditor to determine why a data set is allocated to your TSO session.
CA Auditor will try to identify if panel or message data sets were allocated to the ISPF session by means of the LIBDEF facility. If such data sets are found, they will be included in the generated batch JCL stream as discrete DD statements included within the appropriate concatenation, for example, ISPPLIB or ISPMLIB). CA Auditor will not attempt to replicate the LIBDEF process used to specify these data sets within the generating user’s online TSO session.
Carefully review this generated JCL stream to ensure the following:
CA Auditor creates comment statements out of the LIBDEF data sets and ddnames that it does not recognize as necessary ISPF/PDF ddnames. Review these comments to determine whether these data sets are necessary to run your batch job.
| Copyright © 2009 CA. All rights reserved. | Tell Technical Publications how we can improve this information |