|
 |
|
What EDTSTMF is
The Edit Stream File (EDTSTMF) command starts an editing
program that allows you to create, edit, and format many different
types of
source files or documents. EDTSTMF starts the EZ
editor by default. You can also use this command to start the EMACS editor
by changing the QIBM_PTL_EDITOR environment variable. EZ is an ASCII
based editor, so you can only use it to edit ASCII files or you can use
the convert (CVT) parameter which will convert a file to ASCII before starting
the editor.
Quick Reference:
EDTSTMF
STMF(Stream File Name)
Specifies the fully qualified name of the stream
file to be edited.
fully qualified file name
OPTIONS(Editor options)
Specifies a list of ez or ATK options for the ez
application, for
example -bg tan is the option to set the background
color to tan.
CVT(*YES|*NO)
Specifies whether the file should be converted
to ASCII and copied
to a temporary file. If the file is
modified and saved it will be
converted again and stored back.
*YES
The file will be converted
before starting the editor.
*NO
The file will not
be converted.
FRMCODE(From code page)
If CVT(*YES) is specified, this parameter specifies the
code page to
be used on the ICONV command in PASE for the file to be
converted.
The default value is IBM-037
TOCODE(To code page)
If CVT(*YES) is specified, this parameter specifies the
code page of
the output file that results from the ICONV PASE command.
The default value is IBM-437
TOEXT(Temporary extension)
If CVT(*YES) is specified, this parameter is the extension of
temporary file that is created before the editor is started.
The default value is C
Usage Notes
When the CVT(*YES) parameter is specifed, the converted file is temporarily
stored it your ~/notifs directory. The extension of the temporary
file can be specfied on the TOEXT parameter. The ~/notifs directory
is created by the STRPTL (Start Tools for Developers) command.
If a physical file member is specified by the format /QSYS.LIB/yourlib.lib/yourfile.file/mbr.mbr
and the CVT(*YES) parameter is specified you will likely not see the text
formatted correctly because newlines are not inserted by the iconv conversion
tool. For this type of file you should use the EDTMBR (Edit Member)
command.
Users can specify emacs as the editor to be invoked by setting the
QIBM_PTL_EDITOR or by specfying emacs on the STRPTL or CHGPTLSSNA commands.
Examples
edtstmf '/home/youruserid/preferences'
This command will edit the file preferences that is stored in
your home directory, no conversion will be performed onthe file.
edtstmf '/home/youruserid/ebcidicfile' CVT(*YES)
This command will convert the ebcidicfile using the iconv PASE
command, store it in the ~/notifs directory and start an edit session.
If changes are made the file will be converted back to its original codepage
and stored back in its original location.
Prerequisites
This command requires that PASE option 33 of the Operating System
is installed, that you have run the Start
iSeries Tools (STRPTL) command to initialize your environment
and
that you are running an X Server on your client device.
Related Topics
ez
emacs
|
|
|
|
|
