7. PARAMETERS › 7.3 Unit Level Parameters › 7.3.8 CICS Processing Thresholds (CICTHRSH)

7.3.8 CICS Processing Thresholds (CICTHRSH)

The CICTHRSH member of prefix.MICS.PARMS contains statements
and parameters that define input processing thresholds to the
CA MICS Analyzer Option for CICS.  The primary purpose of the
thresholds is to allow daily processing to continue, at your
discretion, after invalid data or errors have been
encountered during input.
 
* Please note that careful consideration should be given when
  setting input processing error tolerance thresholds because
  the result will be loss of data.  Setting these threshold
  values should only be done when the data being rejected is
  not important and its loss is acceptable.  If not, the
  underlying problem must be addressed instead.
 
* Also note that this member is only used for processing of
  CICS data. If your DAY040 step only processes CICS
  Transaction Gateway SMF type 111 records, you should not
  update this member. Simply leave the default values as
  delivered.
 
In addition, you can set thresholds to limit the size of the
CICCDC (CICS Data Dictionary) file and the number of error
messages displayed in the DAY040 MICSLOG.
 
You may modify CICTHRSH definitions at any time.  No CA MICS
generation jobs are required after making a change.  The
change will take effect in the next DAILY job execution.
 
The structure of the CICTHRSH member follows this format:
 
     o  One CICCDCEX statement
 
     o  One CICMSGTH statement
 
     o  One CIC060nn statement for each CIC060nn error that
        can be tolerated
 
Refer to Section 9.1.3.2 for more information.
 
CICCDCEX STATEMENT:  CMF Data Dictionary Record Retention
                     Period
 
    CICCDCEX number_of_days
 
Code one CICCDCEX statement.  This statement defines the
period of non-reference that must occur before a CMF data
dictionary record in the CICCDC01 file expires.  The expired
records are physically deleted from the CICCDC01 file at the
DETAIL timespan.  Number_of_days defaults to 9999 if CICCDCEX
is not defined.
 
Each CICS region in which CMF is active creates a set of data
dictionary records during CMF initialization.  The most
recently created set of records is retained in the CICCDC01
file.  This permits the processing of CMF data without data
dictionary records present in the input.  When a CICS CMF
region becomes obsolete, its data dictionary records should
be removed from the CICCDC01 file.  This process is automated
by detecting obsolete CICCDC01 records based on their period
of inactivity or non-reference.
 
A period of non-reference is defined as the number of days
between the date of last reference (data from a region was
processed by the CA MICS Analyzer Option for CICS) and
today's date. If the period of non-reference is greater than
the CICCDCEX number_of_days, then the CICCDC01 record is
deleted.
 
 
CICMSGTH STATEMENT:  Input Processing Error Message Display
 
    CICMSGTH number_of_iterations
 
Code one CICMSGTH statement.  This statement defines the
number of times an input processing message (CIC060nn
messages, where nn is the message number 01-99) can be
displayed for an input ddname.  Number_of_iterations defaults
to zero if CICMSGTH is not specified.
 
CIC060nn messages may be generated during the DAY040
processing step as errors are detected in the input.  For
example, CIC06011 indicates data is present for a CICS region
not defined in prefix.MICS.PARMS(CICOPS).  This message will
be generated for each input record related to the undefined
region.  If there are 1,000 input records for the undefined
region, there will be 1,000 occurrences of the CIC06011
condition for the input ddname containing data for this
region.  The number of times the CIC06011 message is
displayed for this input ddname is limited by the CICMSGTH
number_of_iterations value.  If the value is 20, then the
CIC06011 message will be displayed up to 20 times.
 
CICMSGTH specification prevents an unexpected condition from
filling MICSLOG with redundant messages.  The actual number
of occurrences of any CIC060nn message for each input ddname
is summarized and displayed in MICSLOG.  Using the example
above, although a maximum of 20 CIC06011 messages are
displayed for the ddname containing the undefined region, an
informational message is displayed that indicates the
condition occurred 1,000 times.  The CICMSGTH threshold is
message-specific: if the CIC06024 condition was encountered
during processing of the input ddname that contained the
CIC06011 condition, up to 20 occurrences of both messages are
displayed.
 
CIC060nn STATEMENT:  Input Processing Error Tolerance
 
    CIC060nn number_of_occurrences
 
Code one CIC060nn statement for each CIC060nn error that can
be tolerated.  This statement defines the number of times an
input processing error (CIC060nn messages, where nn is the
message number 01-99) can be tolerated before end-of-input
processing is followed by a user 998 abend.
Number_of_occurrences is set to null (no tolerance) if
CIC060nn is not specified for a value of nn.
 
Using the example described in the preceding CICMSGTH
description, a CIC06011 condition may be tolerated.  An input
ddname may contain data for regions that are not to be stored
in CA MICS (for example, test regions). Specification of a
tolerance value for the CIC06011 condition permits successful
processing of input data that contains undefined (to CICOPS)
regions.  Suppression of the user 998 abend will not occur
unless the number_of_occurrences tolerance value equals or
exceeds the number of times the error condition occurred.
 
Alternatively, the input ddname may contain data for a new
and undefined (to CICOPS) region that should be stored in
CA MICS. If the CIC06011 statement is not specified (or
number_of_occurrences is set to 0), then a user 998 abend
will occur in the daily CICS input processing step, signaling
a potential loss of data.  The CA MICS Analyzer Option for
CICS provides a default tolerance value of 999999 for message
CIC06011.
 
We suggest that all CIC060nn statements be defined in
response to a specific situation.  When the error condition
is corrected, the CIC060nn statement should be removed.  If a
condition is transient and the loss of data insignificant,
the CIC060nn number_of_occurrences can be set to a small
value.  If the transient condition results in an unexpected
significant loss of data, the user 998 abend will occur,
indicating an unusual event.
 
A sample CICTHRSH member is illustrated below:
 
    CICCDCEX 32
    CICMSGTH 20
    CIC06013 100
 
The effect of these statements is to:
 
    o  Retain CICCDC01 records for 32 days of non-reference.
 
    o  Limit the display of any CIC060nn message for each
       input ddname to a maximum of 20 iterations.
 
    o  Permit rejection of a maximum of 100 "short records"
       before a user 998 abend is issued after completion of
       input processing.