TAA Tools
CLRSTMF         CLEAR STREAM FILE                      TAAIFTJ

The Clear  Stream File command clears  a stream file  in the IFS.   The
IFS  entry will still  exist, but the  size of the  entry will be  0 as
seen  by  the WRKLNK  display of  attributes for  the  entry.   The TAA
RTVIFSED command will also return a 0 value for the size.

A typical command would be:

             CLRSTMF        /HOME/USER/XXX.FILE

If the  stream file  name starts  with a  '/',  the full  path must  be
entered.

If the stream file  name does not start with a '/',  the user must have
a  current  directory  and the  stream  file name  is  appended  to the
current directory such as:

             CLRSTMF        XXX.FILE

Home Directory and Current Directory
------------------------------------

The user profile  HOMEDIR parameter identifies a  home directory if  it
exists.

When signon occurs,  the system uses the user profile  HOMEDIR value to
help  set  the  current  directory.    The  current  directory  may  be
displayed using the DSPCURDIR  command.  The  current directory may  be
changed with the CHGCURDIR command.

Any changes  to the HOMEDIR  value will not  take place in  the current
job.  You must signoff and signon after making a change.

To check your current directory, enter

             WRKLNK

You should see the objects in your home directory if any exist.

There are  a few cases where  the HOMEDIR value cannot be  used and the
system will set the current directory to '/home'.

  **   If  the  home  directory  does  not exist.    To  create  a home
       directory, use the MKDIR command.  A typical command would be:

             MKDIR         DIR('/home/xxx')

where xxx is the name of your user profile.

  **   If  the  directory is  specified  as  LNKTYPE(*SYMBOLIC).    The
       simplest  solution is  to delete  or rename  this  directory and
       use the MKDIR command described earlier.

Authority required
------------------

You must have *RX authority to the directories in the path.

You must have *WX authority to the stream file.

CLRSTMF escape messages you can monitor for
-------------------------------------------

      TAA9891    Not authorized to write to the stream file.

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

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

   STMF          The  object name to be  cleared.  It must  be a stream
                 file.  Up to 5000 bytes may be entered.

                 If the  object  name begins  with  a '/',  the  stream
                 file name must be entered.

                 If the  object name  does not  begin with  a '/',  the
                 user  must  have a  current directory  and  the stream
                 file name is appended to the current directory.

                 The typical method  of setting  the current  directory
                 is to  have a user  profile HOMEDIR  entry and a  home
                 directory.    See  the  previous discussion  of  'Home
                 Directory and Current Directory'.

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

None.

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

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CLRSTMF       *CMD                   TAAIFTJ       QATTCMD
   TAAIFTJC      *PGM       CLP         TAAIFTJC      QATTCL
   TAAIFTJR      *PGM       RPGLE       TAAIFTJR      QATTRPG
					

Added to TAA Productivity tools December 1, 2004


Home Page Up to Top