The Copy Source Files to IFS tool is meant to provide an easy way to
populate an IFS directory from the source physical files in a given
library.

You may wish to do this if comparing sources across systems or when
you wish to establish a source directory usable with Source Control
Management tool that operates on Unix or Windows style directories.

The tool consists of one command -- the CPYSRCFIFS command.  The
defaults for this command lean toward providing stream files that
are compatible with the Unix-like nature of the Root and QOpenSys
file systems of the IFS.  As such the default CCSID is UTF-8 and the
line endings are line feed characters.  Values are allowed for other
CCSID and line ending characteristics.

If a stream file corresponding to a selected member already exists
in that directory it is overwritten.  Any stream files that do not
correspond to a selected member are left as is.

Directories corresponding to the source files in the library may be
created by this command.  Any stream files or directories that need
to be created will have data and object authorities of *INDIR.

CPYSRCFIFS escape messages you can monitor for
----------------------------------------------

TAA9898 An escape message sent if it is not possible to create or
populate a stream file for some reason.  It will be preceded by a
diagnostic message that outlines the reason.

CPYSRCFIFS Command Parameters                         *CMD
-----------------------------

   LIB           Specifies the library name containing the source
                 files from which to copy members.

   FILE          Specifies the (posibly generic) qualified name of
                 the source files from which to copy members.  *ALL
                 is a special value that indicates all of the source
                 files in a library.

   EXCLUDE       Specifies any source files to be excluded from the
                 generic list.  Up to ten such files may be
                 specified.

   MBR           Specifies the (possibly generic) name of the
                 members to copy into an IFS stream file.  *ALL is a
                 special value the requests that all members be
                 copied.

   TODIR         Specifies the root directory in which the
                 subdirectories stream files corresponding to the
                 selected source files are created.  If a
                 subdirectory does not exist then an attempt is made
                 to create it.  The special value of *LIB can be
                 used to specify that this directory name will be
                 the same as the library name and will be located
                 inside the current directory.

                 This may be an absolute path or relative to the
                 current directory.

   CCSID         Specifies the CCSID that the stream files will
                 have.  If a stream file exists with that name its
                 CCSID attribute will be changed to this CCSID.
                 *UTF8 is a special file that requests that CCSID
                 1208 be used.

   LINEEND       Specifies the line ending characters that will be
                 used for lines in the stream file.  The default
                 value of *LF specifies that line feed will be used.
                 Other special values are *CR for carriage return
                 and *CRLF for carriage return and line feed.  *LF
                 is the default since it is the preferred line
                 ending character for files compatible with
                 QOpenSys.

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

No special authorities are need to use this command.  You will need
to have proper authority to create files and directories within the
TODIR directory.

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

The following TAA Tools must be on your system:

     CHKDBFMBR       Check database file member
     CHKGENERC       Check generic name
     RTVIFSED        Retrieve IFS entry description
     RTVMBRLST       Retrieve member list
     RTVOBJLST       Retrieve object list
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic 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
   ------        ----    ---------      ----------    ----------

   CPYSRCFIFS    *CMD                   TAACPYX       QATTCMD
   TAACPYXB      *PGM       CLLE        TAACPYXB      QATTCL
   TAACPYXC      *PGM       CLLE        TAACPYXC      QATTCL
   TAACPYXHC     *PNLGRP    PNLGRP      TAACPYXHC     QATTUIM

Structure
---------

CPYSRCFIFS  Cmd
   TAACPYXC    CLLE pgm