The Scan Data Base File command scans one or more members of data
base files for up to 20 strings. A listing is output with one line
for each time one of the strings is found in a record. The relative
record number of the record and the position where the string was
found is described.
You must have *ALLOBJ special authority to use SCNDBF.
A typical command would be:
SCNDBF ARGUMENT(AAA) LIB(XYZ)
All data base members (both source and data) would be found in
library XYZ. Every record in each member would be scanned for AAA.
If found a line would be listed. The spooled file is displayed upon
completion.
If only source members are to be scanned, the SCNSRC command is a
more specific solution.
Any errors are noted.
SCNDBF escape messages you can monitor for
------------------------------------------
None. Escape messages from based on functions will be re-sent.
SCNDBF Command parameters *CMD
-------------------------
ARGUMENT Up to 20 arguments may be scanned for. If the
argument contains lower case, the argument must be
surrounded with quotes.
LIB The library to be processed. A list of up to 40
libraries or generic libraries may be entered. The
special values *LIBL, *USRLIBL, *CURLIB, *ALL, or
*ALLUSR
FILE The file to be processed within the library. *ALL
is the default. A generic name may be specified.
DATATYPE The type of data to be processed. *ALL is the
default. Either *DATA (data files) or *SRC (source
files) may be entered.
If only source members are to be scanned, the SCNSRC
command is a more specific solution.
LIBTYPE The library type to be processed. *ALL is the
default. Either *PROD (for PROD type libraries) or
*TEST (for TEST type libraries) may be entered.
OMITLIB A list of up to 40 libraries or generic library
names that should be omitted. *NONE is the default.
An omit list may not be entered for LIB(*CURLIB) or
if only non-generic libraries are specified.
Any library entered is checked for existence.
No check occurs to see if an omit library would have
been selected. For example, if LIB(*LIBL) is
entered with OMITLIBS(ABC) and library ABC is not on
the library list, no error occurs.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. If the display is ended with F3/F12
or the Enter key, the spooled file is deleted after
it is displayed. To retain the spooled file, you
may use the the System Request 'Cancel' function and
the spooled file will exist in a HLD status.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
IGNMAPERR Specifies whether to ignore data mapping errors.
These can occur when scanning a file with
null-capable fields or when encountering data in a
CCSID that cannot be converted to the job CCSID.
*NO is the default. These errors will continue to
be reported and the scan of that file will be
stopped.
*YES indicates that these errors will not be
reported and the scan of that file will continue
with the next record.
Restrictions
------------
You must have *ALLOBJ special authority to use SCNDBF.
Records with null values cannot be processed and will list as an
error with CPF5029. If any exist, the remaining records in the file
are bypassed.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
EXTLST2 Extract list 2
HLRMVMSG HLL remove message
RMVMSGKEY Remove message key
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SCNDBF *CMD TAADBOL QATTCMD
TAADBOLC *PGM CLP TAADBOLC QATTCL
TAADBOLR *PGM RPG TAADBOLR QATTRPG
|
