SCNGENSRCD -- Scan Generic Source Description

SCNGENSRCD SCAN GENERIC SOURCE DESCRIPTION TAASREW
The Scan Generic Source Description command provides a simple display or listing of generic source members. An option exists to select by source change date. One line per member appears. Either a single source file, all source files, standard source files, or the QATT source files in a library may be requested. A typical command would be: SCNGENSRCD GENNAME(ABC) SRCFILE(STD) Note that no is needed for the generic name. If the command is entered interactively, a display would appear with all members beginning with ABC in the standard source files (QCMDSRC, QCLSRC, etc). The default for the LIB parameter is DFT. The library to be searched when LIB(DFT) is used is determined by the following sequence of rules: ** A search is made for the STDSRCLIB DTAARA on the library list. If it is found, the library where the data area exists is used. * The current library is used if it is other than NONE. * The first library on the library list is used. To use the STDSRCLIB DTAARA technique, create a data area in your normal source file library as: CRTDTAARA DTAARA(xxx/STDSRCLIB) TYPE(CHAR) LEN(10) TEXT('Used by TAA SCNGENSRCD tool') SCNGENSRCD escape messages you can monitor for ---------------------------------------------- TAA9897 No source files exist Escape messages from based on functions will be re-sent. Command parameters CMD ------------------ GENNAME The generic name of the member description to be displayed or listed. The value need not contain an at the end for generic to be assumed. Note that there is no method of specifying an individual member unless there is only one matching a generic name. SRCFILE The source file to be used. If a name is entered, only that source file will be searched. ALL may be entered to mean all source files in the library. STD may be specified to mean the standard file names associated with source types described in system help text. Only those source files that exist and match those described by the PRTSRCTYP tool will be checked. See the discussion with PRTSRCTYP. SRC1, SRC2, and SRC3 mean that a data area must exist on the library list by the corresponding names of SRCLST1, SRCLST2, and SRCLST3. These data areas must contain the name of the source files to be checked. Only source files that exist and match one of those found in the data area will be checked. See the discussion with the CRTSRCFLST tool. QATT or QATT2 may be specified to mean the only files checked must match those described in the RTVQATTF TAA Tool. This is either a short or long list of QATTxxx source file names. Use the PRTQATTF command for a listing of the files. LIB The library for the source files. The default is DFT. This causes the library to be determined by the following sequence of rules: 1) A search is made for the STDSRCLIB DTAARA on the library list. If it is found, the library where the data area exists is used. 2) The current library is used if it is other than NONE. 3) The first library on the library list is used. To use the STDSRCLIB DTAARA technique, create a data area in your normal source file library as: CRTDTAARA DTAARA(xxx/STDSRCLIB) TYPE(CHAR) LEN(10) TEXT('Used by TAA SCNGENSRCD tool') A specific library or LIBL may be used. LIBL may not be used if a special value is used for SRCFILE. CHGDATE The source change date to select only those members that have a source change date on or after the date entered. NONE is the default meaning no selection occurs on the change date. TODAY may be entered as a shorthand for today's date. A date may be entered in job date format to select only those members that have been changed on or after the date. OUTPUT The type of output. * is the default to display the results if the command is entered interactively. If the command is entered in batch or PRINT is specified, a listing is output. Restrictions ------------ Up to 999 source files may exist in a library. The first 999 source members in a source file based on the generic name given will be processed. Prerequisites ------------- The following TAA Tools must be on your system: CHKGENERC Check generic CHKOBJ3 Check object 3 CVTTIM Convert time EDTVAR Edit variable RTVDAT Retrieve date RTVLIBSRCF Retrieve library source files RTVMBRLST Retrieve member list RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic 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 ------ ---- --------- ---------- ---------- SCNGENSRCD CMD TAASREW QATTCMD TAASREWC PGM CLP TAASREWC QATTCL TAASREWR PGM RPG TAASREWR QATTRPG

SCNGENSRCD      SCAN GENERIC SOURCE DESCRIPTION        TAASREW


The Scan Generic  Source Description command provides a  simple display
or listing  of generic source members.   An option exists  to select by
source  change date.   One  line per member  appears.   Either a single
source file,  all  source files,  standard source  files,  or the  QATT
source files in a library may be requested.

A typical command would be:

            SCNGENSRCD   GENNAME(ABC) SRCFILE(*STD)

Note that no * is needed for the generic name.

If the  command is entered  interactively, a display would  appear with
all  members beginning with ABC in  the standard source files (QCMDSRC,
QCLSRC, etc).

The default for the LIB parameter is *DFT.

The library  to be searched  when LIB(*DFT)  is used  is determined  by
the following sequence of rules:

  **   A  search is  made  for the  STDSRCLIB  *DTAARA  on the  library
       list.   If it is  found, the library where  the data area exists
       is used.

  **   The current library is used if it is other than *NONE.

  **   The first library on the library list is used.

To use the  STDSRCLIB *DTAARA  technique, create  a data  area in  your
normal source file library as:

             CRTDTAARA   DTAARA(xxx/STDSRCLIB) TYPE(*CHAR) LEN(10)
                           TEXT('Used by TAA SCNGENSRCD tool')

SCNGENSRCD escape messages you can monitor for
----------------------------------------------

      TAA9897    No source files exist

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

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

   GENNAME       The  generic name  of  the  member description  to  be
                 displayed or  listed.  The  value need not  contain an
                 * at the end for generic to be assumed.

                 Note   that  there  is  no  method  of  specifying  an
                 individual member  unless there  is only one  matching
                 a generic name.

   SRCFILE       The source  file to  be used.   If a name  is entered,
                 only that source file will be searched.

                 *ALL  may be entered  to mean all source  files in the
                 library.

                 *STD may  be  specified  to  mean  the  standard  file
                 names  associated  with  source   types  described  in
                 system  help  text.    Only  those  source files  that
                 exist and  match  those  described  by  the  PRTSRCTYP
                 tool  will  be  checked.    See  the  discussion  with
                 PRTSRCTYP.

                 *SRC1,  *SRC2, and *SRC3  mean that  a data  area must
                 exist  on the library list  by the corresponding names
                 of SRCLST1, SRCLST2,  and SRCLST3.   These data  areas
                 must  contain  the name  of  the  source  files to  be
                 checked.   Only source files that  exist and match one
                 of those  found  in the  data  area will  be  checked.
                 See the discussion with the CRTSRCFLST tool.

                 *QATT  or *QATT2  may be  specified to  mean the  only
                 files  checked  must  match  those  described  in  the
                 RTVQATTF TAA Tool.   This  is either a  short or  long
                 list of QATTxxx  source file names.  Use  the PRTQATTF
                 command for a listing of the files.

   LIB           The library for the source files.

                 The default  is *DFT.   This causes the  library to be
                 determined by the following sequence of rules:

                      1)  A search  is made  for the  STDSRCLIB *DTAARA
                      on  the  library list.    If  it  is  found,  the
                      library where the data area exists is used.

                      2)  The current library  is used  if it  is other
                      than *NONE.

                      3)  The  first  library on  the  library  list is
                      used.

                 To use  the  STDSRCLIB  *DTAARA  technique,  create  a
                 data area in your normal source file library as:

                  CRTDTAARA   DTAARA(xxx/STDSRCLIB)
                               TYPE(*CHAR) LEN(10)
                               TEXT('Used by TAA SCNGENSRCD tool')

                 A specific  library or *LIBL may  be used.   *LIBL may
                 not  be used if a  special value is  used for SRCFILE.

   CHGDATE       The source change  date to select  only those  members
                 that have a  source change date  on or after  the date
                 entered.

                 *NONE  is the default  meaning no selection  occurs on
                 the change date.

                 *TODAY  may  be  entered as  a  shorthand  for today's
                 date.

                 A date  may be entered  in job  date format to  select
                 only  those  members  that  have been  changed  on  or
                 after the date.

   OUTPUT        The  type of output.  * is  the default to display the
                 results if the command is entered interactively.

                 If the  command  is  entered  in batch  or  *PRINT  is
                 specified, a listing is output.

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

Up to 999 source files may exist in a library.

The first  999 source  members in  a source file  based on  the generic
name given will be processed.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     CVTTIM          Convert time
     EDTVAR          Edit variable
     RTVDAT          Retrieve date
     RTVLIBSRCF      Retrieve library source files
     RTVMBRLST       Retrieve member list
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic 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
   ------        ----    ---------      ----------    ----------

   SCNGENSRCD    *CMD                   TAASREW       QATTCMD
   TAASREWC      *PGM       CLP         TAASREWC      QATTCL
   TAASREWR      *PGM       RPG         TAASREWR      QATTRPG

Added to TAA Productivity tools February 15, 2006

Home Page

Up to Top