Report Generator User Exits

CA ACF2 provides user exits for its report generators for specialized selection functions. The exit is taken before printing the record. One possible use of these exits is to further filter the SMF records, such as by CPU. Another possible use is to perform tabulating by fields.
acf2src
CA ACF2 provides user exits for its report generators for specialized selection functions. The exit is taken before printing the record. One possible use of these exits is to further filter the SMF records, such as by CPU. Another possible use is to perform tabulating by fields.
Link edit the various exits into the appropriate report generator load modules. All <acf> report generators are reentrant. If the user exit is not reentrant, link the combination without the RENT attribute.
The exit linkage follows standard conventions. Register 15 has the entry point address; register 14 has a return address; register 13 points to a save area; and register 1 points to a parameter list. The exit must save and restore the registers upon return.
The parameter list passed to the exit is two words, with the high-order bit in the second word always on to indicate the end of the parameter list. The only exception is ACFRPTSL, which has a three-word parameter list. Correspondingly, the high-order bit in the third word is always on to indicate the end of its parameter list. Entries in a parameter list are:
  • +0
    Address of SMF record processed (for all report generators except ACFRPTSL) or the address of the logonid record (for ACFRPTSL).
  • +4 
    Address of user's ACUCB (<acf> user control block) or zero if not available. The exit might use the ACUCB to obtain the user's logonid or UID.
  • +8 
    Address of the original input record (applies to ACFRPTSL only). The original record could be an SMF record, a backup file record, or a record from the logonid data set.
Upon return, the exit must set a return code in R15 indicating the action to take. A return code of zero (0) indicates that you should print the record. A nonzero return code causes the record to be skipped.
The following table lists teh CA ACF2 report generators that have exits, the entry points for the report generators, and the names of the exit CSECTs.
Report Generator
Entry Point
Exit CSECT Name
ACFRPTCR
ACF46RCR
ACFRCRXT
ACFRPTDS
ACF44RDS
ACFRDSXT
ACFRTEL
ACF47REL
ACFRELXT
ACFRPTJL
ACF43RJL
ACFRJLXT
ACFRPTLL
ACF42RLL
ACFRLLXT
ACFRPTNV
ACF51RNV
ACFRNVXT
ACFRPTPW
ACF41RPW
ACFRPWXT
ACFRPTRL
ACF45RRL
ACFRRLXT
ACFRPTRV
ACF48RRV
ACFRRVXT
ACFRPTSL
ACF49RSL
ACFRSLXT