This topic describes how to use the installation verification procedure, DFHIVPDB, which you can use to verify that the CICS-DBCTL interface can be used successfully.
Before you can run the DFHIVPDB job successfully, you must:
You can do this as part of the process of tailoring all CICS sample post-installation jobs, as described in Defining DL/I support. When you run the DFHISTAR job as part of the CICS installation process, the DFHIVPDB job is installed in the hlq.XDFHINST library.
To do this, you can tailor and run copies of the following CICS sample jobs:
When you run the DFHISTAR job as part of the CICS installation process, these jobs are installed in the hlq.XDFHINST library.
The DFHIVPDB job depends on you running the IMS installation verification procedures, as part of the INSTALL/IVP process described in the IMS Installation Guide. The following assumptions about the IMS INSTALL/IVP process are made:
For information about installing IMS, the INSTALL/IVP process, and running the IMS IVPs, see the IMS Installation Guide.
The DFHIVPDB job consists of the following job steps:
The COBOL version, DFH$DBCB, and the PL/I version, DFH$DBPL, of the sample DL/I transactions are also in the hlq.SDFHSAMP library. If you want to run the COBOL or PL/I versions, modify this job step to load CARDIN with the appropriate member.
Output generated by the transactions is sent to a similar device - a sequential data set defined as PRINTER.
If you want to examine the sample members used by this IVP, here is a list of them, and where you can find each one:
Before submitting the DFHIVPDB job, run the DFHRMUTL program, as shown below, to reset the global catalog control record to perform an INITIAL start on the next CICS startup.
//DFHRMUTI JOB 24116475,'DFHRMUTL',
// CLASS=A,MSGCLASS=H,NOTIFY=userid
//*
//*--------------------------------------------------------*/
//* RESET GLOBAL CATALOG CONTROL RECORD TO INITIAL START */
//*--------------------------------------------------------*/
//DFHRMUTL EXEC PGM=DFHRMUTL,REGION=1M
//STEPLIB DD DSN=CICSTS31.CICS.SDFHLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//DFHGCD DD DSN=CICSTS31.CICS.DBDCCICX.DFHGCD,DISP=OLD
//SYSIN DD *
SET_AUTO_START=AUTOINIT
/*
When you are satisfied that you have made all the necessary preparations, and that all the prerequisite jobs have been run, submit the DFHIVPDB job. The job loads the DL/I transactions into CARDIN. CICS reads the transactions, and sends the output to the PRINTER sequential data set.
If you want to use some commands online before CICS shuts down, then delete the CEMT command before you run the job. You will then be able to issue CEMT, CEDA and other CICS-supplied transactions, and initiate a shutdown either from a CICS terminal or through an MVS™ console. If you want to communicate with CICS through an MVS console, you must define a console to CICS before you start DFHIVPDB, as described in Defining an MVS console. If you want to enter MODIFY commands from terminals connected to TSO, you must define the TSO users as console devices, as described in Defining a TSO user as a console device.
A sample job log from a run of the DFHIVPDB job is given in Figure 44. The results you get from the transaction processing should be similar to those shown in Figure 44, Figure 45, and Figure 46.
1 J E S 2 J O B L O G -- S Y S T E M M V 2 6 -- N O D E W I N M V S 2 C
0
09.36.19 JOB36923 ---- WEDNESDAY, 19 JAN 2005 ----
09.36.19 JOB36923 ICH70001I CICINST LAST ACCESS AT 08:27:32 ON WEDNESDAY, JANUARY 19, 2005
09.36.19 JOB36923 $HASP373 DFHIVPDB STARTED - INIT 4 - CLASS A - SYS MV26
09.36.19 JOB36923 IEF403I DFHIVPDB - STARTED - TIME=09.36.19
09.36.19 JOB36923 - --TIMINGS (MINS.)-- ----PAGING COUNTS---
09.36.19 JOB36923 -JOBNAME STEPNAME PROCSTEP RC EXCP CPU SRB CLOCK SERV PG PAGE SWAP VIO SWAPS STEPNO
09.36.19 JOB36923 -DFHIVPDB GEN 00 53 .00 .00 .00 184 0 0 0 0 0 1
09.36.19 JOB36923 -DFHIVPDB CICS CICSCNTL 01 16 .00 .00 .00 148 0 0 0 0 0 2
09.36.19 JOB36923 -DFHIVPDB CICS DTCNTL 01 15 .00 .00 .00 161 0 0 0 0 0 3
09.36.20 JOB36923 DFHPA1101 CICSIVP1 DFHSIT IS BEING LOADED.
09.36.20 JOB36923 DFHPA1108 CICSIVP1 DFHSIT HAS BEEN LOADED. (GENERATED AT: MM/DD= 01/12 HH:MM= 13:57).
09.36.20 JOB36923 DFHPA1100 CICSIVP1 OVERRIDE PARAMETERS FROM JCL EXEC STATEMENT: START=AUTO,SYSIN
09.36.20 JOB36923 DFHPA1102 CICSIVP1 OVERRIDE PARAMETERS FROM SYSIN: 1
09.36.20 JOB36923 DFHPA1927 CICSIVP1 GRPLIST=DFH$IVPL, INCLUDE DLI SAMPLE PROGRAMS & TRANSACTIONS 20000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 FCT=NO, 30000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 TCT=5$, TCT INCLUDES SEQ DEVICES 40000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 XRF=NO, 50000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 STNTR=OFF, 53000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 STNTRFC=1, TRACE FILE CONTROL AND DLI EVENTS 56000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 AUXTR=ON, 60000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 AUXTRSW=NEXT, 70000000
09.36.20 JOB36923 DFHPA1927 CICSIVP1 SRT=NO, 70000100
09.36.20 JOB36923 DFHPA1927 CICSIVP1 SEC=NO, 70000200
09.36.20 JOB36923 DFHPA1927 CICSIVP1 TRTABSZ=64, 70000300
09.36.20 JOB36923 DFHPA1927 CICSIVP1 APPLID=CICSIVP1, 70000400
09.36.20 JOB36923 DFHPA1927 CICSIVP1 CICSSVC=233, 70000500
09.36.20 JOB36923 DFHPA1927 CICSIVP1 .END 80000000
09.36.20 JOB36923 DFHPA1103 CICSIVP1 END OF FILE ON SYSIN. 09.36.21 JOB36923 +DFHTR0103 TRACE TABLE SIZE IS 64K
09.36.21 JOB36923 +DFHSM0122I CICSIVP1 Limit of DSA storage below 16MB is 5,120K.
09.36.21 JOB36923 +DFHSM0123I CICSIVP1 Limit of DSA storage above 16MB is 30M.
09.36.21 JOB36923 +DFHSM0113I CICSIVP1 Storage protection is not active.
09.36.21 JOB36923 +DFHSM0126I CICSIVP1 Transaction isolation is not active.
09.36.21 JOB36923 +DFHDM0101I CICSIVP1 CICS is initializing.
09.36.23 JOB36923 +DFHWB0109I CICSIVP1 Web domain initialization has started.
09.36.23 JOB36923 +DFHSO0100I CICSIVP1 Sockets domain initialization has started.
09.36.23 JOB36923 +DFHRX0100I CICSIVP1 RX domain initialization has started.
09.36.23 JOB36923 +DFHRX0101I CICSIVP1 RX domain initialization has ended.
09.36.23 JOB36923 +DFHLG0101I CICSIVP1 Log manager domain initialization has started.
09.36.23 JOB36923 +DFHEJ0101 CICSIVP1 790
790 Enterprise Java domain initialization has started. Java is a
790 trademark of Sun Microsystems, Inc.
09.36.23 JOB36923 +DFHDH0100I CICSIVP1 Document domain initialization has started.
09.36.23 JOB36923 +DFHXS1100I CICSIVP1 Security initialization has started.
09.36.23 JOB36923 +DFHSI1500 CICSIVP1 CICS startup is in progress for CICS Transaction Server Version 3.1.0
09.36.23 JOB36923 +DFHXS1102I CICSIVP1 Security is inactive.
09.36.23 JOB36923 +DFHDU0304I CICSIVP1 Transaction Dump Data set DFHDMPB opened.
09.36.23 JOB36923 +DFHSI1501I CICSIVP1 Loading CICS nucleus.
09.36.26 JOB36923 +DFHTR0113 CICSIVP1 Auxiliary trace is being started on data set DFHAUXT.
09.36.26 JOB36923 +DFHCQ0100I CICSIVP1 Console queue initialization has started.
09.36.26 JOB36923 +DFHCQ0101I CICSIVP1 Console queue initialization has ended.
09.36.26 JOB36923 +DFHCQ0103I CICSIVP1 MVS console queue is open.
09.36.26 JOB36923 +DFHCQ0200I CICSIVP1 CEKL transaction enabled.
09.36.26 JOB36923 +DFHXS1101I CICSIVP1 Security initialization has ended.
09.36.26 JOB36923 +DFHRM0140 CICSIVP1 Recovery manager autostart override found with value: 'AUTOINIT'.
09.36.26 JOB36923 +DFHRM0149I CICSIVP1 Recovery manager autostart override record will be deleted.
09.36.26 JOB36923 +DFHDH0101I CICSIVP1 Document domain initialization has ended.
09.36.26 JOB36923 +DFHMN0105I CICSIVP1 Using default Monitoring Control Table.
09.36.26 JOB36923 +DFHSO0101I CICSIVP1 Sockets domain initialization has ended.
09.36.26 JOB36923 +DFHWB0110I CICSIVP1 Web domain initialization has ended.
09.36.26 JOB36923 +DFHMN0110I CICSIVP1 CICS Monitoring is inactive.
09.36.26 JOB36923 +DFHSI1502I CICSIVP1 CICS startup is Initial.
09.36.26 JOB36923 +DFHTS0100I CICSIVP1 Temporary Storage initialization has started.
09.36.26 JOB36923 +DFHSI1503I CICSIVP1 Terminal data sets are being opened.
09.36.27 JOB36923 +DFHLG0102I CICSIVP1 Log manager domain initialization has ended.
09.36.27 JOB36923 IEC161I 080-053,DFHIVPDB,CICS CICS,DFHTEMP,,,
09.36.27 JOB36923 IEC161I INST.CICSTS31.CNTL.CICS.DFHTEMP,
09.36.27 JOB36923 IEC161I INST.CICSTS31.CNTL.CICS.DFHTEMP.DATA,
09.36.27 JOB36923 IEC161I ICFCAT.SYSPLEX2.CATALOGB
09.36.27 JOB36923 +DFHTS0102I CICSIVP1 About to format the temporary storage data set (359 control intervals).
09.36.27 JOB36923 +DFHKE0406I CICSIVP1 825
825 CICS is about to wait for predecessors defined in the MVS automatic
825 restart management policy for this region.
09.36.27 JOB36923 +DFHKE0412I CICSIVP1 CICS WAITPRED call to automatic restart manager has completed.
09.36.27 JOB36923 +DFHCP0101I CICSIVP1 CPI initialization has started.
09.36.27 JOB36923 +DFHPR0104I CICSIVP1 Partner resource manager initialization has started.
09.36.27 JOB36923 +DFHAI0101I CICSIVP1 AITM initialization has started.
09.36.27 JOB36923 +DFHFC0100I CICSIVP1 File Control initialization has started.
09.36.27 JOB36923 +DFHTD0100I CICSIVP1 Transient Data initialization has started.
09.36.27 JOB36923 +DFHFC0101I CICSIVP1 File Control initialization has ended.
09.36.27 JOB36923 +DFHTD0101I CICSIVP1 Transient Data initialization has ended.
09.36.27 JOB36923 +DFHTS0101I CICSIVP1 Temporary Storage initialization has ended.
09.36.27 JOB36923 +DFHCP0102I CICSIVP1 CPI initialization has ended.
09.36.27 JOB36923 +DFHPR0105I CICSIVP1 Partner resource manager initialization has ended.
09.36.27 JOB36923 +DFHAI0102I CICSIVP1 AITM initialization has ended.
09.36.28 JOB36923 +DFHSI1511I CICSIVP1 Installing group list DFH$IVPL.
09.36.29 JOB36923 IEC031I D37-04,IFG0554P,DFHIVPDB,CICS,DFHAUXT,D306,P2P0C6,INST.CICSTS31.CICS.DFHAUXT
09.36.29 JOB36923 +DFHTR0110 - AUXILIARY TRACE DATA SET DFHAUXT FULL - SWITCHING TO DFHBUXT
09.36.29 JOB36923 IEC031I D37-04,IFG0554P,DFHIVPDB,CICS,DFHBUXT,D50B,P2P14B,INST.CICSTS31.CICS.DFHBUXT
09.36.29 JOB36923 +DFHTR0109 - AUXILIARY TRACE DATA SET DFHBUXT FULL - AUXILIARY TRACE HAS BEEN STOPPED
09.36.30 JOB36923 +DFHLG0103I CICSIVP1 System log (DFHLOG) initialization has started.
09.36.31 JOB36923 +DFHLG0104I CICSIVP1 844
844 System log (DFHLOG) initialization has ended. Log stream
844 CICINST.CICSIVP1.DFHLOG is connected to structure LOG_GENERAL_008.
09.36.31 JOB36923 +DFHLG0103I CICSIVP1 System log (DFHSHUNT) initialization has started.
09.36.31 JOB36923 +DFHLG0104I CICSIVP1 846
846 System log (DFHSHUNT) initialization has ended. Log stream
846 CICINST.CICSIVP1.DFHSHUNT is connected to structure LOG_GENERAL_008.
09.36.31 JOB36923 +DFHAP1203I CICSIVP1 Language Environment is being initialized.
09.36.31 JOB36923 +DFHAP1200 CICSIVP1 A CICS request to the Language Environment has failed. Reason code '0011020'.
09.36.31 JOB36923 +DFHAP1208 CICSIVP1 Language Environment cannot support the Cobol language. 7
09.36.31 JOB36923 +DFHAP1209 CICSIVP1 Language Environment cannot support the C/C++ languages. 7
09.36.31 JOB36923 +DFHAP1210 CICSIVP1 Language Environment cannot support the PL/I language. 7
09.36.31 JOB36923 +DFHAP1211I CICSIVP1 Language Environment initialization completed.
09.36.31 JOB36923 +DFHWB1007 CICSIVP1 Initializing CICS Web environment.
09.36.32 JOB36923 +DFHWB1008 CICSIVP1 CICS Web environment initialization is complete.
09.36.32 JOB36923 +DFHSI1517 CICSIVP1 Control is being given to CICS.
09.36.32 JOB36923 +DFHEJ0102 CICSIVP1 Enterprise Java domain initialization has ended.
09.37.54 JOB36923 +DFHTM1715 CICSIVP1 CICS is being quiesced by userid CICSUSER in transaction CEMT at terminal SAMA.
09.37.54 JOB36923 +DFHDM0102I CICSIVP1 CICS is quiescing.
09.37.54 JOB36923 +DFHDB8122I CICSIVP1 CICS is about to disconnect from DBCTL for CICS shutdown.
09.37.54 JOB36923 +DFHCESD CICSIVP1 SHUTDOWN ASSIST TRANSACTION CESD STARTING. SHUTDOWN IS NORMAL.
09.37.54 JOB36923 +DFHDB8123I CICSIVP1 CICS disconnection from DBCTL for CICS shutdown has completed successfully.
09.37.54 JOB36923 +DFHTM1782I CICSIVP1 All non-system tasks have been successfully terminated.
09.37.55 JOB36923 +DFHZC2305I CICSIVP1 Termination of VTAM sessions beginning
09.37.55 JOB36923 +DFHZC2316 CICSIVP1 VTAM ACB is closed
09.37.55 JOB36923 +DFHCQ0104I CICSIVP1 MVS console queue is closed.
09.37.58 JOB36923 +DFHRM0204 CICSIVP1 There are no indoubt, commit-failed or backout-failed UOWs.
09.37.59 JOB36923 +DFHRM0130 CICSIVP1 Recovery manager has successfully quiesced.
09.37.59 JOB36923 +DFHDU0303I CICSIVP1 Transaction Dump Data set DFHDMPB closed.
09.37.59 JOB36923 +DFHKE1799 CICSIVP1 TERMINATION OF CICS IS COMPLETE.
09.37.59 JOB36923 -DFHIVPDB CICS CICS 00 4070 .03 .00 1.66 23769 0 0 0 0 0 4
09.38.00 JOB36923 -DFHIVPDB CICS PRTDMPA 00 137 .00 .00 .00 289 0 0 0 0 0 5
09.38.00 JOB36923 -DFHIVPDB CICS PRTDMPB 00 138 .00 .00 .00 291 0 0 0 0 0 6
09.38.03 JOB36923 -DFHIVPDB CICS PRTAUXT 00 1935 .01 .00 .04 13326 0 0 0 0 0 7
09.38.04 JOB36923 $HASP375 DFHIVPDB ESTIMATED LINES EXCEEDED
09.38.04 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 5,000 LINES
09.38.05 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 10,000 LINES
09.38.05 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 15,000 LINES
09.38.05 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 20,000 LINES
09.38.05 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 25,000 LINES
09.38.06 JOB36923 $HASP375 DFHIVPDB ESTIMATE EXCEEDED BY 30,000 LINES
09.38.06 JOB36923 -DFHIVPDB CICS PRTBUXT 00 1909 .01 .00 .05 13560 0 0 0 0 0 8
09.38.06 JOB36923 IEF404I DFHIVPDB - ENDED - TIME=09.38.06
09.38.06 JOB36923 -DFHIVPDB ENDED. NAME-CICINST TOTAL CPU TIME= .06 TOTAL ELAPSED TIME= 1.78
09.38.06 JOB36923 $HASP395 DFHIVPDB ENDED
Note:
1 The DFHIVPDB job uses the unsuffixed SIT, DFHSIT, as used by all the CICS IVPs. It also uses some system initialization parameters included in the DFH$SIP5 member of the SYSIN data set, to override the parameters in DFHSIT. Further, the DFH$SIP5 member was edited to specify other system initialization parameters to create the DFHIVPDB job log shown. For information about these extra system initialization parameters used by the IVP jobs, see topic Specify system initialization parameters for the IVP jobs.
7 If you want COBOL, C, C++ and PL/I languages, remove the comment marks from the SCEERUN and SCEERUN2 libraries, and increase the memory size for the job.
You should see messages similar to those in Figure 45 at the end of the MSGUSER section of the job output.
DFHLG0302 01/19/2005 09:36:31 CICSIVP1 Journal name DFHLOG has been installed. Journal type: MVS
CICINST.CICSIVP1.DFHLOG.
DFHLG0302 01/19/2005 09:36:31 CICSIVP1 Journal name DFHSHUNT has been installed. Journal type: MVS
CICINST.CICSIVP1.DFHSHUNT.
DFHLG0744 01/19/2005 09:36:31 CICSIVP1 All records in log stream CICINST.CICSIVP1.DFHLOG have been deleted.
DFHLG0744 01/19/2005 09:36:31 CICSIVP1 All records in log stream CICINST.CICSIVP1.DFHSHUNT have been deleted.
DFHDB8116 I 01/19/2005 09:36:32 CICSIVP1 Connection to DBCTL IM7D is proceeding. Startup Table Suffix used is IV.
DFHDB8101 I 01/19/2005 09:36:32 CICSIVP1 Connection to DBCTL IM7D is now complete. Startup Table Suffix used is IV.
DFHZC3441 I 01/19/2005 09:37:55 CICSIVP1 Orderly termination of VTAM sessions requested. ((1) Module name: DFHZSHU)
DFHRM0205 01/19/2005 09:37:58 CICSIVP1 An activity keypoint has been successfully taken.
DFHLG0743 01/19/2005 09:37:58 CICSIVP1 Tail of log stream CICINST.CICSIVP1.DFHLOG deleted at block id
X'0000000000000FDD'.
You should see messages similar to those in Figure 46 in the Printer section of the job output.
1DFHDB8210D Connection to DBCTL is proceeding. Check CDBC TD queue.
DFHDB8225I CICSIVP1 The DBCTL ID is IM7D. The DRA Startup Table suffix is IV.
INPUT: ASMCDPA02MS16995-28
PART=02MS16995-28 DESC= SCREW
AREA INV PROJ DIV UNIT CURRENT ON IN TOTAL COUNT BACK
DEPT CD PRICE REQMTS ORDER STOCK DISBURSE TAKEN ORDR
1. AA 165 11 0.152 260 0 300 4030 N 0
2. BA 165 15 0.069 60 0 80 5000 N 0
3. FF 554 6D 0.069 440 0 430 5000 N 0
4. 2 59 109 26 6.980 950 0 1000 5000 N 0
INPUT: ASMCDPA02JAN1N976B
PART=02JAN1N976B DESC= DIODE CODE-A
AREA INV PROJ DIV UNIT CURRENT ON IN TOTAL COUNT BACK
DEPT CD PRICE REQMTS ORDER STOCK DISBURSE TAKEN ORDR
1. 2 55 091 26 0.000 170 2000 170 4710 N 0