DP Tool Club 17/CD_ASCQ_17_101194.iso/vrac_os2/zoc195.zip/INSTALL.FIL/ZOC.HLP

OS/2 Help File | 1994-09-09 | 96KB | 2,959 lines

ΓòÉΓòÉΓòÉ 1. Getting Started ΓòÉΓòÉΓòÉ

Before using ZOC you should browse through one of the following help topics
(according to your datacom knowledge).

                             Novice (new to datacom)
                            Experienced (new to ZOC)
                           Experienced (ZOC V1.x User)

If you have questions about ordering ZOC, see General Info.


ΓòÉΓòÉΓòÉ 1.1. Help for Datacom Novices ΓòÉΓòÉΓòÉ

 If you never used a datacom program, it is highly recommended to order and
read the printed documentation for ZOC. It contains a guide to datacom and
explains a lot of the technical terms in the first part (user guide). You
should work through the tutorial there.

If you don't have a printed manual (it can be ordered from the
distribution/registration sites), you could print the help file (from the help
window's print button). Proceed like described in the topic for Experienced
Users but make sure you read the according help topics carefully.

After you made your first call, you should make yourself familiar with other
ZOC functions and options. You will find many new things that seem of no use at
first sight, but if you read about them you will remember them later when they
come handy.

The help file contains a complete Menu Function and Options reference. Showing
the Contents of the help file might be useful as well.


ΓòÉΓòÉΓòÉ 1.2. Experienced Users (new to ZOC) ΓòÉΓòÉΓòÉ

 If you never used ZOC before, you should proceed as follows:

 1.
    First, read the help topic about the Screen Elements. Don't miss the
    section about the main window (about clipping text with the mouse).

 2.
    Then, customize the options in the modem section (make sure you read the
    help pages there, ZOC does some things in a slightly different way to other
    programs) and make sure you use a modem init string you already used
    successfully in another comm program (don't forget to append ^M to it).
    Then set the serial parameters (checking the settings from your other comm
    program might help a lot) and customize your window.

    Then save the options to disk.

 3.
    Next, you should open the phone book and create a new entry for your
    favorite bbs or host. Don't miss the help topic for the AutoLogin feature
    (it's so far uniqe to ZOC and can make things a LOT easier). Everything
    else is more or less similar to other comm programs.

    Before calling it, you should set the options for the phone book (use the
    Options button in the main window of the phone book, or phone book options
    from the Options->Global Menu).

 4.
    Make a call and check if everything works. If not, try to find the problem
    (compare your settings with those of the comm program that worked for you
    so far).

 5.
    If everything works you should make yourself familiar with other ZOC
    functions and options. You will find many that are similar to the comm
    program you already used, but there will be a lot of new things as well.

    The help file contains a complete Menu Function and Options reference.
    Showing the Contents of the help file might be useful as well.


ΓòÉΓòÉΓòÉ 1.3. Version Shock (ZOC V1.x -> V2.x) ΓòÉΓòÉΓòÉ

 If you have already used ZOC V1.x, you will very likely be pleased about the
improvements since V1.33 (unless you are a real purist and don't like new
features).

But no progress comes free, so there are a few things that had to be changed in
order to maintain a logical user interface or for technical reasons.

Here is a list of things that you should be aware of or that you might miss
when browsing through the menus and options (obviosly new things are not
listed).

o The options are now split into Global Options and Options Sets Most of the
  Global Options are new, but the Directories and the Phone Cost Manager were
  moved out of the options booklet.

o The phone cost calculation was completely redesigned, the install program
  does not convert your existing phone cost setup.

o The screen marking of blocks (formerly with the right mouse button) was
  changed to Alt+left mouse button.

o The right mouse button now brings up menus in the phone book, in the main
  window and in the status line.

o The right mouse button now brings up the setup dialogs in the toolbar and in
  the button bar.

o A find command was added to the capture browse window (press 'F').

o The call log file now logs file transfers.

o Modem init and dial strings now require a ^M at the end (this should work
  automatically).

o Ctrl+Space now sends ^@

o There is a setup for multimedia WAV files in the directory options.


ΓòÉΓòÉΓòÉ 1.4. Starting ZOC (command line parameters) ΓòÉΓòÉΓòÉ

There are some parameters, that can be specified when starting ZOC from the
commandline or from an icon.

ZOC [/C] [/M] [/O:<options file>] [/S:<scriptfile>] [/U]

     /C
    This option specifies that you want ZOC to open the COM port in shared
    (cooperative) mode. This way other programs can access the COM port
    together with ZOC (but only if they open it in shared mode as well, which
    OS/2-MDOS and WINOS2 programs don't).

     /M
    This option specifies that you want to start ZOC with its windows
    minimized. ZOC will not show requesters. Instead it will use the default
    action of these. This way ZOC will not stop and wait for an answer if you
    start it at 3.00AM to automatically collect your messages if something
    unusual happens.

     /O
    With this option, you can tell ZOC to load an options file at start time
    (normally OPTIONS\STANDARD is used). This can be useful if you have more
    than one modem and different setups for these. A path should be specified,
    eg. ZOC /O:OPTIONS\COM2OPTS

     /S
    With this option, you can tell ZOC to process a scriptfile after start. A
    path can be specified, eg. 'ZOC /S:SCRIPT\NIGHTCALL'

     /U
    This option specifies unattended mode. In unattended mode


ΓòÉΓòÉΓòÉ 1.5. Screen Elements ΓòÉΓòÉΓòÉ

The elements of the screen are:

o Menu

o Toolbar

o Custom Button Bar

o Main Window

o Chat Field

o Status line


ΓòÉΓòÉΓòÉ 1.5.1. Menu ΓòÉΓòÉΓòÉ

 The menu lets you select most of the ZOC functions (for a description of the
particular functions see see Menu Overview).


ΓòÉΓòÉΓòÉ 1.5.2. Toolbar ΓòÉΓòÉΓòÉ

 The toolbar offers icons for most of the functions in ZOC.

You will see a description for each icon, if you move the mouse over it and
wait half a second.

You can Customize the Toolbar from the Options Menu or by clicking with the
right mouse button on the toolbar.


ΓòÉΓòÉΓòÉ 1.5.3. Custom Button Bar ΓòÉΓòÉΓòÉ

 The custom button bar is located beneath the toolbar and offers buttons that
can be defined in Button Options of the Options Menu to start REXX programs or
send text.


ΓòÉΓòÉΓòÉ 1.5.4. Main Window ΓòÉΓòÉΓòÉ

 The main window displays the received text.

You can bring up a popup menu by clicking the right mouse over the main window.

You can mark text with the left mousebutton (this is called stream mode).

If you hold the Alt key pressed while marking text, the selection will be made
in block mode rather than in stream mode (block mode lets you select arbitrary
rectangular areas on the screen, stream mode is line orientated).

If you hold the Ctrl key pressed while doing the selection, the text will be
appended to the text that already is in the clipboard rather than overwriting
it.

The marked text is copied into the clipboard and can be accessed from the
functions Send, Send without CRs, Send quoted, Send CIS-quoted, Print and Edit
in the Cliptext Menu and with some key shortcuts.


ΓòÉΓòÉΓòÉ 1.5.5. Chat Field ΓòÉΓòÉΓòÉ

The chat field is an entry field into which you can enter text. The text is not
sent until you press enter. This is helpful if you are in an online conference
or if you use a remote shell that does not provide command editing and history.

The chat field can be activated from Window Options or by pressing Alt+C or by
pressing the Scroll-Lock key (the latter, only if defined accordingly in
Terminal Options).

If the cursor is in the chat field, you can discard it by pressing ESC, Alt+C
or the Scroll-Lock key.

You can use arrow keys to retrieve the last few lines you typed (this works
like the command history in an OS/2 shell).


ΓòÉΓòÉΓòÉ 1.5.6. Status Line ΓòÉΓòÉΓòÉ

 The status line provides information about and access to some options (if your
ZOC window is not wide enough (because of a small font) some of the information
will not be available).

Using the right mouse button in the status line brings up a popup menu that
gives access to all options dialogs.

 Serial Parameters
    This button displays the currently set line speed and parameters. Clicking
    on the field with the left mouse button brings up the Serial Options
    dialog.

 Transfer Protocol
    This button displays the currently set file transfer protocol. Clicking on
    the field brings up the Transfer Options dialog.

 Emulation
    This button displays the current terminal emulation. Clicking on the button
    brings up the Emulation Options dialog

 Timer
    This button displays the timer. The value depends on the currently set mode
    (see Cost Description and Window Options).

    A lowercase letter a-h means that a timer unit is selected and that the
    timer was stopped. A capital letter indicates that the timer is running. A
    number (n) after the letter indicates that the n-th time section for the
    distance zone is currently used.

    A click on the button brings up the Timer Options dialog.

 LEDs
    The four LEDs in the status line provide two services:

    If they turn green, your host has requested the Vt100 LED service and sets
    the LEDs according to the application you run. The LEDs will stay green
    until you change the emulation or clear the screen from the Misc Menu

    If they are red they display additional status information:

    LED 1
       ON: Modem Carrier Detect

       OFF: No Carrier.

    LED 2
       Bright Red: Script running.

       Blue: Doorway mode active.

       Pink: Autologin running.

    LED 3/4
       Modem receive-data and send-data. They can be turned off in the Window
       Options.

 Logfile
    This checkmark displays the name of the logfile and opens or closes it.

 Online Time
    This shows how long you are (or have been) connected to a host.

 Window Size
    This shows the size of the window (colums x rows).


ΓòÉΓòÉΓòÉ 2. Menu Overview ΓòÉΓòÉΓòÉ

 The menu provides seven submenus which give you access to ZOC's functions:

o MODEM

o LOGFILE

o CAPTURE

o CLIPTEXT

o TRANSFER

o MISC

o OPTIONS


ΓòÉΓòÉΓòÉ 2.1. Modem Menu ΓòÉΓòÉΓòÉ

 The modem menu manages all necessary functions to maintain the modem an to
connect to a host.

 Initialize
    This function sends the init string defined in the Modem Options to the
    modem to set it to a defined state. It will do this regardless of the
    current carrier detect state.

 Manual Dial
    This function opens a window to enter a phone number. This number is then
    dialed using the dial string (see Modem Options) you specify in the window
    as well. If the number is busy or cannot be reached for any reason, ZOC
    will redial it using the options specified in the Phone Book Options.

 Hangup
    Disconnects the line using the hangup method defined in Modem Options

 Send Break
    Pulls the data pin of the modem low for a given time (see Modem Options).
    This is called 'sending a break'. Some systems use this to stop the current
    operation.

 Auto Answer
    This function enables/disables the auto answer mode of your modem using the
    commands you set up in Modem Options In auto answer mode the modem will
    automatically pick up the phone when the phone rings and will try to
    establish a data connection with the calling modem (of course this is not a
    good idea when you expect voice calls).

 Phone book
    The phone book is a dialog to maintain your personal dialling directory or
    to connect to one or more numbers from it (see Phone Book).

 Call next
    If you select more than one host to call in the phone book, ZOC connects to
    the first of them that is available. After finishing the call you can
    select this function to try to reach the next available host.

 Call XXXX
    At the end of the modem menu appear those entries from the phone book that
    have the Menu Access option enabled (see Changing Phone Book Entries. This
    is handy for hosts you call often.


ΓòÉΓòÉΓòÉ 2.2. Logfile Menu ΓòÉΓòÉΓòÉ

 ZOC maintains four different logging methods. One is logging to a memory
buffer, (called Capture) so you can review data that scrolled off the screen
during a session. Another is the logfile that logs all incoming data
permanently to a file on the hard disk. Yet another is redirecting all incoming
data directly to the printer. The last one, the call log, logs time, duration,
cost and file transfers of your calls to a file (see Call Log).

The Logfile Menu controls the logfile and printer logging.

 Set Name
    Set the name of the current logfile. The name can be automatically selected
    from the phone book when connecting to a host (when starting ZOC the
    logfile gets its name from Capture Options). You may use special
    placeholders for the name as described in the Capture Options and the Code
    Section of the appendix.

 Default Name
    This sets the logfile to the file defined in Capture Options.

 Log active
    This function changes the toggles the status of logging between on and off.
    This can also be achieved by clicking on the capture name in the Status
    Line and can be done remotely if your host supports the DC2/DC4 logging
    protocol (see Capture Options).

 Delete
    Since you can build logfile names that contain the current date you might
    end up with a lot of logfiles. Using this function lets you delete logfiles
    you do not need any more.

 Log to printer
    Sometimes it is handy to have part of a session sent to the printer. This
    is possible by enabling this function before receiving the data (eg. before
    reading a mail).

    Additionally it is possible to print already received text, by opening the
    capture window (see Capture Menu), marking the text with the mouse (to copy
    it to the clipboard). and printing the contents of the clipboard from the
    Clipboard Menu


ΓòÉΓòÉΓòÉ 2.3. Capture Menu ΓòÉΓòÉΓòÉ

 The capture menu manages all functions necessary to log incoming data in a
memory buffer (called Capture) to scroll back and review received text during a
session. All incoming data can be logged to a file (logfile) and/or printer as
well (see Logfile Menu.

 Browse
    This function shows the contents of the capture (for more information see
    Browse Window).

 Clear
    Clears the capture buffer. This function is affected by the Safety Options.

 Load
    Loads a file from disk to the end of the capture buffer.

 Edit
    Starts the editor defined in Directories with the contents of the capture
    buffer. After you leave the editor, the modified contents will be moved
    back into capture buffer.

    Note:  This functions closes the browse window if it is open.

 Print
    Sends the entire contents of the view buffer to the printer (also
    availalble from the Toolbar). Of course this can result in a lot of
    printing.


ΓòÉΓòÉΓòÉ 2.4. Cliptext Menu ΓòÉΓòÉΓòÉ

 Cliptext is text that is stored in the clipboard of the WPS. Normally it is
copied from a ZOC screen by marking characters with the left mouse button (this
can be combined with the Alt key), but it can be copied or cut from an editor
or any other program as well.

 Mark
    This function is just an info message of how to put text from screen into
    the clipboard.

 Copy Window
    This function copies the entire contents of the ZOC text window into the
    clipboard.

 Send
    This function takes text from the clipboard and sends it to the modem. The
    sending is done like an ascii upload and the delay and CR/LF translation
    from Ascii Upload Options are used.

 Send (no CRs)
    Takes text from the clipboard and sends it to the modem. Carriage Returns
    are ignored and a Space is sent instead. This function is affected by the
    Ascii Options in the Transfer Options window.

    Imagine the following case: You searched a host for files with the keyword
    TERM and the host gave you a list of filenames - one in each line. To
    download all files, you could mark the list with a box (left mouse button
    while pressing the Alt key) and send them with a space between them when
    the host asks for the filenames to download.

 Send quoted
    Text from the clipboard is sent. Each line is preceeded by '> ' to indicate
    a quotation. If you press the shift key while selecting this function, ZOC
    will reformat the text to fit into the line before sending it. The function
    is also available from the Toolbar and is affected by the Ascii Upload
    Options in the Transfer Options window and Quote always smart in the Window
    Options window.

    Note:  If you hold the shift key pressed while selecting this function, the
    text will be reformatted to fit a given width.

 Send CIS-quoted
    The quoting style of the Send Quoted function is used widely across the
    networks. However, on Compuserve most people quote text by starting the
    quotation with >> and ending it with <<.

    This function works the same as Send Quoted but uses the Compuserve
    quotation style.

    Note:  If you hold the shift key pressed while selecting this function, the
    text will be reformatted to fit a given width.

 Edit
    Calls the system editor (see Directory Options) with the contents of the
    clipboard. After saving, the new contents is written back into the
    clipboard.

 Print
    Sends the contents of the clipboard to the printer (the printer port is
    defined in Directory Options).


ΓòÉΓòÉΓòÉ 2.5. Transfer Menu ΓòÉΓòÉΓòÉ

 The transfer menu allows you to send files to the host or receive them from
it.

 Upload
    Sending a file to a host is called an Upload. To do this the sender and
    receiver use certain methods called Transfer Protocols. The upload function
    sends a file to the host using the currently active protocol (see Transfer
    Options).

 Download
    Receiving a binary file from a host is called a Download. The same transfer
    protocols are used as for uploads. Downloads are affected by the Transfer
    Options.

 ASCII Send
    This functions takes text from a file and sends it to the modem without
    using a file transfer protocol. Roughly spoken, an ascii upload is the same
    as typing text very fast. This way you can prepare messages using an editor
    before you call a host and then send the file with this function when the
    host asks you to type your message.

    Note:  If the host loses characters in this process, you can specify a
    delay for each character in the Transfer Options window.

 Plugs
    This function gives access to add in modules (so called Plug-In-Protocols)
    and lets you do Setup, Upload or Download for them. Plug-In-Protocols are
    provided from third party and are stored in DLL files named PIP*.DLL.

    Currently there are PIPs available for Kermit and Compuserve-B file
    transfer.

    If no such modules exist in your ZOC directory, this function will be
    disabled.

 Transfer Shell
    Transfer shell launches a command processor from which you can start
    command line based external protocols that can accept a file handle for the
    com port. The handle of the communications port is given in the environment
    variable ZOCHFC.

    Example:

        M2ZMODEM -u %ZOCHFC% -r .\DOWNLOADS


ΓòÉΓòÉΓòÉ 2.6. Misc Menu ΓòÉΓòÉΓòÉ

 Start Script
    Starts a REXX program (or script). REXX is something like a batch programs
    for ZOC, which lets you process specific tasks automatically (see ZOC
    Automation).

 Stop Script
    Stops a currently running REXX.

 Edit Script
    Call the editor to modify a script file manually.

 Learn Script
    Most of the time REXX is used automate logins. Writing these is a rather
    tedious and boring task that can, for the most part, be done automatically.
    If you select this function before calling a host, ZOC will monitor the
    login process and create a REXX program that handles the login
    automatically.

    Note:  The program will only contain the code neccessary for the log in. It
    will not contain commands to call that host (which is normally done from
    the phone book and not from script).

 Stop Learning
    After you enabled script learning and logged into a host you tell ZOC to
    stop the learning process. ZOC will ask you for a name and store the script
    accordingly. The name you use can be entered into the REXX field of a phone
    book entry (see Changing Phone Book Entries). and ZOC will execute it to
    log you into that host after making a connection.

 Lock Macros
    Lock the macro keys to prevent unauthorized use.

 Unlock Macros
    Unlock the macro keys again. If defined, the password from Safety Options
    is required.

 Reset Timer
    Reset the timer in the status line which displays the time or cost of your
    current call.

 Hold Timer
    Stop the timer in the status line which displays the time or cost of your
    current call.

 Release Timer
    Restart the timer in the status line which displays the time or cost of
    your current call.

 Set Timer
    Set the timer to a specific value.

 Split Chat
    The split chat function splits the screen horizontally and shows text you
    type in the lower half while displaying text you receive in the upper. This
    is handy if you want to chat with someone who called you by modem.

    Note:  You should not use this function while accessing a remote host.

 Clear Screen
    This functions just clears the terminal screen and resets the LEDs in the
    Status Line back to red.

 Snippets
    ZOC monitors your input data stream for filenames, fido node numbers,
    Compuserve user IDs and internet adresses and collects them in a little
    window that floats aside the ZOC window. Using this function you can show
    or hide the Snippets Window. When it is showing, you can send one of the
    collected items by double clicking it with the mouse.

    Note:  This feature needs a bit of cpu power, so if you don't need it or
    don't have fast machine you should disable it in the Window Options. A good
    compromise is to hide the window most of the time (thus monitoring the
    input stream but saving the cpu power to update the window) and to show it
    (using the Alt+. key combination) when it is needed.

    Note:  You can change the font of the Snippets window by dragging a font
    from the System->Setup->Fonts folder of the WPS and dropping it above the
    Snippets window.

 Editor
    Call the editor defined in the Directory Options.

 OS/2 Shell
    Call the shell defined in the Directory Options.


ΓòÉΓòÉΓòÉ 2.7. Options Menu ΓòÉΓòÉΓòÉ

 The options menu is used to define the characteristics of ZOC.

There are basically two kinds of options: global options and option sets.

The global options (like directory or sound file names) remain the same for all
the hosts you call, while options from the options sets (like the settings of
the macro keys or character translation) will very likely change from host to
host. Different option sets can be stored in files an can be retrieved when
calling a host. There is one special option set named STANDARD which is used
when you start ZOC.

 Global
    Display a submenu to jump to one of the global option definition dialogs
    (see Global Options).

 Settings
    Opens a settings notebook to define all kind of options (see Options
    Notebook).

 Jump to
    Display a submenu to jump to a specific page in the options booklet.

 Save
    Save the current set of options to disk.

 Save As
    Save an options set in a file with a different name. If saved as STANDARD,
    it will be loaded automatically when ZOC is started.

 Load
    Load a set of options.

 Reset
    Reset the current options set to the default state.


ΓòÉΓòÉΓòÉ 3. Phone Book ΓòÉΓòÉΓòÉ

Select How to use the phone book or Changing a phone book entry.


ΓòÉΓòÉΓòÉ 3.1. How to use the phone book ΓòÉΓòÉΓòÉ

 The phone book acts as a personal dial directory for numbers you call with
your modem. It is subdivided into four sections (default, 1st, 2nd and 3rd
alternate) which means, that you practically have four different phone books.

The main window lets you select one or more hosts to call and gives you
functions like Delete or Edit that are necessary to maintain the list.

 Dial
    Connects to one or more selected entries. If you select more than one entry
    (to do this, hold the Ctrl key pressed while you click on one entry after
    the other with the mouse) ZOC will connect to the first that is available
    and store the others in an internal dial queue so you can call them later
    (using the Call Next operation from the Modem Menu).

 Delete
    Deletes one or more entries from phone book.

 Edit
    Changes the data of the selected entry (check Changing a Phone Book Entry
    for details).

 New
    Creates and edit a new entry in this section of the phone book.

 Clone
    Creates and copy of the selected entry and opens the edit window.

 Due
    Selects all entries which are due for calling (marked with a little yellow
    flash in front of the phone number). ZOC determines the entries that are
    due for calling by looking at the date of the last call and the 'Call after
    xx days' field from the edit window.

 Print
    Prints the selected entries.

 Default Book#1/2/3 All
    These buttons show the selected section of the phone book.

 Options
    Show the phone book options (this is the same as calling the phone book
    options from the options menu).


ΓòÉΓòÉΓòÉ 3.2. Changing a phone book entry ΓòÉΓòÉΓòÉ

 Name
    A name for the entry. For multi port hosts, you should use names that are
    equal in the first six characters (eg. AVALON-1, AVALON-2 ...). This ZOC
    will maintain call dates and the like for all ports of the host instead of
    updating only the one that was called.

 Phone number
    The phone number of the host.

 Call every XX days
    If ZOC finds a carrier detect signal after calling a host, it will update
    the date of last call for the called entries (and all others that are equal
    to the one that was called in the first six characters of the name, thus
    managing multi-line hostes correctly, see above).

    If you want to call a host regularly (say once a week) you can enter the
    number of days here after which ZOC should remind you (by showing a symbol
    in front of the phone number in the main window) that it is time to call
    that host again.

 Phone book
    Select the phone book section to store this entry to.

 Sort first
    The phone book is sorted according to the Phone Book Options but you might
    have entries that you want on top of the list regardless of their name,
    last call or whatever it is you use to sort the list. This option will send
    the entry to the top of the list.

 Menu acess
    Select this if you want the host to be accessible from the modem menu.
    Insert a tilde before a character in the name (eg. ~ZOC InfoBBS), to create
    a shortcut for the menu item.

 Group call
    If you call hosts that have multiple phone numbers you should create one
    entry for each phone number and name them in a way that the first six
    characters of the entries are the same (see above).

    If you don't want to select all these entries to call that host you should
    enable the group call option for one (or all) of them. This way ZOC tries
    the other lines as well to connect to the host.

 Options file
    Enter the name of an options file to be loaded before setting the serial
    parameters, the emulation and filetransfer the protocol. The option file
    must be preceded by a path (eg. OPTIONS\COMPUSRV.OPT).

    This way you can have entirely different options for different hosts.

 Serial parameters
    Serial parameters to be set before calling the number (eg. 19200-8N1).

    If you leave this field blank, the current setting or the setting from a
    loaded options file will be used.

    You may leave out the options (and just type a line speed).

    If you just want to set the options and leave the current line speed
    unchanged set the speed to zero (eg. 0-7N1).

 Emulation
    Select an emulation to use after loading the options file but before
    calling the host.

 Protocol
    Select a protocol to set after loading the options file but before calling
    the host.

 Logfile
    This is a name to be used for logging the session. Special placeholders
    (for date or time) can be used as described in Capture Options.

 Script File and Arg
    The name of a REXX (or Script) file to be executed after the dialler has
    made a connection to the given phone number (for REXX programs the argument
    will be supplied in ARG()).

    Such a script could be used to log you into the host automatically.
    However, for simple login procedures (like sending user name and password),
    the AutoLogin feature or IEMSI (both described below) are more handy.

    Note:  IEMSI is only available if you enter a password.

 Prefix
    Select a dial command (from the Modem Options) to be used to dial the phone
    number.

 Zone
    If you set up the Phone Cost Description you can specify the distance zone
    to be used to calculate the phone cost for calls to this host.

 Password
    You can add a password for the host here. If you connect to the host you
    can send the password by defining a macro key as ^& (or by sending ^& from
    a REXX script).

    That is, if your F12 key is set to the text ^&, you can answer the password
    prompt of the host by pressing F12 (see Macro Keys).

    However, it is more convenient to let the AutoLogin feature (see below)
    handle the entire login.

 IEMSI
    Many bulletin board systems offer a method called IEMSI to automate the
    login procedure.

    Using this method you can provide your name in the IEMSI options window and
    set the password field to the password you use to log into that host.
    Additionally you can specify some options that are used by host.

    During the login the host will send and IEMSI request (**IEMSI_IRQ) to
    which ZOC responds by sending your user name and password to the host. If
    everything goes well, the host will let you in at once and show (or skip)
    news, new mail and new files as selected in the IEMSI options window.

    If you leave the name field empty, ZOC will use the name supplied in the
    Modem Options.

    Note:  This button is only available if you entered a password for this
    host.

 AutoLogin
    This field contains a sequence of events (either wait (W) or send (S)
    events) that logs you into the host automatically. Since most logins can be
    handled in a form like 'wait for this, then send that' ZOC offers a method
    to do exactly this without having to deal with REXX programming.

    To send special keys like Enter or ESC you can use control codes as
    described in the Appendix.

    S0=...
       If defined, S0 is sent unconditionally after a carrier signal was
       detected. It can be used to raise the attention of the host.

    Wn/Sn=...
       Define pairs of words to wait for and to reply then. Text to wait for is
       listed as W1, W2 ..., the corresponding text to be sent is given as S1,
       S2 ... (see example below).

    Note
       the W and S characters must not be lowercase letters

    Example


              W1=Esc|S1=^[|W2=Name|S2=Zaphod^M|W3=Password|S3=HeartOfGold^M
       This example means: To log in, first wait until the host sends the
       characters Esc, then send the ESC character to the host. After that wait
       until the host sends Name, and send Zaphod<Enter> back. Then wait for
       the text Password and send the text HeartOfGold<Enter>.

    Note:  You don't have to write such AutoLogin sequences yourself, since you
    can tell ZOC to learn it from watching you the next time you call this
    host.

 Memo
    This first line of the memo stores a short note about the host. You might
    want to enter the name of the sysop or other info about the host here (for
    passwords you should use the AutoLogin feature or the password field). The
    other fields are maintained by ZOC and cannot be modified.


ΓòÉΓòÉΓòÉ 3.3. The AutoDial feature ΓòÉΓòÉΓòÉ

 When you selected one or more entries from the phone book or choose Manual
Dial from the Modem Menu the AutoDial window will pop up. It will try to
connect you successfully to the number(s) you selected. If a number is busy it
will try the next in the list (if more than one was selected) or retry the
number. To do that, AutoDial will use the values you set in Phone Book Options
to define the maximum number of retries and the time between attempts to call
the same number (see note about redial delay in Phone Book Options).

During AutoDial you can control the operation using four buttons:

 Cancel
    Abort calling.

 Redial Now
    If AutoDial waits to call the next number you can skip the delay and redial
    at once.

 Skip This
    This function skips the call to a number and proceeds with the next in the
    list. The skipped number will be called later.

 Forget This
    This function cancelles the attempt to call a number and proceeds with the
    next in the list. The cancelled number will be removed from the dial list.


ΓòÉΓòÉΓòÉ 4. Browse Window ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 5. Customizing ZOC ΓòÉΓòÉΓòÉ

 There are basically two sets of options, Global Options and Option Sets.

Global options hardly change once you defined then while it is very likely that
the options from options sets will differ with different hosts you use.
Therefore there is only on set of global options but you can have as many
options sets (containing the other options) as you like.


ΓòÉΓòÉΓòÉ 5.1. Help for Global Options ΓòÉΓòÉΓòÉ

 Global options (as opposed to the options from the Options Sets are valid up
for all connections you make. They contain options that, once they are set,
hardly change at all.

Global options are

o Directory and File Names

o Tool Bar Icons

o Keyboard Redefinition

o Phone Cost Description

o Phone Book/Dialling Options


ΓòÉΓòÉΓòÉ 5.1.1. Defining Directory and File Names ΓòÉΓòÉΓòÉ

 The names defined here are the default directories and file names that are
used in file selection windows or special functions.

Most of them are rather straightforward but some need a few words of
explanation.

 Alt Downl.
    This field defines a directory into which special files are downloaded. The
    file extensions of the files to be put into this directory are defined in
    the transfer section of the options notebook. This directory is mosty used
    to receive mail packets for popular offline mail readers like BlueWave or
    Kurt Westerfield's KWQ (which is an excellent shareware product, highly
    recommended).

 Editor
    This defines the editor to be used when calling the Cliptext Edit function
    from the Cliptext menu, or when calling the Edit function from the Misc
    menu.

 Shell
    Shell defines a shell to be opened, when calling the OS/2 Shell function in
    the Misc or Transfer menu. This shell is also called with the /C parameter
    if you issue a SHELL command from within a ZOC script.

 Call Log
    This file is a file to which ZOC logs calls to BBSs (C+/C- means
    connect/disconnect) and file transfers (DL means download, UL means
    upload). However, the Call Log is maintained only, if you have Valid CD
    signal enabled (see Terminal options).

 WAV files
    These are sounds to be played to indicate certain events (of course MMPM/2
    has to be installed for this). They should be entered with full path.


ΓòÉΓòÉΓòÉ 5.1.2. Setting up the Tool Bar ΓòÉΓòÉΓòÉ

 The toolbar makes functions easily accessible offering icons for them.

To customize the toolbar you can select/deselect icons from a list by clicking
on them with the mouse. Those entries in the list that are drawn with dark
background will be shown in the toolbar (if the window is wide enough).

Additionally (depending on screen resolution and your personal taste) you can
select if you want the icons in the toolbar to be large or small.


ΓòÉΓòÉΓòÉ 5.1.3. Redefining the Keyboard ΓòÉΓòÉΓòÉ

 Generally ZOC produces the correct codes and functions for all keys on the
keyboard. If you need customizable keys, you should use the f-keys (available
in the macros section of the options booklet).

However, in special cases it might be necessary to be able to redefine other
keys.

Warning: It is not recommended to redefine key combinations that are already
covered by ZOC (like the arrow keys). These global keyboard remapping
circumvents ZOC's normal key processing (only menu shortcuts take higher
precedence) and might interfere with normal operation.

To redefine a key, first select the key qualifiers (Shift, Ctrl, Alt, Num Lock,
Scroll Lock), then click on a key to bring up the key redefinition window.


ΓòÉΓòÉΓòÉ 5.1.4. Redefining One Key ΓòÉΓòÉΓòÉ

 After you selected a key to be redefined in the keyboard redefinition window,
a small window appears into which you can type the new value that is sent if
you press that key together with the selected combination of key qualifiers
(eg. Alt+Ctrl+Z). Additionally you can restrict the redefinition to a special
terminal emulation, that is, if you need a combination for VT100 only, you
would deselect the ANSI checkbox.

Note:  Only simple Control Codes as listed in the appendix can be used.


ΓòÉΓòÉΓòÉ 5.1.5. Setting up the Phone Cost Description ΓòÉΓòÉΓòÉ

 To monitor phone charges you need to describe how the cost is calculated based
on the duration, time of day and distance of a call.

First you setup up days and times of day that are of interest for the
calculation. In most countries it is cheaper to make calls in the evening and
on weekends than it is during working hours from monday to friday. So, you will
probably end up with three blocks of time like 08:00:00-18:59:49 Mo-Fr,
19:00:00-07:59:59 Mo-Fr and 00:00:00-23:59:59 Sa/Su.

If, like in Germany, some calls don't depend on the time of day, you would need
an additional entry to covers these: 00:00:00-23:59:59 Mo-Fr/Sa/Su.

Next, you would give names like local, near, far, intl. to the distance zones
in the field after the distance zone letters (A-H).

Then you would describe what a call costs at any time of day in the form
<cents>/<seconds>@<time of day> (speak cents per second at time of day) for
each distance zone. For example, if your telephone company charges 6 cents per
minute during working hours and 3 cents per minute during evening hours and
weekends, you would enter 6/60@T1, 3/60@T2 and 3/60@T3 in the fields after the
distance zone description.

Note:  There is an important difference between defining 0.1 cent per one
second and 6 cents per sixty seconds. In the former case you will be billed
exactly 0.1 cent per second, in the latter you will be billed 6 cents at the
beginning of every minute (the minute is called a time-unit). This way you get
18 cents for a 2 minutes 10 seconds call instead of 13 cents (as in the first
case).

If all this is done correctly you can go to the phone book and edit the entries
to assign distance zones to them. After you call such an entry, ZOC will show
you the cost of the call in the Status Line, sum it up in the phone book
entries memo field (see changing phone book entries) and log it to the call log
file (see Directory Options).


ΓòÉΓòÉΓòÉ 5.1.6. Setting up the Phone Book/Dialling Options ΓòÉΓòÉΓòÉ

 The phone book options control the working of the phone book and of the
AutoDialler.

 AUTO DIAL
    The auto dialler is used when you select the dial function from the Phone
    Book or from the Modem Menu It tries to connect you to a given number and
    retries several times if it fails. You can specifiy the maximum number of
    retries and the time between trials of the same number (if, for example,
    you set this time to 10 seconds and select three entries from the phone
    book to be called and the call to all of them fails, the first one will be
    called immediately after the third since trying the second and the third
    will verly likely need more 10 seconds).

 MISCELLANEOUS

    Load standard options after disconnect
       If this option is enabled (which is recommended) ZOC loads the default
       option set after you disconnect from a host session. This way you will
       have the standard options always active, even after calling a host that
       uses unusual options (eg. a slow transfer speed).

    Show phone book after program start
       If enabled ZOC will open the phone book directly after being started.

    Multiple selection without Ctrl key
       Normally you have to hold the control key down to select several non
       contigous entries from the list (which is the way how it is done across
       the entire WPS).

    Large font
       You can choose between a large and a small font to display the list of
       hosts in the phone book.

    Sort order
       Select a sort criteria to control the order in which the hosts are
       presented in the main window of the phone book.

 IEMSI Defaults
    Some BBSs support a method to log in automatically that is called IEMSI
    (you can tell if a BBS supports IEMSI from the **EMSI_IRQ it sends before
    asking for your name (not to be confused with **EMSI_REQ)). The IEMSI
    options are specified for each phone book entry (and are discussed in
    Changing Phone Book Entries), the IEMSI options specified here are the
    defaults that are used if you create a new phone book entry.


ΓòÉΓòÉΓòÉ 5.2. Option Sets ΓòÉΓòÉΓòÉ

This booklet contains all options. Select a tab with the mouse to open the
according dialog.

Available tabs are: Serial, Terminal, Capture, Modem, Transfer, Emulation,
Macro Keys, Custom Buttons, Window, Safety, Character Translation,


ΓòÉΓòÉΓòÉ 5.2.1. Serial Options ΓòÉΓòÉΓòÉ

 This window is used to define serial parameters. It can be opened via menu or
by clicking on the transfer speed button in the status line.

 Transmission
    In this section you define how data is transferred between your computer
    and the modem (which is not neccessarily the same way the modem uses to
    transfer data across the telephone line). You have to select a speed (bits
    per second), the number of databits, a parity mode (none, even, odd, mark
    or space) and the number of stop bits.

    What you use depends mostly on your host (and, of course, on your modem
    limits).

    These settings are often given (eg. in instructions of how to call a host)
    in an abbreviated version, like 38400-8N1 (38400 bits per seocond, 8 data
    bits, no parity, one stop bit).

    Note:  If you have a modem with data compression (MNP5 or V.32) you should
    use a speed that is higher than the actual speed your modem supports. Today
    14,400 bps modems are very popular. These use online data compression which
    allows them to transfer actually more than the theoretical maximum of 1440
    bytes per second. To take advantage of this, you should access these modems
    with 19,200 or 38,400 bps.

 RTS/CTS handshake
    If enabled, ZOC uses RTS/CTS hardware handshake for communication with your
    modem.

    RTS/CTS is used to control the flow of data between the computer and the
    modem and provides a way for both to prevent the other from sending data.

    This is essential for file transfers when the speed of the modem to modem
    connection is different from the modem to computer connection (which is
    true for MNP5 of V.42 modems). It is also essential in a multitasking
    environment where the processor might have other things to do when data
    arrives.

    Thus, it is highly recommended to have this option enabled. However, the
    modem needs to support it as well, so check your modem manual for the
    proper modem command to "enable bidirectional RTS/CTS hardware flow
    control" for use in the modem init string (see Modem Options).

 DSR handshake
    This DSR/DTR handshake is somewhat similar to RTS/CTS as it is a handshake
    method as well. It does not control the data flow, but the general
    availability of the modem and computer (ie. if these are turned on).

    If enabled, ZOC monitors the DSR signal for communication with the modem.
    This option should only be enabled if your modem and your cable properly
    provide the DSR signal. Otherwise ZOC will be blocked.

 XON/XOFF
    If enabled, ZOC uses the Xon/Xoff software handshake for communication
    (which is yet another method to control the data stream). It uses special
    characters to hold/release the sender. This method is inferior to RTS/CTS
    handshaking and should only be used if necessary.

 Valid CD signal
    If your modem supports the Carrier Detect (CD) signal (most modems will do
    this if you add AT&C1 to the modem init string in the Modem Options), you
    should enable this option (which is highly recommended).

    ZOC uses the CD signal to control the connection timer and phone cost
    calculation as well as to write a calling log to the file defined in Path
    Options.

 AutoSpeed
    If enabled, ZOC automatically sets the transfer speed to the one received
    when the modem sends a message like 'CONNECT xxxxx'.

    This should not be used if you use a modem that is capable of data
    compression (as MNP5 and V.32 modems are)!

 Device
    You specify the device to which your modem is connected here (probably COM1
    or COM2). Additionally you can select that ZOC should release the device
    when the window is minimized to let you use a FAX program or another
    communications program (alas!) without having to close ZOC.

 Break signal duration
    The duaration that is used for sending a break signal (some hosts use this
    to break an operation) when pressing Ctrl+End. It is given in milliseconds
    and typically ranges from 250 to 400 ms.

 Timeout blocking
    Some hosts (or in Germany most modems) disconnect after some time
    (typically between one and five minutes) of silence on the line. To prevent
    this, you can tell ZOC to send some characters or a break (^!) after some
    time of silence (which should be, of course, shorter than the timeout of
    the host). It is a good idea to use a string that does not invoke any
    unwanted action (like paging the sysop for a chat), but something neutral
    like ^M (enter), ^! (break signal) or * (which jumps to the main menu on
    some hosts).


ΓòÉΓòÉΓòÉ 5.2.2. Creating a Modem Init String ΓòÉΓòÉΓòÉ

 It sometimes is not easy to find the proper modem init string. Some comm
programs offer modem databases but with new modems coming to the market almost
every day it is hard to ensure correctnes of these.

On the other side, it is not very hard to dig the correct commands from the
modem manual if one knows for what to look.

 Modems with data compression have a rather tricky setup, but since modem
manufacturers don't want to spend all their profits on customer support, most
of these modems have two factory profiles: Data compression enabled and
disabled.

These profiles can be activated by using rather simple commands (probably
AT&F1), so it is very likely that all you have to do, is to check your modem
manual for factory profile command and use that as the modem init string, eg.
AT&F1^M (if you use data compression make sure you have RTS/CTS and a
high-speed enabled in the Serial Options).


ΓòÉΓòÉΓòÉ 5.2.3. Terminal Options ΓòÉΓòÉΓòÉ

 This window is used to define gerneral terminal characteristics. It can be
opened from the menu or by double clicking the space between the buttons in the
status line.

 TERMINAL

    Incoming CR -> CR/LF
       This options ensures, that each incoming Carriage Return is followed by
       a Line Feed. Use this if received text is printed over and over in the
       same line without advancing to the next.

    Strip high bit
       If enabled, all characters in the terminal window are printed with 7
       bits. This can be used if you receive graphical characters where text
       should appear (of course, it does not help if bursts of noise from the
       phone line send garbage to your screen).

    Show ctrl chars
       Show received control-codes as plain text (eg. ^I for TAB) instead of
       using them. It is used mostly for problem determination.

    Show hex dump
       This options shows incoming characters as hexadecimal values. It is used
       only for problem determination.

    Destructive backspace
       This options erases characters from the screen if a backspace is
       received (instead of just moving the cursor back one step).

    Local echo
       Print all manually typed characters to the terminal window (normally the
       host sends all typed characters back to display them). This option
       should be used if you use a half duplex connection (which are pretty
       rare these days) or if you type to a host that does not provide an host
       echo (eg. if you called a friend's computer who uses a terminal program
       as well; however, in this case you are better off with the Split Chat
       from the MiscMenu).

    Send echo
       Loop back all incoming characters to the originator.

       Warning: This may result in an endless loop if the originator also sends
       an  echo (!!!), which is true for most and hosts.

       You can use this, if a friend called you with his modem.

    Translate characters
       If you call a host that uses a different character set than your
       computer, it is possible to have ZOC translate these into your native
       character set (see translation). The translation can be disabled using
       this option.

    Beep
       This option controls what to do for a beep. Choices are ignore
       (unchecked), acoustic (checked) or visual (shaded). instead).

 CLIPBOARD SENDING

    Quote always smart
       If selected, the Send-Quoted function from the Cliptext Menu will always
       try to reformat the text before sending it. When disabled, reformatting
       is still available by holding the shift key pressed.

    Width
       Reformatting for smart quoting will be done in a way that no line is
       longer than the number of characters specified here.

    Always send quick
       Selecting this option will always send marked text at once if only one
       line is marked on the screen. Otherwise the text will be sent at once,
       if you hold the Shift key pressed while doing a one-line selection.

 SCROLL LOCK
    This option lets you map events to the scroll lock key.

           Ignore
       ZOC ignores the scroll lock state of the keyboard.

    Chat field
       Pressing the Scroll Lock key toggles the chat field (see Window Options
       and Screen Elements).

    Doorway mode
       Pressing the Scroll Lock key toggles the keyboard Doorway mode. (Doorway
       mode is a mode in which special key codes are used. It is required by
       software like OS2YOU).


ΓòÉΓòÉΓòÉ 5.2.4. Capture Options ΓòÉΓòÉΓòÉ

 This window is used to define capture parameters and can be opened via menu or
by clicking on the capture size button on the status line.

 Default name
    When you start ZOC, this name will be used as a default name for the
    logfile. You may use special place holders in the name to be substituted by
    ZOC with values like the current month to create create dynamic names (see
    Special Codes in the appendix). The file will be placed in the log
    directory set in Path Options unless you supply a path with the name.

 Active
    Enable saving incoming data in the logfile.  This is the same as the
    checkmark near the log file name in the status line.

 Append
    If logging is activated, data is appended to a existing file rather than
    overwriting it when you start logging.

 Session headers
    Session headers are a few lines of information which are inserted into your
    capture and log file when connecting to a host. This can only be done if
    you have a valid Carrier Detect signal (see Serial Options).

 DC2/DC4 control
    Some hosts (ie. Compuserve's mail system) are able to remotely control your
    logging by sending DC2 and DC4 characters (the check mark in the status
    line will turn gray if the hosts suspends logging for you). This can be
    disabled.

     Size
    Define the size of the memory buffer to hold data for reviewing sessions.


ΓòÉΓòÉΓòÉ 5.2.5. Emulation Options ΓòÉΓòÉΓòÉ

 This window is used to set the emulation. It can be opened via menu or by
clicking on the emulation button in the status line.

 Swap keys
    If you enable the keys swap option, a Backspace is sent when the DEL key is
    pressed and vice versa, if you are in VT102 mode. This is helpful for many
    VT102 systems.

 Discard codes
    Screen control for ANSI and VT102 is done by sending special control codes.
    Logging of these control codes in the capture/log file should be disabled
    since it makes reading of these rather hard.

    This option is unavailable during TTY emulation.

 Disable VT102 key pad
    In VT102 mode the numeric key pad is used as a replacement for VT102
    auxiliary keypad (see VT102-keyboard). This might be problematic on
    machines without an numeric keypad (eg. Laptops) and can be disabled.

    This option is unavailable during ANSI and TTY emulation.

    Note:  If you need the auxiliary keypad for a VT102 system while having the
    key pad disabled (see above), press Shift+Ctrl and a key from the keypad
    (use '+' for VT102-',' and use 'Del' for VT102-'.').


ΓòÉΓòÉΓòÉ 5.2.6. File Transfer Options ΓòÉΓòÉΓòÉ

 These settings define the characteristics of file transfers. They are accessed
via the Options/Settings notebook or by clicking the file transfer protocol
button in the status line.

 PROTOCOL
    Select X- Y- or Zmodem protocol.

    Note:  Some systems falsely offer protocols named Ymodem and Ymodem batch,
    which really are Xmodem with Block-1024 for Ymodem and Ymodem for
    Ymodem-Batch.

    Note:  Other protocols are available as add in modules an can be found in
    the Plugs function (located in the Transfer menu.

 IF FILE EXISTS
    Select what you want to do if you try to download a file that already
    exists on your system. Additionally specify if you want the old (existing)
    or the new (incoming file) renamed (if rename is chosen).

 Special file extensions
    ZOC lets you list extensions of files that should be downloaded to an
    alternate directory (see Directory Options) and files that should be
    deleted after they are uploaded successfully.

    The extensions may contain the * and ? wildchard characters and need to be
    separated by vertical bars (without space characters) like this:
    GIF|Q*|MO?|TU?

 ZMODEM

    Auto transfer
       If enabled, ZOC starts Zmodem transfers automatically.

 ASCII-UPLOAD
    These options are used for ASCII-Uploads and for sending the clipboard
    contents.

    CR -> CR/LF
       Ensures that each Carriage Return is followed by a Linefeed.

    Char-Delay
       ZOC waits n milliseconds, before sending each character. Four times this
       time is waited at the end of each line.

 XMODEM
    These options only apply when the Xmodem protocol is selected.

    CRC on
       CRC is controlled by the receiver of a file. CRC can be used instead of
       the less reliable Xmodem checksums.

    Block 1024
       With this option Xmodem uses blocks of 1024 instead of 128 bytes. Some
       systems falsely call this Ymodem. The block size is controlled by the
       sender.

    Chop pads
       If enabled, ZOC tries to remove padding bytes at the end when receiving
       a file.

 MISCELLANEOUS

    Start picture viewers
       ZOC is able to show pictures while downloading them. For this purpose
       the files TAP_GIF.EXE and TAP_JPG.EXE are provided in your ZOC
       directory. If you don't like this feature, it can be disabled (you still
       can start a viewer manually from the WPS before downloading a picture).

    Time critical
       Enabling this options boosts ZOC's priority during file transfers, which
       might help to increase transfer throughput and reduce transfer errors in
       some very special cases.

       Warning: This will very likely impair the performance of other tasks.


ΓòÉΓòÉΓòÉ 5.2.7. Modem Options ΓòÉΓòÉΓòÉ

 This window is used to define the strings ZOC uses to communicate with your
modem. These strings may contain control characters (eg. ^M, see Special
Codes), the tilde (~, which is a delay of 1/3 sec) and ^# to be substituted
with a phone number.

 Initialisation
    This is a list of modem commands to set the modem to a given state before
    using it. You should be aware that ZOC (unlike some other programs) reqires
    a ^M at the end of the initialisation string.

    If you don't know what to use for the initialisation string, please check
    the Modem Init section of this help file for advice.

    Depending on your setup, you might want to send the initialisation string
    every time you load an options file (thus having different options files
    for different modem configurations).

    Normally ZOC does not send and init sequence if it finds a carrier detect
    signal from the modem (thus preventing a modem reset while you are online).
    However, some modems provide a CD signal after power on. In this case you
    should enable this option (and add AT&C1 to the modem init string to tell
    the modem to provide a real carrier detect signal).

 Dialling
    ZOC lets you set up four dial commands for calling different types of
    numbers (ie. using a credit card number to make long distance calls). You
    can select the dial command to be used from the Phone Book and when
    dialling manually (from the Modem Menu).

    The dial commands need to consist a ^# sequence to be substituted with the
    phone number you want to call, thus a standard dial command would look like
    ATDT ^#^M (meaning send ATDT, then the phone number and then enter).

    If you want to issue a modem command before dialling you should add some
    tilde characters between the modem and the dial command (like in
    ATZ^M~~~ATDT ^#^M) to give the modem time to process the former.

 Hangup
    ZOC supports two methods of telling a modem to hang up. Using the DTR
    signal of the com port is the superior of the two. If you disable it, ZOC
    will use the ATH command.

 Auto answer
    Here you supply two modem commands to enable and disable the modem's auto
    answer mode. These are ATS0=1^M and ATS0=0^M for basically all modems.

 Modem Response Strings
    Here you provide ZOC with the responses the modem sends when making or
    failing to make a connection. These are used by ZOC to determine if a
    connection was made.

    The modem responses have to be separated by a vertical bar (|) without
    spaces like CARRIER|CONNECT


ΓòÉΓòÉΓòÉ 5.2.8. F-Key Macro Definition ΓòÉΓòÉΓòÉ

 It is possible to map text or REXX file execution onto the F4-F12 or
Shift+F1-F12 keys. F1-F4 are not available, since they are used in VT102 and to
provide help (if you need to define F1-F4 anyway, it is possible to redefine
them using Global Keyboard Remapping

The execution of a script file can be mapped onto a function key by defining
the key as ^$=<scriptname> (eg. ^$=MY_SCRIPT).

If you use the special code of ^& in a macro key, ^& will be substituted with
the value of the password field of a phone book entry after you sucessfully
connected to that host via the phone book (see phone book entries).
Additionally there are special codes for date and time of day. Check Special
Codes in the appendix for a complete list.

Note:  This page of the options booklet may be protected by a password (see
Safety Options).


ΓòÉΓòÉΓòÉ 5.2.9. Definition of the AutoMacros ΓòÉΓòÉΓòÉ

 Besides the function key macros ZOC provides so called Auto-Macros. The idea
of AutoMacros is borrowed from text processing where (at least in good
programs) the feature is called Auto-Correct or Auto-Text.

You can think of AutoMacros as abbreviations. Whenever ZOC finds that you typed
some text that is found in the abbreviations, ZOC will replace it with the full
text you provide here. This is done by sending backspace characters to delete
the abbreviation (if necessary) and then sending the full text (if the
abbreviation and the full text begin with the same characters  ZOC will only
backspace the part at the end that differs, like Datcom and Datacommunication).

To avoid erroneous replacement of characters that belong to a word,
abbreviations are matched case sensitive and replaced only if there is a non
alphanumeric character typed before and after the text. So, if you defined Com
as an abbreviation it will be replaced if you type Data-Com_ or Com-Port, but
not if you type The Com1-Port or DataCom_.

Besides correction of typing errors there are many other uses for this feature
in a terminal application.

o Abbreviations for commonly used phrases like Ttyl being replaced with Talk to
  you later

o Abbreviations for logins like replacing MS with Markus Schmidt^Msecret (to
  send user name and password at login prompts).

o Abbreviations for commands when using a shell on a unix or VAX host. (eg.
  using lo instead of logout).

o Nicknames for e-mail adresses (like replacing ms@ with [e-mail]).

Note:  This feature is disabled during REXX and script execution and during
AutoLogin and Learn mode.

Note:  You can enter text into a Full Text field only if the corresponding
Abbreviation field is non empty.

Note:  This feature is similar to the AutoReplies and some results can be
achived by using both methods. However there are some important differences: 1)
AutoReplies monitor the incoming data stream (sent by the host), AutoMacros
watch the keystrokes from the keyboard. 2) AutoReplies can invoke REXX
programs, AutoMacros can't.

Note:  It is a good idea to append a period or an exclamation mark to the
abbreviation text (like MS. or lo!) to make it really uniqe. This way
inadvertent invocation of the full text will be highly unlikely.


ΓòÉΓòÉΓòÉ 5.2.10. Definition of the Custom Button Bar ΓòÉΓòÉΓòÉ

 Below the tool bar reside a group of user defined buttons that can be
specified here. You can set the value to be sent when the button is clicked
with the mouse as well as a short text to describe the button (which is shown
inside the button in the custom button bar).

It is possible to use the button for script execution, as well as for sending
text (that may contain control codes), a password or the value of a function
key.

Please check Special Codes in the appendix for a complete list.

Note:  This page may be protected by a password (see Safety Options).


ΓòÉΓòÉΓòÉ 5.2.11. Definition of the AutoReplies ΓòÉΓòÉΓòÉ

 Auto replies provide a way to automatically send text or invoke REXX programs
whenever a group of specific characters is received.

To do this, you just enter the text that invokes the action in the
Incoming-Text field and provide some text or a REXX name (preceded by ^$=, see
Special Codes) in the Action field.

This feature can be used to

o Automate logins: You could autmatically send your username and password (or
  ^&, see Special Codes) when receiving the text User name?

o Skip birthday checks: Some hosts ask for your date of birth now and then to
  make sure no one else uses your account. Using AutoReplies you can provide
  the date automatically when receving the prompt.

o Reading mail: When you receive the You have mail notification from your unix
  host, you could start your mail reader by replying ELM^M.

Warning: You should make sure that the text you are looking for really is
uniqe. It is better to wait for the text --More-- than it is to wait for More
to automatically answer such prompts.

Note:  This feature is disabled during REXX and script execution and during
AutoLogin and Learn mode.

Note:  You can enter text into an Action field only if the corresponding
Incoming Text field is non empty.

Note:  This feature is a bit similar to the AutoMacros, please check the note
about the differences provided there.


ΓòÉΓòÉΓòÉ 5.2.12. Window Definition ΓòÉΓòÉΓòÉ

 SCREEN ELEMENTS

    Initial Help
       Here you can turn off the help window that appears when you start ZOC.

    Toolbar
       Here you can turn the toolbar on or off.

    Custom button bar
       Here you can turn the strip with cutom buttons that appears below the
       toolbar on or off.

    Chat field
       Here you can turn off the chat field (see screen elements). The chat
       field is an input field above the status line that lets you type, edit
       and retrieve earlier typed text. The text is sent to the host when you
       press enter. This is useful if you join an online conference with many
       people or if you work with a shell on the remote host that does not
       provide command editing or a command history.

       The chat field can be turned on and off with the Scroll-Lock key as well
       if you defined this in terminal options, or by pressing Alt+C.

       Note:  To chat with a friend who called you, you better use the Split
       Chat feature from the Misc Menu.

    Status line
       Here you can select, if you want to see the status line.

    Snippets
       ZOC monitors your input data stream for filenames, fido node numbers,
       Compuserve user IDs and internet user IDs and collects them in a little
       window that floats aside the ZOC window (see Misc Menu). With this
       option you can hide (unchecked) or show (checked) the window or turn
       this feature off (grayed) to save cpu load.

       Note:  You can change the font of the Snippets window by dragging a font
       from the System->Setup->Fonts folder of OS/2 and dropping it above the
       Snippets window.

 WINDOW SIZE
    You can select the window size here. Additionally you can specify if you
    want ZOC to change the number of rows and colums after the window was sized
    with the mouse, or if ZOC should keep the size and add scroll bars instead.

 WINDOW (FONT/COLOR/HANDLING)

    Font size
       Select a font size for the terminal window from the list (the selection
       of other fonts than System VIO is not possible). Additionally you can
       select that ZOC should try to find a fitting font (while retaining the
       same number of rows and colums) after the window was sized with the
       mouse.

    Hide while dialling
       If you don't want the large ZOC window around while dialling you can
       select this option. In this case ZOC will hide while dialling, just
       leaving the small dial progress window on the screen, and come back
       after it made a connection (or failed to do so).

    To front when carrier detect
       If set, the main window of ZOC will come to the top of all windows if
       the modem carrier detect signal is switched on (as it is when connecting
       to your host). This way you can have ZOC dial in the background and jump
       in if a connection was made.

    Minimize during file transfer
       If you don't want the large ZOC window around during a file transfer is
       going on, this options minimizes the ZOC's main window after starting
       the transfer.

    To front when carrier detect
       If set, the main window of ZOC will come to the top of the desktop after
       a file transfer has been completed. This way you can put ZOC aside to do
       other work during a file transfer without missing the transfer's end.

 BROWSE WINDOW FONT
    Select a font size for the browse window (that shows the capture buffer).
    The selection fonts other than System VIO is not possible.

 NATIONAL SUPPORT
    If your host sends a character set that is supported by an IBM code page
    you can specify it here.

 SCROLL JUMPS
    While offering superior ease of use, graphical user interfaces like the
    OS/2 WPS have to handle far greater amounts of memory to maintain their
    displays than text based user interfaces have (eg. a character in a text
    mode application is stored in two bytes while a 8 by 14 character on a 256
    color screen uses 104 bytes).

    This results in rather high cpu load, especially when scrolling. Because of
    this, ZOC is only able to write text to the screen with about 4800 bps if
    the text appears at the bottom of the window and it's necessary to scroll
    up. However, you can allow ZOC to delays scrolling until a few lines (eg.
    five) of text have arrived. This way ZOC saves CPU cycles (since it needs
    to move the image only one instead of five times and since it does not make
    a difference how far it is moved). Obviously output speed benefits from
    this (while the scrolling appears rather "jumpy" instead of smooth). The
    farther the jumps you select (normally flea jumps should be enough) the
    more lines ZOC will collect before actually scrolling and the faster output
    will be.

 SHOW TIMER AS
    This option controls the display of the phone cost in the status line.

    Money
       Show the time elapsed since connecting to a host (or resetting the
       timer) as a money value (according to the Cost Setup).

    Fraction
       Show how many cost units are used so far.

 MISCELLANEOUS

    Disable RD/SD LEDs
       Here you can turn off the (maybe annoying and, more important, processor
       time consuming) flashing of the third and fourth LED in the Status Line
       that emulate the modem receive-data and send-data LEDs. If the checkmark
       is in indefinate state (shaded) the LEDs will be enabled during text
       output but disabled during file transfer (which is highly recommended
       unless your computer is a real killer machine).

    Big cursor
       Enabling this option makes the cursor in the main window a bit bigger.


ΓòÉΓòÉΓòÉ 5.2.13. Safety Options ΓòÉΓòÉΓòÉ

 Define if you want to be warned before performing "dangerous" operations or if
you want to protect the setting of the macro keys and custom buttons.

 Confirm ...
    This should be self explanatory.

 Warning if high-speed ...
    The RTS/CTS handshaking method provides reliable control of the data flow
    between the PC and the modem. If you use high transfer speeds without
    RTS/CTS handshake you will verly likely encounter transmission errors.
    Enabling this option gives you a warning if you select more than 4800 baud
    without selecting RTS/CTS as well.

 Save options ...
    Here you can select if you want to save options automatically when you
    leave the program.

 Lock Macro Keys
    If you leave your computer unattended for a while, you can lock the macro
    keys to prevent unauthorized use. To unlock them, input of the password you
    define below is required. Locking can also be initiated from the Misc Menu.

 Password
    If a password is specified, the dialogs for Phone Book Definition, Keymacro
    Unlocking (in the Misc Menu) and Macro Key Definition will ask for it,
    because often passwords to access online services are stored in these
    places.

        CAUTION:
    The password is case sensitive and there is no backdoor if you forget it.


ΓòÉΓòÉΓòÉ 5.2.14. Translatioin of Inbound/Outbound Characters ΓòÉΓòÉΓòÉ

 Users in countries that do not use the US-Ascii character set often end up
with the problem that the codes of characters that are sent by the host do not
match the codes used by the terminal program/operating system.

This dialog lets you define the translation of the codes of received and sent
characters or reset these tables to their default (non translating state).

Note:  The translations are only active if the Translate Character option is
enabled in the Terminal Options

Assumed your host sends (and needs to receive) the character  { instead of the
German letter  О (as some hosts in Germany do) and you have the letter  О on
your keyboard. In this case you would change the code 123 of the receive table
into 142 ('123 { -> 142 О' would appear in the window) to translate the
incoming character correctly to your screen and you would convert code 142 of
the send table into 123 to send the code the host expects if the you press the
О-key.


ΓòÉΓòÉΓòÉ 6. ZOC Automation ΓòÉΓòÉΓòÉ

 There are two methods available to automate your work using ZOC:
REXX-Programming and Script-Programming.

The REXX interface was introduced in V2.0 and should be used instead of the
scripts since it has superior execution control (loops, decisions) and variable
management.

Scripts are (and will be) maintained for downward compatibility (they were the
sole method of automation in the 1.x versions of ZOC) but will not be improved
in future.


ΓòÉΓòÉΓòÉ 6.1. REXX Programming ΓòÉΓòÉΓòÉ

 If you are not yet familiar with the REXX programming language you should
check the REXX-Information in your WPS System folder, as OS/2 book (like OS/2
Unleashed) or the printed ZOC documentation. A look at the examples in the
ZOC\SCRIPT\RXSAMPLE directory will teach you the basics as well.

Why REXX?

 Ease of use
    The REXX language offers a large set of structured execution control
    statements like IFs and DOs where ZOC Scripts just offer GOTOs.

 Speed
    ZOC runs REXX programs (unlike scripts) in an own thread (task) parallel to
    ZOC's main thread which gives REXX superior execution speed (compared to
    scripts).

 Standards
    REXX is a standard, scripts are YALTL (yet another language to learn). So
    if you learn how to REXX you will be able to use that knowledge in OS/2
    command files and other applications.

How to REXX

ZOC determines that a file is a REXX program by looking at the first line which
should contain the text /* REXX */

When running REXX programs ZOC adds a few commands to the REXX language (see
REXX Command List in the appendix) to give REXX access to ZOCs communication
features. The particular commands are discussed in the command list and basics
are shown in the printed manual - this section will cover a few very special
topics about the ZOC <--> REXX interface.

 Screen Input/Output
    ZOC supports the REXX PULL and SAY commands which are redirected to the ZOC
    window. However, texts printed using SAY are not scanned for control
    characters (like ^M) while texts printed with the ZOC commands
    WRITE/WRITELN are.

 Command Arguments
    Some ZOC commands use more than one argument (eg. the ASK command). If
    arguments contain space characters, you need quotes to make clear what
    belongs to which argument. For example, in ASK Enter Name the word Name
    could be interpreted as part of the first argument (ie. being part of the
    title) or a second argument (the value to preset the input field with). The
    ZOC interpreter would chose the latter.

    To make the command clear it comes to mind to use quote characters.
    Unfortunately REXX parses away quotes, so, given you would write ASK "Enter
    Name" you would still end up with a window containing the text Enter in the
    title bar and the input field preset with the text Name.

    To work around this problem, you have to use single quote (') to enclose
    the command or argument like ASK я"Enter Name"я or ASK я"Enter Name"я.

    It gets real tricky if you have an argument that is stored in a REXX
    variable. If you use the method described above would get the name of the
    variable instead of its value, if you don't, you would have the problem
    already described. Of course there is a solution and it looks like this :
    ASK я"я || titlevar || я"я.

A Small Example Most of the time you will use REXX to log into a host and do
things automatically for you. Simple logins can be stored directly in the phone
book (see Changing Phone Book Entries) and can be recorded automatically.

The example below does a bit more and shows how to use REXX (as well as the
REXXHOST sample in the SCRIPT directory does). with ZOC.

%include <...\SCRIPT\RXSAMPLE\RXLOGIN>


ΓòÉΓòÉΓòÉ 6.2. Script Programming ΓòÉΓòÉΓòÉ

 The script language is inferior to REXX programming and hence will not be
improved beyond its current state. It is (and will be) mainly available to
maintain compatibility with earlier versions of ZOC.

This section is addressed to those who are already familiar with ZOC scripts
and who don't want to move over to REXX.

The appendix contains a list of all the available script commands. For more
information about variables and common commands check the examples in the
SCRIPT\SAMPLES directory.

About the Script Parser

 Note 1: Recognition of commands and system variables is case insensitive, but
     user defined variables are case sensitive.

 Note 2: Metas (=variables) are written between percent signs (like in DOS
     batch files). If a name of a meta is not recognized, the expression
     represents itself, that is, if you write WRITE "%ABC%" and ABC does not
     exist, ZOC prints '%ABC%'.

 Note 3: Each line of code is processed in two steps. First all variables are
     replaced with their value. Second, the parser collects arguments and
     passes them to the commands. Arguments are delimited by TAB or Space,
     arguments containing TAB or Space must be enclosed by single or double
     quotes.

     The following commands are legal:

      SETA "string1" "Hello World"

      SETA string1 "Hello World"

      SETA string2 Hello

      WRITE "%string2%"

      WRITE %string2%

     The following commands are not legal:

      WRITE %string1%

      SETA string1 Hello World

     As a rule of thumb it is a good idea to include all <text> arguments in
     quotes, while it is generally safe and easier to read to leave arguments


ΓòÉΓòÉΓòÉ 7. About ZOC (Versions, Author, Orders, ...) ΓòÉΓòÉΓòÉ

 THE ORDER FORM IN THE ZOC BETA IS NOT VALID!!

The Order Form from the help menu provides most of the information necessary to
order ZOC (like a list of distributors/regisration sites and automatic pricing
calculator).

Other related topics are How to Order, How to Contact the Author, Versions of
ZOC and A Word about Shareware.


ΓòÉΓòÉΓòÉ 7.1. Where/How to Order ΓòÉΓòÉΓòÉ

 Select Order Form from the help menu to get an order form, distributor list
and automatic pricing calculator.

 Orders
     The most convenient way to order ZOC is to logon to Compuserve, type GO
    SWREG at the forum! prompt, search for ZOC and register online. I will be
    notified that you registered and a few days later (currently I process
    orders twice a week) you will receive e-mail on Compuserve which contains
    your registration code and instructions how to use it. The price will be
    charged with your next Compuserve bill.

    If you don't want to order via Compuserve (or if you don't have an account
    there), select 'Order Form' from the help menu and enter your personal
    data, method of payment (see below) and options. Then print or file the
    order form. ZOC will compute the price (see below) automatically and print
    (or file) it with the order form.

    In return to your order you will receive a letter (and probably email/fax)
    that contains a license, information on how to remove the display of the
    order form after each download, a disk label and - if you ordered one - a
    printed manual and a disk.

 Distributors
    You find the complete list of distributors/registration sites  (address and
    phone/fax/bbs numbers) in the order form.

 Options
    There are a few options to chose from.

    License until 2.99
       The basic registration is a code that is entered into ZOC (and stored
       into your OS2.INI) to remove the registration remainder screens and
       messages from all versions with the same major version number (currently
       all 2.xx versions).

    Future license
       While the basic registration entitles you only to use all versions with
       the same major registration number (eg. all 2.x versions), you can
       register all future versions in advance (for the price of one upgrade).
       This way you have free access to all future versions of ZOC.

           Disk+Manual
       If you want, you can order a printed manual and a disk containing the
       current version of ZOC and ZOC related files. The commercial style
       printed manual provides basically the same information as the help file
       but adds introductory guidance to datacommunication and REXX
       programming.

 Pricing
    Automatic pricing table is available from the Order Form (to be found in
    the help menu).

    When considering if to buy ZOC, you should be aware that most commercial
    packages (either for OS/2 or Windows(TM)) without future upgrades cost more
    than the V9.99 license of ZOC.

 Payment
     The notes below apply only if you register from the author! If you plan to
    register from a registration site, please contact them for payment details.

    Credit Cards
       I accept VISA, MasterCard and Eurocard.

       Credit cards are always charged in DM.

       To prevent credit card fraud I need an order form with your written
       signature (ie. a FAX or a letter) and with your credit card number and
       expiration date.

           Compuserve
       Compuserve offers a convenient shareware registration feature. To use it
       you need a Compuserve account. Compuserve registration is only available
       for future registrations without manual and costs additional $5 since
       Compuserve charges 15% for the SWREG feature.

           Check
       Checks are fine with me. Just send a personal check in the currency you
       like (covering the amount to be charged by the registration site in your
       country).

       If you order from Germany, send me an Euro- or Verrechnungsscheck
       (please don't send Verrechnungsschecks by registered mail).

           Cash
       If you send cash, please use registered mail. I will take the additional
       postage (that is, you pay $5 less for ZOC).

    Bank Transfer
       I guess this is convenient only if used from inside Germany. If you send
       money via Bank Transfer please send an order form (via mail) as well. My
       bank is POSTGIROAMT NЪRNBERG (BLZ 760 100 85), account is 0314153856.

       Note:  If possible, please don't use bank transfers from other
       countries, since I am charged a transfer fee that is rather prohibitive!


ΓòÉΓòÉΓòÉ 7.2. Contacting the author ΓòÉΓòÉΓòÉ

 I more or less monitor international conferences and forums (mainly OS2 and
OS2.GER on FIDO's, comp.os.os2.apps on the internet and OS2SHARE on
Compuserve).

If you have problems, feel free to contact me personally (PLEASE check the help
file, especially the Problems and Questions section, first).

E-Mail (preferred):

     Internet
    [e-mail]

    Please don't post big files (>5K) without my consent, since I have to pay
    for incoming internet mail.

     Compuserve
    100101,3256

 ZOC Infobbs
    The number is [phone] (or 0911 9933662 from Germany). Login as
    'ZOC'. The menus there are in English!

Other:

     Phone/FAX
    +49+911+7499380 (or 0911 7499380 from within Germany). This is a hybrid
    voice/FAX answering machine, that will recognize incoming FAXes (if you
    encounter problems sending your FAX to this number, try again and if you
    have no success, send the FAX to +49+911+3193618).

 Mail

         EmTec
         Markus Schmidt
         Waagstr. 4
         90762 Fuerth
         - Germany -


ΓòÉΓòÉΓòÉ 7.3. ZOC Versions ΓòÉΓòÉΓòÉ

 ZOC light
    ZOC light is currently available in Germany only and is bundled with modems
    from several manufacturers. ZOC light is free and you may use it as long as
    you want but a few features are disabled. To get a full version you should
    contact the distributor listed in the startup panel.

 ZOC unregistered
    This is the shareware version of ZOC which you may evaluate for 30 days. No
    features are missing or disabled, but the order form is shown after each
    download to remind you that you should buy/register it after 30 days.

 ZOC registered
    This is the ZOC version you should go for. When you buy/register ZOC you
    get a registration code that is entered into ZOC (or the installation
    program) to remove the 30 days reminder and the order form from the
    unregistered version.


ΓòÉΓòÉΓòÉ 7.4. A Word (or two) about Shareware ΓòÉΓòÉΓòÉ

 Shareware restricton and nagging

    I belive in uncrippled shareware, but I believe as well that moderate
    reminders (widely known as nagging) are an acceptable method to make sure
    that shareware will be registered.  The shareware version of ZOC is fully
    functional. If you feel that something important is not working, you are
    probably doing something wrong.

    In ZOC, the order form and this help topic are shown after every successful
    Zmodem download as a reminder that you should register after the trial
    period.

    Personally I would have preferred to use a method that begins to show the
    window AFTER the trial period, but this is tecnically not possible without
    risking that someone will fiddle with the method of time measuring to gain
    free access to ZOC. However, you can fully explore the program and won't
    see the reminder too often anyway. If you find this unacceptable, you might
    consider if you already are using ZOC enough that you should register.

    Note:  Btw, I have already seen more than enough discussions about ZOC's
    way of nagging, so I won't contribute to any such discussion going on on
    the networks, even if I monitor it.

 Fairness
    Please be aware that shareware is Fair-Ware and that the shareware concept
    requires fairness from the user. It is possible to use shareware programs
    eternally without paying for it, but, in the long run, this will hurt the
    users as bad as the authors.

    If the shareware concept does not work, more and more programmers will
    market their work commercially without giving the user the opportunity to
    legally test the program for some time (the list of programs that were
    changed from shareware into commercial packages already is quite long).


ΓòÉΓòÉΓòÉ 8. APPENDIX ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 8.1. Function Shortcuts ΓòÉΓòÉΓòÉ

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéKey         ΓöéFunction            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPgUp        ΓöéUpload              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéCtrl+PgUp   ΓöéASCII Upload        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPgDn        ΓöéDownload            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéShift+InsertΓöéCliptext Send       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Insert  ΓöéCliptext, Send      Γöé
Γöé            ΓöéSpaced              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéCtrl+End    ΓöéModem, Send Break   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+B       ΓöéCapture, Browse     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+C       ΓöéShow/Hide Chat      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+D       ΓöéModem, Phone Book   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+E       ΓöéMisc, Editor        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+H       ΓöéModem, Hangup       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+J       ΓöéTransfer,           Γöé
Γöé            ΓöéTransfer-Shell      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+L       ΓöéCapture, Open/Close Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+N       ΓöéModem, Call Next    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+P       ΓöéLogfile, Log To     Γöé
Γöé            ΓöéPrinter             Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Q       ΓöéCliptext, Send      Γöé
Γöé            ΓöéQuoted              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+S       ΓöéOptions, Settings   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+U       ΓöéTransfer, Plugs     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+X       ΓöéEnd Program         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Z       ΓöéMisc, Clear Screen  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt +       ΓöéStart Script        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt -       ΓöéStop Script         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt .       ΓöéEnable/Disable SplitΓöé
Γöé            ΓöéChat                Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt ,       ΓöéShow/Hide Snippets  Γöé
Γöé            Γöéwindow              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt /       ΓöéMisc OS/2 Shell     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt *       ΓöéCliptext Print      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.2. VT102 Auxiliary Keypad ΓòÉΓòÉΓòÉ

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéVT102 KeypadΓöéPC MF-Keypad   Γöé
Γöé            Γöé(Num Lock Off) Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF1]       Γöé[F1]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF2]       Γöé[F2]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF3]       Γöé[F3]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF4]       Γöé[F4]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[0] ... [9] Γöé[0] ... [9]    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[Enter]     Γöé[Enter]        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[.]         Γöé[./Del]        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[-]         Γöé[-]            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[,]         Γöé[+]            Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.3. Special Codes ΓòÉΓòÉΓòÉ

 Sometimes it is necessary to send characters that are not available from the
keyboard or that cannot be entered into a field because WPS uses it to move the
cursor (like the ESC or Enter key).

ZOC offers Control Sequences that are replaced with keys that would not be
available otherwise and special ZOC Codes that give you access to values like
current time or date or let you map events to function keys instead of texts.


ΓòÉΓòÉΓòÉ 8.3.1. Control Sequences ΓòÉΓòÉΓòÉ

 The following table shows control sequences that can be used to simulate
special keys when building macro keys, REXX scripts.

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéKey            ΓöéControl   Γöé
Γöé               ΓöéCode      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^ char         Γöé^^        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéBeep           Γöé^G        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéBackspace      Γöé^H        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéTab            Γöé^I        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéEsc            Γöé^[        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéEnter          Γöé^M        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLine Feed      Γöé^J        Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
 (see as well: ZOC Codes).


ΓòÉΓòÉΓòÉ 8.3.2. ZOC Codes ΓòÉΓòÉΓòÉ

 This table shows place holders that can be used in some ZOC functions to send
special values or achive other magic like starting scripts from macro keys.

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéCode ΓöéExplanation                   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^1   ΓöéReplaced with current day of  Γöé
Γöé     Γöémonth                         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^2   ΓöéReplaced with current month   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^3   ΓöéReplaced with current year    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^4   ΓöéReplaced with current minute  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^5   ΓöéReplaced with current minute  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^6   ΓöéReplaced with current second  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^&   ΓöéReplaced with the password    Γöé
Γöé     Γöéfrom the phone book entry thatΓöé
Γöé     Γöéis currently online           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^$=  ΓöéRun a script file that is     Γöé
Γöé     Γöégiven after the equal sign    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^!   ΓöéSend a break                  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^%n  ΓöéReplace with the value of a   Γöé
Γöé     Γöéfunction key (eg. ^%12, only  Γöé
Γöé     Γöéavailable in custom button    Γöé
Γöé     Γöétexts)                        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé~    ΓöéDelay of 1/3 second (only     Γöé
Γöé     Γöéavailable in modem strings)   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^#   ΓöéReplaced with the phone numberΓöé
Γöé     Γöé(only available in modem dial Γöé
Γöé     Γöéstrings)                      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.4. REXX Commands/Functions ΓòÉΓòÉΓòÉ

 ASK [<title> [<default>]] Show a text input window and read text from user. If
     the second argument (<default>) it is provided, the entry field will be
     preset with this value. The result of the command can be obtained using
     the ZOCRESULT() function.

     Example:

          ASK я"Are You sure?"я No

          IF ZOCRESULT()==No THEN ...

 BAUD <baud>[-{7|8}{N|O|E}{1|2}] Set serial parameters.

     Example:

          BAUD 38400-8N1

 BEEP [<n>] Beep n times.

 CAPTCLR Clear the capture buffer.

 CLS Clear the screen.

 DELAY [<sec>] Wait a given time or delay 1/5 second if the parameter is
     omitted.

 DIAL [<number>] Dial a number or read the number to dial from the user if the
     parameter is omitted.

 DOWNLOAD {X[C]|Y|Z} <file/dir> Download file(s) using the X/Y/Zmodem file
     transfer protocol. The second parameter is a filename for Xmodem and a
     directory to store the received file(s) for Ymodem and Zmodem

     Example:

          DOWNLOAD Z C:\ZOC\INFILES

 ENDZOC Terminate ZOC and return to shell or WPS

 GETFILENAME <title> Display a file selection window and return the filename in
     ZOCRESULT().

     Example:

          GETFILENAME Enter file to upload

          UPLOAD Z ZOCRESULT()

 GETLINE Wait for the next non empty line of text from the modem (if you want
     to wait for the next line, no matter if empty or not, use WAIT ^M). The
     received text is available using the ZOCLASTLINE() function. If GETLINE
     times out it returns a value of 640 in RC.

     Example:

          GETLINE

          IF RC\=640 & ZOCLASTLINE()==CONNECT THEN ...

 HANGUP Disconnect line.

 LOADOPTS <optsfile> Load options file.

     Example:

          LOADOPTS OPTIONS\VT100OPT

 LOGNAME <filename> Set new name for logging.

     Example:

          LOGNAME TODAY.LOG

 LOGGING [0|1] Suspend/resume logging.

 NOTIFY <text> Display message window.

     Example:

          NOTIFY Hello World!

 PRINT <text> Same as WRITELN

 REQUEST <title> <opt1> [<opt2> [<opt3>]] Display a requester window with
     options (result in ZOCRESULT()).

     Example:

          REQUEST я"Are you sure?"я Yes No я"any way"я

 REPLY <text1> [<text2>] Send <text2> whenever <text1> is received during a
     DELAY or WAIT command. A maximum of 32 REPLY commands can be active
     simultaneously. <text1> must not contain carriage returns or line feeds.
     If <text2> is omitted or empty the REPLY command for <text1> is cancelled.

     Example:

          /* Wait for 'Command' and

          skip all prompts in between*/

          RESPOND Enter ^M

          RESPOND More N

          WAIT Command

          RESPOND Enter

          RESPOND More

 RESTIMER Reset the timer on the status line.

 SEND <text> Send text to modem.

     Example:

          SEND "JOE USER^M"

 SENDBRK Send a modem break.

 SENDKEY <number> Send text from macro key (1 ... 20).

 SETEMU 1|2|3 Set emulation (1=ANSI, 2=VT102, 3=TTY).

     Example:

          SETEMU 1

 SETHOST 0|1 Set host echo on or off.

 SETTIMER <hh: mm:ss>Set timer to given time.

 TIMEOUT <sec> Set timeout for WAIT (see also: WAIT, GETLINE).

     Example:

          TIMEOUT 60

 UPLOAD {A[0|1]|X[K]|Y|Z} <file> Start upload.

     Example:

          UPLOAD XK ZOC.ZIP
     uploads ZOC.ZIP with Xmodem protocol and 1KB block size.

     Example:

          UPLOAD A0 LIST.TXT
     uploads LIST.TXT with per ascii transfer without CR/LF translation.

 WAIT <text> Wait for the given text (see also: GETLINE, TIMEOUT). If it times
     out it returns a value of 640 in RC.

     Example:

          WAIT Password

          IF RC=640 THEN SIGNAL PANIC

 WAITLINE This command is available for compatibility with older versions of
     ZOC. The correct command is now called GETLINE.

 WRITE <text> Write text to screen.

 WRITELN <text> Write text to screen and skip to the next line.

 ----------------------

 ZOCCARRIER() This is a function and returns the current state of the carrier
     detect signal from the modem. If the serial options say that the modem
     provides no valid carrier detect signal it returns N/A, otherwise
     ZOCCARRIER() returns CARRIER or NO CARRIER

     Example:

          TIMEOUT 30

          WAIT Password

          IF ZOCCARRIER()=="NO CARRIER" THEN SIGNAL PANIC

 ZOCLASTLINE() This is a function and returns the current line of text when the
     last WAIT/GETLINE command was satisfied.

     Example:

          SEND ATZ^M

          GETLINE

          IF ZOCLASTLINE()==OK THEN DIAL 123456

 ZOCRESULT()This is a function and returns the results from the ASK, REQUEST
     and GETFILENAME commands.

     Example:

          REQUEST я"Are you sure"я Yes No

          IF ZOCRESULT()==Yes THEN SIGNAL DOITAGAIN


ΓòÉΓòÉΓòÉ 8.5. Script Language Commands ΓòÉΓòÉΓòÉ

See the program extract at the end of the list as a prerequisite for the some
of the examples.

 ADD <meta> <num>Add a number to a variable.

     Example:

          ADD VARN 11; WRITELN %VARN%
      => 110

 ASK [<title> [<default>]]Read text input from user. Result in %lastline%.

     Example:

          ASK "Are You sure?"

 BAUD <baud>[-{7|8}{N|O|E}{1|2}]Set serial parameters.

     Example:

          BAUD 4800-8N1

 BEEP [<n>]Beep n times

 CALL <label>Call a label (defined as ':label') as subroutine (see also:
     RETURN).

     Example:

          CALL Label

 CAPTCLRClear the capture buffer

 CLOSEFILEClose the file opened with OPENFILE

 CLS Clear the screen

 COMPA <string> WITH <string>Compare two ASCII strings (see also: EXACT, IFxxx)

     Example:

          COMPA "%VAR1%" WITH "%VAR2%"

 COMPN <num> WITH <num>Compare numeric values

 DEBUG 0|1Debugmode off/on

 DEC <meta>Decrement numeric variable by one.

     Example:

          DEC VARN

 DELAY [<sec>]Wait given time in seconds or delay 1/5 second if parameter is
     omitted.

 DIAL [<number>]Dial a number or display dial requester.

 DIV <meta> <num>Divide a variable by a number

 DOWNLOAD {X[C]|Y|Z} <file>Download file with X/Y/Zmodem (Zmodem can be done
     with the ZOC's autodownload feature as well).

 ENDSCRIPTSame as EXIT

 ENDZOCTerminate ZOC and return to shell or WPS

 EXACT 0|1Set exact mode for COMPA. EXACT 1 means, that the two strings must be
     exactly equal. EXACT 0 means, that the are compared in the length of the
     shorter string (that is, line [6] in the example below would result to
     equal).

 EXITEnd the script

 EXTERN <scriptfile> [<parameter>]Execute other scriptfile. The other
     scriptfile gets the parameter in the %lastline% variable.

 GETENV <name>Read value from environment into %lastline%.

 GETFILERead line from ASCII file opened with OPENFILE into %lastline%

 GETFILENAME <title>Display a file requester and return name in %lastline%

 GETLINEWait for the next non empty line of text from the modem (use WAIT "^M"
     to wait for the next line, no matter if empty or not). (See WAIT, TIMEOUT,
     IFBRK, IFNBRK).

     Example:

          GETLINE

 GOTO <label>Jump to label (defined as ':label')

 HANGUPDisconnect from line

 IFBRK <command>Do command if the last WAIT/WAITLINE returned due to timeout.

     Example:

          IFBRK GOTO ERROR

 IFEQU <command>Do command if the operands of the last COMPx (COMPA/COMPN) were
     equal.

     Example:

          IFEQU SETN X 0

 IFHIGH <command>Do command if first operand of the last COMPx was greater than
     the second.

     Example:

          IFHIGH SEND "^X^X^X^X"

 IFIN <command>Do command if first operand of the last COMPA was found
     somewhere in the second.

 IFLOW <command>Do command if first operand of the last COMPx was lower than
     the second.

 IFNBRK <command>Do command if the last WAIT/WAITLINE returned with the text
     found.

 IFNEQU <command>Do command if result from last COMPx was not equal.

 IFNHIGH <command>Do command if first operand of the last COMPx was lower than
     or equal to the second.

 IFNIN <command>Do command if first operand of the last COMPA was not

 IFNLOW <command>Do command if first operand of the last COMPx was greater than
     or equal to the second.

 INC <meta>Increment numerical variable by one.

     Example:

          INC VARN

 KILL <meta>Remove variable from memory (not explicitely necessary).

     Example:

          KILL VARN

 LOADOPTS <optsfile>Load options file.

     Example:

          LOADOPTS "OPTIONS\VT100OPT"

 LOGNAME <filename>Set new name for logging.

     Example:

          LOGNAME "TODAY.LOG"

 LOGGING [0|1]Suspend/resume logging

 LOWER <meta>Convert value of variable to lowercase (see also: UPPER).

     Example:

          LOWER VAR1

 LTRIM <meta>Remove blanks from beginning of variable (see also: RTRIM).

     Example:

          LTRIM VAR1

 MAXSCAN <num>Set maximum recursion for meta replacement. Variables can contain
     refereces to other variables (eg. SETA V1 "%%V2%%", SETA V2 "%%V3%%",
     SETA V3 "Hello World"). MAXSCAN defines the maximum scanning depth for
     such value expansions. That is, normally "%V1%" would expand to "Hello
     World", while it would expand to "%V2%" if MAXSCAN were '1'.

 META <newchar>Change meta character "%" into something else.

     Example:

          META $; WRITELN "$VAR1$"

 MOD <meta> <num>Calculate result of meta mod num and store result in the
     variable of the first argument.

     Example:

          MOD VARN 10; WRITELN %VARN%
      => 9

 MUL <meta> <num>Multiply a variable with a number and store result in the
     variable of the first argument.

     Example:

          MUL VARN 100; WRITELN %VARN%
      => 9900

 NOTIFY <text>Display message window.

     Example:

          NOTIFY "Hello World!"

 OPENFILE <filename> <mode>Open ASCII file (mode= r,w,a).

     Example:

          OPENFILE "data.lst" "a"
     opens file 'data.lst' in write append mode.

 PRINT <text>Same as WRITELN

 PUTFILE <text>Write text to an ASCII file opened with OPENFILE

 QUOTE <newquote>Change quotation character (")

 REQUEST <title> <opt1> [<opt2> [<opt3]]Display requester with options.

     Example:

          REQUEST "Are you sure?" "Yes" "No"

 RESPOND <text1> <text2>Send <text2> if <text1> is received (only during DELAY
     or WAIT commands). A maximum of 32 RESPOND commands can be active
     simultaneously. <text1> must not contain carriage returns or line feeds.
     RESPOND <text1> "" cancells any previous RESPONSE commands for <text1>.
     See SCRIPT\SAMPLE directory for an example about RESPOND.

 RESTIMERReset the timer on the status line.

 RETURNReturn from subroutine call (see also: CALL)

 RTRIM <meta>Remove trailing blanks from variable (see also: LTRIM).

     Example:

          RTRIM VAR1

 SEND <text>Send text to modem.

     Example:

          SEND "JOE USER^M"

 SENDBRKSend a modem break

 SENDKEY <number>Send text from macro key (1 ... 20)

 SETA <meta> <text> [<pos> [<length>]]Create or overwrite ASCII variable with
     text. Positive <pos> is counted from the left side of <text>, negative
     <pos> is taken from the right.

     Example:


             SETA V1 "Hello World"
             SETA V2 "Hello World" +4
             SETA V3 "Hello World" -3
             SETA V4 "Hello World" +2 3
             WRITE "%V1%, %V2%, %V3%, %V4%"

     OUTPUT: Hello World, lo World, rld, llo.

 SETN <meta> <num>Create or overwrite numerical variable with value

 SETEMU 1|2|3Set emulation (1=ANSI, 2=VT102, 3=TTY).

     Example:

          SETEMU 1

 SETHOST 0|1Set host echo on or off

 SETTIMER <hh:mm:ss>Set timer to given time

 SHELL <command>Execute a program via 'CMD.EXE /C <command>'.

     Example:

          SHELL "DEL FILE.TMP"

 SUB <meta> <num>Subtract a number from a variable.

     Example:

          SUB VARN 50; WRITELN %VARN%
      => 49

 TIMEOUT <sec>Set timeout for WAIT (see also: WAIT, GETLINE, IFBRK, IFNBRK).

     Example:

          TIMEOUT 60

 UPLOAD {A[0|1]|X[K]|Y|Z} <file>Start upload.

     Example:

          UPLOAD XK "ZOC.ZIP"
     uploads ZOC.ZIP with Xmodem protocol and 1K blocksize.

     Example:

          UPLOAD A0 "LIST.TXT"
     uploads LIST.TXT with per ascii transfer without CR/LF translation.

 UPPER <meta>Convert variable to uppercase (see also: LOWER)

 WAIT <text>Wait for the given text (see also: GETLINE, TIMEOUT, IFBRK, IFNBRK)

     Example:

          WAIT "Password"

 WAITLINEThis command is available for compatibility with older versions of
     ZOC. The correct command now is GETLINE.

 WRITE <text>Write text to screen

 WRITELN <text>Write text to screen, add newline

 Note:Many functions (such as OPENFILE, REQUEST, GETFILE deliver error codes
     like (##ERROR##, ##CANCEL##, ##EOF##, ...) in %lastline%.

 Program part for the examples

             SETA VAR1 "Hello  "
             SETA VAR2 "Hell"
             SETN VARN 99
             SETN VARN2 10
          :Label
             WRITELN "%VAR1%"
             COMPA "%VAR1%" WITH "%VAR2%"
             COMPA  %VARN% WITH 100
             COMPN  %VARN% WITH %VARN2%


ΓòÉΓòÉΓòÉ 8.6. Common problems (trouble shooting guide) ΓòÉΓòÉΓòÉ

 Where do I get the current version of ZOC?
    see REGISTER.DOC in the ZOC directory on your hard disk.

 How can I set ZOC to tone dial
    Change the modem options and set the dialling command to 'ATDT'.

 My modem works properly with other terminal software but not with ZOC
    Try using the same modem initialization as in the other terminal package.
    Or store that modem configuration into the non-volatile memory of the modem
    (mostly done with AT&W) and use ATZ as the initialization string for ZOC.

 No characters appear after making a connection
    You use a secured transmission and the modem waits to get an ok signal from
    the computer which does not come. Turn on RTS/CTS in Options, Serial.

 Downloads generally work fine, but uploads of large files fail
    Probably you are using a high-speed modem but have RTS/CTS disabled. For
    high-speed transmission both, the modem and ZOC, need to be configured to
    use RTS/CTS handshaking.

 ZOC turns NumLock on and off
    "It's not a bug, it's a feature". ZOC uses the NumLock LED for VT102
    application key pad.  You can turn this off using Options, Emulation.

 The STANDARD options are not used at startup
    Maybe you unpacked ZOC without preserving pathnames. The STANDARD file must
    be in a subdirectirey named OPTIONS (and located in your ZOC directory, eg.
    C:\TERM\ZOC\OPTIONS).

 Whenever I leave the program I get a Carrier Detect warning
    Maybe your modem is configured to have the CD signal always on. Set it to
    match the CD state (maybe AT&C1) or set the CD signal to 'invalid' in the
    serial options.

 The phone book does not load the options file
    You need to enter the path as well as the options file name, eg.
    OPTIONS\VTOPTS.

 Sizing the ZOC only works in large steps
    By default ZOC changes the font size when you size the window. Since the
    font is not available in every neccessary size ZOC will use a best-fit
    method and size the window accordingly. If you do not like this, you can
    change the sizing behaviour in the Window Options.

 I miss a full screen mode
    There is no character based full screen mode available. ZOC is a true PM
    program and uses the benefits of OS/2's window system (like offering
    icons). However, you can maximize the ZOC window using the maximize button
    in the title bar. This way ZOC will cover the whole screen (you should
    select a large font if you do this).

 Is there a way to change the font or the colors of the terminal window?
    You can change the font size and color of the terminal window in
    (Options,Window), but not the font.