TAA Tools
CVTSRCMBR       CONVERT SOURCE MEMBER                  TAAFILH

The  Convert Source  Member  command converts  source  that exceeds  70
columns of  data to a format  not exceeding 70 columns.   This allows a
tool  such as  EDTSRC to work  with previously created  DDS source such
as CL or DDS.   The type of source must  be CL, CMD, DDS, or TXT.   Any
non supported source types are flagged.

You must have all rights to the source file to use CVTSRCMBR.

A typical command would be:

             CVTSRCMBR  SRCTYP(DDS) SRCFILE(QDDSSRC) SRCMBR(*ALL)

All  members would be  read and  reformatted to  a temporary  member in
QTEMP.   Any statements  where data  existed beyond column  70 would be
converted to two or more statements  with + signs added to all but  the
last statement.   The  temporary member  would then  be copied back  to
the original member.

A  spooled file is  created with the  results.  Members  that have been
changed are  flagged  as  well  as non-supported  source  types.    Any
additional statements  that are added  receive a current  source change
date.   If new  statements are added,  all sequence numbers  are reset.
If  no source statements have data  beyond column 70, the source member
is not changed.

For CL  types and  CMD source, F4  may need  to be  used to format  the
changed statements.

Considerations
--------------

  **   Valid source must exist for the named type.

  **   If  a statement  already has  a plus  or minus  sign at  the end
       within position 70, no change to the statement occurs.

  **   Statements  which  have  data  beyond  position  70  may not  be
       correctly converted if there  are multiple blanks between  data.
       For  example,  in CL  and  DDS  if  position  70 is  blank,  the
       conversion  places the  plus sign  2 positions  to the  right of
       the last non-blank in the first  70 columns.  If the data  after
       70 begins  with blanks,  some blanks  will be  dropped from  the
       statement.  This may cause a CRTxxx command to fail.

  **   The  prompter may  be used  on the  converted statements  for CL
       types  and  CMD source.   In  some cases  the prompter  will get
       confused  and  insert  a  long  string  of  blanks   instead  of
       properly formatting the statement.

CVTSRCMBR escape messages you can monitor for
---------------------------------------------

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

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

   TYPE          The type of source to be converted.

                 CL  may  be specified  and  will  convert  any of  the
                 source types CL, CLP, CLP38, and CLLE.

                 CMD  may  be specified  and  will convert  any  of the
                 source type CMD.

                 DDS may  be  specified and  will  convert any  of  the
                 source types PF,  PF38, LF, LF38, DSPF,  DSPF38, PRTF,
                 PRTF38, BSCF38, CMNF38, ICFF, and MXDF38.

                 TXT  may be  specified to  convert  any of  the source
                 types TXT, PNLGRP, SPADCT,  and TBL.   If a line  must
                 be split, the last  blank (assuming it is in  the last
                 25 positions)  is found and  the line is  split at the
                 blank.  The new line will start in position 2.

   SRCFILE       The qualified name of the source file.

                 *LIBL  is  the  default  library  name.    A  specific
                 library or *CURLIB may be entered.

   SRCMBR        The  source  member  to  be  converted.    A  specific
                 source member,  a generic  name, or the  special value
                 *ALL  for  all  members  in  the  source  file may  be
                 specified.


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

See the considerations section.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTMBRLST       Convert member list
     EDTVAR          Edit variable
     HLRMVMSG        HLL Remove message
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVDBFA         Retrieve data base file attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTSRCMBR     *CMD                   TAAFILH       QATTCMD
   TAAFILHC      *PGM       CLP         TAAFILHC      QATTCL
   TAAFILHR      *PGM       RPG         TAAFILHR      QATTRPG
   TAAFILHR2     *PGM       RPG         TAAFILHR2     QATTRPG
   TAAFILHR3     *PGM       RPG         TAAFILHR3     QATTRPG

TAAFILHR is used  for DDS  conversion.   TAAFILHR2 is used  for CL  and
CMD conversion.  TAAFILHR3 is used for TXT conversion.
					

Added to TAA Productivity tools January 15, 2010


Home Page Up to Top