Note that switch characters are case sensitive.
| Switch | Purpose |
|---|---|
| -A app | Run application app. This implies -d, see below. The application to be run is defined a string named app in the registry under the key HKEY_LOCAL_MACHINE/SOFTWARE/Kerridge/Apps. The string value of the key app will be interpreted as a program. In the examples above V8profile had the value d:\rev8\profile.src |
| -a ans | Define a VT100 answerback string. When Kclient starts up in client server mode it is initially in a vt100 terminal emulation mode until such time as it is able to get authenticated and start the server process which will then switch the client into its proper KCML mode. During logon the Unix .profile may well interrogate the client with and ascii ENQ character to get the answerback as a simple form of security. This switch allows you to define the string to be sent in response to this query. |
| -b | This will suppress the splash bitmap that the kclient issues during initialization. It will only do this if another client is already running and if it has enough information to logon to the server without input from the user. |
| -C args | Application command line. The possibly quoted argument that follows the -C will be passed to the KCML server as found. The server program can gain access to this via a $DECLARE function and can use this string to determine how to run. This mechanism is how bookmarking is implemented. |
| -c proxy_name | Specifies the name of an HTTP proxy server needed as a gateway through a firewall blocking the server. |
| -d | Direct mode with both client and server on the same machine. This requires the kserver.dll DLL to be in the same directory as the client. This is the mode that WKCML uses. |
| -f host | Connect via a connection broker where the link to the KCML server is known to be unreliable. |
| -F host | Connect via a connection broker over a dial-up connection. Use this setting if your connection is billable for time connected or the amount of data sent. Normally KClient will ping the broker to test the line status and re-establish the connection if required. Using this option means the line will be allowed to stay disconnected until KClient attempts to send some user data. |
| -h host | Defines the host computer as either a hostname (defined by a DNS or by an entry in a hosts file) or a dotted IP address e.g. 10.0.0.10. By default kclient uses port 23 but another port may be specified by adding a comma or colon and the port number, e.g. -h myhost,45 or -h myhost:45. This switch can be repeated to allow for failover to an alternative server in the event of the link disconnecting. |
| -i file,index | Defines the icon to be used in terms of an index number in the icon resource of the file file (which may be an EXE or a DLL) |
| -K | Use the auto-discovery protocol to find the server |
| -l | Connect using Transport Layer Security (TLS) encryption. |
| -L | Connect to an NT server without a logon process. |
| -m | Client to start minimized |
| -M | Connect over HTTP |
| -N | Use single sign-on to automatically log into the server with the credentials used to log into the client. |
| -o userid | Login with this userid. Do not update the stored 'last user'. |
| -P x,y | Set position of the initial form using pixel co-ordinates based on top left corner of screen. |
| -q | Quit immediately if unable to connect. Without this switch the login dialog will remain allowing the host to be changed. |
| -R | Cache the users password in an encrypted form in the registry after a successful log in and use this password when subsequently connecting to that server under the same userid. This is only available if the user is explicitly logged into the client. |
| -r | Force a request for the userid and password despite any other prevailing setting. |
| -S dir | Set the current working directory for a direct login. Not applicable for remote connections. |
| -s | Disable dynamic screen resizing in the KCML workbench |
| -T | Display a text window after connection thus revealing the login process. |
| -t | Display text window after login process is completed. |
| -u userid | Login with this userid |
| -V Port | Specify the port to connect to. The default port is 23, as used by the Telnet service unless -v is used to specify a service when it is 790. If encryption is enabled the default port is 4790. |
| -v Service | Specify the service when connecting through the Connection Manager |
| -w file | Load command line options from the specified file |
| -X pwd | Supply a password to go with the userid in -u |
| -Y | Disable access to the prefences menu. Useful on Citrix managed environments. |
| -z | Disable access to the Workbench |
| User@Host:Port | Short hand for connecting as 'User' to the server 'Host' on port 'Port' |
The following switches can also be used on a direct connection only as they will be passed on to KCML
| KCML switch | Purpose |
|---|---|
| -g | defines a global process |
| -p prog | explicitly defines a program to load |
| -e env | defines an environment variable |
| -n | NPL compatibility |
| -x lib | specify dynamic library to load |