What transactions does Report Facility have defined for CICS

Products

• Report Facility

Issue/Introduction

What transactions does Report Facility have defined for CICS?

Resolution

For PRF there are external and internal transaction codes. External transaction codes are defined as those that a user can execute from the CICS command line. Internal transaction codes are those
that are issued by PRF only for pseudo-conversational purposes. There are eleven sets of transaction codes for processing PRF and each set can be defined differently depending upon the needs of
the installation.

PRF External Transaction codes

• PRF - The standard PRF product transaction code

  >------ PRF -----+----------+--->                 + procname +

  If the optional procname is indicated on the product transaction code(s), then PRF will force the user into autostart mode (see the User Profile Option for startup mode). PRF will then attempt to
  run the named procedure and will either succeed or issue a message to the user. The user will finally be placed in the PRF Main Menu screen.

• PRFI - The standard Spill initialization transaction code

  >------ PRFI ------------------->

  PRFI is used to clean out the spill file. Further, it also frees the storage used for tracking the spill record usage and the PRF users in the system. Finally it erases the PRF information that is
  stored in the CWA. PRFI should NEVER be run when there are users in PRF using the system. If the PRFI transaction is run with users in PRF, those users will abend with ASRA abend codes.
  
  PRF should start each CICS session with a clean spill file. This can be done in one of three ways.
  
  
  1. The PRFSPINT program can be added to the CICS startup JCL to cleanup the spill file before starting the CICS region. (See SRCLIB(MPRJCL) for a similar IMS jobstream).
  2. The PRFCINT1 program can be added to the PLT processing at the startup of CICS. PRFCINT1 is the very program that is executed using PRFI. (See SRCLIB(PRFPLT) for a sample PLT entry for CICS).
  3. Remember to use the PRFI transaction code each time CICS is started. The PRFI transaction is the only way to clean up the PRF Spill file for a running CICS system. Only on rare occasions should this be necessary but might be needed for long running systems.

 

• PRFK - The PRFKILL transaction code

  >------ PRFK ZZZZ HHMM --------->

  Where:
  
  
  • ZZZZ - Decimal offset within the CWA of the 14 bytes of PRF information.
  • HHMM - The interval at which you wish PRFKILL to restart itself, in hour/minute format.
  
  The PRFKILL transaction is executed both internally and externally. Mostly it is used internally by PRF based on the System Profile parameter (See the System Profile). There is an external interface but the user needs to know where the PRF information is in the CWA.

PRF Internal transaction codes

• PRFA - PRF Administration Menu return tranid
• PRFM - PRF Main Menu return tranid
• PRFS - PRF System Profile return tranid
• PRFU - PRF Active User Display return tranid
• PFUM - PRF User Profile return tranid
• PFMG - PRF Message Processor return tranid

PRF transaction sets

Above are listed the standard transaction set for PRF. There are also alternate sets of transaction codes for PRF that add a suffixed number to the standard transaction codes. These transaction sets can be defined differently by the administrator to accomplish load balancing of the CICS regions or to include different security parameters to the sets. The transactions are:

• PRF0 thru 9 - Alternate PRF product transaction code for the given set number
• PRI0 thru 9 - Alternate Spill initialization transaction code for the given set number
• PRA0 thru 9 - Alternate PRF Administration Menu return tranid for the given set number
• PRM0 thru 9 - Alternate PRF Main Menu return tranid for the given set number
• PRS0 thru 9 - Alternate PRF System Profile return tranid for the given set number
• PRU0 thru 9 - Alternate PRF Active User Display return tranid for the given set number
• PFM0 thru 9 - Alternate PRF User Profile return tranid for the given set number
• PFG0 thru 9 - Alternate PRF Message Processor return tranid for the given set number