Creating COBOL Routines

You can create your own COBOL routines for use with Payroll Interface. The system isolates your COBOL routines from the delivered Payroll Interface COBOL processes and calls them by retrieving the name specified on the Process Table component - Interface Process Table page, User Exit Program field.

Shell programs for three user exit invocation points are provided with Payroll Interface. You can use these programs as templates for your COBOL routines:

  • PIPMPOTH: For routines performed during the Import process.

  • PIPSPOTH: For routines performed during the Export process select/compare phases.

  • PIPXPOTH: For routines performed during the Export process create export file phase.

To define your own COBOL routine:

  1. Make a copy of the shell program that is associated with the Payroll Interface process phase in which your special process routine will be performed.

    Do not modify the shell programs. These programs are set up with all the necessary working storage and linkage section data elements already defined and should be preserved as modules for future development.

  2. Change all references to the shell program name to the name of your new routine.

    Follow the PeopleSoft naming convention to make it easier to identify the timing of your own routines. You should change the last three characters of the program name to the system ID for which the routine is written. For example, the ADP system ID has three routines: PIPMPADP, PIPSPADP, and PIPXPADP.

  3. Select a process ID for your new routine.

    Review copy member PICPRCSW.CBL and select an unassigned number between 80000 and 899999. These numbers will not be used by PeopleSoft development. Add an 88 level description for your new routine in the copy member. Code your program logic and compile your program.

  4. Define your new routine to Payroll Interface by setting up a process ID using the Process Table component.

Note:

For AS400 and Oracle/VMS platforms, you must specify the calls to your user exit programs in copy member PICUEXIT.CBL. Edit this copy member to add your new program in the appropriate place.

Related Topics