TAA Tools

The  Clear Logical  File Member  command  clears all  of  the based  on
physical members for a specific logical file member.

If  you have  a  logical file  over multiple  physical  files, clearing
each  of the physical files  will cause the access  path of the logical
to be  rebuilt each time  CLRPFM occurs.   To perform  the function  in
the most efficient manner you should:

       - Remove the logical file member
       - Clear each of the physical file members
       - Add the logical file member

CLRLFM performs these steps for you:

A typical command would be entered as:

         CLRLFM    FILE(FILEX)

The named  file must be  a logical file.   If the file  has select/omit
logic, a special option is required.

Before  any  of  the physical  members  are  cleared,  authorization is
checked to ensure the user can  clear a member and each of the  members
is allocated.   If any  errors occur,  the members are  deallocated and
the command fails with an escape message.

Command parameters                                    *CMD

   FILE          The   qualified  logical  file  name.     The  library
                 defaults to *LIBL.

   MBR           The member name.   The default is  *FIRST.  The  entry
                 of *FIRST is  not quite the  same as normal  data base
                 commands.   If there is only a  single member there is
                 no  difference.   The  CLRLFM  command uses  the DSPFD
                 member  output file  to  determine the  first  member.
                 This  is the  first alphabetical  member.   The normal
                 data  base  commands  use *FIRST  to  mean  the oldest
                 member using creation date order.

   SELECTOMIT    Protect the file if  it is specified with  select/omit
                 logic.   The default  is *YES.   If *NO  is specified,
                 the  file is not checked.   The intent  of this option
                 is to  protect the  user  who thinks  he may  only  be
                 clearing  the records  that are  found  on the  access
                 path.    Because the  command  will clear  all  of the
                 based  on  physical  members,  the  user  must specify
                 *NO, to cause the command to run.




The following TAA Tools must be on your system:

           EDTVAR         Edit variable
           SNDCOMPMSG     Send completion message
           SNDDIAGMSG     Send diagnostic message
           SNDESCMSG      Send escape message


None, the tool is ready to use.

Objects used by the tool

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

   CLRLFM        *CMD                      TAAMBRG        QATTCMD
   TAAMBRGC      *PGM          CLP         TAAMBRGC       QATTCL

Added to TAA Productivity tools April 1, 1995

Home Page Up to Top