TAA Tools
DSPDFTRCD       DISPLAY DEFAULT RECORDS                TAADBLJ

The  Display  Default  Records command  displays  the  Relative  Record
numbers of  the records in  a file that  match the default  record used
by  the  system  when adding  a  new record.    It is  possible  for an
application or  a  utility like  DFU  to add  a  default record  as  an
error.    DSPDFTRCD  will  find  these  conditions,  but  not  all  may
indicate an error.  You must decide based on your application.

A typical command would be:

              DSPDFTRCD   FILE(xxx)

By  default  a listing  would  be output  and displayed.    The listing
would contain any  relative record numbers of  records where the  value
matches the unique default record used for the file.

Additional comments
-------------------

  **   One, generic, or all files in a library may be analyzed.

  **   Any files you do not have authorization to will be bypassed.

  **   Any files without members will be bypassed.

  **   Only PF type files will be processed.

  **   If you have  initialized a file with many records,  each RR will
       appear.  These types of files should be avoided.

  **   Any  files with  record lengths greater  than 9999  are bypassed
       and noted with a  diagnostic message.  An  escape will occur  at
       completion.

  **   Any files  with variable  length fields  are bypassed and  noted
       with   a  diagnostic  message.     An   escape  will   occur  at
       completion.

  **   Any  files  with  null  fields are  bypassed  and  noted  with a
       diagnostic message.  An escape will occur at completion.

System use of the default record
--------------------------------

The system  creates a  unique  default record  which is  placed at  the
front of  the file  (it does not  count as one  of your records).   The
record  contains  blanks or  zeros  for typical  character  and decimal
fields.  Date,  time, and  timestamp fields  contribute unique  values.
You may have specified defaults using the DDS DFT keyword.

When a  new record is to  be added, any data  you add is placed  on top
of a copy of the default record and then added.

If you  use INZPFM, the RECORDS parameter  allows you to initialize new
records to either the default record or deleted records.

Accessing the default record values
-----------------------------------

DSPDFTRCD does not access the default  record.  It creates a  temporary
file  with the  same definition  and  then uses  INZPFM  to create  one
default record.   The entire record is read and  the value is stored to
use as a comparison against each record in the named file.

DSPDFTRCD escape messages you can monitor for
----------------------------------------------

      TAA9893    Some error occurred.  See *DIAG messages.

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

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

   FILE          The  qualified  name of  the file  to  be checked.   A
                 specific or generic  file name may  be entered or  the
                 special value *ALL.

                 A specific library must be entered.

   MBR           The member  to be  checked.  The  default is  *ALL for
                 all members.

                 If  the file name  is generic or  *ALL, MBR(*ALL) must
                 be used.

                 If a single file is  named, the special values  *FIRST
                 or *LAST may be used.

   BYPSRC        A *YES/*NO option  for whether to bypass  checking for
                 source files.

                 *YES is the default to bypass source members.

                 *NO may be specified to check source members.

   OUTPUT        How  to  output the  results.   *  is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

                 If  the  command is  entered  in  batch  or *PRINT  is
                 specified,  the spooled  file is  output and retained.

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

The file size cannot exceed 9999 bytes in record length.

Files with variable length or null fields are not supported.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     DUPFILFMT       Duplicate file format
     EDTVAR          Edit variable
     FILEFDBCK       File feedback
     HLRMVMSG        HLL Remove message
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPDFTRCD     *CMD                   TAADBLJ       QATTCMD
   TAADBLJC      *PGM       CLP         TAADBLJC      QATTCL
   TAADBLJR      *PGM       RPG         TAADBLJR      QATTRPG
   TAADBLJR2     *PGM       RPG         TAADBLJR2     QATTRPG
					

Added to TAA Productivity tools January 1, 2007


Home Page Up to Top