TAA Tools
PRTACG          PRINT ACCOUNTING                       TAAACGE

The Print  Accounting tool is  a series of  commands that let  you work
with the  print accounting entries  from the QACGJRN journal.   You may
either  display  the entries  using several  different access  paths or
print the entries  using different  selection and sequencing  criteria.
Print accounting  entries from  multiple systems may  be stored  in the
same data base.

Trying it out
-------------

There  are a lot of things you  can consider with Print Accounting, but
if you just want to  try it out, do  the following (skip the first  two
steps if you are already using Job Accounting).

  **   Create a journal receiver:

              CRTJRNRCV    JRNRCV(QGPL/ACG00001)
                             TEXT('Accounting receiver')

  **   Create a  journal (it must  have the  name QACGJRN and  exist in
       QSYS):

              CRTJRN       JRN(QSYS/QACGJRN)
                             JRNRCV(QGPL/ACG00001)
                             TEXT('Accounting journal')

  **   Use  WRKSYSVAL SYSVAL(QACGLVL).   Use  the  Change option.   The
       value should at least include *PRINT.

  **   Create the files  needed for  the PRTACG  tool in  a library  of
       your choice:

            CRTPRTACG   PRTACGLIB(xxx)

  **   Let several spooled  files print to hard copy  before converting
       the entries in the next step.

  **   Convert the  QACGJRN entries to the PRTACG  files in the library
       you specified.

             CVTPRTACG   PRTACGLIB(xxx)

  **   Display the entries with the command

             DSPPRTACG   PRTACGLIB(xxx)

More on Print Accounting
------------------------

It  is not necessary to  use job accounting codes  to gain the benefits
of  the Print  Accounting  tool.   You  may  display the  entries  with
various  selection criteria  such  as by  device,  by user,  or by  job
without  using  job  accounting  codes.   You  must  however,  have the
Accounting journal in existence.

The QACGJRN  journal entries  must be  converted to  a  data base  file
before the  display or print functions  may be used.   Special commands
exist to  create the required data base  files and convert the journal.

The system  allows you  to request  either or  both  Job Accounting  or
Print  Accounting journal  entries.   Either  or  both the  JOBACG  and
PRTACG tools may be used.

Also see  the CVTJOBACG3 tool for conversion of  the journal entries as
they occur.

What causes a Print Accounting Journal Entry
--------------------------------------------

It  is important to note that a Print  Journal entry only occurs when a
file is  physically printed  (hard copy).    This can  occur either  by
printing  a spooled file  or directly  printing a  file (not  using the
spool function).

The  Accounting journal  entry contains  summary information  about the
number of  print  files  and  the  number of  lines  printed  from  the
program.   This  includes  the use  of  spooled  files and  non-spooled
files.   It does  not include any  information about whether  hard copy
was produced.

The Print  Accounting function  is only  applicable to  files that  are
actually output to a printer device.

Creating the Accounting Journal
-------------------------------

If you have  not already created  the Accounting journal  and specified
the  QACGLVL  system value,  do  the following  steps  as the  Security
Officer  (the library  QGPL is used  for the Journal  receiver, but any
user library may be used):

  **   Create a journal receiver:

              CRTJRNRCV    JRNRCV(QGPL/ACG00001)
                             TEXT('Accounting receiver')

       The Print  Accounting tool  does  not require  a special  naming
       convention  for the  journal receivers.   However,  a convention
       such as ACG00001 is recommended.

  **   Create  a journal (it  must have the  name QACGJRN  and exist in
       QSYS):

              CRTJRN       JRN(QSYS/QACGJRN)
                             JRNRCV(QGPL/ACG00001)
                             TEXT('Accounting journal')

  **   Use WRKSYSVAL  SYSVAL(QACGLVL).   Use  the  Change option.    It
       should at  least be set  to *PRINT.   If you  want both  the Job
       Accounting  and  Print Accounting  functions,  the  value should
       *JOB *PRINT.

Creating the required data base files
-------------------------------------

The CRTPRTACG command creates  the files used  by the PRTACG  function.
A typical command would be:

            CRTPRTACG   PRTACGLIB(xxx)

If you are  using the Job  Accounting function, you probably  want both
the JOBACG and PRTACG files in the same library.

You  can have  multiple sets of  Print Accounting  files, but  only one
set  per  library.   A  single  physical  file PRTACGP  is  created and
several logical files.

The default for  public access is  *USE on CRTPRTACG.   You may  change
this to *EXCLUDE or *LIBCRTAUT.

If you  have created the required  files and then wish  to delete them,
the special command DLTPRTACG should be used.

Converting the journal entries
------------------------------

You  need to convert the journal entries  to the data base files before
displaying or printing them.   There are two methods of converting  the
accounting entries:

  **   CVTPRTACG command  which is part of  the PRTACG tool is  a batch
       like function which would be used periodically.

  **   CVTJOBACG3  command   which  is  part  of  the  CVTJOBACG3  tool
       provides  a  solution  for  continuous  conversion  by  using  a
       program which waits for  entries to arrive on the  journal.  See
       the discussion with the CVTJOBACG3 tool.

The following discussion refers to the CVTPRTACG command.

To convert the QACGJRN entries from your own system specify:

             CVTPRTACG   PRTACGLIB(xxx)

CVTPRTACG  should be  specified  on a  regular  basis such  as  once or
twice  a day.  If you have a 'start  of day' or 'end of day' procedure,
CVTPRTACG could be  included or as  a 'time dependent scheduling'  job.
If you  change the Accounting journal  receiver at the end  of the day,
you should follow this process with a CVTPRTACG command.

An  option exists on  CVTPRTACG to allow  a new journal  receiver to be
generated.  You  may use this  option on CVTPRTACG  and then a  command
like the  TAA Tool  MTNJRN to  delete the  old receivers.   If you  use
both  JOBACG  and PRTACG,  you  will  want to  use  both  CVTJOBACG and
CVTPRTACG before deleting the old receivers.

CVTPRTACG  has  the  smarts  to  determine  the  last  entry  that  was
converted for  the current  system and  will only  convert the  journal
entries that  have occurred after  that point.  Therefore,  you may run
CVTPRTACG  whenever  required to  convert  the current  entries without
concerning yourself about duplicating the entries.

The process that  CVTPRTACG uses  is to determine  the last entry  that
was converted  previously.  The  journal receiver containing  the entry
will  be converted to  a data  base file and  read.   Conversion to the
Print Accounting file does not  start until entries which do not  exist
in  the  Print  Accounting  file are  read.    Therefore,  to  minimize
conversion  of  the  journal  receivers  during  your  regular  use  of
CVTPRTACG,  you  should   switch  to  a   new  receiver  before   using
CVTPRTACG.   This causes  both the old  and new  receivers to  be read.
Once  the entries from  the old receiver  have been converted,  the old
receiver will never be converted again.

If  you reset  the journal sequence  numbers, you must  reset the Print
Accounting file.  See the later discussion.

Note that  neither DSPPRTACG  or PRTPRTACG  convert the  journal.   The
information will only be as current as the last use of CVTPRTACG.

You must periodically  clean out old entries from  the data base files.
A  special command MTNPRTACG  is provided for  this function.   See the
later discussion.

A special command  CVTPRTACG2 is  used for  converting journal  entries
from other systems that  you want to store in the same  data base.  See
the later discussion of CVTPRTACG2.

Displaying the entries
----------------------

The  DSPPRTACG command  is used  to  display the  accounting data  in a
subfile.  There are two approaches in the use of the command:

  **   Using  the  defaults  (no  selection  criteria)  to  begin   the
       display  with  the first  job  of  the  current day.    Use  the
       'position to'  and F9 key  to limit and  resequence the display.

  **   Specifying  selection criteria  to determine  what is displayed.

Both approaches may be used,  but it is generally advisable to  not use
both on the same use of the DSPPRTACG command.

There  will be will  be one  journal entry  for each  file output  to a
printer device.

Journal  entries  have a  common  set  of standard  fields  followed by
variable information termed  'entry data'.   Each journal  entry has  a
one byte  journal code  and a  2 byte  journal entry  type.   Different
journal codes  may appear in the QACGJRN  journal, but Print Accounting
only uses the  'A' codes  which are  the 'accounting  entries' and  the
'SP' (spooled files) and the 'DP' (direct print) entry types.

The F6 key is also  supported to allow you to prompt  for the PRTPRTACG
command.

Using the DSPPRTACG defaults
----------------------------

The command  would be entered  without any of  the selection parameters
specified using the default STRDATE(*CURRENT):

             DSPPRTACG   PRTACGLIB(xxx)

A  subfile is displayed with the  first record that matches the current
date.  The  'journal entry date' in  the accounting record is  used for
the  comparison.   If no  record matches  the current  date,  the first
record  prior is displayed.   You may  use the 'position  to' values to
position to a prior date and time.   You may use the F9 key to  request
the  prompt  that  changes  the  sequence  in  which  the  records  are
displayed.   Entering  a 'start time'  value with  STRDATE(*CURRENT) is
also considered  a 'positioning'  request and  does not  prevent  prior
entries from being displayed.

Using the DSPPRTACG selection parameters
----------------------------------------

DSPPRTACG  supports several  parameters  to allow  you  to select  what
will appear  in the subfile.   If you use the  selection criteria, only
the  accounting records  which are  selected will  appear regardless of
the use  of  the 'position  to' values  or  the F9  key  to change  the
access path being used.

A  typical command  would be  to display  all print  accounting records
for a specific job name between a date range such as:

             DSPPRTACG   PRTACGLIB(xxx) STRDATE(jobfmt)
                           ENDDATE(jobfmt) JOB(xxxxx)

Some  selection options may  be used,  but the information  can only be
seen on  the detail  display.   For example,  you may  specify the  Job
Accounting  Code  and  the  Print  Accounting  records  that  meet  the
criteria  will  be  displayed  in  the  subfile.    However,  the  'Job
Accounting Code' information can  only be seen  on the detail  display.

Printing the entries (PRTPRTACG command)
----------------------------------------

The Print  Print Accounting  command allows  you to  print the  entries
using  different selection  criteria.   For example,  if you  wanted to
print the entries for a specific device, you would specify:

             PRTPRTACG   PRTACGLIB(xxx) DEV(xxx)

The  PRTPRTACG is  a simple  general function.   You may  want to write
your  own  program  with  sequencing  and  selection  or  use  a  query
function  (such   as  the  TAAQRY   tool)  to  provide   your  specific
processing requirements.

Maintaining the Print Accounting files
--------------------------------------

The  CVTPRTACG  command  converts  entries  into  the print  accounting
files.  A separate command MTNPRTACG is used to delete entries.

You  would  typically   run  MTNPRTACG   periodically  based  on   your
retention period  of Print  Accounting entries.   The command  supports
the  RTNDAYS parameter which allows  you to name  your retention period
in days.

A typical command would be:

             MTNPRTACG    RTNDAYS(30) PRTACGLIB(xxx)

This would  remove  all the  entries  that are  30  days prior  to  the
current date.

Locking considerations
----------------------

CVTPRTACG and CVTPRTACG2 require *SHRNUP locks on the PRTACGP file.

MTNPRTACG requires  an  *EXCL lock  on the  PRTACGP file  (the file  is
cleared as part of the processing).

Converting journal entries from other systems
---------------------------------------------

The  PRTACG  tool  lets   you  have  a  single  data  base  with  print
accounting  entries  from one  or  more systems.    The high  order key
field for all logical files is the system name.

Or you may want  to use PRTACG for  multiple systems, but would  rather
have unique files  for each system (this would  require one library for
each system).

The  steps described  are  the same  whether you  have one  or multiple
sets of files.

In  the following  discussion,  the  term  'master  system'  means  the
system where PRTACG  will be run.   The term 'remote system'  means the
system that  is only capturing print accounting  entries, but not using
the PRTACG tool.

The CVTPRTACG command is used  to convert the Print Accounting  entries
from the master system.

The  special command  CVTPRTACG2  is used  to  convert journal  entries
from  the  remote  systems.   CVTPRTACG2  must  be  run  on the  master
system.   The remote system must do  DSPJRN to get the Print Accounting
journal entries into a data  base file that can be used  by CVTPRTACG2.

Do the following steps:

  **   Use  DSPJRN   on  the  remote   system  to  convert   the  Print
       Accounting  journal entries to  a data base  file.   A good time
       to do  this would  be just  after converting  to  a new  journal
       receiver.   You do  not have to  concern yourself  with ensuring
       that  the  same  entry will  only  be  converted  once from  the
       journal.  When  CVTPRTACG2 is  run, it will  bypass any  journal
       entries that already exist in the PRTACG data base files.

       When  DSPJRN is  used, you  must  specify OUTFILFMT(*TYPE1)  and
       ENTDTALEN(155).  A typical command would be:

            DSPJRN    JRN(QACGJRN) RCVRNG(*CURCHAIN) OUTPUT(*OUTFILE)
                        OUTFILFMT(*TYPE1) OUTFILE(xxx/DSPJRNP)
                        ENTDTALEN(155)

       If  you are using  Job Accounting  as well as  Print Accounting,
       the previous step will capture both types of entries.

  **   You  would then transfer the DSPJRNP  file to the master system.

  **   Run the CVTPRTACG2  command on the  master system and specify  a
       system name: You  must ensure that the date  format used for the
       job  is the same  for the job  that ran DSPJRN and  the job that
       will run CVTPRTACG2.

             CVTPRTACG2    JRNOUTF(DSPJRNP) SYSTEM(sss) PRTACGLIB(xxx)

The system name  is needed because  the *TYPE1 format  is used for  the
journal outfile which does not contain the system name.

The Print  Accounting information is then  available to be  reviewed or
printed.

If you  are also converting the Accounting  entries, use the CVTJOBACG2
command as described in the JOBACG tool.

Security discussion
-------------------

To work  with  the  Accounting  journal, the  user  must  have  *ALLOBJ
authority.   PRTACG provides a  method where a  system operator may  be
authorized to perform the CVTPRTACG function.

This  occurs by use  of the  TAAJOBACG authorization list  which allows
an  authorized user  to the  list to  use CVTPRTACG.   CVTPRTACG adopts
the Security  Officers profile  during the conversion  of the  entries.
A  user  who has  *USE  authority to  the  authorization  list may  use
CVTPRTACG to any set of Print Accounting files.

The  user authorized to the TAAJOBACG  authorization list does not have
the automatic right to use DSP or PRTPRTACG.

The user who uses  CRTPRTACG becomes the owner  of the data base  files
that  are  created.   To  minimize  exposures,  you must  have  *ALLOBJ
special  authority to  use  CRTPRTACG.   The PRTACGP  physical  file is
created as AUT(*USE).  This prevents  any other user from changing  the
data in the file  by default (access to the logical  files is *PUBLIC).
Allowing *USE  means that any user may use  the functions of DSPPRTACG.

The  MTNPRTACG command  deletes old  entries in  the PRTACGP file.   To
run the command, the user  must have *ALL authorization to  the PRTACGP
file.

The CVTPRTACG2  command adds  records to the  PRTACGP file  from remote
systems.   A user with *ALLOBJ authority  on the remote system must use
DSPJRN to  convert the QACGJRN  journal entries  to a  data base  file.
The file is  then placed on the  master system.  To  run the CVTPRTACG2
command,  the user  must be authorized  to the  TAAJOBACG authorization
list.

To summarize the security:

       CRTPRTACG      *ALLOBJ authority
       CVTPRTACG      *USE to TAAJOBACG authorization list
       CVTPRTACG2     *USE to TAAJOBACG authorization list
       MTNPRTACG      *ALL authority to PRTACGP file
       DLTPRTACG      *ALL authority to PRTACGP file
       DSPPRTACG      *USE authority to PRTACGP file
       PRTPRTACG      *USE authority to PRTACGP file


Resetting the journal sequence number
-------------------------------------

If you have reached  the maximum journal sequence  number or decide  to
reset the  journal sequence  numbers (using  the CHGJRN  SEQOPT(*RESET)
function),  the CVTPRTACG process  will not  work correctly.   You must
begin  again with an empty PRTACGP  file and convert only the receivers
with the re-sequenced numbers.  Do the following steps:

  **   Delete the  receivers that contain  the sequence numbers  before
       they were reset.

  **   Clear the PRTACGP file.

             CLRPFM       FILE(xxx/PRTACGP)

  **   Run CVTPRTACG.

If  you want  to retain  the old  information for  some  time, consider
creating  a separate  library, using  CRTPRTACG to create  the required
files, and CPYF  from the PRTACGP  file of the  old information to  the
new library.

CRTPRTACG parameters                                  *CMD
--------------------

   PRTACGLIB     The name  of the  library where  the Print  Accounting
                 files will  be created.  The  physical file PRTACGP is
                 created along with several logical files.

   SRCLIB        The  source  library  to  use  for  the  QATTDDS  file
                 source.  The  default is *TAAARC.   If a  full license
                 exists, the  source is used from the  TAA Archive.  If
                 a  demonstration  license exists,  the source  is used
                 from the QATTDDS file in the TAATOOL library.

                 A specific user library  may be named, but the  source
                 file must be QATTDDS.

   AUT           The  authority to the  PRTACGP file.   The  default is
                 *USE  which  allows  any  user  to  use  the  DSP  and
                 PRTPRTACG commands.  *LIBCRTAUT  or *EXCLUDE may  also
                 be specified.

CVTPRTACG parameters                                  *CMD
--------------------

   RMVALLLFM     A  *YES/*NO parameter  for  whether  the logical  file
                 members  should be  removed before the  update program
                 runs  and  then   added  back  after.     This  is   a
                 performance  option.    It  is   generally  faster  to
                 remove the  members and then add them  back if a large
                 percentage of records will be added to the file.

                 *NO  is the default which should  be used when a small
                 percentage of records are added.

                 *YES should  be specified  to improve the  performance
                 when adding a large percentage of records.

   GENNEWRCV     Whether to  generate a new  journal receiver.   *NO is
                 the default.

                 *YES  may be specified to cause  the CHGJRN command to
                 occur with JRNRCV(*GEN).

   PRTACGLIB     The name  of the  library where  the Print  Accounting
                 files  exist.   The  default is  *LIBL.   *CURLIB  may
                 also be used.

                 If  you  are  using  both  Job  Accounting  and  Print
                 Accounting,  you  will  probably  want  both  sets  of
                 files in the same library.

   FIRSTENTRY    The  first entry  to  be converted.    The default  is
                 *LASTENTRY  meaning  to  begin  from  the  last  entry
                 converted.    If  this  entry does  not  exist  in the
                 journal, an  error will occur.   For  example, if  you
                 deleted  a receiver  without  converting the  entries,
                 the  last  entry  will not  exist  and  an  error will
                 occur.    You  can  bypass  the  error  by  specifying
                 *FIRST.

                 *FIRST  causes  all  entries  in  the  journal  to  be
                 output from  DSPJRN.  Only those  entries which do not
                 exist in the PRTACGP file will be converted.

DSPPRTACG parameters                                  *CMD
--------------------

   PRTACGLIB     The name  of the  library where  the Print  Accounting
                 files  exist.   The  default is  *LIBL.   *CURLIB  may
                 also be used.

   STRDATE       The start  date to start the first  display.  The date
                 is  compared against  the 'journal entry  date' in the
                 print  accounting record.    The default  is  *CURRENT
                 which means the  current day.  A specific  date may be
                 entered in job format.

                 If  a record does not exist  for the date entered, the
                 previous record is displayed.

                 If *CURRENT is  used, the  STRDATE and STRTIME  values
                 are used  as 'position  to' values  in the data  base.
                 They   are   not   used   as   'selection   criteria'.
                 Therefore,  when   the   subfile   is   displayed,   a
                 'position to'  date may be  entered to  re-position to
                 an earlier date and time.

                 The other  selection parameters (such  as DEV) prevent
                 records   from   being   displayed   in   the  subfile
                 regardless  of where  the  'position  to'  values  are
                 set.

                 STRDATE(*START)  may  be  used  to start  the  display
                 with  the  first record  (oldest  journal  entry date)
                 found in the file.

                 If a specific date is  entered for STRDATE, the  value
                 (and STRTIME)  are considered as  'selection criteria'
                 and  're-positioning'  prior to  the  date  entered on
                 the command will not  cause any additional records  to
                 be displayed.

   STRTIME       The start time  of the records  to be selected.   This
                 value   is  used  in   conjunction  with   STRDATE  to
                 determine    what   print   accounting   records   are
                 selected.   If  the print  accounting record  'journal
                 entry  date'  matches  the   the  STRDATE  value,  the
                 STRTIME  value  is  used for  selection.    A specific
                 time may be entered in HHMMSS format.

                 For  example,  if  you   want  all  print   accounting
                 entries  for   the  current  day  that   fall  between
                 10:00:00   and   11:00:00   take   the  defaults   for
                 STRDATE/ENDDATE  and   specify   STRTIME(100000)   and
                 ENDTIME(110000).

                 If  you  want   all  Print  Accounting   records  from
                 05/11/09   beginning   at  18:00:00   and   ending  on
                 05/11/09    at   06:00:00    specify   STRDATE(jobfmt)
                 STRTIME(180000) ENDDATE(jobfmt)  and  ENDTIME(060000).

   ENDDATE       The journal entry  end date to be included.   The date
                 is  compared against  the 'journal  entry date'.   The
                 default is *CURRENT  which means the  current day.   A
                 specific date may be entered in job format.

   ENDTIME       The  end time  of the  journal entry  to be  selected.
                 This  value  is used  in conjunction  with  ENDDATE to
                 determine what records are  selected.  The default  is
                 *END  which  means  all records  of  the  ENDDATE  day
                 would be considered.

                 If   the  accounting   record  'journal   entry  date'
                 matches  the the  ENDDATE value, the  ENDTIME value is
                 used for selection.   A specific  time may be  entered
                 in HHMMSS format.

   SYSTEM        The  system  name to  be  selected.    The default  is
                 *CURRENT for the current system name.

                 A specific system name may be entered.

   JOB           The  job name  to be  selected.   The default  is *ALL
                 for all job names.

                 A specific job name may be entered.

   USER          The user profile  name to  be selected.   The  default
                 is *ALL for all user names.

                 A specific user name may be entered.

   JOBNBR        The job  number to be selected.   The default  is *ALL
                 for all job numbers.

                 A specific job number may be entered.

   ACGCDE        The  accounting code to  be selected.   The default is
                 *ALL for all accounting codes (or blanks).

                 A specific accounting code may be entered.

   DEV           The device name to be  selected.  The default is  *ALL
                 for all device names.

                 A specific device name may be entered.

   SPLF          The  spooled file  to  be selected.    The default  is
                 *ALL for all spooled files.

                 A specific spooled file may be entered.

   USRDTA        The user  data value to  be selected.   The default is
                 *ALL for all user data.

                 A specific user data value may be entered.

   FORMTYPE      The  form type  to be selected.   The  default is *ALL
                 for all form types.

                 A specific form type may be entered.

   TYPE          The type to be selected.   The refers to the  SP entry
                 type (spooled  file) or DP entry  type (direct print).
                 The default is *ALL for both SP and DP types.

                 Either SP or DP may be entered.

   TOTPAGES      The  number  of  total  pages  to  be  selected.   The
                 default is 1  meaning the  file must  have printed  at
                 least one page to be displayed.

                 A specific  number of  pages may  be entered  to allow
                 you to limit the display to large print files.

MTNPRTACG parameters                                  *CMD
--------------------

   RTNDAYS       The  number  of days  of Print  Accounting  entries to
                 retain.   The default  is 30  meaning that  any  Print
                 Accounting entries  with a date  prior to 30  days ago
                 will be deleted from the file.

   PRTACGLIB     The  name of  the library  where the  Print Accounting
                 files  exist.   The  default  is *LIBL.    *CURLIB may
                 also be used.

PRTPRTACG parameters                                  *CMD
--------------------

   STRDATE       The start  date to be  used.   The default is  *TODAY.
                 If a date is entered, it must be in job format.

                 *FIRST may  be entered to  start with the  oldest date
                 in the file.

   ENDDATE       The  end date  to be  entered.   The default  is *LAST
                 which means  the  last  journal  entry found.    If  a
                 specific date  is needed,  it must  be entered in  job
                 format.

   SYSTEM        The system  to print the entries for.   The default is
                 *CURRENT  meaning  the  current  system.    Only   the
                 entries from a single system may be printed.

   ACGCDE        Whether  to print  only  a specific  Accounting  code.
                 The  default  is *ALL  for  all accounting  codes.   A
                 specific accounting code may be entered.

   USER          Whether  to print only  a specific user.   The default
                 is *ALL for  all users.  A  specific user name may  be
                 entered.

   DEV           Whether  to  print  only   a  specific  device.    The
                 default  is *ALL for  all devices.   A specific device
                 name may be entered.

   SEQ           The sequence of the report.

                 *DATTIM  is  the  default   to  print  in  date   time
                 sequence with the earliest date first.

                 *USER  may be  specified  sequence  by user  and  then
                 date/time.

                 *DEV  may  be specified  sequence by  the  device that
                 was used and then date/time.

   PRTACGLIB     The name  of the  library where  the Print  Accounting
                 files  exist.   The  default is  *LIBL.   *CURLIB  may
                 also be used.

DLTPRTACG parameters                                  *CMD
--------------------

   PRTACGLIB     The  name of  the library  where the  Print Accounting
                 files will be deleted.

CVTPRTACG2 parameters                                 *CMD
---------------------

   JRNOUTF       The  name  of  the qualified  file  that  contains the
                 journal  entries from  another  system.   The  library
                 defaults to *LIBL and *CURLIB may be used.

                 DSPJRN  must have  been used  to create  the  file and
                 must  have  been  specified  as OUTFILFMT(*TYPE1)  and
                 ENTDTALEN(155).

   SYSTEM        The  system  name  to  be  used  for   the  accounting
                 entries.   This is a  required parameter.   You cannot
                 use  the  current  systems  name  (use  the  CVTPRTACG
                 command instead).

                 The reason that  the system name  is required is  that
                 the  *TYPE1 format  is  used  for the  DSPJRN  outfile
                 which does not contain the system name.

   RMVALLLFM     A  *YES/*NO  parameter for  whether  the logical  file
                 members  should be  removed before  the update program
                 runs  and  then   added  back  after.     This  is   a
                 performance  option.    It   is  generally  faster  to
                 remove  the members and then add  them back if a large
                 percentage of records will be added to the file.

                 *NO is the default which  should be used when a  small
                 percentage of records are added.

                 *YES should  be specified  to improve  the performance
                 when adding a large percentage of records.

   PRTACGLIB     The  name of  the library  where the  Print Accounting
                 files exist.    The default  is  *LIBL.   *CURLIB  may
                 also be used.

RFMPRTACG parameters                                  *CMD
--------------------

   PRTACGLIB     The library  where the PRTACG  data base  files exist.

   WRKLIB        The  work  library  that  will  be used  to  copy  the
                 current  files to.   A unique library  is desirable so
                 you can simplify review and deletion.

                 After the command  completes, the old versions  of the
                 files  will be  retained in  the work  library.   When
                 you  are satisfied with  the new  versions, delete the
                 files from the work library.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     ADDDAT          Add date
     ADJVAR          Adjust variable
     CHKACTOBJ       Check active object
     CHKALLOBJ       Check *ALLOBJ authority
     CPYTAADDS       TAA Archive
     CVTDAT          Convert date
     CVTJRNA         Convert journal attributes
     EDTVAR          Edit variable
     FILEFDBCK       File feedback
     HLRMVMSG        HLL Remove message
     RMVALLLFM       Remove all logical file members
     RTVDAT          Retrieve date
     RTVDBFA         Retrieve data base attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message
     UPDPFILE        Write source

Implementation
--------------

None, the tool is ready to use.   You must use CRTPRTACG to create  the
required files  and CVTPRTACG to convert  the entries before  using DSP
or PRTPRTACG.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CRTPRTACG     *CMD                   TAAACGE       QATTCMD
   CVTPRTACG     *CMD                   TAAACGE2      QATTCMD
   DSPPRTACG     *CMD                   TAAACGE3      QATTCMD
   DLTPRTACG     *CMD                   TAAACGE4      QATTCMD
   PRTPRTACG     *CMD                   TAAACGE6      QATTCMD
   MTNPRTACG     *CMD                   TAAACGE6      QATTCMD
   CVTPRTACG2    *CMD                   TAAACGE7      QATTCMD
   RFMPRTACG     *CMD                   TAAACGE8      QATTCMD
   TAAACGEC      *PGM       CLP         TAAACGEC      QATTCL
   TAAACGEC2     *PGM       CLP         TAAACGEC2     QATTCL
   TAAACGEC3     *PGM       CLP         TAAACGEC3     QATTCL
   TAAACGEC4     *PGM       CLP         TAAACGEC4     QATTCL
   TAAACGEC5     *PGM       CLP         TAAACGEC5     QATTCL
   TAAACGEC6     *PGM       CLP         TAAACGEC6     QATTCL
   TAAACGEC7     *PGM       CLP         TAAACGEC7     QATTCL
   TAAACGEC8     *PGM       CLP         TAAACGEC8     QATTCL
   TAAACGEC15    *PGM       CLP         TAAACGEC15    QATTCL
   TAAACGER2     *PGM       RPG         TAAACGER2     QATTRPG
   TAAACGER3     *PGM       RPG         TAAACGER3     QATTRPG
   TAAACGER5     *PGM       RPG         TAAACGER5     QATTRPG
   TAAACGER12    *PGM       RPG         TAAACGER12    QATTRPG
   TAAACGED      *FILE      DSPF        TAAACGED      QATTDDS
   TAAACGEP      *FILE      PF          TAAACGEP      QATTDDS
   TAAACGEL      *FILE      LF          TAAACGEL      QATTDDS
   TAAACGEM      *FILE      LF          TAAACGEM      QATTDDS
   TAAACGEN      *FILE      LF          TAAACGEN      QATTDDS
   TAAACGEO      *FILE      LF          TAAACGEO      QATTDDS
   TAAACGEQ      *FILE      LF          TAAACGEQ      QATTDDS
   TAAJOBACG     *AUTL

The files created from CRTPRTACG use the following source.

        File          Source       Description
        ----          ------       -----------

        PRTACGP       TAAACGEP     Physical
        PRTACGL       TAAACGEL     LF by system, date, and time
        PRTACGM       TAAACGEM     LF by system, acctg code, date, time
        PRTACGN       TAAACGEN     LF by system, user, date, time
        PRTACGO       TAAACGEO     LF by system, job, date, time
        PRTACGQ       TAAACGEQ     LF by system, dev, date, time

Structure
---------

CRTPRTACG   Cmd
   TAAACGEC   CL pgm

CVTPRTACG
   TAAACGEC2  CL pgm
     TAAACGER12  RPG Pgm
     TAAACGER2   RPG Pgm

DSPPRTACG
   TAAACGEC3  CL pgm
     TAAACGER3  RPG Pgm
       TAAACGED   Display file
       TAAACGEC15  CL pgm

DLTPRTACG
   TAAACGEC4  CL pgm

PRTPRTACG
   TAAACGEC5  CL pgm
     TAAACGER5  RPG Pgm

MTNPRTACG
   TAAACGEC6  CL pgm

CVTPRTACG2
   TAAACGEC7  CL pgm
     TAAACGER12  RPG Pgm
     TAAACGER2  RPG Pgm

RFMPRTACG
   TAAACGEC8  CL pgm
					

Added to TAA Productivity tools September 1, 1999


Home Page Up to Top