TAA Tools
CRTTAATOOL          CREATE TAA TOOL                         TAATOLA

The  Create TAA  Tool  command  creates the  objects  for a  named  TAA
Productivity Tool.

       ******************************************************
       *                                                    *
       *      Because the object form of the tools are      *
       *      shipped with the TAA Productivity Tools       *
       *      (in addition to source), there is far less    *
       *      need for CRTTAATOOL than when the TAA         *
       *      Tools were part of i5/OS QUSRTOOL and         *
       *      only source was shipped.                      *
       *                                                    *
       ******************************************************

CRTTAATOOL may be useful to:

  **   Allow  the creation  of certain  tools  that require  changes to
       the  source before the  tools can be used  (The vast majority of
       tools do not require any changes).

  **   Allow the  modification  of tools.   Since  the  source is  also
       shipped  with the  TAA Productivity  Tools, you  can  access the
       source,  make changes, and then use  CRTTAATOOL to re-create the
       modified version.

A typical command would be:

          CRTTAATOOL    TOOL(ADDDAT) SRCLIB(xxx)

Only a user with *ALLOBJ special authority can re-create a tool.

The TAACTL area in  TAATOOL is accessed to  determine the name of  your
command library.   If the tool has  one or more commands,  a version of
the  commands is always  created in TAATOOL.   If your  command library
is other than TAATOOL, a second  version of any commands is created  in
your command  library.   The  command library  can only  be changed  at
install time or by use of the DUPTAACMD command.

Some tools  use RPG code.   To re-create  these tools requires  the RPG
compiler  exist on  your system.   If  you do  not need to  re-create a
tool, you can  use the object  form of any  RPG program without  having
the RPG licensed product installed on your system.

Only the  object form  of CRTTAATOOL is  shipped (no source  exists for
the tool).

Modifying and re-creating a tool
--------------------------------

The  source for  the tools  is shipped  in the TAA  Archive.   You must
copy  the  source  from  the  archive  to  source  files  in  order  to
re-create a tool.

The  recommended  solution for  modifying  and  re-creating a  tool  is
described  with the  CRTTAASRCF  tool.   CRTTAASRCF lets  you  create a
QATTxxx source files in a library so that changes can be made.

Some tools are  used frequently  as prerequisite  tools and  CRTTAATOOL
is restricted for  these tools for  integrity purposes.   If CRTTAATOOL
is attempted  on one of  these tools, messages will  be sent describing
how to make modification.

You  should avoid using the source files  in the TAATOOL library as the
data will be overlaid  on a new release  of the TAA Productivity  Tools
and you would lose the changes that you have made.

You should  avoid using  CRTCMD, CRTCLPGM, etc.   directly  against the
TAA source.  Using the CRTTAATOOL command is preferred because:

  **   Some  of  the  CRT  commands  that  are  run  by CRTTAATOOL  use
       special parameters  for  various  functions  such  as  security,
       help text, etc.

  **   Some of the  object creation steps require  temporary objects be
       created  or a specific  sequence of steps.   CRTTAATOOL performs
       these steps correctly.

  **   Some tools  require  prerequisite  tools.    CRTTAATOOL  does  a
       better  job  for  checking for  the  existence  of  these  tools
       rather than having the compiler or run time code fail.

DUPTAPIN Tool
-------------

The DUPTAPIN  tool uses PL/1  object code.   The object code  exists in
TAATOOL.    CRTTAATOOL  does  not  create  the  PL/1  object  code  for
DUPTAPIN (it does  create the commands  and CL programs).   You do  not
need the PL/1 compiler to be able to use DUPTAPIN.

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

The  majority of  code can  be  created with  standard i5/OS  functions
such  as the CL compiler  and DDS.   Many of the  tools require the RPG
compiler.

Many TAA tools require  the use of other TAA  tools.  For example,  the
EDTVAR tool is used by many different tools.

The dependent  tools are  described in  the 'Prerequisites' section  of
each  tool description.  When  you use CRTTAATOOL for  a specific tool,
the command first ensures that the  dependent tools already exist.   If
not, the request is rejected.

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

   TOOL          The tool you want to create.

   SRCLIB        The  source library  name.    The default  is  *TAAARC
                 which  means   that  QATTxxx  source   files  will  be
                 created  in QTEMP,  the members  for the  tool will be
                 copied from  the TAA Archive  to QTEMP,  and the  tool
                 created.

                 If  a library  is named,  you should  avoid specifying
                 TAATOOL   and  use  your   own  library  as  described
                 previously and in the CRTTAASRCF tool description.

   RMVOBS        A *YES/*NO parameter that  defaults to *YES to  remove
                 the observability  of the  programs.  This  means that
                 the  program cannot  be debugged  nor can  a formatted
                 dump occur.    This  results in  a  significant  space
                 saving.   If  you  need to  debug  one of  the  tools,
                 recreate it with RMVOBS(*NO).

   ALWRTVSRC     A  *YES/*NO  parameter that  defaults  to *NO  meaning
                 the   CL  source  will  not  be  stored  with  the  CL
                 programs and therefore  cannot be retrieved  using the
                 RTVCLSRC command.   This saves about 15%  space in the
                 object  sized  of  the  programs.    The  *YES  option
                 stores the  source with  the  CL programs  and  allows
                 for retrieval with the RTVCLSRC command.

   LOG           A  *YES/*NO parameter  that  defaults  to *NO  meaning
                 the  commands  will not  be logged  from  CL programs.
                 Some tools  are always  created with  LOG(*NO)  either
                 for  security  reasons or  to  reduce  potential  high
                 logging.

   INCLIB        A  list  of  up   to  three  libraries  that  will  be
                 searched   for  includes.     During  the  compilation
                 process the  library list  will be  the SRCLIB,  these
                 libraries,  QTEMP,  and QGPL.    The  library list  is
                 restored when the command completes.

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

None, the tool is ready to use.

Object only tool
----------------

CRTTAATOOL  is shipped in object form only.   The source does not exist
on your system.
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top