


             Execute an EXM program on the fly
                      RUN Version 1.00
             Copyright (C) 1995 Hiroyuki Sekiya



[1] Introduction

  MoreEXM has enabled the addition of limitless number of EXM
  programs.  However, it is still troublesome that you need to
  register a new application.  It would be more convenient, if
  you can prepare a program file and simply run it, as you do
  for a DOS program.  This program RUN.EXE is an utility to
  dynamically add an EXM program and execute it, by using an
  API (application program interface) of MoreEXM.  You do not
  need to add a program to AppManager or to moreexm.ini any
  more.  You can simply enter "RUN (program name)" and it runs.


[2] Hardware/Software requirements

  This program runs on the 100/200LX.  It runs on the DOS
  process under the System Manager, with MoreEXM Version 1.50
  or later loaded.  It does not run on pure DOS process or on
  the DOS process created by MaxDOS.


[3] Installation

  Install MoreEXM first, if not yet, before trying to use
  RUN.EXE. Copy RUN.EXE to a directory defined by PATH
  statement and this is all you should do.  (In this guide, we
  assume that the file is copied to the directory A:\BIN\).


[4] Quick start

  Within System Manager, press [CTRL]+[123] to shell out to DOS
  process.  Then execute RUN.EXE as follows.
          >run a:\exm\gs.exm

  This example launches gs.exm placed in a:\exm directory.


[5] Environment variable

  If you do not like to name the program by its long full
  path, you can specify the directories to hold the EXM
  programs by adding, for example, the following line to
  your autoexec.bat.
          set exmpath=a:\exm;a:\bin

  You can then run programs placed in a:\exm or a:\bin by
  simply entering
          >run gs.exm
  without a directory name.  You can also skip the file
  extension .EXM for running RUN.EXE.  Then what you should
  type in is as simple as:
          >run gs

  If RUN.EXE does not find a program in the directories defined
  by EXMPATH, it also searches directories defined by PATH.

  If RUN.EXE finds the program with the same path in the
  sockets of MoreEXM, it execute the existing program, without
  loading a new one.  Even if you enter "run gs" repeatedly,
  multiple loading of the same program gs.exm is thus avoided.


[6] Start key

  A unique start key should be assigned to a program added to
  MoreEXM.  RUN.EXE assigns an unused key code from 8BFF to
  8CFF, which cannot be generated from the keyboard. You cannot
  return to a program launched by RUN.EXE, by use of task
  switching with a hot key.  Use TaskList instead, or run
  RUN.EXE again.

  If needed, you can explicitly define the start key with '-K'
  option.
          >run -k6fff tasklist
          >run -k8100 gs
  If you assign a keycode, which can be generated from
  keyboard, you can use task switching by a hot key to return
  to a program launched by RUN.EXE.


[7] Tips

  o Use DosLine
    With DosLine, an utility created by Mr.Brahma, you can
    easily run EXM programs from anywhere within System
    Manager.  Dosline closes the DOS process, after running
    RUN.EXE and before launching an EXM program.  This feature
    avoids the memory shortage problem experienced with
    launching from the DOS process created by [CTRL]+[123].

  o Run EXM programs from Filer
    The 200LX has a function to launch an application
    associated with a file extension.  Combined with RUN.EXE,
    you can launch an application by highlighting it within
    Filer and pressing [ENTER].  You need to add the following
    definition to c:\_dat\filer.ini.
          EXM=a:\bin\run.exe %

  o When you do not want to assign a hot key
    When you add a more number of programs to MoreEXM, you have
    more difficulty to find an unused start key (hot key).
    When you do not need a hot key for an EXM program and you
    rarely use task switching with it, you can launch such a
    program by using RUN.EXE.



[] Copyright, disclaimer and distribution policy

  This program is a copyrighted freeware.  Its copyright is
  owned by its author, Hiroyuki Sekiya.  You can freely copy
  and use it for your non-commercial and private use.

  Prior permission from the author is necessary, if you want to
  post it on other information services, web sites, FTP sites,
  or similar locations, or to include it in electronic storage
  media.  Please contact the author by e-mail in such cases.

  The author is in no way responsible for any damages, which
  may be caused by using, or by inability to use, this
  software.


[] History of this software

  This software was originally developed as one of the 9 new
  programs bundled with the book "HP200LX Software Bible",
  co-authored by Hiroyuki Sekiya and Hirotaka Hamada, published
  by Softbank, Tokyo, in April 1996 (ISBN4-89052-911-X).  As
  such, the programs should not be distributed on networks nor
  regarded as freeware.  In short, you needed to buy the book
  to use them.

  Fortunately the book received an enthusiastic acceptance
  within the HP200LX user community in Japan and it reached an
  out-of-print status two years after its publication, in 1998.
  Now that the book is no more available easily, the author of
  these programs decided to release them as copyrighted
  freeware.


[] Contact address of the author

  The author of this program, Hiroyuki Sekiya, can be contacted
  at the following addresses.

  E-Mail:
    hiroyuki.sekiya@nifty.ne.jp
    JBD00432@nifty.ne.jp
    SDI00992@nifty.ne.jp
  WWW:
    http://member.nifty.ne.jp/~sekiya/


                                                Hiroyuki Sekiya



                                Translated from the Japanese by
                                Toshiki Sasabe
                                toshiki@j.email.ne.jp

    Note from the translator:
    This document is a translation of the original Japanese
    document run.txt (included in this package as run.jpn).

