SoftWoehr MyEditUtil 1.0

User's Manual

Copyright © 2000 by Jack J. Woehr
P. O. Box 51
Golden, Colorado 80402-0051 USA
http://www.softwoehr.com

NO WARRANTY NO GUARANTEE FREE SOFTWARE.

Table of Contents

Introduction

SoftWoehr MyEditUtil (MEU) is a editor coded in Java to remotely edit OS/400 source physical file members. If you do not need to edit OS/400 source physical file members, or do not know what one is, you do not need MEU.

MEU can:

MEU is a piece of free, open-source software which I wrote in my spare time in the hope it would be genuinely useful. MEU is fully functional, but several features intended for MEU are either incomplete or not yet implemented. See the To Do list. The author regrets any inconvenience occasioned by the limitations of MEU,  If enough people use it, we'll work out maintaining and extending MEU.

Advantages of MEU over editing on the server

Disadvantages of MEU compared to editing on server

MEU is "vaguely like SEU" in behavior but vastly different in many aspects

Since the problems of record file text editing have been well understood for decades, the author didn't try excercise much originality in the general behavior of MEU. It behaves like SEU where that was convenient to code and made sense, and behaves differently in arbitrary ways which generally reflect the exigencies of  the project. Since the author doesn't know SEU very well, some of the commands came out more like VM/ESA XEDIT than SEU.

Some of the simliarities and differences between MEU and SEU are noted in the following list:

System Requirements

Lauching MEU

MEU may be lauched immediately loading a file member from the server or without loading a file member. The command line is:
java com.SoftWoehr.JTOpenContrib.MEU.MEU [ -ppropfile_name ] [ -sserver_name ] [ ifs_path_name ]

MEU Properties File

The properties which can be set are listed as defaults in the source file com.SoftWoehr.JTOpenContrib.MEU.MEUProperties .. the ones which it is useful to set are shown as follows with their default values:
 
com.SoftWoehr.JTOpenContrib.MEU.system.server.ifsdirectory / Directory on server from which to start requester widgets.
com.SoftWoehr.JTOpenContrib.MEU.system.server.servername none Name of AS/400 to connect to
com.SoftWoehr.JTOpenContrib.MEU.system.server.user none Username for logins
com.SoftWoehr.JTOpenContrib.MEU.window.cascade.xincrement 20 x-increment by which multiple windows are cascaded.
com.SoftWoehr.JTOpenContrib.MEU.window.cascade.yincrement 20 y-increment by which multiple windows are cascaded.
com.SoftWoehr.JTOpenContrib.MEU.window.color.foreground green Text color.
com.SoftWoehr.JTOpenContrib.MEU.window.color.background black Background color
com.SoftWoehr.JTOpenContrib.MEU.window.open.xlocation 20 Initial x-location of first window.
com.SoftWoehr.JTOpenContrib.MEU.window.open.ylocation 20 Initial y-location of first window.
com.SoftWoehr.JTOpenContrib.MEU.window.edittext.rows 25 Number of rows in display.

The Initial Window

MEU starts with one window. That window has a command line, a text area, a menu bar, and a status bar. Nothing can be done in the text area until a source physical file member  is loaded for editing.

Click to see an image of that window with a file member loaded to edit..

Multiple MEU windows may be opened. When the last window is closed, MEU exits.

Menu Operations

The menu bar at the top of MEU offers many operations. Note that some operations are available at the command line which are not available from the menu.

Each menu operation can be reached by accelerator key sequences as shown in the the following description of available selections:

The Command Line

The command line (not to be confused with line commands, which you type over line numbers)  is at the top of the window.

You may enter a line number into the command line. The editing view will jump to that line.

The command line also understands certain commands:

The Status Bar

Setting the Server

Before anything else useful can be accomplished, the server to which you intend to connect must be set. Use the System menu or the SERVER command to do so. You will be prompted for a password or username and password when a connection is actually made, e.g., when browsing for files or

The Cursor and the Current Line

The current line is the one the cursor is on. This matters for many commands. There is no other indication of the current line other than the cursor position.

If the cursor is in the command line, press F10 to hop down into the edit buffer. Press F10 again to hop back up to the command line.
 

Editing

You can move the cursor around with the mouse or the arrow keys and edit text. When you hit ENTER or perform most commands, line commands, or special keys, MEU updates its records and the member becomes CHANGED as shown in the status bar at the bottom.

Text entry can be undone by the ESC key until an action key is pressed. Action keys cause recent text entry to become permanent, that is, MEU is like a terminal and no typing is really recorded until one of the following events occur:

Special keys

The following keys are special; some are also action keys:

Line Commands

You may overtype the line number at the left of each edit line. If you enter a number, the view will jump to that line number.

Additionall, the following line commands can be entered anywhere in the line number area:

To Do

The following features of MEU are either missing or incomplete in this release:

Bugs

Report bugs to bugs@softwoehr.com

Fairmount, Colorado
September 15, 2000