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