TECHNICAL BULLETIN #186 - Rev 1.10 (9/03/96)

==============================================================================
TITLE   : Command Line Options for Procomm Plus
PRODUCT : Procomm Plus 4.x, 3.x
==============================================================================

This document is an overview of the command line options for Procomm Plus.
The command line options allow you to execute Procomm Plus and run a script,
enter a particular connection mode, and/or make a connection from the command
line.

SYNTAX
The Procomm Plus command line parameter has the following form:

        PW4 [argument] [argument] ...

PROCOMM PLUS 3.0:

	PW3 [argument] [argument] ...

where each optional argument is separated by a space or tab character. The
accepted arguments are as follows:

  [startup mode]
  This optional argument specifies the type of Procomm Plus communication
  window that is launched. If it is included, it must occur as the first
  command line argument. Valid values include TERMINAL, FTP, WWW, MAIL, NEWS,
  or TELNET.

  [file.dir]
  This optional argument specifies a Connection Directory to load.

  [CONNECT {MANUAL [class] number/address} | {[class] [GROUP] name}]
  This optional argument specifies a manual connection or Connection Directory
  entry to connect to once Procomm Plus is launched.

  If MANUAL is specified, a manual connection of the specified connection
  class is attempted with the specified number or address. If the connection
  class is not specified, the Connection Directory class associated with the
  current communication window is used.

  If MANUAL is not specified, the name parameter must be included and enclosed
  in quotation marks, such as "James BBS." Procomm Plus searches the
  Connection Directory for a matching name and attempts a connection. If GROUP
  is specified before name, Procomm Plus interprets name as a group name and
  attempts to connect with the specified group. If class is specified, it
  overrides the Connection Directory entry class associated with the current
  communication window, and the Connection Directory is searched for a
  corresponding entry name or group name (if GROUP is also specified). Valid
  class values include DATA, FAX, VOICE, TELNET, FTP, WWW, MAIL, or NEWS.

  [/nostartup]
  If a startup.wax script exists in the path specified by Script path in
  Setup | Data | Data Options | Paths, this optional argument prevents the
  script from executing when a script or connection operation has not been
  specified with the [file.wax...] or [CONNECT...] parameters.

  [file.wax | file.was [argument list]]
  This optional argument specifies an ASPECT script file for Procomm Plus to
  execute. If a .was file is specified, the ASPECT Compiler first compiles the
  script and upon successful compilation, the associated .wax file is
  executed. Any arguments following the script name are passed to the script
  in the predefined variables.

The following rules apply when specifying command line options:

  * Command line arguments are always delimited by spaces or tab markers.
  * Always enclose Connection Directory entry or group names in quotation
    marks, and be careful to include any spaces that exist in the name.
  * A quotation mark preceded by a backslash is interpreted as a quotation
    character. For example, the following command specifies an attempt to
    connect with a Connection Directory entry named This is "The Place".

	PW4 CONNECT "This is /"The Place/""

  * Connection Directory names, numbers, and addresses are the only command
    line arguments that are case-sensitive.
  * If the [startup mode] argument is specified, it must be the first
    argument.
  * If a script file is specified, any arguments following the script name are
    passed to the script in the predefined variables.

EXAMPLES
Here are examples of command line options for Procomm Plus:

  PW4.EXE WWW
  This starts Procomm Plus in Web Browser mode.

  PW4.EXE FTP /nostartup
  This starts Procomm Plus in FTP mode, and prevents the script STARTUP.WAX
  from executing when no other script or connection or operation has been
  specified.

  PW4.EXE CONNECT WWW Quarterdeck
  This starts Procomm Plus in Web Browser mode, and opens the Quarterdeck Home
  page.

  PW4.EXE CONNECT DATA Quarterdeck
  This starts Procomm Plus in DATA mode and connects to the Quarterdeck BBS.

  PW4.EXE CONNECT MANUAL 1-123-456-7890
  This manually dials 1-123-456-7890.

  PW4.EXE script.wax arg0 arg1 arg2 arg3
  This starts script.wax and passes four arguments to the script.

==============================================================================
   To ensure that you have the latest version of this document, compare its
   revision number to that of the same document on any of our support sites.
  This technical bulletin may be copied and distributed freely as long as it
       is distributed in its entirety and it is not distributed for profit.
           Copyright (c) 1998 Quarterdeck  All rights reserved.
==============================================================================