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