Appendix C. WEB LOG EXTRACTOR (WLE) OVERVIEW › C.3 Defining the Configuration Parameters › C.3.1 Web Log Extractor Configuration File › C.3.1.1 Configuration File Global Information

C.3.1.1 Configuration File Global Information

When preparing to configure the Web Log Extractor, certain
parameters must be defined.  This section explains the global
parameters and their function.

Note:  The following parameters keywords are case-sensitive,
and errors can occur if they are not entered correctly.
Every attempt is made by the utility program to correct
case-sensitive errors before the program aborts.

Note:  Only the DataSetName parameter is required.  All other
parameters are optional, but must be specified if the
parameter defaults do not meet your site
requirements.

An example of a WLE Configuration File Global Information
parameter specification is shown below.  A detailed
explanation of each parameter follows.

DataSetName    SERVER2.OS390.HTTP.LOGRECS
DSmodelDSCB    no
RecType        241
DSprimary      5
DSsecondary    2
DSunit         3390
DSvolser       MICS01
DSstorClas     no
DSdataClas     no
DSmgmtClas     no
DSdisp         OLD
CompanyName    CA
ConfigReport   yes
ErrorLimit     100

o   DataSetName - Data Set Name

       Required: Yes

       Default : None

       The data set name, created or written to by the WLE
       Extract Utility job, must be no more than 44
       characters and follow standard MVS data set naming
       conventions.  This is the data set input by the DAY052
       step in the CA MICS daily update job.  It is
       recommended that this data set be created as a GDG
       data set by adding a (+1) to the end of data set name
       in order to minimize changing of the DISP parameter.
       If a GDG type data set is indicated, the DSmodelDSCB
       parameter may be required.

o   DSmodelDSCB - Model DSCB name

       Required: No

       Default : no

       The model DSCB name may be required when creating GDG
       output data sets with the WLE Extract Utility job.  It
       must be no more than 44 characters, and follow
       standard MVS data set naming conventions. This
       parameter should reference the model DSCB used for GDG
       data sets on the system that the WLE utility is being
       executed on.

o   RecType - Record Type / Number

       Required: No

       Default: 241

       The records created from the server log files by the
       WLE Extract Utility job are "SMF like", and contain
       the record type or number, in byte 2 of each record.
       You can specify a numeric value other than 241, as
       long as it falls between 128 and 241.

o   DSprimary - Data Set Primary Space Allocation

       Required: No

       Default: 9

       Primary space allocation, in cylinders, for the output
       data set name.  The default value is 9 cylinders.

o   DSsecondary - Data Set Secondary Space Allocation

       Required: No

       Default: 5

       Secondary space allocation, in cylinders, for the
       output data set name.  The default value is 5
       cylinders.

o   DSunit - Data Set Unit Name

       Required: No

       Default: SYSALLDA

       Unit for the output data set name (e.g., SYSALLDA,
       SYSDA, 3390, etc.).

o   DSvolser - Data Set Volume Serial Number

       Required: No

       Default: None

       Volume Serial number for the output data set name.  No
       default is available.

o   DSstorClas - Storage Class

       Required: No

       Default: no

       SMS Storage class name for output data set name.  The
       default value is "no".

o   DSdataClas - Data Class

       Required: No

       Default: no

       SMS Data class name for output data set name.  The
       default value is "no".

o   DSmgmtClas - Management Class

       Required: No

       Default: no

       SMS Management class name for output data set name.
       The default value is "no".

o   DSdisp - Data Set Disposition

       Required: No

       Default: NEW

       The disposition of the output data set name at open
       time.  Possible values for this parameter are either
       NEW or OLD.

o   CompanyName - Company Name

       Required: No

       Default: CA

       Company name used for web log extract report headings.
       This field can be up to 44 characters.

o   ConfigReport - Configuration Report

       Required: No

       Default: yes

       The ConfigReport parameter allows you to suppress
       generation of the GLOBAL and SERVER extract reports by
       the WLE Extract Utility job.

       Possible values for this parameter are yes or no.  If
       ConfigReport no is specified, processing statistics
       for the selected log files and error messages are
       produced.  If ConfigReport yes is specified, in
       addition to processing statistics and error messages
       (generated by ConfigReport no), a formatted report of
       the configuration file is printed.

o   ErrorLimit - Error Limit

       Required: No

       Default: 100

       Number of errors allowed per log file before
       termination.  The WLE Utility job expects the various
       server log files to be formatted according to industry
       defined specifications.  Occasionally, fields in the
       log records are not formatted correctly, and must be
       skipped.  This parameter allows for a reasonable
       amount of malformatted data without rejecting the
       processing of an entire log file.