OUTFFLD -- Outfile Fields

OUTFFLD OUTFILE FIELDS TAADBNF
The Outfile Fields tool is a series of commands that allow you to display a field name that exists in either a system and/or TAA model file. This can assist in understanding the attributes of the field and the command which outputs the file. After the required files are created and the field information is converted, the DSPOUTFFLD command can be used. A typical command would be: DSPOUTFFLD FIELD(ODOBSZ) Note that you can position to a different field by using the 'Position to field' prompt at the top of the display. This allows you to look at several fields without ending the display. Getting started with OUTFFLD ---------------------------- ** An ALLOBJ user must use the CRTOUTFFLD command to create the file structure in a specific library. Assuming multiple users may want to use the DSPOUTFFLD command, a general use library that is on most user's library list such as QGPL could be used. CRTOUTFFLD OUTFFLDLIB(xxxx) The files OUTFFLDP and OUTFFLDL would be created. The default is to allow PUBLIC use. ** The model files fields for the system and/or TAA commands must be converted using CVTOUTFFLD. This is a long running command and could be submitted to batch. CVTOUTFFLD TYPE(BOTH) All fields in the system and TAA model files would be converted (a few exceptions exist - see the section on Restrictions). Note that CVTOUTFFLD should be used when a new system release exists or when a new TAA version is installed. * The DSPOUTFFLD command may then be used. A specifically named field could be entered such as: DSPOUTFFLD FIELD(JAJOB) All matches of the name would be displayed in a subfile. An option to display the detail field information could be used. Another option allows the format containing the field to be displayed. You may also enter a partial name such as: DSPOUTFFLD FIELD(JAJ) and the subfile will be filled with all field names that begin with the characters entered. ** The SCNOUTFFLD command may also be used to scan the prompt text for a value such as: SCNOUTFFLD FIELD(SPACE) All fields with SPACE in the text description would be displayed. Both the scan value and the prompt text are converted to upper case before scanning. OUTFFLD escape messages you can monitor for ---------------------------------------------- None. Escape messages from based on functions will be re-sent. CRTOUTFFLD Command parameters CMD ----------------------------- OUTFFLDLIB The library where the OUTFFLDx files will be created. The typical use would be to name a library where all programmer type users could access the information. SRCLIB The source library to use for the QATTDDS file source. The default is TAAARC. A specific user library may be named, but the source file name must be QATTDDS. AUT The authority to the OUTFFLDP physical file. USE is the default. CHANGE or EXCLUDE may be specified. DLTOUTFFLD Command parameters CMD ----------------------------- OUTFFLDLIB The library where the OUTFFLDx files will be deleted from. CVTOUTFFLD Command parameters CMD ----------------------------- OUTFFLDLIB The library where the OUTFFLDx files exist. LIBL is the default. CURLIB or a specific library may be named. TYPE The type of model files to be converted. BOTH is the default for both system and TAA model files. SYSTEM may be used to create the information for system model files. TAA may be used to create the information for TAA model files. REPLACE A YES/NO option for whether to replace the data in the OUTFFLDP file. YES is the default to replace the data. NO may be specified to add to the data. DSPOUTFFLD Command parameters CMD ----------------------------- FIELD The field name to display information for. If a partial name is entered, all field names that match the partial name would be displayed. OUTFFLDLIB The library where the OUTFFLDx files exist. LIBL is the default. CURLIB or a specific library may be named. SCNOUTFFLD Command parameters CMD ----------------------------- SCNVAL The string of text to be scanned for in the field description text. Both the SCNVAL and the field text are converted to upper case before scanning. A single word such as 'space' may be entered or multiple words such as 'space size'. OUTFFLDLIB The library where the OUTFFLDx files exist. LIBL is the default. CURLIB or a specific library may be named. Restrictions ------------ The following command model files are not converted: CVTAUDJRNE - Many formats exist. CVTARPTBL - Does not allow conversion. The following command model files will only be converted if they exist: ** CMPPTFLVL Prerequisites ------------- The following TAA Tools must be on your system: CHKACTOBJ Check active object CHKALLOBJ Check ALLOBJ special authority CHKDBFMBR Check data base file member TAAARC TAA Archive EDTVAR Edit variable RSNLSTMSG Resend last message 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 TRNVAL Translate value UPDPFILE Update PFILE keyword Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CRTOUTFFLD CMD TAADBNF QATTCMD DLTOUTFFLD CMD TAADBNF2 QATTCMD CVTOUTFFLD CMD TAADBNF3 QATTCMD DSPOUTFFLD CMD TAADBNF4 QATTCMD SCNOUTFFLD CMD TAADBNF5 QATTCMD TAADBNFC PGM CLP TAADBNFC QATTCL TAADBNFC2 PGM CLP TAADBNFC2 QATTCL TAADBNFC3 PGM CLP TAADBNFC3 QATTCL TAADBNFC4 PGM CLP TAADBNFC4 QATTCL TAADBNFC5 PGM CLP TAADBNFC5 QATTCL TAADBNFC13 PGM CLP TAADBNFC13 QATTCL TAADBNFR3 PGM RPG TAADBNFR3 QATTRPG TAADBNFR4 PGM RPG TAADBNFR4 QATTRPG TAADBNFR5 PGM RPG TAADBNFR5 QATTRPG TAADBNFD FILE DSPF TAADBNFD QATTDDS TAADBNFE FILE DSPF TAADBNFE QATTDDS TAADBNFP FILE PF TAADBNFP QATTDDS TAADBNFL *FILE LF TAADBNFL QATTDDS Structure --------- CRTOUTFFLD Cmd TAADBNFC CL pgm DLTOUTFFLD Cmd TAADBNFC2 CL pgm CVTOUTFFLD Cmd TAADBNFC3 CL pgm TAADBNFR3 RPG pgm TAADBNFC13 CL pgm DSPOUTFFLD Cmd TAADBNFC4 CL pgm TAADBNFR4 RPG pgm TAADBNFD DSP file SCNOUTFFLD Cmd TAADBNFC5 CL pgm TAADBNFR5 RPG pgm TAADBNFE DSP file

OUTFFLD         OUTFILE FIELDS                         TAADBNF


The Outfile  Fields tool  is a  series of  commands that  allow you  to
display a  field name that exists  in either a system  and/or TAA model
file.   This  can assist in  understanding the attributes  of the field
and the command which outputs  the file.  After the required  files are
created  and  the  field   information  is  converted,  the  DSPOUTFFLD
command can be used.

A typical command would be:

       DSPOUTFFLD  FIELD(ODOBSZ)

Note  that  you  can  position  to  a  different  field  by  using  the
'Position to field'  prompt at  the top  of the display.   This  allows
you to look at several fields without ending the display.

Getting started with OUTFFLD
----------------------------

  **   An *ALLOBJ  user must use the  CRTOUTFFLD command to  create the
       file structure  in a specific library.   Assuming multiple users
       may want to use  the DSPOUTFFLD command,  a general use  library
       that  is on  most user's  library  list such  as  QGPL could  be
       used.

               CRTOUTFFLD   OUTFFLDLIB(xxxx)

       The files OUTFFLDP and OUTFFLDL would be created.

       The default is to allow *PUBLIC use.

  **   The model  files fields for the system  and/or TAA commands must
       be  converted using CVTOUTFFLD.  This  is a long running command
       and could be submitted to batch.

               CVTOUTFFLD   TYPE(*BOTH)

       All  fields  in  the  system  and  TAA  model   files  would  be
       converted  (a  few  exceptions   exist  -  see  the  section  on
       Restrictions).

       Note  that CVTOUTFFLD should  be used when a  new system release
       exists or when a new TAA version is installed.

  **   The DSPOUTFFLD command may then  be used.  A specifically  named
       field could be entered such as:

               DSPOUTFFLD   FIELD(JAJOB)

       All matches  of the name  would be displayed  in a subfile.   An
       option  to display the  detail field information  could be used.
       Another option  allows the  format containing  the field  to  be
       displayed.

       You may also enter a partial name such as:

               DSPOUTFFLD   FIELD(JAJ)

       and the subfile will  be filled with all field  names that begin
       with the characters entered.

  **   The  SCNOUTFFLD command  may  also be  used to  scan  the prompt
       text for a value such as:

               SCNOUTFFLD   FIELD(SPACE)

All  fields  with SPACE  in the  text  description would  be displayed.
Both the scan  value and the  prompt text are  converted to upper  case
before scanning.

OUTFFLD escape messages you can monitor for
----------------------------------------------

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

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

   OUTFFLDLIB    The   library  where  the   OUTFFLDx  files   will  be
                 created.   The typical use would  be to name a library
                 where all  programmer  type  users  could  access  the
                 information.

   SRCLIB        The  source  library  to  use  for  the  QATTDDS  file
                 source.  The default is *TAAARC.

                 A specific  user library may be  named, but the source
                 file name must be QATTDDS.

   AUT           The authority to the OUTFFLDP physical file.

                 *USE is the default.

                 *CHANGE or *EXCLUDE may be specified.

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

   OUTFFLDLIB    The library where the  OUTFFLDx files will be  deleted
                 from.


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

   OUTFFLDLIB    The library  where the  OUTFFLDx files  exist.   *LIBL
                 is  the default.   *CURLIB or  a specific  library may
                 be named.

   TYPE          The type of model files to be converted.

                 *BOTH  is the  default for  both system  and TAA model
                 files.

                 *SYSTEM may  be  used to  create  the information  for
                 system model files.

                 *TAA  may be used  to create  the information  for TAA
                 model files.

   REPLACE       A  *YES/*NO option for whether to  replace the data in
                 the OUTFFLDP file.

                 *YES is the default to replace the data.

                 *NO may be specified to add to the data.


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

   FIELD         The field  name  to display  information  for.   If  a
                 partial name  is entered, all  field names  that match
                 the partial name would be displayed.

   OUTFFLDLIB    The  library where  the OUTFFLDx  files exist.   *LIBL
                 is the default.   *CURLIB  or a  specific library  may
                 be named.


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

   SCNVAL        The string  of text  to be  scanned for  in the  field
                 description  text.   Both  the  SCNVAL  and the  field
                 text  are converted to upper  case before scanning.  A
                 single  word  such  as  'space'  may  be   entered  or
                 multiple words such as 'space size'.

   OUTFFLDLIB    The  library where  the OUTFFLDx  files exist.   *LIBL
                 is  the default.   *CURLIB  or a specific  library may
                 be named.

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

The following command model files are not converted:

  **   CVTAUDJRNE - Many formats exist.

  **   CVTARPTBL - Does not allow conversion.

The following  command  model files  will  only  be converted  if  they
exist:

  **   CMPPTFLVL

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

The following TAA Tools must be on your system:

     CHKACTOBJ       Check active object
     CHKALLOBJ       Check *ALLOBJ special authority
     CHKDBFMBR       Check data base file member
     TAAARC          TAA Archive
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     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
     TRNVAL          Translate value
     UPDPFILE        Update PFILE keyword

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

None, the tool is ready to use.

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

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

   CRTOUTFFLD    *CMD                   TAADBNF       QATTCMD
   DLTOUTFFLD    *CMD                   TAADBNF2      QATTCMD
   CVTOUTFFLD    *CMD                   TAADBNF3      QATTCMD
   DSPOUTFFLD    *CMD                   TAADBNF4      QATTCMD
   SCNOUTFFLD    *CMD                   TAADBNF5      QATTCMD
   TAADBNFC      *PGM       CLP         TAADBNFC      QATTCL
   TAADBNFC2     *PGM       CLP         TAADBNFC2     QATTCL
   TAADBNFC3     *PGM       CLP         TAADBNFC3     QATTCL
   TAADBNFC4     *PGM       CLP         TAADBNFC4     QATTCL
   TAADBNFC5     *PGM       CLP         TAADBNFC5     QATTCL
   TAADBNFC13    *PGM       CLP         TAADBNFC13    QATTCL
   TAADBNFR3     *PGM       RPG         TAADBNFR3     QATTRPG
   TAADBNFR4     *PGM       RPG         TAADBNFR4     QATTRPG
   TAADBNFR5     *PGM       RPG         TAADBNFR5     QATTRPG
   TAADBNFD      *FILE      DSPF        TAADBNFD      QATTDDS
   TAADBNFE      *FILE      DSPF        TAADBNFE      QATTDDS
   TAADBNFP      *FILE      PF          TAADBNFP      QATTDDS
   TAADBNFL      *FILE      LF          TAADBNFL      QATTDDS

Structure
---------

CRTOUTFFLD  Cmd
   TAADBNFC   CL pgm

DLTOUTFFLD  Cmd
   TAADBNFC2  CL pgm

CVTOUTFFLD  Cmd
   TAADBNFC3  CL pgm
      TAADBNFR3  RPG pgm
         TAADBNFC13 CL pgm

DSPOUTFFLD  Cmd
   TAADBNFC4  CL pgm
      TAADBNFR4  RPG pgm
         TAADBNFD   DSP file

SCNOUTFFLD  Cmd
   TAADBNFC5  CL pgm
      TAADBNFR5  RPG pgm
         TAADBNFE   DSP file

Added to TAA Productivity tools July 15, 2011

Home Page

Up to Top