What do the accounting, post-print accounting, and audit PSF DSS user exits provide?
The accounting and audit PSF DSS user-exit programs record statistical data on jobs processed by InfoPrint Manager actual destinations. This table shows the most common accounting and audit user-exit programs, the files where they record data, and the types of data that they record.
| Program | Log File | Records |
|---|---|---|
| install_path\bin\ainuxaccp | install_path\var\psf\podaccount.log | Job submitter, job ID, actual destination, submission machine (nodeid), pages processed (projected), sheets from bin 1, sheets from bin 2, end time, start date, start time, copies per job |
| install_path\bin\ainacclog | install_path\var\psf\accounting.log | Job submitter, job name, actual destination, submission machine (nodeid), pages processed (projected), sheets from bin 1, sheets from bin 2, end time, start date, start time, fonts, resident fonts, overlays |
| install_path\bin\ainuxjobcompletion | install_path\var\psf\jobcompletion.log | Job submitter, job ID, job name, spool ID, actual destination, global ID, user pages stacked by tray, user sheets stacked by tray, actual pages stacked by tray, actual sheets stacked by tray, copies requested, fonts and resident fonts used, overlays used, hard and soft segments used, processing start and stop date/time, job completion date/time, file date/time, extended user ID, extended job ID, address, account, building, department, programmer, room, title, job ticket name |
| install_path\bin\ainaudlog | install_path\var\psf\audit.log | Job submitter, job name, actual destination, pages per job, pages per actual destination, jobs per output bin, start date, start time, fonts, resident fonts, overlays |
Both install_path\bin\ainacclog and install_path\bin\ainaudlog record the same information in different files. This information is specified in flat ASCII format, with a single line for each job that is processed. You can use this information to determine billing procedures, to assess the workload of different output devices, or to determine how resources are used at your installation.
The ainuxjobcompletion exit is called when the printer reports back to InfoPrint Manager that all of the pages for a job have printed. This includes a partial job (due to a data stream error or because the job was paused/cancelled or forward-spaced) and also any extra pages produced as a result of a backspace or other recovery. For the last job that prints on a continuous forms printer, the exit is not called until an NPRO (non-print run out) is done, either by an operator or automatically by InfoPrint Manager.
Only one record is written for a job that prints, unless a job is paused. In this case, a record is written for the part of the job that was printed up to the pause point; later, if the job is resumed, another record is written for the rest of the job.
A new procedure has been added to the InfoPrint Manager Administration GUI to show you how to activate the default PSF ainuxjobcompletion accounting logs. The ainuxjobcompletion accounting exit interface can be used for PSF-driven IPDS printers. It provides actual (versus projected) accounting data and provides additional information about completed print jobs.
Customers installing a InfoPrint Manager server for the first time will see the post-print
accounting exit activated and the accounting data will be written to install_path\var\psf\jobcompletion.log.
The intent is to minimize migration issues for existing customers, but to start new customers out with the preferred accounting exit. The default installation for new machines will not activate both accounting exits. However, when a newer version of InfoPrint Manager is installed, both new and migrated customers can choose to have the old, preferred, or both accounting exits active.
If a migrating installation wants to activate the preferred (new) exit, the administrator must set the psf-post-print-accounting-program-name auxiliary sheet attribute in the appropriate auxiliary sheet object to provide the name of either the IBM supplied sample exit or a custom version of the preferred exit. The administrator can also choose to deactivate the old exit by resetting the value of the psf-exit-program-name auxiliary attribute in the appropriate auxiliary sheet object to <not set>.
If a new installation wants to deactivate the preferred exit and instead run the old exit, the administrator must reset the psf-post-print-accounting-program-name auxiliary sheet attribute in the appropriate auxiliary sheet object to <not set>. The administrator can also choose to activate the old exit by setting the value of the psf-post-print-accounting-program-name auxiliary sheet attribute in the appropriate sheet object to the name of either the InfoPrint Manager supplied sample exit or a custom version of the old exit.
In both cases, the administrator can also choose to have both exits active by setting the psf-exit-program-name and the psf-post-print-accounting-program-name auxiliary sheet attributes to the names of the two accounting programs (old and preferred). The administrator can also choose to deactivate both exits by leaving both attributes unset.