TAA Tools
DSPTXTCNT       DISPLAY TEXT COUNT                     TAASRFK

The Display  Text  Count command  is designed  for an  analysis of  TXT
type  members in a  source file, but  may be  used on any  source type.
One,  generic, or all members in a source  file may be analyzed.  Total
records and  blank records  are always  counted.   Up  to 5  comparison
groups  (such as  all the  ABC values  in a  From/To location  within a
source  record) may also be compared for  an equal value or scanned for
a value.

A typical command would be:

             DSPTXTCNT   SRCFILE(QTXTSRC)

All members  in the file  would be  listed along  with a  count of  the
total records in each member and the number of blank records.

To  determine the  number of  times that  the  value 'ABC'  is used  in
positions 12-14,  prompt for the command and  fill in the CMPGRP prompt
as:

     Compare group:
       Title          'ABC Used'
       From position  12
       To position    14
       Operation      *EQ
       Fold to upper  *NO

This would result in the command to be executed as:

             DSPTXTCNT   SRCFILE(QTXTSRC)
                           CMPGRP(('ABC Used' 12 14 ABC *EQ *NO))

Each member  would  be read  and  a count  of  the records,  all  blank
records,  and the  records  with  'ABC'  in positions  12-14  would  be
listed.   The 'ABC Used' title  would be right adjusted  over the count
values.

You  may also scan  the entire source  record for an  'ABC' value using
the *CT (contains) operation such as:

             DSPTXTCNT   SRCFILE(QTXTSRC)
                           CMPGRP(('ABC Used' 1 80 ABC *CT *NO))

Up to 5 compare groups may be described.

DSPTXTCNT escape messages you can monitor for
---------------------------------------------

      TAA9891    No members exist in the file
      TAA9892    The named member does not exist
      TAA9893    No generic members exist

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

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

   SRCFILE       The qualified name  of the source  file.  The  library
                 value  defaults  to  *LIBL.   A  specific  library  or
                 *CURLIB may also be used.

   MBR           The  member to be  analyzed.  *ALL for  all members is
                 the default.   A  specific member  or  a generic  name
                 may also be entered.

   SRCTYP        The source type  or types to be analyzed.   TXT is the
                 default.   Up to 10 values may  be entered such as CLP
                 or  RPG.    If  a  text  member  does  not  have   the
                 specified  value,  it  is  bypassed.     *ALL  may  be
                 specified for all source types.

   CMPGRP        Up  to 5 compare  groups may  be entered.   Each group
                 is made up of the following:

                 Title.    Up  to 10  characters  may be  entered  as a
                 title for  the count.   The title  cannot be blank  if
                 any  of the  other  parts of  the  group are  entered.
                 The title will be right adjusted over the count.

                 From  position.     The  From  position  in  the  data
                 portion of  the  source  record.   This  excludes  the
                 beginning  12 bytes  of  the  source record  (sequence
                 number  and date).  The  number must be  between 1 and
                 228.

                 To position.  The To  position in the data portion  of
                 the source  record.   This excludes  the beginning  12
                 bytes  of  the  source  record  (sequence  number  and
                 date).    The number  must be  between  1 and  228 and
                 cannot exceed the  record length (minus the  12 bytes)
                 of the source file.

                 Value.    Up to  20  bytes  that  can be  compared  or
                 scanned  for.   The value  must be non-blank.   *BLANK
                 should be entered to compare  for blanks.  For an  *EQ
                 operation, the  length of the  value must be  the same
                 length   as   described  by   the   From/To  positions
                 (excluding any  trailing blanks).   The  data  entered
                 will  be folded  to upper  case  unless surrounded  by
                 apostrophes.   If the source  data to be  compared may
                 be  in mixed  case, specify  *YES for  'Fold source to
                 upper case'.

                 Operation.   How to  compare the  value.   *EQ or  *NE
                 may be  entered for a  simple comparison.   The length
                 described  for the  From/To  positions must  match the
                 length of the value  (excluding any trailing  blanks).
                 *CT may be  entered to scan the data  between the From
                 and   To  positions  for  the   length  of  the  value
                 (excluding any trailing blanks).   The entire data  of
                 a source  record  may be  scanned.   If  *CT is  used,
                 *BLANK  may not  be used  as the  value to  be scanned
                 for.

                 Fold  source to upper case.   A *YES/*NO value to fold
                 the data to  upper case before comparing  or scanning.
                 *NO is the  default.  *YES should be  specified if you
                 are  searching for a value that  may be in mixed case.

   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  DSPSPLF is ended  with F3/F12 or  the
                 Enter key.   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.


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

None.

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

The following TAA Tools must be on your system:

     ADJVAR          Adjust variable
     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     HLRMVMSG        HLL Remove message
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     RTVMBRLST       Retrieve member list
     RTVSYSVAL3      Retrieve system value 3
     RTVVALA         Retrieve value attributes
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSCNT       Send status count
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPTXTCNT     *CMD                   TAASRFK       QATTCMD
   TAASRFKC      *PGM       CLP         TAASRFKC      QATTCL
   TAASRFKR      *PGM       RPG         TAASRFKR      QATTRPG
					

Added to TAA Productivity tools October 15, 2011


Home Page Up to Top