Command Line Parameter Syntax

The command line syntax is:

C:\program files\install directory\qws3270p.exe <host> <-dDirectory> <-sFilename> <-Tnn> <-w Filename> <-zSession>

Command Parameter descriptions

<host> This is the host to which a connection will be attempted. This can be a host name or an IP address In the most widely installed level of the Internet Protocol (IP) today, an IP address is a 32-bit number that identifies each sender or receiver of information that is sent in packets across the Internet. An IP address has two parts: the identifier of a particular network on the Internet and an identifier of the particular device (which can be a server or a workstation) within that network. On the Internet itself - that is, between the router that move packets from one point to another along the route - only the network part of the address is looked at. . The application automatically attempts to make a connection to this host when the application is started.

WARNING:  Do not include host and port parameters if there is a script or a session that connects to a host inserted into the command line. Limit the command line to one host connection.

<port> This is the port number to be used on the specified host. The default is 23.

<-Ddirectory> this is a fully qualified directory name in which to store the parameter files. These files contain the saved parameter settings and any customized keyboard settings. This parameter is useful if a site is sharing a server version of the software. In order to customize the product for personal preference, each user can store their parameters locally using the shortcut –d parameter. This way each user can have different storage locations for his or her settings.

<-Sfile.name> this is a fully qualified script file name to executed. The application will attempt to execute this script file when the application is started.

WARNING:  Do not include scripts that connect to a host. The host/port method or the –zsession method are the best ways to do this on the command line. If a <-Zsession> is included, scripts will be ignored.

<-Tnn> this is the title number of a custom title to use as Window Title. The application will then use the nn portion of this parameter to look up a TITLEnn= parameter in the .ini file. The TITLEnn= parameter can be added to the .ini file with the editor of your choice.

<-w file.name> this is a fully qualified script file name to execute. The application will attempt to execute this script file when the application is started. This parameter is useful if you are using the QWS3270//: URL header to pass parameters in Netscape or another browser that requires a space between the –w and the file name.

<-zsession> the pre-defined session (as defined in the QWS3270 / CONNECT dialog) that you wish to use to connect to the host. All of the parameters that are set-up in this session will be used for this connection. If the session name contains a hyphen or spaces, then the session name must be enclosed in double quotes (")

WARNING:  DO NOT INCLUDE A SESSION NAME AND HOST/PORT PARAMETERS AT THE SAME TIME. Include one or the other.