CMPJRNINF -- Compare Journal Information

CMPJRNINF COMPARE JOURNAL INFORMATION TAAJRNY
The Compare Journal Information command is intended for comparing journal attribute information from two different systems. Both journal and attached journal receiver attributes are compared. The CVTJRNINF command (part of this tool) must be used to capture the information in an outfile. After placing two outfiles from different systems on the same system, CMPJRNINF may be used to make a comparison. Assume you want to compare two journals of the same name (JRN1) on two different systems (SYSTEMA and SYSTEMB). On SYSTEMA you would do the following (Assume you used an outfile library of SYSALIB): CVTJRNINF JRN(JRN1) OUTLIB(SYSALIB) The outfile name is always JRNINFP with a record format name of JRNINFR. Assume you do the same on SYSTEMB with an outfile library of SYSBLIB. CVTJRNINF JRN(JRN1) OUTLIB(SYSBLIB) Assume you want to run the comparison on SYSTEMB. You would transfer the SYSALIB library to SYSTEMB and then run the following command: CMPJRNINF FROMLIB(SYSALIB) TOLIB(SYSBLIB) Any differences would be described in a spooled file. It is not necessary to physically transfer the file. A function such as DDM could be used. The basic information from the first (or only) attached journal receiver is also compared such as the THRESHOLD value. Capturing and comparing for multiple journals --------------------------------------------- CVTJRNINF will capture the information for a single journal each time the command is run. However, you may capture the information from multiple journals to the same outfile by using REPLACE(NO) on CVTJRNINF. Or you may use a separate member for each converted journal by specifying the OUTMBR parameter on CVTJRNINF. CMPJRNINF will compare the information for a single journal each time the command is run. The default is that the information from a single journal exists in the member to be processed in each outfile. If you have captured the information from multiple journals in the same outfile member, you must specify which journal is to be compared in each outfile using the FROMJRN and TOJRN parameters. CVTJRNINF escape messages you can monitor for --------------------------------------------- TAA9891 The OUTLIB cannot be TAATOOL TAA9892 The OUTLIB cannot be LIBL if the file does not exist Escape messages from based on functions will be re-sent. CMPJRNINF escape messages you can monitor for --------------------------------------------- TAA9893 The requested jrnl does not exist in the FROM outfile TAA9894 The requested jrnl does not exist in the TO outfile TAA9895 Differences found (based on ESCAPE parameter) Escape messages from based on functions will be re-sent. CVTJRNINF Command parameters CMD ---------------------------- JRN The qualified name of the journal to extract information for. The library value defaults to LIBL. CURLIB may also be used. If the file does not exist, a specific library must be described. OUTLIB The library where the information will be written to. The file name is always JRNINFP with a record format name of JRNINFR. OUTMBR The member of the JRNINFP file to be written to. The default is JRNINFP. REPLACE A YES/NO option for whether the member to be used will be cleared before writing any data to it. The default is YES to clear the member. NO may be specified if you are capturing the information from multiple journals into the same member. CMPJRNINF Command parameters CMD ---------------------------- FROMLIB The library that contains the From JRNINFP file to be used in the comparison. The file must have been output using the CVTJRNINF command. TOLIB The library that contains the To JRNINFP file to be used in the comparison. The file must have been output using the CVTJRNINF command. FROMJRN The qualified name of the From journal to be compared. The default is ONLY meaning there is only a single record in the JRNINFP file. No library qualifier can be used if ONLY is specified. Only the information from a single journal can be compared on each use of CMPJRNINF. If the information from multiple journals was captured with multiple CVTJRNINF commands to the same outfile, you must specify a fully qualified name for the journal to be compared. TOJRN The qualified name of the To journal to be compared. The default is FROMJRN meaning the same journal as in the FROMJRN parameter. No library qualifier can be used if FROMJRN is specified. Only the information from a single journal can be compared on each use of CMPJRNINF. If the information from multiple journals was captured with multiple CVTJRNINF commands to the same outfile, you must specify a fully qualified name for the journal to be compared. FROMMBR The member used in the JRNINFP file of the From library. The default is JRNINFP. TOMBR The member used in the JRNINFP file of the To library. The default is JRNINFP. ESCAPE Whether to send an escape message if differences exist. The default is NO which means a completion message is sent. YES may be specified to send TAA9895 if differences exist. DLTSPLF Whether to delete the spooled file if there are no differences. The default is YES meaning the spooled file is deleted if no differences are found. The spooled file is always retained if differences exist. NO may be specified to ensure a spooled file will exist regardless of whether differences exist or not. Restrictions ------------ CVTJRNINF must be used to capture the information into an outfile named JRNINFP in different libraries before a comparison can be made. Prerequisites ------------- The following TAA Tools must be on your system: CHKOBJ3 Check object 3 CRTDUPPF Create duplicate physical file EDTVAR Edit variable RTVFMT Retrieve format RTVJRNA Retrieve journal attributes RTVJRNRCVA Retrieve journal receiver attributes RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape message UPDFLD Update field Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CVTJRNINF CMD TAAJRNY QATTCMD CMPJRNINF CMD TAAJRNY2 QATTCMD TAAJRNYC PGM CLP TAAJRNYC QATTCL TAAJRNYC2 PGM CLP TAAJRNYC2 QATTCL TAAJRNYR PGM RPG TAAJRNYR QATTRPG TAAJRNYR2 PGM RPG TAAJRNYR2 QATTRPG TAAJRNYP *FILE PF TAAJRNYP QATTDDS Structure --------- CVTJRNINF Cmd TAAJRNYC CL pgm TAAJRNYR RPG Pgm CMPJRNINF Cmd TAAJRNYC2 CL pgm TAAJRNYR2 RPG Pgm

CMPJRNINF       COMPARE JOURNAL INFORMATION            TAAJRNY


The  Compare Journal  Information  command  is intended  for  comparing
journal  attribute  information  from  two  different  systems.    Both
journal  and attached  journal receiver  attributes are  compared.  The
CVTJRNINF command  (part of  this tool)  must  be used  to capture  the
information in an  outfile.  After placing two  outfiles from different
systems  on   the  same  system,  CMPJRNINF  may  be  used  to  make  a
comparison.

Assume you want  to compare  two journals  of the same  name (JRN1)  on
two different systems  (SYSTEMA and SYSTEMB).  On SYSTEMA  you would do
the following (Assume you used an outfile library of SYSALIB):

                 CVTJRNINF  JRN(JRN1) OUTLIB(SYSALIB)

The  outfile  name is  always  JRNINFP  with a  record  format  name of
JRNINFR.

Assume you do the same on  SYSTEMB with an outfile library of  SYSBLIB.

                 CVTJRNINF  JRN(JRN1) OUTLIB(SYSBLIB)

Assume you want to  run the comparison on SYSTEMB.   You would transfer
the SYSALIB library to SYSTEMB and then run the following command:

                 CMPJRNINF  FROMLIB(SYSALIB) TOLIB(SYSBLIB)

Any differences would be described in a spooled file.

It is not  necessary to physically transfer the  file.  A function such
as DDM could be used.

The  basic  information  from  the  first  (or  only)  attached journal
receiver is also compared such as the THRESHOLD value.

Capturing and comparing for multiple journals
---------------------------------------------

CVTJRNINF will capture the  information for a single journal  each time
the  command is run.   However,  you may  capture the  information from
multiple  journals  to  the  same  outfile  by  using  REPLACE(*NO)  on
CVTJRNINF.   Or  you  may use  a  separate member  for  each  converted
journal by specifying the OUTMBR parameter on CVTJRNINF.

CMPJRNINF will compare  the information for a single  journal each time
the  command  is run.    The default  is  that the  information  from a
single journal exists in  the member to be  processed in each  outfile.
If you  have captured  the information  from multiple  journals in  the
same outfile  member, you must specify which journal  is to be compared
in each outfile using the FROMJRN and TOJRN parameters.

CVTJRNINF escape messages you can monitor for
---------------------------------------------

      TAA9891    The OUTLIB cannot be TAATOOL
      TAA9892    The OUTLIB cannot be *LIBL if the file does not exist

Escape messages from based on functions will be re-sent.

CMPJRNINF escape messages you can monitor for
---------------------------------------------

      TAA9893    The requested jrnl does not exist in the FROM outfile
      TAA9894    The requested jrnl does not exist in the TO outfile
      TAA9895    Differences found (based on ESCAPE parameter)

Escape messages from based on functions will be re-sent.

CVTJRNINF Command parameters                          *CMD
----------------------------

   JRN           The   qualified  name   of  the   journal  to  extract
                 information  for.    The  library  value  defaults  to
                 *LIBL.   *CURLIB may also be  used.  If  the file does
                 not exist, a specific library must be described.

   OUTLIB        The  library  where the  information  will  be written
                 to.  The  file name  is always JRNINFP  with a  record
                 format name of JRNINFR.

   OUTMBR        The  member of  the  JRNINFP file  to  be written  to.
                 The default is JRNINFP.

   REPLACE       A  *YES/*NO option for  whether the member  to be used
                 will be cleared before  writing any data  to it.   The
                 default is *YES to clear the member.

                 *NO  may  be  specified  if   you  are  capturing  the
                 information  from  multiple  journals  into  the  same
                 member.

CMPJRNINF Command parameters                          *CMD
----------------------------

   FROMLIB       The  library that  contains the  From JRNINFP  file to
                 be used in  the comparison.   The file must have  been
                 output using the CVTJRNINF command.

   TOLIB         The library  that contains the  To JRNINFP file  to be
                 used  in  the comparison.    The file  must  have been
                 output using the CVTJRNINF command.

   FROMJRN       The  qualified  name  of   the  From  journal  to   be
                 compared.   The  default  is  *ONLY meaning  there  is
                 only  a  single  record  in  the  JRNINFP  file.    No
                 library qualifier can be  used if *ONLY is  specified.

                 Only  the information  from a  single  journal can  be
                 compared on each use of CMPJRNINF.

                 If   the  information   from  multiple   journals  was
                 captured  with  multiple  CVTJRNINF  commands  to  the
                 same  outfile, you  must  specify  a  fully  qualified
                 name for the journal to be compared.

   TOJRN         The qualified  name of the To journal  to be compared.
                 The  default is *FROMJRN  meaning the  same journal as
                 in the FROMJRN  parameter.   No library qualifier  can
                 be used if *FROMJRN is specified.

                 Only  the information  from  a single  journal can  be
                 compared on each use of CMPJRNINF.

                 If   the  information   from  multiple   journals  was
                 captured  with  multiple  CVTJRNINF  commands  to  the
                 same  outfile,  you must  specify  a  fully  qualified
                 name for the journal to be compared.

   FROMMBR       The  member  used in  the  JRNINFP  file  of the  From
                 library.  The default is JRNINFP.

   TOMBR         The  member  used  in  the  JRNINFP  file  of  the  To
                 library.  The default is JRNINFP.

   ESCAPE        Whether  to  send an  escape  message  if  differences
                 exist.   The default is  *NO which means  a completion
                 message is sent.

                 *YES  may be specified to  send TAA9895 if differences
                 exist.

   DLTSPLF       Whether to delete  the spooled  file if  there are  no
                 differences.     The  default  is  *YES   meaning  the
                 spooled file  is deleted if no  differences are found.
                 The spooled  file is  always retained  if  differences
                 exist.

                 *NO may  be specified  to ensure  a spooled file  will
                 exist  regardless  of  whether  differences  exist  or
                 not.

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

CVTJRNINF  must  be used  to capture  the  information into  an outfile
named JRNINFP in different  libraries before a comparison can  be made.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CRTDUPPF        Create duplicate physical file
     EDTVAR          Edit variable
     RTVFMT          Retrieve format
     RTVJRNA         Retrieve journal attributes
     RTVJRNRCVA      Retrieve journal receiver attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message
     UPDFLD          Update field

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

None, the tool is ready to use.

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

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

   CVTJRNINF     *CMD                   TAAJRNY       QATTCMD
   CMPJRNINF     *CMD                   TAAJRNY2      QATTCMD
   TAAJRNYC      *PGM       CLP         TAAJRNYC      QATTCL
   TAAJRNYC2     *PGM       CLP         TAAJRNYC2     QATTCL
   TAAJRNYR      *PGM       RPG         TAAJRNYR      QATTRPG
   TAAJRNYR2     *PGM       RPG         TAAJRNYR2     QATTRPG
   TAAJRNYP      *FILE      PF          TAAJRNYP      QATTDDS

Structure
---------

CVTJRNINF   Cmd
   TAAJRNYC   CL pgm
     TAAJRNYR   RPG Pgm

CMPJRNINF   Cmd
   TAAJRNYC2   CL pgm
     TAAJRNYR2   RPG Pgm

Added to TAA Productivity tools November 15, 1999

Home Page

Up to Top