Appendix C. WEB LOG EXTRACTOR (WLE) OVERVIEW › C.2 WLE Utility Install Job › C.2.1 Executing the WLE Utility › C.2.1.1 Executing WLE Utility in Batch
C.2.1.1 Executing WLE Utility in Batch
__ 1. Edit prefix.MICS.PARMS(WLECONF).
WLECONF is where you configure necessary parameters.
This is where you decide what log files you want to
collect data from, space allocations, data set names,
etc. See Appendix C.3.1.1 and Appendix C.3.1.2 of
this guide for all parameter specifications.
__ 2. The following numbered JCL example and correlating
steps help to execute the log extract program
(WLELOAD.EXE) from the z/OS or OS/390 environment.
After the JCL has been updated:
Submit prefix.MICS.CNTL(WLERUN).
Ensure there are no error messages in the SYSUT2 DD
of the WLEERROR step, and the job completes with a
return code of zero.
Below is an EXEC step with three parameters that must
be updated. This procedure and their descriptions
follow.
1 //WLERUN PROC HFSPATH='HFS.path.to.WLE',
2 // HFSHELL='wleload.scp', /* Script File Name */
3 // WLECONF='wleload.conf', /* WLE Config File */
4 // WLEREPRT='wleload.rpt', /* WLE Output Report */
5 // WLEERROR='wleload.err' /* WLE Error Log */
6 //*
7 //* Copy the script contents
8 //*
9 //OCOPYS1 EXEC PGM=IKJEFT01
10 //INSCP DD DISP=SHR,DSN=&SPREFIX..&SMICS.PARMS(WLESCRPT)
11 //OUTSCP DD PATH='&HFSPATH/&HFSHELL',
12 // PATHDISP=(KEEP,KEEP)
13 //SYSTSPRT DD SYSOUT=*
14 //SYSTSIN DD DUMMY
15 //*
16 //* Copy the WLE config file
17 //*
18 //OCOPYS2 EXEC PGM=IKJEFT01
19 //INCONF DD DISP=SHR,DSN=PREFIX.MICS.PARMS(WLECONF)
20 //OUTCONF DD PATH='&HFSPATH/&WLECONF',
21 // PATHDISP=(KEEP,KEEP)
22 //SYSTSPRT DD SYSOUT=*
23 //SYSTSIN DD DUMMY
24 //*
25 //*************************************
26 //* Execute the script file
27 //*************************************
28 //*
29 //RUNSCRPT EXEC PGM=BPXBATCH,REGION=8M,
30 // PARM='sh cd &HFSPATH/;&HFSHELL'
31 //*
32 //*************************************
33 //* Copy HFS error.file to MVS dataset
34 //*************************************
35 //*
36 //OCOPYS3 EXEC PGM=IKJEFT01
37 //INERROR DD PATH='&HFSPATH/&WLEERROR',
38 // PATHOPTS=(ORDONLY)
39 //OUTERROR DD DSN=&&OUTERROR,DISP=(NEW,PASS),UNIT=SYSDA,
40 // SPACE=(TRK,(5,5),RLSE),
41 // DCB=(RECFM=VB,LRECL=133,BLKSIZE=137)
42 //SYSTSPRT DD SYSOUT=*
43 //*
44 //* Copy HFS error.file to MVS dataset
45 //*
46 //WLEREPRT EXEC PGM=IEBGENER
47 //SYSPRINT DD SYSOUT=*
48 //SYSUT1 DD DISP=(OLD,DELETE),DSN=&&OUTERROR
49 //SYSUT2 DD SYSOUT=*
50 //SYSUT3 DD PATH='?HFSPATH/?WLEERROR',
51 // PATHDISP=(DELETE,DELETE)
52 //SYSIN DD DUMMY
53 //*************************************
54 //* Copy HFS report.file to MVS dataset
55 //*************************************
56 //*
57 //OCOPYS4 EXEC PGM=IKJEFT01
58 //INREPRT DD PATH='&HFSPATH/&WLEREPRT',
59 // PATHOPTS=(ORDONLY)
60 //OUTREPRT DD DSN=&&OUTREPRT,DISP=(NEW,PASS),UNIT=SYSDA,
61 // SPACE=(TRK,(5,5),RLSE),
62 // DCB=(RECFM=VB,LRECL=133,BLKSIZE=137)
63 //SYSTSPRT DD SYSOUT=*
64 //*
65 //* Copy HFS report.file to MVS dataset
66 //*
67 //WLEREPRT EXEC PGM=IEBGENER
68 //SYSPRINT DD SYSOUT=*
69 //SYSUT1 DD DISP=(OLD,DELETE),DSN=&&OUTREPRT
70 //SYSUT2 DD SYSOUT=*
71 //SYSUT3 DD PATH='?HFSPATH/?WLEREPRT',
72 // PATHDISP=(DELETE,DELETE)
73 //SYSIN DD DUMMY
74 // PEND
75 //STEP EXEC WLERUN,
76 //* */
77 //*************************************************************
78 //OCOPYS1.SYSTSIN DD *
79 OCOPY INDD(INSCP) OUTDD(OUTSCP) TEXT CONVERT(YES) PATHOPTS(USE)
80 /*
81 //OCOPYS2.SYSTSIN DD *
82 OCOPY INDD(INCONF) OUTDD(OUTCONF) TEXT CONVERT(YES) PATHOPTS(USE)
83 /*
84 //OCOPYS3.SYSTSIN DD *
85 OCOPY INDD(INERROR) OUTDD(OUTERROR) TEXT CONVERT(YES) PATHOPTS(USE)
86 /*
87 //OCOPYS4.SYSTSIN DD *
88 OCOPY INDD(INREPRT) OUTDD(OUTREPRT) TEXT CONVERT(YES) PATHOPTS(USE)
89 /*
This job executes the BPXBATCH utility program to run
a shell script that executes the wleload.exe
program to process HTTP server log files. This JCL
may be submitted directly or can be submitted by a
scheduling product.
__ . The HFSPATH symbolic parameter is assigned the value
of path name that is defined in JCLDEFC with the
keyword HFSROOT.
WLERUN job copies wleload.conf and wleload.scp files
in the subdirectory of the CA MICS Root Directory
(&HFSROOT./wle). The wleload.scp is a script file
that executes wleload.exe program. The wleload.exe
program redirects the stderr (wleload.err) and stdout
(wleload.rpt) output to this directory.
Do not change the HFSPATH symbolic value in the JCL
since this member is generated. Any changes made here
are lost when regenerated.
You can override the default HFSPATH symbolic value
by coding the desired value for WLEDIR symbol in
prefix.MICS.PARMS(JCLNAMES).
Note: The &HFSROOT./wle must exist, contain the WLE
utility executable code, and you must have read,
write, and execute permissions to this path name or
the job will fail.
The following parameters are optional and can be
added to the EXEC statement, located at the bottom of
this JCL job, to override the default file names.
__ 2a. Change "HFSHELL" to point to the script file that
must be in the directory, as defined by step 1
(above). The default file name is wleload.scp. If
you would like to specify a specific date for the
HFSHELL, you can tailor this member to meet your
site's needs in:
prefix.MICS.PARMS(WLESCRPT)
See Appendix C.2.1.2 in this guide for further
information about date manipulation and redirection,
pertaining to the WLESCRPT member.
__ 2b. Change "WLECONF" to point to the WLE configuration
file. This is where you define what log files you
want to collect data from, the OS data set name,
space allocations, etc. See Section C.3.1.1 of this
guide for all parameter specifications.
Updates can be made to the configuration in
prefix.MICS.PARMS(WLECONF).
__ 2c. Change "WLEREPRT" to match the name of the report
file set in the wleload.scp file, using redirection.
To retrieve the report from UNIX System Services when
running the wleload program from a z/OS or OS/390
address space, the wleload.scp file must use
redirection for stdout to create an HFS file that can
be sent to JES output.
__ 2d. Change "WLEERROR." This is where all the non-utility
related errors are.
