home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Mega Top 1
/
os2_top1.zip
/
os2_top1
/
DEMO
/
PM2YOU21
/
OS2YOU.ZOO
/
os2you.inf
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-01-31
|
431KB
|
2,630 lines
ΓòÉΓòÉΓòÉ 1. Ordering information ΓòÉΓòÉΓòÉ
Ordering information
This program is released as shareware. This means that you have the software
for a trial period, and after a reasonable evaluation time, you register the
product by paying a fee to the author, if you find the program of use. Some
limitations on how you can use this program exists (see the License agreement
for more about this). By registering this product you support the further
development of this program.
You will get the following benefits if you register:
o You will get the most recent versions of the programs.
o You will get a hardcopy manual.
o You will get support through mail, voice, fax, email and BBS (non commercial
licenses only supported through email, voice and BBS).
o You will get rid of the introduction screen with the delay, when logging on
to the host.
o You will be sleeping good tonight, without any bad conscience haunting you...
Use the order form below to order:
Date: ___________
FROM: TO:
Name: ____________________________________ Ridax programutveckling
Kransen 4E
Company: _________________________________ S-416 72 Gothenburg
Sweden
Address: _________________________________
City, State; _____________________________
Fax number: ______________________________
Sales tax info number: ____________________________________
(for EU countries only)
Specification Amount Price Sum
========================================= ====== ===== ===========
PM2You/OS2You software ______ 2000 __________
OS2You software ______ 700 __________
OS2You/M2Zmodem file transfer option ______ 300 __________
FAX2You fax receive option ______ 300 __________
WinTerm Windows 3.0 terminal program ______ 300 __________
Total SEK __________
OS2You is included in all PM2You packages. All prices are in SEK
(Swedish crown) and exclude sales tax. For countries within the
EU you should specify your sales tax information number, or we
will add 25% sales tax to your order. For orders from Sweden
a 25% sales tax will always be added. For other countries no
sales tax will be added.
One USD is about 7.45 SEK. We accept most credit cards,
company checks, purchase orders, money orders and SWIFT transfers.
If you pay with VISA, AmEx or MasterCard please fill in the
following:
Cardholders name: ________________________________________
Cardholders address: _____________________________________
Card number: _____________________________________________
Card validy until: _______________________________________
Signature: _______________________________________________
Send or FAX a copy of this invoice to:
Ridax programutveckling
Kransen 4E
S-416 72 Gothenburg
Sweden
Fax: +46 31 196417
Phone: +46 31 196074 or +46 705 955612
Compuserve: 100114,3127
Internet: d9mikael@dtek.chalmers.se
You can also register via CompuServe in forum SWREG and use
registration ID 767. You will be billed by CompuServe.
Date: ___________
ΓòÉΓòÉΓòÉ 2. License agreement ΓòÉΓòÉΓòÉ
License agreement
This is a legal agreement between you (either an individual or an entity) and
Ridax programutveckling, a Sweden company ("Ridax"). By using the software you
are agreeing to be bound by the terms of this agreement.
GRANT OF LICENSE This License Agreement permits you to use one
copy of the enclosed Ridax software program (the
"SOFTWARE") on a single computer. The SOFTWARE
is in "use" on a computer when it is loaded into
temporary memory (i.e. RAM) or installed into
permanent memory (e.g. hard disk or other storage
device) of that computer.
COPYRIGHT The SOFTWARE is owned by Ridax and is protected
by copyright laws and international treaty
provisions and all other applicable national
laws. Therefore, you must treat the SOFTWARE
like any other copyrighted material except that
you may either a) make one copy of the SOFTWARE
solely for backup or archival purposes, or b)
transfer the SOFTWARE to a single hard disk
provided you keep the original solely for backup
or archival purpose. You may not copy the user
documentation provided with the SOFTWARE.
OTHER RESTRICTIONS You may not rent or lease the SOFTWARE. You may
not reverse engineer, decompile, or disassemble
the SOFTWARE.
LIMITED WARRANTY Ridax warrants that a) the SOFTWARE will perform
substantially in accordance with the accompanying
written materials for a period of ninety (90)
days from the date of receipt. Any implied
warranties on the SOFTWARE is limited to ninety
(90) days.
CUSTOMER REMEDIES Ridax's and its suppliers' entire liability and
your exclusive remedy shall be, at Ridax's
option, either a) return of the price paid, or b)
repair or replacement of the SOFTWARE that does
not meet Ridax's Limited Warranty and which is
returned to Ridax or its suppliers with a copy OF
your receipt. The Limited Warranty is void if
failure of the SOFTWARE resulted from accident,
abuse, or misapplication. Any replacement
SOFTWARE will be warranted for the remainder of
the original warranty period or thirty (30) days,
whichever is longer.
NO OTHER WARRANTIES To the maximum extent permitted by law, Ridax
disclaims all warranties, either expressed or
implied, including but not limited to implied
warranties of merchantibility and fitness for a
particular purpose and any warranty against
infringement, with regard to the SOFTWARE and any
accompanying written materials.
NO LIABILITY FOR CONSEQUENTIAL DAMAGESTo the maximum extent permitted by
applicable law, in no event shall Ridax or its
suppliers be liable for any damages whatsoever
(including, without limitation, damages for loss
of business profits, business interruption, loss
of business information, or other pecuniary loss)
arising out of the use of or inability to use the
SOFTWARE, even if Ridax has been advised of the
possibility of such damages.
OS2You, PM2You, FAX2You and Terminal/2 are copyright (c) 1994 by Ridax
programutveckling, all rights reserved.
Ridax programutveckling
Mikael Wahlgren
Kransen 4E
416 72 Gothenburg
Sweden
Phone: +46 31 196074 or +46 10 6673880
Fax: +46 31 196417
BBS: +46 31 196406
Internet: d9mikael@dtek.chalmers.se
Fidonet: Mikael Wahlgren 2:203/302.5
CompuServe: 100114,3127
ΓòÉΓòÉΓòÉ 3. 1. Introduction ΓòÉΓòÉΓòÉ
1. Introduction
Thank you for purchasing the OS2You/PM2You remote control products from Ridax
software development. We hope that you will be satisfied with the products and
please feel free to contact us if there are any questions. Please notice that
the best time to phone is between 10.00 and 21.00 GMT. Note that we have a
Bulletin Board System (BBS, see the sheet for phone numbers) where you can
always download the most recent version of the OS2You products.
With the OS2You remote control software from Ridax software development you
can remote control another computer running with the operating system OS/2
version 1.1 or later (including OS/2 2.x and OS/2 WARP 3.x) with a dial-up
modem connection OR a network (LAN), and you can run OS/2 or DOS character mode
programs and WITH PM2You also OS/2 Presentation Manager programs. OS2You
supports several communication devices and protocols like serial communication,
ISDN, Named Pipes, X.25, TCP/IP sockets, SPX and APPC. Below is a connectivity
chart to describe how OS2You can be used:
OS2You is built around several separate parts that work together and you
license the parts you need. OS2You is used as a name for all products but also
for one of the parts below. The following products are available:
OS2You Remote Access Facility is the basic part that enables you to
remote control OS/2 and DOS character
mode programs.
PM2You Remote Access Facility includes OS2You and does everything
that OS2You does, but also enables you
to remote control OS/2 Presentation
Manager (PM) programs.
WinTerm Windows client is a terminal client that will allow
you to remote control OS/2 character
mode and Presentation Manager sessions
from Windows in combination with OS2You
and PM2You. An OS/2 PM terminal client
is included in the base packages.
M2Zmodem file transfer option allows you to do file transfers between
a host with OS2You/PM2You and a
terminal.
FAX2You fax receive option lets OS2You/PM2You accept both incoming
data and fax calls with a faxmodem and
if a fax call is detected the fax is
received and printed.
The included program diskette contains the programs that you have licensed,
but may also include demonstration versions of the other parts. The
demonstration versions are only intended for short evaluations and must not be
used on a regular basis.
This manual will use the words host to indicate the computer that is remote
controlled and client or terminal to indicate the computer that you remote
control from.
ΓòÉΓòÉΓòÉ 4. 2. Installation ΓòÉΓòÉΓòÉ
2. Installation
To install OS2You at the host computer you do the following:
1 Insert the diskette in drive A and type A:INSTALL in an OS/2 command
session.
2 Enter A: when the computer asks for the Source path. This specifies where
the program files are. The installation program will list the products
you have licensed.
3 Enter something like C:\OS2You when you are asked for the Target path.
This specifies where the program should be installed.
4 If the directory specified in paragraph 3 above does not exist, you should
respond Y, when asked if you want to Create directory, to specify that the
directory should be created.
5 The installation program will ask what parts to install. At the host
computer you only need the PM2You part (this automatically includes
OS2You). The installation program will begin copying from diskette onto
the hard drive and write a status report on screen.
6 When the programs are copied to the hard drive, you will be asked if the
system configuration file (CONFIG.SYS) should be updated. If you are not
absolutely sure that this is not the fact, you should respond Y to this
question. A copy of the old CONFIG.SYS will be saved with the name
CONFIG.OLD.
7 A program folder will be created now (see below) and the OS2You
configuration program will be started. See further chapter 3 about
configuring OS2You. After the configuration is completed you will have to
reboot the machine this first time to activate the changes in CONFIG.SYS.
This is not needed in the future if you change the configuration.
Exactly what program objects are created in the folder depends on what parts
you have chosen to install. OS2You Reference and PM2You Reference are the
on-line manuals. OS2You Setup is the configuration program for OS2You and
OS2You Host Server will put the machine into host mode waiting for a call.
Terminal/2 is the client program for OS/2 Presentation Manager.
ΓòÉΓòÉΓòÉ 5. 3. Configuration ΓòÉΓòÉΓòÉ
3. Configuration
The configuration program is automatically started during installation. The
program can also be started by double clicking with the mouse at the program
icon OS2You Setup.
ΓòÉΓòÉΓòÉ 5.1. 3.1 Device settings ΓòÉΓòÉΓòÉ
3.1 Device settings
Select the menu choice Settings and then Device. The following dialogue to
configure the communication device will be displayed:
Field Explanation
Device name Specifies what communication device to use for OS2You.
This can be an asynchronous port like COM1 or COM3 but
also a pipe name like \Pipe\OS2You. You can enter any
name or choose from in the list. If another device
than an asynchronous port is used a pipe name must be
specified (like \Pipe\OS2You).
Modem Here you specify what modem or communications protocol
you use. If the list does not contain your modem,
don't change this entry before you have created a
suitable modem configuration profile with the menu
choice Profiles/Modems.
Databits This setting is only relevant for asynchronous
devices. It indicates how many databits to use for
communication. This should in most cases be set to 8
(for PM2You this must be set at 8).
Stopbits This setting is only relevant for asynchronous
devices. It indicates how many stopbits to use for
communication. This should in most cases be set to 1.
Parity This setting is only relevant for asynchronous
devices. It indicates whether parity checking should
be enabled for the communication. This should in most
cases be set to None.
FIFO Buffer This setting is only relevant for asynchronous
devices. It indicates whether FIFO buffering (also
referred to as extended hardware buffering) should be
enabled for devices that support this. This should in
most cases be set to Enable. Note that this parameter
can be set to Enable even if your hardware does not
support buffering. This is automatically detected by
the software and you only need to Disable this
parameter if you encounter some kind of problem with
the buffering.
ΓòÉΓòÉΓòÉ 5.2. 3.2 OS2You settings ΓòÉΓòÉΓòÉ
3.2 OS2You settings
The menu choice Settings followed by OS2You lets you configure some parameters
related to the operation of OS2You. Note that these parameters in most cases
are only valid for OS2You and not when running PM2You. The following dialogue
will be displayed:
Field Explanation
Re-Initialize... This setting indicates how frequently OS2You should
re-initialize the modem. If the modem suffers from a
power failure or for some other reasons, a modem can
lose its configuration. This would prevent OS2You
from working, if OS2You doesn't re-initialize the
modem now and then. The recommended setting for this
parameter is 15 minutes. To disable this feature, set
this parameter to 0 (zero). This parameter is only
significant for modem connections.
Inactivity timeout This parameter decides how many seconds a user can be
inactive (not doing any keyboard input) before being
logged off by OS2You. To disable this feature set
this parameter to 0 (zero).
Screen update... This parameter specifies how long OS2You will wait
after a screen update, before trying to do the next.
This is to prevent OS2You from claiming too much power
from the computer, preventing other programs from
running. A lower value increases responsiveness but
also increases the CPU load. A recommended value for
most applications is 100 ms.
Cursor update... This parameter specifies how long OS2You will wait
after a cursor update, before trying to do the next.
This parameter is only significant when you are
running a session through the Task Switcher. If you
don't switch sessions, cursor updates will be as
frequent as all other updates. When the cursor is
updated when running a session through the Task
Switcher, OS2You has to "flash" the screen for a short
period. Doing this too often, will yield a
"flickering" impression at the host. Thus a
recommended setting is 5000 ms but you can decrease
this value in case the screen flickering doesn't
bother you.
Execution priority This parameter specifies what CPU priority the screen
updating logic in OS2You will have. Normally this
parameter shouldn't need any modification, but some
programs set their privilege so high, that OS2You
won't get any attention from the CPU at all. If you
notice that screen updates are abnormally slow you
could try to increase this setting a little (in some
cases it also helps to decrease this setting).
Detect carrier loss This parameter specifies whether carrier loss should
be detected or not. When a modem connection is
interrupted, the modem will signal this to the
computer. If this setting is enabled, OS2You will
return to host mode if this happens. This setting is
only significant for asynchronous devices, as OS2You
always return to host mode if any networking
connection or similar is interrupted. If you use an
asynchronous cable, you might have to disable this
setting, depending on how the cable is constructed.
Lock config... This parameter specifies whether the configuration
file should be locked when a user logs in or not. As
the configuration file contains the user ID's and
passwords, OS2You can lock this file from access when
a user is logged in. You might want not to lock the
file, in case your users are reliable and you want to
be able to change configuration yourself during a
remote login.
Printer port This parameter specifies which printer port to
redirect to the remote terminal. Note that this
parameter works in combination with the next one.
Printer redirection This parameter specifies how printer port redirection
is performed. If it is set to Local no redirection is
performed at all. If set to Remote all printer output
directed towards the device specified in the field
above, will be redirected to the remote terminal. If
set to Both, printer output will be directed both to
the local printer and the remote terminal.
Port request pipe This parameter specifies which name to use for the
port request pipe. This is a way for other programs
to give commands to OS2You to perform certain actions.
You shouldn't normally need to change this parameter.
Show file at login This parameter specifies which file to show to the
caller before logging in. You may leave this field
empty, meaning that no file will be displayed. If you
specify a filename this is normally a text file that
could describe your system and instructions for
logging in (this file is displayed before the user is
prompted for user ID and password).
Log file This parameter specifies which file to use for logging
certain events in OS2You (like logins and logouts).
The log file will be limited in size to 100 kb. When
the log file is 100 kb large, logging will restart at
the beginning of the file again.
ΓòÉΓòÉΓòÉ 5.3. 3.3 PM2You settings ΓòÉΓòÉΓòÉ
3.3 PM2You settings
The menu choice Settings and then PM2You is used to configure certain
parameters in PM2You. These parameters are only valid when running PM2You and
are not significant when running OS2You. The PM2You configuration is stored in
a separate file called PM2YOU.CFG. These settings are stored directly when you
exit the PM2You configuration. The following dialogue is displayed:
Field Explanation
Compression These settings specify what compression algorithms to
use. It is too complicated to describe these
algorithms in detail, instead some indications on how
to use these settings are given. The rule is that
high communication speeds need less compression while
low communication speeds need high compression. As it
takes time to do the compression calculations, some
algorithms will in most cases waste time if the
communication speed is high. The Fx(0) compression
should usually be enabled. The Rep(1) compression
should be enabled if the host screen often contains
vertical patterns. The Zp(3) compression should
usually be enabled. It will decrease the over all
data volumes needed to be sent. The ZpH(4)
compression should usually be disabled. It is similar
to the Zp(3), only a little more efficient, but takes
significantly more time. The Dither(5) compression
should be enabled if the host screen contains large
areas of dithered colours (dithered colours are
patterns of other colours to build different colours).
SCA compression is a special method that greatly
increase performance, but is only available with some
display drivers (like VGA and XGA). However PM2You
will in most cases automatically detect if this
capability is not available, thus this setting should
be always enabled, except if you experience any
problems (if PM2You can't be started). In most cases
the most correct setting is to enable Fx(0), Zp(3) and
SCA compression and disable all other compressions.
If you are using LAN connections you might experiment
by disabling Zp(3) and if you are running very slow
modem connections (2400 bps) you might try to enable
the other compression algorithms.
Priority This parameter specifies what CPU priority PM2You will
have. Normally this parameter should be set to Normal
but if you notice that screen updates are abnormally
slow change this parameter to Time Critical.
Keyboard input This parameter specifies which method PM2You uses to
emulate mouse and keyboard input. This parameter
should normally be set to WM_CHAR msg for best
performance. If you have any problems with keys that
do not work properly in PM applications, you could try
to set this parameter to System Queue instead.
WinKey This parameter specifies which method PM2You uses to
emulate keystrokes in a seamless Windows (WINOS2)
session. The WinKey method allows better keyboard
emulation, but requires that you copy the files
WINLOAD.EXE and WINKEY.EXE to your Windows directory
(like C:\OS2\MDOS\WINOS2) and edit the file SYSTEM.INI
in the same directory to replace the line
"os2shield=winsheld.exe" with "os2shield=winload.exe".
Only mirror act... If this parameter is enabled PM2You will only send
screen updates that belong to the application
currently active (example: if the System Clock is in
focus, only the System Clock updates will be
transmitted and the rest of the screen is ignored).
If this parameter is disabled PM2You will ensure that
the screen is always updated.
Screen update... This parameter specifies for how long PM2You will wait
after a complete screen update before trying to send
the next. This is to prevent PM2You from claiming too
much of the CPU power. Recommended setting is 1000 ms
but could be decreased for improved responsiveness
from PM2You or increased to lower the CPU load.
Maximum block size This parameter specifies the maximum size that the
communication link can handle. This setting should in
most cases be set to its default (and maximum) value
at 65535. Only in some situations (especially when
using NetBIOS) you should change this value if you
experience problems (like getting disconnect when
starting PM2You) to something like 16384 or 8192.
Lowering this value will decrease performance.
PM2You version This parameter specifies if the 32-bit version or the
16-bit version of PM2You should be used. The 32-bit
version should be a little bit faster, but can only be
run with OS/2 2.x/3.x or compatible, while the 16-bit
version can be run on OS/2 1.x/2.x/3.x. The
recommended setting is to let PM2You autodetect which
version to use. In this case PM2You will use the
32-bit version if OS/2 is capable of running it,
otherwise it will start the 16-bit version.
In some situations you may want to remote control only part of the host
desktop. In that case you can add the following lines to your CONFIG.SYS file
(example):
SET PM2YOU_XLEFT=0
SET PM2YOU_XWIDTH=320
SET PM2YOU_YBOTTOM=0
SET PM2YOU_YHEIGHT=240
This will configure PM2You to only mirror the lower left screen area. The
values are specified in pixel units. You can also set these values locally in
a session when you start OS2You or PM2You, and this way have several PM2You
sessions running concurrently mirroring different parts of the host screen.
ΓòÉΓòÉΓòÉ 5.4. 3.4 Creating user entries ΓòÉΓòÉΓòÉ
3.4 Creating user entries
The menu selection Profiles and then Users is used to create user entries. It
looks like this:
Field Explanation
Name Specifies the user name (when the user logs in a user
name and password must be entered).
Password This field specifies the password. If this field is
blank, any password (including none at all) will be
accepted when logging in.
Callback number If a phone number is specified in this field, OS2You
will break the connection after the user has specified
the user name and password and call back the specified
number. This is useful to increase security and/or
manage phone costs. This entry is only significant
for dial-up modem connections.
Shell command Specifies which program or command to start when a
user logs in. Mostly you use CMD.EXE to get an OS/2
command prompt, but you may also specify any OS/2
character mode program. If you want to start a
CMD-file you do this by specifying something like
CMD.EXE /C MyCMD. By specifying PM.EXE you will get
the PM Desktop directly after logging in by using
PM2You.
Startup session Specifies what session name automatically to switch to
when the user logs in. If specified, this must
exactly match a name in the Task List of an OS/2 Full
Screen session or a DOS session. In most cases this
field is left blank to avoid switching in order to let
the user get the output of the program that was
started as above.
Terminal def... Specifies what terminal the user has. If this field
is left blank an ANSI-terminal, that works with all
included terminal programs, will be assumed.
By pressing the Privilege button you can assign different privileges to the
users. You will get a new dialogue that looks like this:
Field Explanation
Task Switch Specifies that the user is allowed to switch between
different active sessions in OS2You (this parameter is
not used when in PM2You mode).
Local keyboard This feature is not implemented yet. It specifies
that the keyboard at the host is active at the same
time as the user is logged in. At this time both host
and client keyboard are active concurrently.
Upload Specifies that the user is allowed to send files to
the host. This setting only prevents the use of the
built in file transfer mechanism and not external file
transfer protocols like M2Zmodem.
Download Specifies that the user is allowed to receive files
from the host. See above.
Reboot Specifies that the user may request reboot of the
machine.
Protected files list Allows you to read/write protected files. See
separate section about this.
Manual access... Specifies that the user must get approval from an
operator at the host computer before the login is
accepted.
ΓòÉΓòÉΓòÉ 5.5. 3.5 Modem configuration ΓòÉΓòÉΓòÉ
3.5 Modem configuration
OS2You includes modem configurations for several well-known modem brands. For
other modems you can easily create or customize an existing profile to make
OS2You work with another modem. By selecting the menu choice Profiles and then
Modems you will get the following dialogue:
Field Explanation
Description Name of the modem.
Initializing string Modem command (see below) sent to the modem to
initialize it. This command should put the modem into
auto answer mode.
Dial cmd prefix Modem command (see below) sent to the modem to start a
dialling. A complete dial sequence is composed by the
prefix + phone number + suffix.
Dial cmd suffix Modem command (see below) sent to the modem to end a
dialling.
Auto answer off Modem command (see below) sent to the modem to turn
off auto answer mode.
Auto answer answ. Modem command (see below) sent to the modem to answer
an incoming call.
Hang up string Modem command (see below) sent to the modem to
disconnect.
Shutdown string Modem command (see below) sent to the modem when the
program terminates.
Ring string Text string sent by the modem when an incoming call is
detected. This text string is pattern matched with
the response from the modem and if the string is
received the Auto answer answ. string is sent to the
modem, if the Active answer parameter is activated
(see below).
Active answer Indicates that OS2You should actively answer incoming
calls by monitoring modem responses and send an answer
command to the modem when a call is detected.
Slow init. Some modems can't handle modem commands in full speed.
If this parameter is activated modem commands will be
sent with a delay between each character.
Connect string 1-6 Text string sent by the modem when a connection is
established with the speed specified by Baud rate
1-6. These text strings are pattern matched with the
response from the modem. It is recommended to
configure modern high speed modems for a fixed rate
between computer and modem, not related to the actual
connection rate. In that case you only specify one
Connect string that matches every speed. The fields
that are not needed (few modems have 6 speeds) should
be left blank. If you don't know what message is sent
by the modem youcould: A) Insert the line DEBUG=ON i
CONFIG.SYS and reboot the computer. B) Start OS2You
in host mode. C) Do a connection attempt.
Disconnect. D) Look in the log file and see what
message is logged.
Baud rate 1-6 Communication speed as above. The modem is always
initialized with the speed specified by Baud rate 1
and therefore this should be the highest speed that
the modem accepts.
Fax connect string Text string sent by the modem when a connection is
established with a fax machine. When this message is
sent by the modem, OS2You will start the Fax command
line (see below) that should start an external fax
program to receive faxes (in most cases FAX2You, not
included). Note that you also can use DOS fax
programs. This field is only meaningful when you have
a fax modem. Otherwise it should be left blank (for
more information about configuring OS2You to receive
faxes see section 6).
Release fax device This indicates that the communications port to which
the fax modem is connected should be closed (released)
by OS2You before the FAX command is started. Most fax
programs must open the communication port on their
own, and can not share it with OS2You.
Fax command line This indicates what command to use to start when a fax
call is detected, to receive a fax. In this command
string you can use the symbolic parameters "%%" (is
interpreted as a single "%" sign), "%1" (port handle,
decimal), "%2" (port handle, hex), "%3" (device name,
like COM1), "%4" (device number like 1, for COM1). An
example command line: "FAX2You.EXE -l %%%1 -connected
-print -pcl".
CTS/RTS Specifies that the computer should use CTS/RTS
hardware handshaking.
Xon/Xoff Specifies that the computer should use Xon/Xoff
software handshaking. This must not be activated if
you want to use PM2You.
The following characters are interpreted specially in modem commands:
Character Explanation
^ (5E hex, 94 dec) CR
~ (7E hex, 126 dec) 1 second delay
> (F2 hex, 242 dec) Set DTR low (note the decimal code, it is not the
greater-than sign)
< (F3 hex, 243 dec) Set DTR high (note the decimal code, it is not the
less-than sign)
; (3B hex, 59 dec) Begin comment
To type these characters you can do the following:
1 Press and hold the ALT key down.
2 Type the decimal code of the character (like 2-4-2) with the numeric part
of the keyboard.
3 Release the ALT key. The character should now be displayed on the screen.
ΓòÉΓòÉΓòÉ 5.6. 3.6 Named Pipe configuration ΓòÉΓòÉΓòÉ
3.6 Named Pipe configuration
Named Pipe is a high level communication interface that is available for most
LANs. The implementation between different networks differ in features. In
Novell Netware the Named Pipe support is installed as an option and allows
OS2You to be installed on any OS/2 requester. In MS Lan Manager the Named Pipe
support is standard and allow OS2You to be installed on any OS/2 requester or
server. In IBM Lan Server 2.0 or earlier the Named Pipe support is standard
but only allows OS2You to be installed on servers. In IBM Lan Server 3.0 the
Named Pipe support is standard but to allow OS2You to be installed on OS/2
requesters you have to install the Peer-service on that machine and share the
IPC$ device. The following is a configuration chart for Named Pipes:
By selecting the MultiCast Named Pipe driver you can also connect multiple
workstations to the same OS2You session. All workstations will be able to both
monitor and control the remote session. To the terminal programs the
connection will look as an ordinary named pipe connection, and should be
configured for this. This driver only works with OS2You (character mode) and
not for PM2You (graphics mode).
To configure OS2You for Named Pipe connections you should go into the
Settings/Device dialogue (see section 3.1) and specify a pipe name in the
Device name field and select the Named Pipe profiles in the Modem field.
ΓòÉΓòÉΓòÉ 5.7. 3.7 NetBIOS configuration ΓòÉΓòÉΓòÉ
3.7 NetBIOS configuration
NetBIOS is a high level communication protocol that is available for most LANs
and some WANs (Wide area networks). It is available from many vendors, for
many operating systems and different hardware. The following is a
configuration chart for NetBIOS:
To configure OS2You for NetBIOS connections you should first go into the
Settings/Device dialogue (see section 3.1) and specify a pipe name in the
Device name field and select one of the NetBIOS profiles in the Modem field.
The configuration procedure is identical regardless of which NetBIOS driver you
select. NB30/ACSNETB is used mainly with some IBM software configurations
while Submit/NETAPI is used mainly by other vendors. When the Settings/Device
is completed, select Profiles and then Modems in the menu. Highlight the
NetBIOS driver (if not already highlighted) and select the Change button. You
should get the following dialogue:
Field Explanation
LAN adapter If you have two LAN adapters, you can choose which one
to use for OS2You. If you only have one, you should
set this parameter to Primary.
Host name This specifies the NetBIOS name that identifies OS2You
over the network.
Allow slave term... If this parameter is enabled you can connect several
clients to OS2You and get the screen output directed
to all of them in a classroom like configuration.
Only the first terminal that connects to OS2You can
control OS2You. If you do not plan to run OS2You with
slave terminals, you should disable this parameter to
save network bandwidth. Slave terminals only work
with OS2You and not with PM2You.
Slave terminal... This specifies the NetBIOS name that identifies the
slave terminals over the network.
ΓòÉΓòÉΓòÉ 5.8. 3.8 Mailslot configuration ΓòÉΓòÉΓòÉ
3.8 Mailslot configuration
Mailslot is a high level communication protocol that is available for OS/2
LANs. Mailslots supports many-to-many operation. To configure OS2You for
Mailslot connections you should first go into the Settings/Device dialogue (see
section 3.1) and specify a pipe name in the Device name field and select the
Mailslot profiles in the Modem field. When the Settings/Device is completed,
select Profiles and then Modems in the menu. Highlight the Mailslot driver (if
not already highlighted) and select the Change button. You should get the
following dialogue:
Field Explanation
Host mailslot This is the name of the mailslot that identifies
OS2You over the network. This is at the client
combined with the machine name of the host. A correct
mailslot name is formed like \Mailslot\OS2You.
Terminal mailslot This is the name of the mailslot that identifies the
OS2You clients over the network. This name should
include the machine name of the client. The machine
name can also be replaced with an asterisk * to
indicate that OS2You should be available from all
machines and that output is sent to everyone that is
connected with a client. A correct name is formed
like \\Name\Mailslot\Terminal or
\\*\Mailslot\Terminal.
ΓòÉΓòÉΓòÉ 5.9. 3.9 SPX and TCP/IP configuration ΓòÉΓòÉΓòÉ
3.9 SPX and TCP/IP configuration
SPX is a network communication protocol used mainly in Novell Netware
configurations. TCP/IP is a highly standardized transport protocol for WANs
(Wide Area Networks). There are two different TCP/IP support drivers available
for OS2You, one based on IBM's socket implementation and the other based on FTP
Software's PC/TCP socket implementation. Compatibility with other TCP/IP
implementations is not assured. The following is a configuration chart for SPX
or TCP/IP:
The configuration procedures for SPX and TCP/IP are identical. To configure
OS2You for SPX or TCP/IP connections you should first go into the
Settings/Device dialogue (see section 3.1) and specify a pipe name in the
Device name field and select the SPX or TCP/IP profiles in the Modem field.
When the Settings/Device is completed, select Profiles and then Modems in the
menu. Highlight the SPX or TCP/IP driver (if not already highlighted) and
select the Change button. You should get the following dialogue:
Field Explanation
Socket number This indicates which socket number OS2You is known by
over the network. This number should be unique and
selected to identify OS2You. The default value is set
at 7787.
ΓòÉΓòÉΓòÉ 5.10. 3.10 Read/Write protecting files ΓòÉΓòÉΓòÉ
3.10 Read/Write protecting files
By selecting Profiles and then Protected files in the menu, you can create and
modify protected files lists. These files could be assigned to a user in the
Profiles/Users configuration ( see section 3.4 ). Following is an example of a
protected files list:
C:\CONFIG.SYS /RW ; Read/Write protection
C:\OS2\*.* /W /S ; Write protection including sub-directories.
C:\IN\*.* /R /S ; Read protection including sub-directories.
Note, however, that only files that exist when the user logs in are protected.
Files that are created when the user is on-line are not protected. The file
locking is global, meaning that if a file is Read/Write protected by OS2You, it
can't be accessed by any other program/process running in OS/2 concurrently.
Protecting a large number of files will take quite some time, which will delay
the logon for the user.
ΓòÉΓòÉΓòÉ 6. 4 OS2You users manual ΓòÉΓòÉΓòÉ
4 OS2You users manual
OS2You allows you to remote control almost any OS/2 or DOS character mode
program. OS2You handles many different communication links like async. dial-up
modems, Named Pipes, NetBIOS, TCP/IP, APPC and SPX. You can connect almost any
terminal or terminal program to OS2You through async. dial-up lines, but there
are also special terminal programs included with OS2You (Terminal/2 for OS/2
and WinTerm (optional) for Windows).
ΓòÉΓòÉΓòÉ 6.1. 4.1 Starting OS2You ΓòÉΓòÉΓòÉ
4.1 Starting OS2You
To start OS2You is host mode, waiting for a call, you may double click at the
program icon called OS2You Host Server. If you want OS2You to start
automatically when the computer starts, you can create a shadow of the object
in the AutoStart folder (valid for OS/2 2.x). You may also change/create the
STARTUP.CMD file with the commands:
CD \OS2You
START /FS OS2You -c OS2You.CFG
EXIT
When OS2You is started in host mode, the following character mode screen
should appear:
ΓòÉΓòÉΓòÉ 6.2. 4.2 Terminating OS2You ΓòÉΓòÉΓòÉ
4.2 Terminating OS2You
To exit from an OS2You on-line session, you enter the command EXIT at the OS/2
command prompt or if a program was started directly by OS2You, you terminate
that program and OS2You will automatically end the session.
ΓòÉΓòÉΓòÉ 6.3. 4.3 Terminal emulation ΓòÉΓòÉΓòÉ
4.3 Terminal emulation
To access the remote OS2You machine over an asynchronous line (cable or
modem), you will need a terminal emulation program (or a terminal), with one of
the terminal emulation modes supported by OS2You. It doesn't matter which
operating system your terminal emulator is running.
There are terminal emulators included in the package for DOS, Windows
(optional), OS/2 character mode and OS/2 Presentation Manager. These emulators
will map the keyboard better than many other terminal emulators, as they are
specially designed for OS2You. If you use a public terminal program from
another vendor, you should first look for a terminal program that supports
Doorway keyboard mode. This will ensure that the keyboard mapping is correct
with OS2You. Otherwise, if you use a terminal or a terminal program that does
not support Doorway mode, you will have to emulate some keystroke combinations
by pressing first the Esc command key and then another key.
The following terminals are currently supported by OS2You (ANSI is default if
none selected).
Terminal Description file
ANSI/VT100/VT102 ANSI.PRM (not same as default)
Hazeltine 1500 HAZEL.PRM (not tested)
IBM3101 IBM3101.PRM
Tandberg TDV2116 TANDBERG.PRM
Televideo 910-955/ADM 5/Wyse 50 TELEVID.PRM
VT52/Heath/Zenith/ADDS VP VT52.PRM
Note that the description files only alter the screen output, and do not
honour different keystroke combinations used by different terminals, except the
ANSI escape keysequences. Also note that some terminals will work better if you
run OS2You in a screen with only 24 lines (MODE CO80,24) instead of the more
common 25 lines.
The following terminal programs should work with OS2You and have special
keyboard modes that make them suitable for OS2You (we recommend using one of
these separate products instead of LANTERM for serial communications):
OS/Program Terminal definition to use/comments
DOS LanTerm Use built in ANSI (ANSI.SYS should be loaded) has
Pipe-support.
DOS Telix 3.15 Use built in ANSI, supports Doorway mode (Alt-=),
(disable status line in Telix).
DOS Communiq 1.0 Use built in ANSI, supports Doorway mode (ScrLock) and
IEMSI logon.
DOS Terminat 1.20b Use built in ANSI, supports Doorway mode (ScrLock) and
IEMSI logon.
DOS DWCOMM Supports Doorway mode (of course).
OS2 LanTerm2 Use built in ANSI, has Pipe-supportand PM2 You
Graphics capabilities.
OS2 LiveWire 2.1 Use built in ANSI and OS2You mode (ScrLock), has
Pipe-support.
OS2 TE/2 1.30 Use bilt in ANSI and OS2You mode (Alt-=), has
Pipe-support.
PM Terminal/2 Use built in ANSI, has Pipe-support and PM2You
Graphics capabilities.
The following terminal programs should work with OS2You (except when otherwise
indicated) but does not provide any special keyboard mapping:
OS/Program Terminal definition to use/comments
DOS Procomm+ 1.0 Use external ANSI, use only 24 lines in OS2You, screen
colourbackgrounds won't be correct.
DOS Procomm+ 2.0 Use external ANSI, use only 24 lines in OS2You (if you
use the standard 25 line mode in Procomm+).
OS2 LogiComm 2.20S Use built in ANSI.
OS2 M2Zmodem 2.11 Use built in ANSI.
OS2 HyperAccess 5/2 Use external ANSI, use only 24 lines in Os2You.
OS2 CKOKER 4E(070) Use external ANSI, use only 24 lines in Os2You.
PM PMComm 1.07 Won't work with OS2You. Very strange scrolling
handling.
PM XKOKER 5A(119) Use external ANSI, use only 24 lines in OS2You.
If your terminal is not supported with a terminal description file, you may
define your own terminal, by starting the setup utility and select Terminal in
the configuration menu.
OS2You automatically detects how many columns and lines the OS/2 session
contains, but you have to configure your terminal program for a screen size
with at least the same amount of columns/lines (it doesn't matter if the
terminal program uses more columns/lines than the OS/2 session). It is possible
to alter the screen size with the MODE-command, while connected to OS2You, as
long as the screen will fit the remote screen.
To "emulate" different keystrokes from public terminal programs that does not
support Doorway mode, the special OS2You keyboard mapping, Esc sequences are
used. The following Esc sequences are valid (note that upper/lower case letters
are significant):
The above screen is showed if you press Esc without any character following
within approx. one second. You may select any keystroke from the menu, and the
menu exits, and OS2You sends the selected keystroke to your application. If Esc
is pressed and directly followed by another character, the selected keystroke
is sent directly to your application, without showing the help screen.
ANSI escape sequences for cursor movements are mapped to their corresponding
arrow key. All characters, except Esc, are translated directly to the
corresponding keystroke. ASCII 01H is translated to Ctrl-A, ASCII 02H to
Ctrl-B and so on. To emulate Shift, Ctrl and Alt function keys, you first have
to select which mode you want by pressing Esc-s, Esc-l resp. Esc-a followed by
the appropriate function key Esc-code. In the upper right corner of the help
menu the current state of the function keys is written. The above table means
that you should press Esc first and thena character. Esc-i means that you
should press Esc first followed by "i". Note that you have to press Esc twice,
if you want to emulate a Esc keystroke.
ΓòÉΓòÉΓòÉ 6.4. 4.4 Printer redirection ΓòÉΓòÉΓòÉ
4.4 Printer redirection
Printer output may be redirected from one device to a remote printer. Note
that all output to the selected device is redirected, even output from other
sessions to this device. You can select to direct printer output either to the
local printer, remote printer or both. To redirect the printer output from one
device to a remote printer, you should install a printer driver for the remote
printer on the selected device. Example:
1 You have a IBM Proprinter 4201 connected to LPT1 on the remote computer
running LanTerm, LanTerm2 or Terminal/2.
2 Install the IBM Proprinter 4201 printer driver for LPT2 on the host
computer.
3 Install OS2You to redirect LPT2 to remote computer.
4 All output to LPT2 on the host will now be redirected to the remote
printer. Other printer devices, like LPT1, will be unaffected.
Printer redirection requires that the terminal program on the remote computer
is capable of handling this feature. To use this feature, you will have to use
LanTerm, LanTerm2 or Terminal/2.
If you use a terminal program that can't handle this feature, and have
installed OS2You to redirect printer output to remote printer, all printing
will be put on hold.
Printer redirection currently works only when running OS2You and not if you
run PM2You.
ΓòÉΓòÉΓòÉ 6.5. 4.5 Chat ΓòÉΓòÉΓòÉ
4.5 Chat
With the Chat feature, you can enter a special conversation mode in OS2You, by
choosing the Service functions menu, either from your terminal programs menus
(if you use WinTerm or Terminal/2) or by pressing Esc-y (if you use a terminal
program from another vendor). When you are in Chat mode the screen is split
into two windows. Everything you type at the host is displayed in the upper
window and everything that is typed at the terminal is displayed in the lower window.
To exit the Chat mode you press Esc.
ΓòÉΓòÉΓòÉ 6.6. 4.6 Task Switching ΓòÉΓòÉΓòÉ
4.6 Task Switching
By pressing Esc-tab (first Esc and then Tab 1bH, 09H) you will get a list of
programs currently running. If you use Terminal/2 or WinTerm you should select
the Task List choice in the menus instead. The Task List might look like this:
The task list displays all running programs. If the list is too long for the
screen, you may scroll up and down with the PgUp and PgDn keys. You enter the
character displayed before the program you want to switch to, or move the arrow
with the cursor keys. If you want to return to the original session (the one
you started from) you should select A.
You can only switch to programs running in an OS/2 Full Screen text session or
DOS Full Screen or Windowed text session (if you run OS2You with OS/2 2.0 or
later). If you try to switch to another session, you will get an error
message. Note that the session you select is switched to the foreground at the
host machine, and will interrupt any user running another session at the
machine from the keyboard. It will also interrupt any other user running the
same host through OS2You running other session than their original session. If
the session you selected is an OS/2 Full Screen session it should not be
switched to the background, while you are connected to it, as the user will be
returned to the task-list if the task is switched to background. DOS sessions
will continue to work even if they are switched to background.
NOTE! The built in LockUp feature of OS/2 2.x Workplace Shell prevents the
OS2You task switching from functioning. If you use the task switching feature
in OS2You, you should disable the LockUp feature in OS/2.
ΓòÉΓòÉΓòÉ 6.7. 4.7 DOS compatibility box ΓòÉΓòÉΓòÉ
4.7 DOS compatibility box
It is possible to switch to DOS sessions in OS/2 2.x or OS/2 1.x and remote
control DOS programs. For the DOS-box access to work, you must take some extra
care to configure your system. First, the DOS_SRV.EXE program must be located
in the directory you installed OS2You in (or in a pathed directory). If this
is not the case you will get a message like DOS Keyboard emulation not
available! If you used the installation program to install OS2You, this should
have been done automatically. Then you must load the resident program
KBFILTER.COM (or K1FILTER.COM if you run OS/2 1.x) in the DOS-box you want to
access remotely, in order to get the function keys to work (other characters
will work without this program). You can either load the program from the
remote, when you have switched to the DOS-session, or you can load the program
in your AUTOEXEC.BAT file (this is not done by the installation program). The
program will require very little memory (less than 1 Kb) and interfere very
little withyour usual work (the Esc-key can seem a little slow in DOS sessions).
To access the DOS sessions in OS/2 2.x you bring up the Task List (see section
4.6) and select the DOS session you want to switch to. To access the DOS box
in OS/2 1.x you issue the command ToDOS at the OS/2 Command Prompt (you
terminate the OS/2 1.x DOS box access by pressing the F12 key).
If you can see the DOS-box screen output, but not send any keystrokes at all,
this probably means that DOS_SRV.EXE isn't loaded properly. If you can send
alphanumerical characters, but no function keys, that probably means that
KBFILTER.COM isn't loaded properly.
Note that KBFILTER.COM could be loaded several times in the same session. This
is not recommended.
ΓòÉΓòÉΓòÉ 6.8. 4.8 Sharing ports with other communication programs ΓòÉΓòÉΓòÉ
4.8 Sharing ports with oter communication programs
If you have set up OS2You in HOST mode to answer incoming calls, it is
possible temporarily to suspend OS2You, to let other communication programs
access the port. To do this you have to enter a pipe name in the configuration
parameter Port request pipe (like \PIPE\RELEASE, see section 3.1). To do this
you run the program LanRel with one of the following syntaxes (assuming the
port request pipe was called \Pipe\Request):
LanRel \Pipe\Release
LanRel \\Srvname\Pipe\Release
It is possible to use both local and remote pipes, so you can suspend OS2You
on your local computer or another computer at the LAN running as OS2You Host.
When OS2You gets a port request, it releases the communication port and halts
for one (1) minute, leaving the port available. By using LanRel you will have
1 minute to start any other communication program accessing the port, and
OS2You will remain suspended until the port is available again. OS2You
automatically detects when the port is available again, and will resume its
operation. The port is re-initialized when operation is resumed.
It is also possible to access the port directly with LanTerm or LanTerm2 by
starting these programs with the Port request pipe name as a parameter to the
LanTerm(2) program, instead of the communication device name. If you use
Terminal/2 you should use the ordinary device name, and if this device is
claimed by the OS2You host, Terminal/2 will automatically request access to the
port, using the default request name \Pipe\Request (this will only work with
local devices).
ΓòÉΓòÉΓòÉ 6.9. 4.9 Use within a BBS ΓòÉΓòÉΓòÉ
4.9 Use within a BBS
This program can be used to access the command prompt from your BBS, for
maintenance, or to run programs as doors within the BBS. The following is some
examples of how to install OS2You in a BBS (Maximus 2.00).
Start a command prompt from Maximus with the following syntax:
UsrRemote Xtern_Run OS2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-e_CMD.EXE Normal "Shell"
Start an OS/2-program called "MyProg" from Maximus with the following syntax:
UsrRemote Xtern_Run OS2You.EXE_-l_%%%P_-s_-e_CMD.EXE_/C_MyProg Normal "MyProg"
Start a DOS-program called "MyDOS" from Maximus with the following syntax:
UsrRemote Xtern_Run OS2You.EXE_-l_%%%P_-s_-g_"DOS.BAT"_-e_CMD.EXE_/C_DOS
Normal "MyDOS"
You should have a batch file called DOS.BAT like this:
@echo off
MYDOS
ΓòÉΓòÉΓòÉ 7. 5 PM2You users manual ΓòÉΓòÉΓòÉ
5 PM2You users manual
PM2You is an add-on to the OS2You product, that lets you remote control the
entire Presentation Manager (PM) Desktop and PM programs. It mirrors the
entire desktop to a remote terminal with complete keyboard and mouse support.
PM2You can handle any known screen resolution with up to 256 colours and will
work with your existing display drivers. At the client terminal you get the
host desktop within a window either in MS Windows or OS/2 that can be sized and
scaled to any size you want. The display resolution at host and client don't
have to match as the host image is scaled to fit the client window.
PM2You supports any communication device that is supported by OS2You. To use
PM2You, you must use a terminal program at the client that is compatible with
PM2You (currently Terminal/2 for OS/2 or WinTerm (optional) for Windows).
ΓòÉΓòÉΓòÉ 7.1. 5.1 Starting PM2You ΓòÉΓòÉΓòÉ
5.1 Starting PM2You
PM2You is built upon the OS2You product, and OS2You should be started as
described in section 2.1. The user logs into OS2You and after the login is
completed PM2You is started if the user entry is configured for this (see
section 3.4 Shell command). PM2You can also be started from the command line
once you have logged into OS2You with the command PM.
If you get an error message when trying to start PM2You, please note that it
is important that the OS2You INSTALL program has been allowed to modify your
CONFIG.SYS file, or that the corresponding modifications have been made
manually. Also note that you must use a client software that is capable of
handling PM2You (currently that is Terminal/2 for OS/2 PM or WinTerm for Windows).
ΓòÉΓòÉΓòÉ 7.2. 5.2 Terminating PM2You ΓòÉΓòÉΓòÉ
5.2 Terminating PM2You
You can terminate PM2You in many different ways. In your terminal program you
should have a menu choice for terminating PM2You (in Terminal/2 that is done in
the menu Special/PM2You/Terminate). This is the preferred method. You can also
close the PM2You Remote Access Facility session in the Task List or double
click at the upper left corner of the PM2You window, if visible.
Terminating PM2You can sometimes take some time (up to about half a minute).
When PM2You terminates you will get back to the OS/2 command prompt, if PM2You
was started from this, or the session will be closed by OS2You if PM2You was
started automatically by OS2You.
ΓòÉΓòÉΓòÉ 7.3. 5.3 Using PM2You ΓòÉΓòÉΓòÉ
5.3 Using PM2You
Normally the PM2You program window is minimized. By selecting the PM2You
Remote Access Facility session from the Task List or clicking on the
corresponding icon, you can bring up the PM2You program window. This window
continuously shows the current status of PM2You.
If you have configured PM2You to Only mirror active window (see section 3.3)
you should notice that only the window or program that is in focus, is updated
at the client by PM2You. This improves the performance, but can sometimes be
confusing, especially when switching between different programs, as the window
you are switching to background, doesn't get updated and won't disappear at the
client. You can always manually request a complete screen update with the
terminal program (in Terminal/2 this is done with the menu
Special/OS2You/Refresh Screen).
PM2You has an error control mode. When this mode is active every transaction
from PM2You is verified by the client and if a transmission error occurs a
retransmission is requested. Most network connections have this functionality
built into the network transport protocol and thus this feature is not needed
for these connections. Most modern high speed modems also has the capability
to verify the transmitted data (MNP4 or V.42 mode). If the modem has this
capability it is recommended to enablethis feature in the modems and disable
the error control mode in PM2You. If you don't have any problems with garbled
data with your modems, you should disable the error control mode in PM2You, as
it will slow down operation, even if there are no transmission errors. Note
that the errorcontrol mode is configured in the client software only and that
there is no such setting in PM2You. In Terminal/2 there is a setting in the
Special/Settings/Other Settings called PM2You Error Correction.
PM2You has its own Chat mode. You enter Chat mode from the host by selecting
Chat in the PM2You menu or from the clients menu (in Terminal/2 there is a menu
choice called Special/OS2You/Chat. When entering Chat mode two identical
dialogues are displayed on host and client that look like this:
In the bottom field of the dialogue you enter messages that you want to send
to the other party and press Enter or click on the Send button. The message
will appear in the scroll list above at both host and client. To exit Chat
mode, you press the Exit button and the dialogue will disappear at both host
and client.
ΓòÉΓòÉΓòÉ 7.4. 5.4 Performance tuning of PM2You ΓòÉΓòÉΓòÉ
5.4 Performance tuning of PM2You
To get maximum speed when remote controlling PM programs with PM2You, you
should consider the following options.
1 Do not use background pictures on the host desktop.
2 Do not use dithered (patterns of different colours to create another shade
of colour backgrounds or other large areas of dithered colours at the
host.
3 Check that you have enabled SCA-compression in PM2You setup, unless you
know that your device doesn't support this. This will greatly increase
the performance and reduce the CPU load of the host. Also set the PM2You
screen update delay to 100 ms.
4 Use the lowest acceptable screen resolution at the host. Decreasing
colours from 256 to 16 will not help much however.
5 Do not use the PM2You Error Correction mode if you don't need it, as it
will slow down overall performance, even if there are no transmission
errors.
6 Selecting a modem with build in compression like MNP5 or V.42" will not
help, as PM2You already compresses the information.
7 The speed of the CPU and display hardware at both host and client will
affect performance.
8 Try to balance compression aggressiveness with communication speed. High
communication speeds require less compression while slow communication
links will benefit more from efficient compression (see section 3.3).
9 Consider increasing PM2You priority from Normal to Time Critical if
performance isn't what it should be (see section 3.3). Also consider
decreasing the Screen update delay parameter (see section 3.3).
ΓòÉΓòÉΓòÉ 7.5. 5.5 Compatibility considerations using PM2You ΓòÉΓòÉΓòÉ
5.5 Compatibility considerations using PM2You
PM2You is compatible with the following types of software that is also
compatible with the operating system version you are running:
1 Any Presentation Manager/WPS program with complete keyboard and mouse
emulation.
2 Any OS/2 Windowed character mode session with complete keyboard and mouse
emulation.
3 Any DOS Windowed character or graphics mode session with complete keyboard
and mouse emulation. For complete keyboard emulation, you should ensure
that the program KBFILTER included with OS2You is loaded. The best way to
do this is to edit your AUTOEXEC.BAT file to include the KBFILTER command.
5 Windowed (Seamless) MS Windows session with limited keyboard but complete
mouse emulation. The limited keyboard emulation means that sometimes
accelerator (shortcut) keys don't work.
PM2You is not compatible with Full Screen OS/2 or DOS sessions. These should
not be activated when running PM2You as they will prevent PM2You from working.
To run OS/2 or DOS full screen sessions, you should exit PM2You and run these
with OS2You only.
ΓòÉΓòÉΓòÉ 8. 6 File transfer option ΓòÉΓòÉΓòÉ
6 File transfer option
With the File transfer option you can transfer files between the host and
client through any device that is supported by OS2You. The file transfer
option includes many different methods for file transfers, most of them
following public standards to let you transfer files between OS2You and
terminal programs from other vendors. Note that currently file transfers are
only supported when running in OS2You mode (text mode and not PM2You PM remote
control mode).
ΓòÉΓòÉΓòÉ 8.1. 6.1 File transfer with service functions menu ΓòÉΓòÉΓòÉ
6.1 File transfer with service functions menu
By bringing up the Service functions menu, you can select send at receive from
it. You enter the service functions menu by selecting this choice from the
WinTerm or Terminal/2 menus, or by pressing Esc-y if you use a terminal program
from another vendor.
If you choose C - Send files from host you will be prompted for a file name.
This must be a fully qualified file name, including directory path, to the
file(s) you want to send from the host to the client. You may specify
wildcards (like C:\*.TXT) to send multiple files. If you use a terminal
program from another vendor you should begin your download procedure now, using
the Ymodem Batch file transfer method. If you use Terminal/2 the file transfer
will be started automatically.
If you choose D - Receive files to host you will be prompted for the directory
to place files into at the host. You will then be prompted (either by OS2You
or by your terminal program) to begin sending the files. If you use a terminal
program from another vendor, you should select the Ymodem Batch file transfer method.
ΓòÉΓòÉΓòÉ 8.2. 6.2 File transfer from command line ΓòÉΓòÉΓòÉ
6.2 File transfer from command line
By using the Sz, Rz or OS2FTP programs you can request file transfers from the
OS/2 command prompt. Use Sz <filename> to send files from the host to the
terminal with the fast and reliable Zmodem file transfer method. You may
specify wildcards in the file name to send multiple files (like Sz C:\*.TXT).
Use Rz <directory> to receive files from the terminal to the host with the
Zmodem file transfer method. You may enter only Rz to receive files into the
current directory.
If you use LanTerm (for DOS), you should get DSZ file transfer program
(shareware from Omen Technology). If you use LanTerm2 (for OS/2), you should
get M2Zmodem file transfer program (from the same place you got OS2You). Both
programs should be installed in the same directory as LanTerm(2), or in a
directory specified in your path.
To perform file transfers with other public file transfer methods that Zmodem
you can use the OS2FTP utility (this is used by the Sz and Rz utilities).
Enter the command OS2FTP to see the different options. OS2FTP can perform file
transfers following the Xmodem, Xmodem-1K, Ymodem, Ymodem-G and Zmodem
standards. Examples:
OS2FTP -s*.*
OS2FTP -rC:\Download
OS2FTP -XMODEM -sMYFILE.DAT
OS2FTP -XMODEM -rMYFILE.DAT
You may also use the M2Zmodem file transfer utility, which is only another
variant of the OS2FTP utility.
ΓòÉΓòÉΓòÉ 9. 7 Fax receive option ΓòÉΓòÉΓòÉ
7 Fax receive option
With the Fax receive option OS2You can use a class 2 faxmodem both to receive
data (on-line) calls and fax calls from fax machines. If a data call is
detected OS2You will prompt for user ID and password as usual. If a fax call
is detected OS2You will receive the fax and print it. Thus you can use the
same modem and phone line to receive both data and fax calls.
To use FAX2You fax receive option you need a class 2 faxmodem and a HP
LaserJet (PCL4 or PCL5), Epson FX or Epson 24-pin printer.
The fax receive option is always installed and just needs configuration to
work. The fax option works with both class 1 and class 2 faxmodems, but only
the class 2 specification defines a standard for detection between data and fax
calls which is necessary for OS2You to work. Thus a class 2 faxmodem is
recommended, although some class 1 faxmodems may have an option for detecting
fax calls.
The fax receive option is configured by the standard OS2You SETUP program by
editing the modem configuration profile. With the OS2You SETUP program you
edit the modem profiles to initialize the faxmodem for detecting both data and
fax calls. With class 2 faxmodems this is done by adding the following strings
to your modem initialization string:
~AT+FCLASS=2^
~AT+FCR=1^
~AT+FAA=1^
~AT+FDCC=1,5,0,2,0,0,0,0^
~AT+FLID="Your fax-ID"^
In addition to defining the above initialization string, you should set the
Fax connect string to +FCON and disable the Release fax device setting and
define a Fax command line.
As a reference, you might look at the ZyXEL 1496E+ modem profile, which is
already correctly configured for this option.
The initialization string above will set the modem to accept both data and fax
calls. If a fax call is detected the command in the field Fax command line
will be started. This command should be edited to correctly start the fax
receive program (FAX2You), like: FAX2You.EXE -l %%%1 -connected -print -pcl
This line will start the fax receive program FAX2You and print received files
with HP LaserJet printer format. OS2You can work together with other fax
receive programs from other vendors, but we recommend using the FAX2You program.
The FAX2You program can be started with the following parameters:
Parameter Explanation
-l <COMport> Specifies serial port to use. If set to %xx
COM-handle xx (decimal) will be used. If set to %AUTO
a COM-handle will be scanned. Default AUTO.
-b <baudrate> Specifies serial port baudrate, default no change.
-connected Will instruct FAX2You that the call was answered by a
separate program (like OS2You).
-pcx Produce PCX-file output.
-dcx Produce DCX-file output.
-class1 Use Class 1 commands, default Class 2 commands.
-print Print received faxes.
-epson Use Epson FX printer format.
-epson24 Use Epson 24 pin printer format.
-pcl Use PCL printer format, default.
-pdev <device> Use <device> for printer output, default PRN.
-nodcd Do not check for carrier during fax reception.
Normally carrier is checked and FAX2You aborted if
carrier is lost.
-multiple Enter an endless loop waiting for multiple fax calls.
This option is not valid when -connected is specified.
-faxworks Export fax file to FaxWorks/PMfax (or any other fax
program licensed from the Keller Group Inc.). Note
that FaxWorks must be running for this export to work.
The FAX2You program will maintain a log file named FAX2You.LOG with
statusreports from fax connections. All faxes will be saved in separate files,
which can later be printed or viewed on screen with separate utilities (not
available yet). The fax files are created with names derived from the date in
the format MMDDnnnn.APF (MM=Month, DD=Day, nnnn=counter). Note that these
files are never deleted and can be quite large. Therefore you should have some
routine to delete old fax files when they are not needed any more.
Bundled with the FAX2You option, there is a program called VIEWFax that will
let you view and print received faxes.
ΓòÉΓòÉΓòÉ 10. 8 Hardware information ΓòÉΓòÉΓòÉ
8 Hardware information
Press the "+" sign to expand this topic.
ΓòÉΓòÉΓòÉ 10.1. 8.1 Hardware requirements ΓòÉΓòÉΓòÉ
8.1 Hardware requirements
OS2You should run on any system that can run OS/2 Presentation Manager and
OS/2 Full Screen text applications.
OS2You assumes that you use a display card with 2 bytes/character attribute
format, compatible with the CGA/EGA/VGA standards.
OS2You have modest memory requirements, and should run fine with almost any
system that can run OS/2.
OS2You is compatible with any asynchronous port, compatible with the OS/2
specification. FIFO buffering can be used, and is recommended.
OS2You can use any Hayes compatible modem, and it should be possible to
configure OS2You for almost any automatic modem. MNP5 or V.42" data
compression is very valuable when using OS2You (but not with PM2You).
OS2You emulates an enhanced keyboard.
ΓòÉΓòÉΓòÉ 10.2. 8.2 Creating a null-modem cable ΓòÉΓòÉΓòÉ
8.2 Creating a null-modem cable
If you use OS2You to access an OS/2 session from a computer or terminal using
a cable, this is how such a cable (null-modem) should be configured, to work
with OS2You:
25 Dsub 25 Dsub
TxD 2 ------------ 3 RxD
RxD 3 ------------ 2 TxD
RTS 4 ------------ 5 CTS
CTS 5 ------------ 4 RTS
GND 7 ------------ 7 GND
DTR 20 ---------|-- 6 DSR
|-- 8 DCD
DSR 6 ---|-------- 20 DTR
DCD 8 ---|
9 Dsub 9 Dsub
TxD 3 ------------ 2 RxD
RxD 2 ------------ 3 TxD
RTS 7 ------------ 8 CTS
CTS 8 ------------ 7 RTS
GND 5 ------------ 5 GND
DTR 4 --------|--- 6 DSR
|--- 1 DCD
DSR 6 ---|-------- 4 DTR
DCD 1 ---|
9 Dsub 25 Dsub
TxD 3 ------------ 2 RxD
RxD 2 ------------ 3 TxD
RTS 7 ------------ 5 CTS
CTS 8 ------------ 4 RTS
GND 5 ------------ 7 GND
DTR 4 --------|--- 6 DSR
|--- 8 DCD
DSR 6 ---|-------- 20 DTR
DCD 1 ---|
ΓòÉΓòÉΓòÉ 10.3. 8.3 Creating a modem cable ΓòÉΓòÉΓòÉ
8.3 Creating a modem cable
If you use OS2You with an asynchronous modem, this is how the cable between
your computer and modem should look like to work with OS2You (this is an
ordinary modem cable):
25 Dsub Modem
TxD 2 ------------ 2
RxD 3 ------------ 3
RTS 4 ------------ 4
CTS 5 ------------ 5
DSR 6 ------------ 6
GND 7 ------------ 7
DCD 8 ------------ 8
DTR 20 ------------ 20
9 Dsub Modem
TxD 3 ------------ 2
RxD 2 ------------ 3
RTS 7 ------------ 4
CTS 8 ------------ 5
DSR 6 ------------ 6
GND 5 ------------ 7
DCD 1 ------------ 8
DTR 4 ------------ 20
ΓòÉΓòÉΓòÉ 11. 9 Programming information ΓòÉΓòÉΓòÉ
9 Programming information
Press the "+" sign to expand this topic.
ΓòÉΓòÉΓòÉ 11.1. 9.1 Command Line options ΓòÉΓòÉΓòÉ
9.1 Command Line options
Normally you start OS2You in host mode and let it handle receiving calls and
verify userID and password. However it is also possible to start OS2You
directly from the command line or from other programs, by adding command line
parameters. This is especially useful when you want to invoke OS2You from your
own applications to provide remote access capabilities to it. OS2You may use a
hot (i.e. inherit an already opened device handle) file handle.
It is the callers responsibility to set the communication port as wanted, and
OS2You will use the current settings when called.
When the program exits, it restores the communication port to its previous
state. If a program was successfully spawned the program will exit with
Exit-code set to zero. If the program failed by any reason, the Exit-code will
be set to a non zero value.
The parameters may be entered at the command line or/and set in the
environment variable OS2YOU. If both the environment variable and a command
line is entered, the environment variable will be parsed first and the command
line after that, making command line parameters override any settings in the
environment variable. The environment variable is set by the SET OS2YOU=xxx
xxxx xxxx xxx command. The following parameters are available (note that they
should be in lower case if not otherwise specified):
Switch Explanation
-b Causes OS2You to be started in "background".
Immediately after OS2You is loaded, you get control
back to the session and can do ordinary work in this
session. When someone is connecting to OS2You, he is
prompted for userid and password as usual, and will
then be connected to this session. This option is
usual in those cases when you have a special
application that you want to monitor.
-c <fname> Use the configuration file <fname>. This option is
only valid if you use HOST mode or callback
processing.
-d Do not detect carrier loss. Normally the program
monitors the carrier and closes the remote session if
carrier is lost. By adding this parameter you
override this behaviour.
-e <fname> Execute program <fname> for the remote session
(typically CMD.EXE). This parameter is the last one
read by OS2You. All following parameters are sent to
the called program. Default is CMD.EXE.
-f <decint> Delay between screen updates with <decint>
milliseconds. Default is 100 mSecs (0.1 seconds).
-g <session-name> Go to session <session-name> directly.
-h Invoke host mode (default if no device name is
specified). You must specify the "-c" switch in
combination with this option. Note that the user
access information (like task switching access,
command shell, terminal emulation and so on) are
retrieved from the configuration file specified with
the "-c" switch, and parameters on the command line
are ignored.
-i <decint> Exit if keyboard inactive in <decint> seconds. If set
to zero no inactivity time-out is used. Note that
only the keyboard activity is monitored, and that the
inactivity counter is active even if the screen
alters. Default is zero (no inactivity counter).
-l <dname> Use device <dname> for communication. If <dname> is
replaced by a percent sign and a decimal value (for
example %5), the program will use the device handle (5
in the example) for communication. The program may
also use pipes handles for communication. This
parameter has no default value, and if the parameter
is omitted, the program will start up in HOST mode.
-n <uname> Use parameters for user <uname> in the configuration
file, including callback processing to <uname>. This
parameter is only valid if you do not start the
program in HOST mode. If you want to include spaces
in the <uname> you should replace the space by an
underscore "_", or surround the parameter with double
quotes. Default is not to use any entries in the
configuration file.
-p Use physical screen area for remote. If this
parameter is specified the program will use the
physical screen area for the remote, and not the
screen area owned by the session. If this parameter
is specified you can't use the "-s" parameter. Default
is to use the session screen area.
- prn <dname> Redirect printer output for <dname> to the remote
printer. This parameter works in combination with the
"-redir" option.
-prty <decint> Screen update priority <decint> 0-39. This parameter
sets the priority for the remote screen update thread.
Zero is the lowest priority and 39 the highest.
Priority 0-9 executes with IDLE priority, 10-19 has
REGULAR priority, 20-29 HIGH priority and 30-39 TIME
CRITICAL priority. Default is 14 giving the update
thread exactly the same priority as the executing
program. Setting the priority to a higher value (15)
may result in smother operation.
-redir <decint> Specifies how printer redirection should work. If
<decint> is 1, printer output will go to local (host)
printer. If <decint> is 2 printer output will be
redirected to the remote printer. If <decint> is 3
printer output will be redirected to the remote
printer, but also sent to the local (host) printer.
-s Disable the built in task switcher and physical
screen. If you don't want the remote user to be able
to switch between running tasks, you should disable
this feature. If this parameter is specified you
can't use the "-p" parameter. Default is to enable
the task switcher.
-t <fname> Use terminal definition file <fname>. The file
extension .PRM is added if no extension is included.
This parameter has no default value, instead the
program has a built in table for ANSI terminal
emulation.
Examples:
OS2You -l COM1 -f 1000 -i 300 -e CMD.EXE /K DIR
This command will tell OS2You to use COM1 and update the screen each 1000
millisecond. If no remote keystroke is received within 300 seconds the program
will be forced to exit. CMD.EXE is loaded for remote operation with the
parameters /K DIR (which will tell CMD.EXE to display a directory list).
OS2You -l %4 -f 100 -i 0 -d -e CMD.EXE
This command will tell OS2You to use device handle 4 (decimal value) and
update the screen each 100 millisecond. If the carrier is lost the program
will be terminated. but no inactivity timer is set.
OS2You -l %4 -f 100 -i 0 -d -n Mikael_Wahlgren
This command is similar to the previous example, except that the program will
spawn the program and use the parameters indicated by the username Mikael
Wahlgren in the configuration file. By using the -n option it is possible to
spawn different sessions depending on username.
To be compatible with MaxPipe (TM of Peter Fitzsimmons) an alternate calling
syntax is automatically invoked, if the first parameter does not begin with a
minus sign "-". In this case, the syntax will be like:
OS2You <device> <prgname> <parm1> ... <parmN>
Switch Explanation
<device> Tells which communication device to use. It is
possible to pass a hot device handle by replacing the
device name with a number corresponding to the device
handle decimal coded (like %4). The device name may be
replaced by a pipe name, but special care should be
taken, when using this possibility. The best choice
when using pipes is to use the stand alone interface.
<prgname> Tells which program to load for remote operation.
(Typically CMD.EXE).
<parm1> ... The remaining parameters are optional and are passed
as parameters to <parmN> ... <prgname>.
All other values are set to their default when using this syntax. To select
which communication parameters to use, you should use the MODE program,
included in the operating system. Read the documentation for the operating
system to see how to configure your communication line. All communication
parameters set with MODE, will be used with OS2You.
Example:
MODE COM1:2400,N,8,1,OCTS=ON,DTR=ON,RTS=HS,BUFFER=ON
This command will tell OS2You to use baud rate 2400, no parity, 8 data bits, 1
stop bit, hardware handshaking CTS/RTS and use the extended hardware buffering capabilities.
ΓòÉΓòÉΓòÉ 11.2. 9.2 Detecting presence of OS2You or PM2You ΓòÉΓòÉΓòÉ
9.2 Detecting presence of OS2You or PM2You
When a user has logged into OS2You, OS2You will try to open a public semaphore
called \Sem\OS2You\Running and clear this semaphore. When the user logs out
the semaphore will be set again by OS2You. An application that wants to
determine if a user is logged in, should create a public semaphore with the
name above and issue a DosSemSetWait. See the example below:
IF Dos.OpenSem(Sem, '\Sem\OS2You\Running') = 0 THEN
Dos.SemWait(Sem, -1);
ELSE
Dos.CreateSem(1, Sem, '\Sem\OS2You\Running');
Dos.SemSetWait(Sem, -1);
END;
IO.WrStr('Running');
WHILE Dos.SemWait(Sem, 0) = 0 DO
Dos.Sleep(1000);
END;
IO.WrStr('-Closed');
An application that wants to determine specifically if PM2You is running can
use the same technique but use the semaphore name \Sem\PM2You\Running instead.
ΓòÉΓòÉΓòÉ 12. 10 Terminal/2 users manual ΓòÉΓòÉΓòÉ
10 Terminal/2 users manual
Terminal/2 is a terminal program primarily written for use together with our
OS2You and PM2You remote control products, and is bundled in these packages.
However, Terminal/2 may be used as general purpose terminal program and thus it
is also sold as a separate product. Some of the features in Terminal/2 and
some paragraphs in this manual may not be important for you, if you are not
running Terminal/2 to access our OS2You or PM2You remote control products.
Terminal/2 can communicate through several different transport devices and
protocols, like asynchronous (modem) devices, Named Pipes, NetBIOS, ISDN, X.25,
TCP/IP and SPX. For general purpose use, you will only use asynchronous devices.
ΓòÉΓòÉΓòÉ 12.1. 10.1 Configuring Terminal/2 ΓòÉΓòÉΓòÉ
10.1 Configuring Terminal/2
When you start Terminal/2 the phonebook will be displayed. To configure
Terminal/2, just press the "Cancel" button to exit from the phonebook. Select
first the "Special" menu and then "Settings". You will get the following dialogue:
Field Explanation
Printer device Specifies a file or device for printer output. This
is used by Terminal/2 when it receives redirected
printer output from OS2You and when you select "Print
Screen" in Terminal/2. If you specify a file,
Terminal/2 will create a file and place all printer
output in this file.
Character set Specifies which character set to use. In most cases
you should select "International", but if you are
located in a country with special character mapping,
you might need to change this setting, depending on
the host system. For use with OS2You, you should
always have this setting to "International".
Font size Selects the font size you want to use. You may also
dynamically change the font size in Terminal/2 by
pulling the border of the window, if the Track Window
option is enabled (see below).
Track Window Specifies that pulling the border of the Terminal/2
window should resize the window and change the font
size to best fit the selected window size.
Alarm time These parameters specifies how long the alarm (melody)
will sound when a connection is established or a file
transfer is competed. To disable the sound effects
completely, set these parameters to 0 (zero).
HW buffering Specifies that extended hardware buffering (also
referred to as FIFO buffering) should be used if
available. If you have an improved communication
hardware that allows FIFO buffering, this will yield
better performance and won't load the CPU as much as
it otherwise would do. Terminal/2 can automatically
detect if this hardware is present, and thus this
option should always be enabled, if you don't have any
special reason to disable it.
Use IEMSI The IEMSI standard is a public standard to allow
automatic logon to different services. This standard
is widely used by different BBSes and also used as the
method to automatically logon to OS2You. Terminal/2
automatically detects if a system is capable of IEMSI
logon, and will only use it if it is, so this setting
could always be enabled. For the logon to work, you
must specify user ID and password in the Phonebook
entry you use (see more about IEMSI options below).
By pressing the Other Settings button you get a new dialogue with more rarely
used options:
Field Explanation
Animated cursors Indicates if animated (moving) mouse pointers should
be used. This option is most for fun and does not
have any real use.
Show on-line time This option specifies if the time on-line should be
displayed in the caption (title) row.
Swap Backspace... This option specifies that the Backspace key should be
swapped with the Delete key. This option is mostly
used for general purpose terminal emulation and not
for PM2You.
Maximize hides... Indicates how Terminal/2 should be maximized when
remote controlling PM2You. If this option is enabled
Terminal/2 will be maximized in such a way that the
remote PM2You image will cover the entire screen,
otherwise Terminal/2 will be maximized to leave room
for the Terminal/2 title bar and menus.
Fast screen draw Indicates how Terminal/2 should update the display.
Certain display drivers (like some SVGA) don't handle
screen draws correctly, and therefore Terminal/2 may
need to use a slower method to update the screen. If
you don't know if you can use fast screen draws, try
it, but remember if Terminal/2 halts with an error
popup saying something like "Protection violation in
XXXX" (XXXX being the name of your display driver),
you should select the slower screen draw.
Error correction Indicates if error correction should be used when
communicating between PM2You and Terminal/2. When
this option is enabled Terminal/2 will check if the
information received have been corrupted during
transmission and if that is the case request
retransmission. Normally most high-speed modems
include error correction by themselves and it is
recommended to use the error correction built into the
modems and to disable software error correction in
Terminal/2 as software error correction will
significantly degrade performance, even if there are
no transmission errors.
Hourglass after... This option specifies that the mouse pointer should
change to a clock-symbol (or hourglass) when a mouse
button is sent to PM2You.
Background PM2... This option specifies that Terminal/2 should
acknowledge a received package immediately when it is
received and before it is actually analysed. While
Terminal/2 analyses the received packet and draws the
changes to screen, it can receive a new package.
Enabling this option will yield better performance,
but you must have a computer that handles the
processor load this will cause.
Stretch image This option lets you select whether the remote image
should be displayed in Terminal/2 with its original
size, or if it should be stretched/compressed to fit
the size of the Terminal/2 window. If you don't
select to stretch the image and the remote image is
larger than the Terminal/2 window can display, you can
scroll through the remote image by placing the mouse
cursor near the border of the Terminal/2 client area.
Default editor This field specifies which editor Terminal/2 should
use. Terminal/2 uses the editor to display the
help-text and history buffer.
Software PAD:
The optional Software PAD is useful for some packet distributed services (like
X.25). Some services are packet oriented and you may reduce costs and increase
performance by assembling keystrokes and mouse events into larger packets.
This is because these services often have a significant overhead for every
packet that is sent and you pay for every packet you send, regardless of the
actual packet size. You configure the PAD with the following settings:
Field Explanation
Enable software PAD This option specifies that the PAD should be used. If
this option is not enabled the following parameters
will be ignored and no packetizing be performed.
PAD max age This parameter specifies the maximum age of the
information in the PAD buffer, in 1/10 second. When
the information in the buffer is older than the time
specified in this field, it will be sent.
PAD max size This parameter specifies the maximum amount of
information in the PAD buffer, in bytes. When the
information in the buffer exceeds the specified size,
it will be sent. This parameter should be set to
correspond the packet size of the communication
service you are using, to maximize the benefit of the
PAD.
PAD flush byte This parameter specifies a character that will force
the information in the PAD buffer to be sent. This is
often set to 13 (CR/Enter) as this key is often used
to indicate the end of an input.
ΓòÉΓòÉΓòÉ 12.2. 10.2 IEMSI automated logon ΓòÉΓòÉΓòÉ
10.2 IEMSI automated logon
The IEMSI standard is a public standard to automate logons to different
services. It will identify you to the host system and set different options
for you, without the need for any user interaction. OS2You complies with the
IEMSI standard and uses this to allow automated logons. Of course you can
still logon manually to OS2You if you don't want to (or can't) use IEMSI. To
get IEMSI logon to work you should specify your user ID and password in the
Phonebook entry you use for the host system.You should also enable the IEMSI
logon in the Special->Settings dialogue.In addition to this you can specify
different options by pressing the IEMSI Settings button. You will get the
following dialogue:
These settings specifies how the host system should behave when you logon
(these settings are not used by OS2You but only to other public services).
ΓòÉΓòÉΓòÉ 12.3. 10.3 Phonebook ΓòÉΓòÉΓòÉ
10.3 Phonebook
The phonebook in Terminal/2 plays a very important role in the program. Here
you specify how the communication link should be configured, phone numbers,
user IDs, passwords and so on. To be able to communicate you have to "Dial"
and entry in the phonebook. Unlike some other terminal programs, device
settings are not specified globally for the terminal program, but specified for
every phonebook entry. This is useful if you have several different kinds of
communication tasks.
The phonebook is built around two dialogues. The first is displayed directly
when you start Terminal/2, and contains a list box with the different phonebook
entries you have previously created and buttons to Dial, Reconnect, Add,
Change, Copy and Delete entries (Reconnect opens a communication device without
actually dialling the phone number specified).
If you select to Add, Change or Copy, a phonebook entry you will see the
following dialogue:
Field Explanation
Name Specifies the title to be used in the phonebook. This
is just for your own reference and is not used in any
other way by Terminal/2.
Phone number Only significant when used with asynchronous devices.
Specifies which phone number to dial.
User id Specifies which User ID Terminal/2 should identify you
with when logging on to a BBS or OS2You. This setting
is only significant if you connect to OS2You or a BBS
that supports the IEMSI logon standard, otherwise it
is ignored.
Password Specifies password to use. See above (User ID).
Device (left) This specifies the name of the communication device to
use. This can be a COM-name like COM1, COM2 or COM3
(note that you can TYPE in any name you like, not just
choose from the list) or it can be a pipe name like
\Pipe\OS2You. If you use other communication
protocols than asynchronous devices, you should
specify a pipe name, like \Pipe\OS2You.
Device (right) This specifies the type of the communication device to
use. You can only select between the types in the
drop down list. To use Terminal/2 as a general purpose
terminal program, you should specify "Asynchronous".
Scriptfile This specifies a script file that should be executed
when you connect. If this field is empty, no script
will be executed (see more in a separate section about
scripts).
Emulation This specifies which terminal emulation to use. For
use with OS2You, you should select the OS2You
emulation, otherwise the most common emulation is ANSI
or VT100.
The "Async settings" are only significant when you have specified an
asynchronous device. The "Network settings" are only significant when you have
specified a special communication protocol like NetBIOS or TCP/IP.
Configuring asynchronous devices:
Field Explanation
Baudrate Specifies which communication speed to use.
Databits Specifies how many databits to use. Should in most
cases be set to 8. For use with OS2You, this field
should be set at 8.
Stopbits Specifies how many stopbits to use. Should in most
cases be set to 1.
Parity Specifies if parity checking should be used. Should
in most cases be set to "None".
Configuring NetBIOS:
There are two different variants of NetBIOS implementations available, NetBIOS
3.0 (NB30) and NetBIOS Submit (NBAPI). NetBIOS Submit is available from most
vendors, while NB30 is used most in IBM environments. The configuration in
Terminal/2 is identical regardless of which protocol you use.
Field Explanation
Host name Specifies the NetBIOS name for the host. This should
correspond to the host name configured in the OS2You
setup. This must be an unique name on the LAN.
Terminal name Specifies the NetBIOS terminal name. If you don't use
slave terminals (for details about slave terminals,
please see the OS2You documentation), this could be
any NetBIOS name on the LAN. Different work stations
can use the same name but different instances of
Terminal/2 running on the same machine must have
different names.
Adapter/channel Specifies which LAN adapter to use. For most
configurations this should be set to 0 (zero) but you
might want to change this if you have more than one
LAN adapter configured in your machine.
Configuring ISDN CAPI:
This communications interface might not be included in your version of
Terminal/2. If you miss it and need it, please contact us. When using the
ISDN CAPI interface, you should specify the destination number in the "Phone
number" field and the channel number in the "Adapter/Channel" field of the
network settings.
Configuring SPX:
When configuring SPX, you need to know the SPX address of the OS2You machine
you want to access. This address is displayed by the OS2You software, when
OS2You is started.
Field Explanation
Net no Specifies the network number of the OS2You host
machine. This information is displayed by OS2You when
it is started in host mode.
Node no Specifies the node number of the OS2You host machine.
This information is displayed by OS2You when it is
started in host mode.
Socket no Specifies the socket number of the OS2You host
software. This can be any free socket number, but
must correspond to the socket number configured in
OS2You. Default and suggested socket number to use is
7787.
Configuring TCP/IP:
There are two different drivers for the TCP/IP interface, one for the IBM
TCP/IP socket interface and one for the FTP Software PC/TCP socket interface.
Both these interfaces are configured in the same way.
Field Explanation
Host address IP address of the OS2You host machine. This should be
an IP address in the format 1.2.3.4 or a host name in
the format server.ridax.se.
Socket no Specifies the socket number of the OS2You host
software. This can be any free socket number, but
must correspond to the socket number configured in
OS2You. Default and suggested socket number to use is
7787.
Configuring ICL OSI WAN:
This communication driver might not be included in your version of Terminal/2
as it is a very specialized interface. If you miss it and need it, please
contact us.
Field Explanation
Destination Specifies the destination address (often a X.25 node
number) of the OS2You host machine.
User group Specifies a closed user group. In most cases this
field should be blank, but for increased security you
might specify a closed user group. This must
correspond to the configuration in the OS2You host
machine.
AC name AC name that Terminal/2 should use.
ΓòÉΓòÉΓòÉ 12.4. 10.4 Defining macros ΓòÉΓòÉΓòÉ
10.43 Defining macros
In Terminal/2 you can assign macros (shortcuts) to different keystroke
combinations. By choosing Special->Macros in the menu you get the following dialogue:
If you press the Record key you will be requested to press a key combination
(like ALT-C) and the code for this key combination will be shown together with
the macro that is already assigned to this key. You can enter a new macro
string and Save it. To inspect different macros that are defined you can press
the Next and Previous buttons.
A macro string contains ordinary characters that are sent when the key
combination you have chosen is pressed. It may also contain the caret ("^")
character followed by a character to specify a control character (like "^M" for CR).
ΓòÉΓòÉΓòÉ 12.5. 10.5 File transfer ΓòÉΓòÉΓòÉ
10.5 File transfer
You can configure some parameters that are related to the file transfer
functions in Terminal/2 by choosing File transfer->Settings in the menus:
Field Explanation
Upload path Specifies the default directory for files that are
sent from Terminal/2. This path can be overridden
when you request the file transfer.
Download path Specifies the default directory to place files that
are received to Terminal/2.
Existing files Specifies how Terminal/2 should act when you try to
receive a file that already exists in your computer.
You can choose to let Terminal/2 Rename the file,
Resume it (meaning that it will receive the remaining
part of the file, if the file was previously
unsuccessfully transferred) or to Reject the file.
Carrier detect Specifies that Terminal/2 should monitor the carrier
signal and abort the file transfer if carrier is not
present.
Autodetect Terminal/2 can automatically detect when the remote
system you are connected wants to initiate a file
transfer. With this setting you can define what file
transfer protocols that should be automatically
detected. The ZModem protocol can always be
automatically detected, while X/Ymodem can only be
detected when the remote system uses a X/Ymodem
protocol implementation from Ridax.
ΓòÉΓòÉΓòÉ 12.6. 10.6 Operating Terminal/2 ΓòÉΓòÉΓòÉ
10.6 Operating Terminal/2
Dialling (ALT-D)To make a connection you have to use the phonebook and "dial"
an entry, as the information about which device to use is stored in the
phonebook entries. This does not mean that you have to let Terminal/2 make a
dial attempt. If you haven't specified a phone number in the phonebook entry,
or if you press the Reconnect button, Terminal/2 won't dial.
When Terminal/2 dials with a modem, it automaticly detects if the dialled
number is busy (if your modem supports BUSY detection) and will try to redial
the same number after a short delay (defined in the Special->Settings->Modem
settings dialogue). You can also highlight several phonebook entries and then
press the Dial button. In this case Terminal/2 will perform a queue dial,
meaning that it will first try to connect to the first highlighted entry. If
this number is busy, it will try to dial the next and so on. When a connectio
is successfully established the entry will be removed from the dial queue and
you can requeust a new queue dial with the remaining entries.
History editor/Scroll back (ALT-F6)
Terminal/2 does not have an ordinary Scroll back buffer. Instead it uses a
history buffer. When you press the ALT-F6 key combination (or press
Edit->History buffer in the menus) Terminal/2 will load the text editor
(defined in the Special->Settings->Other Settings dialogue) with the passed session.
Printing/Capture (ALT-G)
If you press the ALT-G key combination (or press Special->Print Screen in the
menus) Terminal/2 will send a copy of the terminal screen to the printer (could
also be a file, as defined in the Special->Settings dialogue).
File transfer
To start a file tranfer session press the PgDn (for receive) or PgUp (for
send) and select the appropriate file transfer protocol from the menu. Note
that the Send to host and Receive from host menu items only are intended for
use with OS2You and should not be used for general purpose terminal emulation.
Hints for use with OS2You/PM2You
To automatically login to OS2You, you should use the IEMSI option (see above).
To maximize the Terminal/2 window area, you could double click with the right
mouse button at any place of the client window area. Double clicking once
again will toggle the window client area size between the two different
maximized states (see above).
To emulate some key combinations and perform special actions in OS2You/PM2You
there are special menu items in the Special menu.
To terminate PM2You, you can chose the Special->PM2You->Terminate menu item.
ΓòÉΓòÉΓòÉ 12.7. 10.7 Shortcut keys ΓòÉΓòÉΓòÉ
10.7 Shortcut keys
For many actions there are shortcut keys defined. Note that these keys are
similar to the keyset used by Procomm Plus (tm).
Key Explanation
ALT-B Send a Break signal
ALT-C Clear terminal screen
ALT-D Dial
ALT-G Print Screen/Capture
ALT-H Hangup/Disconnect
ALT-J Initialize modem
ALT-S Set parameters
ALT-X or ALT-F4 Exit program
ALT-Z Help
PgDn Receive files
PgUp Send files
ALT-F6 History buffer/Scroll back
ΓòÉΓòÉΓòÉ 13. 11 If you have problems Q and A ΓòÉΓòÉΓòÉ
This section describes some frequently asked questions and problems.
ΓòÉΓòÉΓòÉ 13.1. 11.1 OS2You ΓòÉΓòÉΓòÉ
Q: I can't get access to the task-list in OS2You.
A: Check that you have enabled "Task Switch" privilege in the OS2You user
setup and that you don't run "LockUp" screen-saver feature in OS/2.
Q: I can't start a DOS program when in OS2You.
A: DOS programs can't be started directly from the OS/2 command prompt within
OS2You. Instead you should issue the command "START /DOS" which will create an
independent DOS session, and then you should switch to this session with the
task-switcher in OS2You (the session will be named COMMAND.COM).
Q: The OS2You modem is answering and connecting, but after that I only get garbage.
A: OS2You and the modem are probably not correctly configured. In most cases
you should only specify one connect string in the OS2You modem setup like
"CONNECT" and configure the modem for a fixed speed between modem and computer
(this is default in most new high-speed modems). If you have problems try
adding the line "SET DEBUG=ON" in your CONFIG.SYS, reboot and do a new
connection attempt. The log file will now display what connect strings the
modem returned.
Q: I want to use OS2You and Terminal/2 with COM3, but the programs only
supports COM1 and COM2.
A: OS2You and Terminal/2 only have the COM1 and COM2 devices in the
pre-configured drop-down list, but you may type in any device name (like COM3)
in the device field. OS2You supports any communication port that is supported
by OS/2 or an OS/2 device driver that conforms with the standard serial port driver.
ΓòÉΓòÉΓòÉ 13.2. 11.2 PM2You ΓòÉΓòÉΓòÉ
Q: When I try to start a PM program from the command line, nothing happens and
I don't see the output of it at my terminal.
A: To be able to remote control the PM desktop and PM programs, you have to
first start PM2You. This is done by entering the command "PM" at the command
line. After a while you should see the remote PM desktop.
Q: When I enter "PM" nothing happens or I get an error.
A: You must install OS2You/PM2You with the included installation program and
let it do the necessary changes to your CONFIG.SYS file and reboot, before you
can start PM2You. If you have SCA-compression enabled, try to disable it in
the PM2You configuration.
Q: The PM2You connection is very unreliable and after a while it can stop entirely.
A: Ensure that you have turned off Xon/Xoff software handshaking in both the
OS2You and terminal configuration and in the modems. Ensure that you have
hardware RTS/CTS handshaking enabled in software and modems. If you run
Terminal/2, try to disable "PM2You background communication". If you run over
a networked connection, try decreasing the PM2You maximum block size setting
(to a value like 8192 or 4096).
ΓòÉΓòÉΓòÉ 13.3. 11.3 Terminal/2 and WinTerm ΓòÉΓòÉΓòÉ
Q: Sometimes Terminal/2 stops with an error like "Protection violation in XXXX"
(XXXX=the name of the display driver).
A: Some drivers does not support the faster method of screen drawing that
Terminal/2 uses. Select the "Special->Settings->Other Settings" dialog and
disable the "Fast screen draw" setting.
ΓòÉΓòÉΓòÉ 14. 12 News in this release ΓòÉΓòÉΓòÉ
11 News in this release
PM2You 2.1/OS2You 3.1
Fixes PM2You would fail initialization over serial links.
PM2You 2.0/OS2You 3.1
Fixes Using the Task switcher in OS2You could cause OS2You to
fail when used with other devices than asynchronous ports.
OS2FTP could cause OS2You to be permanenty suspended with
some machines.
PM2You wouldn't start in some situations.
Ctrl-C operation fixed in OS2You.
PgUp/PgDown in OS2You task list fixed.
Ctrl-C directed to correct OS/2 session when using task switcher.
Improvements Faster 32-bit version of PM2You.
Terminal/2 can now display either a compressed/stretched
image of the remote host (as previous versions) or a
natural sized image of the remote host that can be scrolled
(if size of host and client doesn't fit).
PM2You is warning operator that tries to start a Full
Screen session.
MultiCast Named Pipe driver.
OS2You time scheduler.
Improved DOS and Windows keyboard emulation.
Telnet compliant TCP/IP drivers.
IP host address can now be specified with name in
Terminal/2 like server.ridax.se.
OS2You can now operate with modems that have the DCD
signal permanently set (but this is not recommended).
WinTerm can now be maximized to cover the entire screen by
double clicking with the right mouse button in the terminal window.
PM2You can be configured to only mirror part of the screen.
OS2You can now be started "in background" with the "-b"
switch. This means that you start OS2You in host mode
invisibly in a session, and can continue working with
another application in this session. When a caller logs
in, he gets directly into the application that is running
in foreground of this session.
PM2You 1.2/OS2You 3.0
Fixes NetBIOS operation fixed/improved in OS2You, Terminal/2,
LanTerm and LanTerm.
NetBIOS Submit could generate TRAPs with OS/2 1.x.
DOS sessions could die during heavy keyboard input in OS/2 2.x.
OS2You could refuse to answer after disconnect if an
external Program changed COM-port status during a session.
Improvements OS2You now handles "bad" applications that access physical
screen memory.
Added AUTOdetect of communication handle ("-l AUTO").
Added support for automatic Doorway keyboard support mode.
DOS and OS/2 Windowed sessions accessable from PM2You.
DOS Full Screen and DOS Windowed sessions now accessible
from OS2You and sessions don't need to be in foreground any
more. DOS box re-enabled for OS/2 1.x.
OS2You can now be started in an OS/2 Windowed session, but
will only run in Foreground.
IBM TCP/IP and FTP Software PC/TCP socket support added to
OS2You, PM2You and Terminal/2. WINSOCK support added to WinTerm.
Novell SPX support added to OS2You, PM2You and Terminal/2.
Improved modem support with faster initialization and an
option to re-initialize modem regulary.
OS2You can now receive faxes with a faxmodem (option).
Reboot capabilities added to OS2You.
PM2You now have configurable compression options to
optimize the compression ratio to the speed of the
communication device.
PM2You can now be limited to only transfer the active
window for improved performance.
Improved logging feature when using communication protocol drivers.