10. MODIFICATION › 10.2 Standard User Exits › 10.2.2 Input Exits

10.2.2 Input Exits

This section provides a description of the input exit that is
shared by IMS with the other installed CA MICS products.

The exit description includes the name and title, a
description of its purpose, when it is invoked, and whether
or not it has an interface to the CA MICS Accounting and
Chargeback product.  It also shows which data elements are
available, the special considerations to note, and a sample
user exit.

+---------------+
| _ U S R S E L |  Input Record Selection Exit (_USRSEL)
+---------------+

DESCRIPTION:
   The _USRSEL exit provides the ability to select records
   that may be processed by the IMS input format routine.  It
   is similarly invoked to provide data selection for each
   CA MICS product.

INVOCATION:
   The  _USRSEL exit gains control during the input format
   phase of the IMS daily update process step (DAY060).  It
   is invoked after the account data SYSID header and other
   common fields have been read, but before the front-end
   record processing.  See Chapter 9 of this guide for more
   information.

ACCOUNTING INTERFACE:
   No interface is provided.

USES:
   This exit may be used to exclude records from processing
   based on their source, type, or origin.

ELEMENTS AVAILABLE:
   This exit is referenced by many different CA MICS
   products.  To help identify the caller, the ROUTINE
   variable is initialized with the module name.  The element
   SKIP_REC is initialized to zero just prior to the exit.
   If the exit code sets SKIP_REC to one, that record will be
   bypassed.

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

SAMPLE:



       MACRO _USRSEL
         IF ROUTINE = 'DYIMSFMT' THEN
         IF IMSID = 'IMS1' OR IMSID = 'IMS2' THEN
         IMSID = 'PIMS';/* COMBINE BOTH PROD IMS SYSTEMS */
       %