10. MODIFICATION › 10.1 Standard User Exits › 10.1.2 General Exits

10.1.2 General Exits

General exits are invoked for all products.  They are
presented here to identify the special uses available for the
Hardware and SCP Analyzer.

Each exit description includes the name and title, a
description of its purpose, and when it is invoked.  It also
shows which data elements are available and any special
considerations.

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

DESCRIPTION:  USRSEL allows access to each record processed
by any product.  It can be used to alter input data formats
or to select or exclude specific records.

INVOCATION:  This exit gains control after a detail input
record has been read and before the record formats have been
defined.

ACCOUNTING INTERFACE:  No interface is provided.

USES:  This exit may be used to delete records before
processing or to alter the data, such as SMF SYSID.

ELEMENTS AVAILABLE:

ROUTINE - The name of the routine that invoked this exit.  To
use this exit in the Hardware and SCP Analyzer, test for:

ROUTINE = 'DYRMFFMT'
SMFRTYPE - the record type of the input record
ORGSYSID - the original SYSID from the SMF record
ENDTS    - the time when the record was written to SMF

CODING RESTRICTIONS:  For coding restrictions, refer to the
System Modification Guide, Section 4.3.2.1.

SPECIAL NOTES:  Because this exit is used by all products,
the source code is located in member #BASEXIT of the
appropriate source libraries.

SAMPLE USER EXIT:  This exit will set all SYSIDs of TEST to
SYS1 for all RMF records.

MACRO _USRSEL
  /**********************************/
  /* Convert SYSIDs of TEST to SYS1.*/
  /**********************************/
  IF ROUTINE='DYRMFFMT' AND ORGSYSID='TEST'
  THEN ORGSYSID='SYS1';
  %

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

DESCRIPTION:  USRIHL permits inspection of the DETAIL
timespan checkpoint file immediately following processing of
all input records in the format routine.

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

ACCOUNTING INTERFACE:  No interface is provided.

USES:  This exit is normally not of use to the Hardware and
SCP Analyzer.

ELEMENTS AVAILABLE:  All elements in the ADMIHL file.

CODING RESTRICTIONS:  For coding restrictions, refer to the
System Modification Guide, Section 4.3.2.1.

SPECIAL NOTES:  Because this exit is used by all products,
the source code is located in member #BASEXIT of the
appropriate source libraries.