Appendix C. WEB LOG EXTRACTOR (WLE) OVERVIEW › C.2 WLE Utility Install Job

C.2 WLE Utility Install Job

The WLEINST and WLEINSTM jobs are generated in
sharedprefix.MICS.CNTL after the
sharedprefix.MICS.CNTL(JCLGEN0) job ends successfully.

The WLEINST job creates three files in a user-defined HFS
directory that are required for the WLE utility extract job,
prefix.MICS.CNTL(WLERUN):  wleload.exe, wleload.conf, and
wleload.scp, which are extracted from the WLETAR tar file.


The WLEINSTM job is similar to the WLEINST job with one
exception.  WLEINSTM extracts only one file, wleload.exe,
from the WLETAR tar file, and it is used to update the WLE
utility executable code as necessary.


Once the three files are in your HFS directory they are used
to create SMF-like data sets from web server log files.
Below is a detail checklist that will help you to configure
the necessary JCL.

 __ 1.  Customize Installation JCL.

     ********************************************************
     *                                                      *
     *  Note: This program is case sensitive.  JCL must be  *
     *  uppercase and UNIX System Services path names must  *
     *  be lowercase.                                       *
     *                                                      *
     ********************************************************

        The WLE Utility JCL is found in:

        sharedprefix.MICS.CNTL(WLEINST).

        On the next page, you will find sample JCL for the
        WLEINST job.  The lines are numbered and then
        referred to later in the checklist for detailed
        instructions on both how to tailor the individual
        lines and what they are used for.



  1  //WLEINST PROC HFSPATH='HFS.path.to.WLE'
  2  //*
  3  //STEP1   EXEC PGM=BPXCOPY,REGION=8M,
  4  // PARM='ELEMENT(WLETAR) TYPE(BINARY) MODE(0,6,6,6)'
  5  //SYSUT1   DD DSN=&SPREFIX..&SMICS.BIN(WLETAR),DISP=SHR
  6  //SYSUT2   DD PATH='/tmp/',
  7  //          PATHOPTS=(OCREAT,OWRONLY,OAPPEND),
  8  //          PATHMODE=(SIRWXU,SIRWXG,SIRWXO),
  9  //          PATHDISP=(KEEP,KEEP)
 10  //SYSTSPRT DD SYSOUT=*
 11  //*
 12  //STEP2   EXEC PGM=BPXBATCH,REGION=8M,COND=(0,NE,STEP1),
 13  // PARM='sh cd ?HFSPATH/;tar -xvof /tmp/WLETAR'
 14  //STDOUT DD PATH='/tmp/wleinst.stdout.dat',
 15  //          PATHOPTS=(OCREAT,OWRONLY,OAPPEND),
 16  //          PATHMODE=(SIRWXU,SIRWXG,SIRWXO),
 17  //          PATHDISP=(KEEP,KEEP)
 18  //* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 19  //* Print USS messages and command processing log
 20  //* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 21  //*
 22  //COPYSTDO EXEC PGM=IKJEFT1A,COND=EVEN,
 23  // PARM='OCOPY I(SYSUT1) O(SYSUT2) TEXT PATHOPTS(OVERRIDE)'
 24  //SYSTSPRT DD SYSOUT=(*)
 25  //SYSUT1   DD PATH='/tmp/wleinst.stdout.dat',
 26  //            PATHDISP=(DELETE,DELETE)
 27  //SYSUT2   DD SYSOUT=*,DCB=(LRECL=255,RECFM=VB,BLKSIZE=2560)
 28  //SYSUT3   DD PATH='/tmp/WLETAR',
 29  //          PATHDISP=(DELETE,DELETE)
 30  //SYSTSIN  DD DUMMY
 31  //*
 32  //     PEND
 33  //STEP EXEC WLEINST



        Step one (line 3) executes the BPXCOPY utility
        program to copy WLETAR (Web Log Extract TAR file)
        from the partitioned data set sharedprefix.MICS.BIN.
        The WLETAR file is copied to the default temporary
        directory, /tmp, in Unix Services (USS).  The /tmp is
        the path name of the directory used for temporary
        files.

 __ 2.  The HFSPATH symbolic parameter is assigned the value
        of path name that is defined in JCLDEFC with the
        keyword HFSROOT.

        WLEINST job stores the WLE files in a subdirectory of
        the CA MICS Root Directory (&HFSROOT./wle).

        Do not change the HFSPATH symbolic value in the JCL
        since this member is generated. Any changes made here
        will be lost when regenerated.

        You can override the default HFSPATH symbolic value
        by coding the desired value for WLEDIR symbol in
        sharedprefix.MICS.PARMS(JCLNAMES).


        *****************************************************
        * WARNING!  The &HFSROOT./wle must exist and you    *
        * must have read, write, and execute permissions to *
        * this path name. If the HFSPATH name is not found, *
        * the job completes with condition code zero and    *
        * message EDC5129I, "No such file or directory," in *
        * SYSUT2 DD.                                        *
        *****************************************************

        If the directory path is too long to fit on one line,
        the following example shows how to continue an
        apostrophe-enclosed parameter on another line
        (maximum length 255).

                Leave column 72 blank  ---------------------+
                                                            |
                Enter characters up to column 71   --------+|
                                                           ||
     INST PROC MICSHLQ='SHAREDPREFIX.MICS',                vv
          HFSPATH='/u/users/servers/systems/group/test/platf
          orm/http/logs'
          Y            Y
          |            +--- End with closing apostrophe
          |
          +---  Resume with next character column 16

 __ 3.  Submit WLEINST and ensure that it completes
        successfully with a condition code of zero.

        Step two (line 12) ensures that step one completed
        with a condition code of zero, and the WLETAR archive
        file was successfully copied to the specified
        directory.  If step one was successful:

        o  A change directory command is issued to point to
           the location where the WLE files are stored.

        o  A tar command is issued to inflate the tar files.

        o  Using the WLEINSTM job, the tar command extracts
           wleload.exe only from the WLETAR file.