Signature Systems, Inc. Comet Tips

	Let us help you* run your business.*

Home News Products Support Download Contact Site Contents

Command Line Options

Comet supports a number of command line options. These options are included in the "Target" field of the Comet shortcut, and set certain parameters when Comet is run.

Here is a list of the currently supported. Each entry in the chart includes the option, the program affected by the option (Cosw, Cosc or Cosh), and an explanation of the option.

Option

Program
affected

Explanation

/C

Cosh

Configuration mode - has same restrictions as /D

/CAPORT:port

Cosw

Specify CometAnywhere port number

The default TCP/IP port number for CometAnywhere is 11751. If you want to use another port number, you must specify the new value in two places:

on the remote CometAnywhere remote system using the /CAPORT command line option, or the following COSW.INI option

on the host Comet system, via the following entries in the COSW.INI file (works on remote systems also):

[NetConfig]
CAPort=port

The valid TCP/IP ports are 0 to 65535, however please note that the first 1024 port numbers are reserved for applications other than CometAnywhere.

Example (using port number 54321):

command line option on remote system:

cosw.exe /CAPORT:54321 /NET

COSW.INI entry on host system:

[NetConfig]
CAPort=54321

/D

Cosh

Demonstration mode

This option allows you to run Comet in demonstration mode. The restrictions of demonstration mode are:

a maximum of 1,000 keystrokes may be typed

data files may not be larger than 640K bytes

a maximum of 3 partitions may be configured

/DEBUG

Cosp

Opens the program log window for debugging purposes

/DETAILS

Cosw

Show Comet startup and session details

/FRAME

Cosw

Creates a Comet window with no frame/menu/tools

/HIDE

Cosw

Forces the Comet window to be invisible

/INI

Cosw

Specifies an alternate path to COSW.INI or COSWGLOB.INI

/KEYFILE=file
/KEYFILE:file

Cosw

Plays back keystrokes from the named text file

/LOG

Cosc

Enables COSC logging to default log file

The default log filename is the user's profile name appended with ".LOG". For example, if the user's profile is NODE1, the log file is NODE1.LOG.

The log file is created in the Comet startup directory.

/MAX

Cosw

Forces the Comet window to maximize

/MIN

Cosw

Forces the Comet window to minimize

/NET
/NET:IP-address
/NET:domain-name

Cosw

Connect CometAnywhere to Comet host system:

/NET displays a dialog for the user to user an IP address or domain name.

/NET:IP-address connects to the Comet host system at the specified IP address.

/NET:domain-name connects to the Comet host system at the specified domain name.

/O1

Cosh

Startup option for the Comet Point-Of-Sale (POS) system (not supported in Comet2000)

/PN=profilename

Cosh

Specifies the Comet user profile

The user profile is a file created during the system configuration process (SYSGEN). The extension for this file is CFG.

For example, to start Comet using a profile name of TEST (which equates to a configuration file of TEST.CFG), use the following option:

cosw /PN=TEST

/RESETID

Cosw

Deletes and re-assigns a new Session Identifier (CAID) to the computer.

/S:session

Cosw

Cosc

Request specified session

Allows a remote CometAnywhere user to request a specific session number on the host system. The following example requests session 005 on the host machine:

cosw /S:005 /NET

If the requested session is not available, and if the /TSR option (see below) has not been specified by the host, Comet runs the first available session on the host system.

/SEC

Cosc

Cosh

Start Comet Security Server

This option attempts to load the Comet Security Server when Comet is started. This is a convenient way to start Comet on a single-user system.

Notes:

This option is for standalone systems only, where the Comet Security Server is to be run on the same system as Comet. This option is not intended for Comet systems that get security from the Comet Security Server running on another node in the network.

When the /SEC command line option is specified, Comet looks for a program named Csecsrv.exe in the specified start-in directory. The program, if found, is launched.

· In Builds 300 through 307, this was an automatic feature (i.e., no command line parameter was required in order to launch the Comet Security Server). Starting with Build 308, it is no longer an automatic feature.

/TSR

Cosw

Cosc

Target Session Required

Used on the CometAnywhere host this option will limit a session requested by a remote to only the specific session number requested. If that session is not available no session will be granted. This option is used in conjunction with the /S option (see above).

Here's an example:

cosw /TSR

If the requested session number is not available, Comet will not scan for another available session.

/TSRALL

Cosw

Cosc

Target Session Required

Requires all remote sessions include a "/S:n" parameter to request a specific session. If they do not use this parameter then they'll get the "Target Session Unavaliable" error.

Option	Program affected	Explanation
/C	Cosh	Configuration mode - has same restrictions as /D
/CAPORT:port	Cosw	Specify CometAnywhere port number The default TCP/IP port number for CometAnywhere is 11751. If you want to use another port number, you must specify the new value in two places: on the remote CometAnywhere remote system using the /CAPORT command line option, or the following COSW.INI option on the host Comet system, via the following entries in the COSW.INI file (works on remote systems also): [NetConfig] CAPort=port The valid TCP/IP ports are 0 to 65535, however please note that the first 1024 port numbers are reserved for applications other than CometAnywhere. Example (using port number 54321): command line option on remote system: cosw.exe /CAPORT:54321 /NET COSW.INI entry on host system: [NetConfig] CAPort=54321
/D	Cosh	Demonstration mode This option allows you to run Comet in demonstration mode. The restrictions of demonstration mode are: a maximum of 1,000 keystrokes may be typed data files may not be larger than 640K bytes a maximum of 3 partitions may be configured
/DEBUG	Cosp	Opens the program log window for debugging purposes
/DETAILS	Cosw	Show Comet startup and session details
/FRAME	Cosw	Creates a Comet window with no frame/menu/tools
/HIDE	Cosw	Forces the Comet window to be invisible
/INI	Cosw	Specifies an alternate path to COSW.INI or COSWGLOB.INI
/KEYFILE=file /KEYFILE:file	Cosw	Plays back keystrokes from the named text file
/LOG	Cosc	Enables COSC logging to default log file The default log filename is the user's profile name appended with ".LOG". For example, if the user's profile is NODE1, the log file is NODE1.LOG. The log file is created in the Comet startup directory.
/MAX	Cosw	Forces the Comet window to maximize
/MIN	Cosw	Forces the Comet window to minimize
/NET /NET:IP-address /NET:domain-name	Cosw	Connect CometAnywhere to Comet host system: /NET displays a dialog for the user to user an IP address or domain name. /NET:IP-address connects to the Comet host system at the specified IP address. /NET:domain-name connects to the Comet host system at the specified domain name.
/O1	Cosh	Startup option for the Comet Point-Of-Sale (POS) system (not supported in Comet2000)
/PN=profilename	Cosh	Specifies the Comet user profile The user profile is a file created during the system configuration process (SYSGEN). The extension for this file is CFG. For example, to start Comet using a profile name of TEST (which equates to a configuration file of TEST.CFG), use the following option: cosw /PN=TEST
/RESETID	Cosw	Deletes and re-assigns a new Session Identifier (CAID) to the computer.
/S:session	Cosw Cosc	Request specified session Allows a remote CometAnywhere user to request a specific session number on the host system. The following example requests session 005 on the host machine: cosw /S:005 /NET If the requested session is not available, and if the /TSR option (see below) has not been specified by the host, Comet runs the first available session on the host system.
/SEC	Cosc Cosh	Start Comet Security Server This option attempts to load the Comet Security Server when Comet is started. This is a convenient way to start Comet on a single-user system. Notes: This option is for standalone systems only, where the Comet Security Server is to be run on the same system as Comet. This option is not intended for Comet systems that get security from the Comet Security Server running on another node in the network. When the /SEC command line option is specified, Comet looks for a program named Csecsrv.exe in the specified start-in directory. The program, if found, is launched. · In Builds 300 through 307, this was an automatic feature (i.e., no command line parameter was required in order to launch the Comet Security Server). Starting with Build 308, it is no longer an automatic feature.
/TSR	Cosw Cosc	Target Session Required Used on the CometAnywhere host this option will limit a session requested by a remote to only the specific session number requested. If that session is not available no session will be granted. This option is used in conjunction with the /S option (see above). Here's an example: cosw /TSR If the requested session number is not available, Comet will not scan for another available session.
/TSRALL	Cosw Cosc	Target Session Required Requires all remote sessions include a "/S:n" parameter to request a specific session. If they do not use this parameter then they'll get the "Target Session Unavaliable" error.