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.

    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.

 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
    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
    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

Added to TAA Productivity Tools September 1, 1999


Home Page

Powered by AS/400Powered by AS/400 Last modified on January 12, 2010 © 1995, 2010 - Jim Sloan, Inc.