10. MODIFICATION › 10.3 Input Exits

10.3 Input Exits

This section provides a description of the general user exits
that are invoked during CA MICS Analyzer for CA-IDMS DAILY
update processing.  The exits are listed alphabetically.

Each exit description includes the name and title, a
description of its purpose, when it is invoked, and whether
it has an interface to CA MICS Accounting and Chargeback. In
addition, it shows the data elements that are available, the
special considerations to note, and a sample user exit.

+---------------+
| _ U S R S E L | - File Processing Selection Exit
+---------------+

DESCRIPTION:  This exit allows access to each record
processed.

INVOCATION:  The exit gains control after a detail input
record has been read.

ACCOUNTING INTERFACE:  No interface to CA MICS Accounting and
Chargeback.

USES:  This exit can be used to delete records before
processing.

ELEMENTS AVAILABLE:
  ROUTINE - The name of the routine that invoked this exit.
    To use this exit in the IDMS Analyzer process, test for
    ROUTINE = 'DYIDMFMT'.

  SMFRTYPE - The record type of the input record:
    230 - CA-IDMS Performance Monitor record

  ORGSYSID - Original SYSID defined by the system
    administrator.

  IDMSID -  Created, unique IDMS identification for each
    Central Version.  The IDMSID will be a four-byte field
    consisting of a constant "CV" concatenated with the two-
    byte Central Version number (01-99).

  STARTTS - The time when the task was initiated.

  ENDTS - The time when the record was written to SMF.

CODING RESTRICTIONS:  Refer to System Modification Guide,
section 4.3.2.1.

SPECIAL NOTES:

  1. This exit is part of the CA MICS Base component and is
     located in sharedprefix.MICS.USER.SOURCE(#BASEXIT).

  2. You must qualify all coding in this exit by examining
     the name of the routine in which the exit was invoked
     because this exit is invoked in many places.  The
     program variable ROUTINE exists for this purpose.

  3. No time offset has been applied to ENDTS when this exit
     gains control.

+---------------+
| _ U S R I H L | - Examine Input History Log
+---------------+

DESCRIPTION:  This exit permits inspection of the DETAIL
timespan checkpoint SAS file immediately following processing
of all input records.

INVOCATION:  This exit is referenced in code that passes the
DETAIL timespan checkpoint SAS file.  This code reads
_ADMX.CKPTDATA as an integrity check on that file, and in the
process allows the user to inspect the file's contents.

ACCOUNTING INTERFACE:  No interface to CA MICS Accounting and
Chargeback.

USES:  This exit can be used to abort DAILY update processing
based on an extended checkpoint examination algorithm.

ELEMENTS AVAILABLE:  All elements in the ADMIHL File.

  ROUTINE - the name of the routine that invoked this exit.
    To use this exit in the IDMS Analyzer process, test for
    ROUTINE = 'DYIDMFMT'.

CODING RESTRICTIONS:  Refer to System Modification Guide,
Section 4.3.2.1.

SPECIAL NOTES:

  1. This exit is part of the CA MICS Base component and is
     located in sharedprefix.MICS.SOURCE(#BASEXIT).  However,
     it is recommended that the user modify
     prefix.MICS.USER.SOURCE(#BASEXIT).  A more detailed
     description of this routine is provided in the CA MICS
     System Modification Guide, Section 4.3.2.1, General
     Operational Exits.

  2. Because this exit is used in many places, it is
     necessary to qualify all coding in this exit by
     examining the name of the routine in which the exit was
     invoked.  The program variable ROUTINE exists for this
     purpose.