Troubleshooting
Problem
The following provides information on how to set up resource or printer file accounting.
Resolving The Problem
The following provides information on how to set up resource or printer file accounting.
Creating a Journal Receiver
Create a journal receiver in a library of your choice by using the Create Journal Receiver (CRTJRNRCV) command. On the operating system command line, type the following:
Press the Enter key. Name the journal receiver ACGJRN1 or a similar name that can be used to create a naming convention such as ACGJRN2, ACGJRN3, for future journal receivers.
After you create the first receiver, you can create additional receivers and attach them to the QSYS/QACGJRN journal automatically with the correct naming convention by using the CHGJRN JRNRCV(*GEN) command. Place the journal receiver in a library that is saved regularly.
Specify options on the CRTJRNRCV command to assist in operational aspects. If dual journal receivers are used, create a second journal receiver.
Note: The following restrictions apply to both journals and journal receivers:
Note: If you need to record files in a journal that users have received and printed, you must first delete all the QPRTJOB system jobs for those users. End the QPRTJOB system job using the End Job (ENDJOB) command and option SPLFILE(*YES). This deletes all spooled files sent to this user using the Send Network Spooled Files (SNDNETSPLF) command and ends the user's QPRTJOB system job. The system value QACGLVL should be changed to *PRINT or *PRINT *JOB. The next time a file is sent to a user, a QPRTJOB job is created for that user and the job accounting level is correct for any files sent to that user.
Creating a Journal Receiver
Create a journal receiver in a library of your choice by using the Create Journal Receiver (CRTJRNRCV) command. On the operating system command line, type the following:
CRTJRNRCV JRNRCV(USERLIB/ACGJRN1)
Press the Enter key. Name the journal receiver ACGJRN1 or a similar name that can be used to create a naming convention such as ACGJRN2, ACGJRN3, for future journal receivers.
After you create the first receiver, you can create additional receivers and attach them to the QSYS/QACGJRN journal automatically with the correct naming convention by using the CHGJRN JRNRCV(*GEN) command. Place the journal receiver in a library that is saved regularly.
Specify options on the CRTJRNRCV command to assist in operational aspects. If dual journal receivers are used, create a second journal receiver.
Note: The following restrictions apply to both journals and journal receivers:
| o | Restore journals and journal receivers to the same library where they are saved. |
| o | Journals or journal receivers cannot be renamed, moved, or copied. |
| o | A library containing a journal or journal receiver cannot be renamed. |
Creating a Journal Entry
Create a journal QSYS/QACGJRN using the Create Journal (CRTJRN) command. The name QSYS/QACGJRN must be used, and you must have authority to add objects to QSYS. Specify the name of the journal receiver(s) created earlier and any other options on the command. Consider who should have authority to this journal.
Note: See the restrictions listed above which also affect journal entries.
Changing the System Value
As the security officer, change the accounting level system value QACGLVL using the Work with System Value (WRKSYSVAL) command or the Change System Value (CHGSYSVAL) command. When the system value is changed, any new jobs started on the system automatically produce a job accounting journal entry when the jobs are completed.
The VALUE parameter on the CHGSYSVAL command determines when job accounting journal entries are produced:
Create a journal QSYS/QACGJRN using the Create Journal (CRTJRN) command. The name QSYS/QACGJRN must be used, and you must have authority to add objects to QSYS. Specify the name of the journal receiver(s) created earlier and any other options on the command. Consider who should have authority to this journal.
Note: See the restrictions listed above which also affect journal entries.
Changing the System Value
As the security officer, change the accounting level system value QACGLVL using the Work with System Value (WRKSYSVAL) command or the Change System Value (CHGSYSVAL) command. When the system value is changed, any new jobs started on the system automatically produce a job accounting journal entry when the jobs are completed.
The VALUE parameter on the CHGSYSVAL command determines when job accounting journal entries are produced:
| Parameter Value | Description |
| *NONE | The system does not produce any entries in the job accounting journal. |
| *JOB | The system produces a JB journal entry for each accounting segment of a job. |
| The system produces a DP or an IBM SP journal entry for each file printed (either a nonspooled file or a spooled file written by a print writer). | |
| *JOB *PRINT | The system produces both types of journal entries. |
The system requires that the QSYS/QACGJRN journal be created before this system value is changed to request job accounting.
Note: If you specify Yes to save job accounting information about completed printer output using the Operational Assistant user interface, the QACGLVL system value is changed to *PRINT or *JOB *PRINT if job accounting is already on. A journal receiver and a journal are also automatically created, eliminating the need to manually create them. If you change the system value later to turn job accounting off, the completed printer output option on the Operational Assistant menu is not available.
For information on processing the accounting journal entries, see Converting Job Accounting Journal Entries in the Work Management manual.
Note: In order to get the SP and DP audit journal entries when doing a DSPJRN, make sure the outfile format is set to OUTFILFMT(*TYPE5).
Note: Remote writers do not log useful information (for instance, the JATPAG value would always be 0 for remote writers) so you should switch from using Remote Output Queues (RMTOUTQ) to using *LAN 3812 printer device descriptions if you want to get useful information from the SP and DP audit journal entries. For more information, reference Capabilities and Limitations of Remote Output Queues (RMTOUTQs)
Note: If you specify Yes to save job accounting information about completed printer output using the Operational Assistant user interface, the QACGLVL system value is changed to *PRINT or *JOB *PRINT if job accounting is already on. A journal receiver and a journal are also automatically created, eliminating the need to manually create them. If you change the system value later to turn job accounting off, the completed printer output option on the Operational Assistant menu is not available.
For information on processing the accounting journal entries, see Converting Job Accounting Journal Entries in the Work Management manual.
Note: In order to get the SP and DP audit journal entries when doing a DSPJRN, make sure the outfile format is set to OUTFILFMT(*TYPE5).
Note: Remote writers do not log useful information (for instance, the JATPAG value would always be 0 for remote writers) so you should switch from using Remote Output Queues (RMTOUTQ) to using *LAN 3812 printer device descriptions if you want to get useful information from the SP and DP audit journal entries. For more information, reference Capabilities and Limitations of Remote Output Queues (RMTOUTQs)
Note: If you need to record files in a journal that users have received and printed, you must first delete all the QPRTJOB system jobs for those users. End the QPRTJOB system job using the End Job (ENDJOB) command and option SPLFILE(*YES). This deletes all spooled files sent to this user using the Send Network Spooled Files (SNDNETSPLF) command and ends the user's QPRTJOB system job. The system value QACGLVL should be changed to *PRINT or *PRINT *JOB. The next time a file is sent to a user, a QPRTJOB job is created for that user and the job accounting level is correct for any files sent to that user.
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CHjAAM","label":"Job and Work Management"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Historical Number
4292031
Was this topic helpful?
Document Information
Modified date:
07 October 2024
UID
nas8N1014726