Command Line Parameter Syntax

The command line syntax is:

C:\program files\install directory\qws3270p.exe <host> <-dDirectory> <-sFilename> <-Tnn> <-w Filename> <-zSession> <-ssl-lib=> <-ssl-prot=> <-mode=secure>

Note that the '<' and '>' in the above are not included in the actual command line. They are shown merely to indicate the beginning and end of each parameter.

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.

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

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

<-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 be 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 parameter is included, scripts will be ignored.

<-Tnn> this is the title number of a custom title to use as the Window Title. The application will then use the nn portion of this parameter to look up a TITLEnn= parameter in the .ini file. This 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 be executed. 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> this is 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 the connection. If the session name contains a hyphen or a space, 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.