Available pcAnywhere command line parameters and switches
search cancel

Available pcAnywhere command line parameters and switches

book

Article ID: 151711

calendar_today

Updated On:

Products

Symantec Products

Issue/Introduction

You want to know what command line parameters and switches are available to run pcAnywhere, and how to use them.

 

Resolution

This document contains four sections that describe the command line syntax, available switches, how to run command lines under Windows, as well as a series of common examples.

pcAnywhere has several applets that can run from a command line with a parameter and switches. Their syntax is as follows:

    \WINAW32.EXE /R
    \AWREM32.EXE .CHF  /Cx  /L  /V
    \AWHOST32.EXE .BHF  /D  /V
    \STOPHOST.EXE

Note: pcAnywhere 11.0 does not support the /V option. The Voice First communications option has been dropped in this version.




Command-line switches and examples

 

Argument
Used With
Function
/Cx
Awrem32.exe
Instructs the remote to call a host using TCP/IP, overriding the current host address in the .CHF file. The value x represents the IP address of the host to call.
/D
Awhost32.exe
This disables the pcAnywhere Host Service. Used in conjunction with the /Cx or /V switch under Windows NT/2000/XP only.
/L
Awrem32.exe
Instructs the remote to wait for a call from a host.
/R
Winaw32.exe
Disables the splash screen that normally appears when launching the main module.
/V
Awhost32.exe
Awrem32.exe
Sets up a Voice First call. If used with Awhost32.exe on Windows NT/2000/XP, you must also use the /D switch.


 

    Notes on using the /D switch
    The /D switch only applies to running Awhost32.exe at a command line from a Windows NT/2000/XP host. Because it disables the pcAnywhere Host Service, the following functions of pcAnywhere will not function during a remote session:
      • Ctrl+Alt+Del
      • Optimize desktop
      • Symmetric or Public-Key Encryption
      • Windows user authentication

    Without these functions, you would not be able to unlock a locked host, log out of Windows and still wait for the connection, bring up the Task Manager, or use File Transfer.


    STOPHOST.EXE
    Run this command at the host to cancel a waiting host. This command has no arguments and no switches.



How to Run Command Lines
You can run command lines in any of four ways:

    • From an icon placed on the desktop
    • From an item placed into the Windows Start menu
    • From the Run command item on the Windows Start menu
    • From a DOS prompt
    To create an icon on the Desktop
    1. Click Start, point to Programs, and then click Windows Explorer or Windows NT Explorer.
    2. Locate and select the pcAnywhere data folder, usually All Users\Application Data\Symantec\pcAnywhere. The connection items are in this folder.
    3. Drag the connection item or items of your choice to the desktop, to create a shortcut.

    To create an icon on the Start Menu
    1. Right-click the Taskbar, and then click Properties.
    2. Click the Start Menu Programs tab.
    3. Click Add.
    4. Type the desired command line, and then click Next.
    5. Select the folder to place the item in, and then click Next.
    6. Type a descriptive name for the shortcut.
    7. Click Finish and then Click OK.

    To run a command line from the Run window
    1. Click Start, and then click Run. The Run window will appear.
    2. Type the full command line in the "Open" field. Be sure to use quotes if appropriate.
    3. Click OK.

    To run a command line from the DOS Prompt
    1. Click Start, point to Programs, and then click MS-DOS Prompt (Command Prompt under Windows NT).
    2. Type the command line at the DOS Prompt and then press Enter.

    Determining the Data folder location
    The location of the pcAnywhere Data folder depends on the version of pcAnywhere installed and, in some cases, on the operating system. The following are the default locations for the pcAnywhere Data folder by version and platform:
    • pcANYWHERE32 versions 7.x and 8.x (all platforms): C:\Program Files\pcANYWHERE\data
    • pcAnywhere 9.0 (all platforms): C:\Program Files\Symantec\pcAnywhere\data
    • pcAnywhere 9.2.x on Windows 9x or ME: C:\Windows\All Users\Application Data\Symantec\pcAnywhere
    • pcAnywhere 9.2.x on Windows NT: C:\WINNT\Profiles\All Users\Application Data\Symantec\pcAnywhere
    • pcAnywhere 9.2.x on Windows 2000: C:\Documents and Settings\All Users\Application Data\Symantec\pcAnywhere
    • pcAnywhere 10.0 on Windows 9x or Me: C:\Program Files\Symantec\pcAnywhere
    • pcAnywhere 10.0 on Windows NT: C:\Winnt\Profiles\All Users\Application Data\Symantec\pcAnywhere
    • pcAnywhere 10.0 in Windows 2000: C:\Documents and Settings\All Users\Application Data\Symantec\pcAnywhere

Note: If you upgraded to pcAnywhere 9.2 or 9.2.1 from 9.0 by running LiveUpdate or by downloading and installing the 92up.exe or 921up.exe file, then the path to the pcAnywhere data folder will conform to the paths for pcAnywhere 9.0 - C:\Program Files\Symantec\pcAnywhere\Data.





Example Command Lines
 


Notes:

  • The examples assume that you installed pcAnywhere 10.0 or 10.5 under Windows NT/2000/XP in the C:\Program files\Symantec\pcAnywhere folder. Your installation folder may be different.
  • Any path that includes a long file name must be in double quotes.
  • Host calling remote and remote call back are not options in pcAnywehre 12.5 sp3 and later.

    Disable the pcAnywhere splash screen
    "C:\Program Files\Symantec\pcAnywhere\winaw32.exe" /r

    Call a Host using the modem
    "C:\Program Files\Symantec\pcAnywhere\awrem32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.chf"

    Call a Host using the Network (assume TCP/IP for this example)
    "C:\Program Files\Symantec\pcAnywhere\awrem32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Network,Cable,DSL.chf"

    Call a Host using the Network overriding the current IP address and replacing it with the address stated on the command line
    "C:\Program Files\Symantec\pcAnywhere\awrem32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Network,Cable,DSL.chf" /c10.10.10.100

    Be a Remote but wait for the Host to call (using the network)
    "C:\Program Files\Symantec\pcAnywhere\awrem32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Network,Cable,DSL.chf" /l

    Be a Remote set for a Voice first call
    "C:\Program Files\Symantec\pcAnywhere\awrem32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.chf" /v

    Be a Host and wait for a call using the modem
    "C:\Program Files\Symantec\pcAnywhere\awhost32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.bhf"

    Be a Host on Windows 9x/Me and wait for a Voice first call
    "C:\Program Files\Symantec\pcAnywhere\awhost32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.bhf" /v

    Be a Host on Windows NT/2000/XP and wait for a Voice first call
    "C:\Program Files\Symantec\pcAnywhere\awhost32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.bhf" /d /v

    Be a Host and dial to a remote over modem
    "C:\Program Files\Symantec\pcAnywhere\awhost32.exe" "C:\winnt\profiles\all users\Application Data\Symantec\pcAnywhere\Modem.bhf" /c5411231234




 

 


Attachments