ZCC File Format

The .ZCC (Zephyr Communication Configuration) file is a normal text file and can be edited with any text editor such as Notepad. If the parameter is not specified in the ZCC file, then the default value is used.

Sample .ZCC File

[Connection]
IPHostName=192.86.33.94
TCPPort=623
EmulType=TN3270
TimeOut=30
TN3270ESupport=Yes
ConnectMethod=Generic
ResourceName=
ScreenSize=2
ExtendedAttributes=Yes
AutoReconnect=Yes
HostCodePage=037

Parameter Values for the .ZCC file

The first line in the .ZCC file must be a single line containing [Connection] in the first position. If a parameter is not specified in the .ZCC file, then the default value is used. The following connection parameters can be specified in the .ZCC file.

IPHostName=<Text string representing the IP address or Host Name>
This is the name or IP address number of the host computer you wish to connect to. If you enter a text string for the name of the host computer, the TCP/IP protocol will translate it into an IP address number and use this number to connect to the IBM host. You can also enter the IP address number directly. However, it must be supplied in the standard 4 number dot delimited format, nnn.nnn.nnn.nnn, where each number nnn ranges in value from 0 to 255. Your system administrator can supply you with this information. There is no default value for this parameter.

TCPPort=<Number ranging in value from 1 to 65535>
If your system administrator has defined port numbers for Telnet host, the number must be entered here. Normally, this number is not changed, but may be changed to some other TCP port for SSL host connections. The default value for this parameter is 23.

EmulType=TN3270 or TN5250
If TN3270 is configured, access to IBM zSeries (S/390) mainframes will be provided using the Telnet 3270 protocol. If TN5250 is configured,access to IBM iSeries (AS/400) midrange hosts will be provided using the Telnet 5250 protocol. The default value is TN3270.

TimeOut=<Number indicating connection time-out value, in seconds>
This value designates the number of seconds the connection method will wait for the host system to respond before timing out. If a time-out occurs, this could be caused by the host system not being available or IPHostName IP address, TCPPort or some other connection parameter being incorrect. The default value is 10.

TN3270ESupport=Yes or No
This option can only be enabled if EmulType=TN3270 is also specified, otherwise it is ignored. If this option is set to Yes, the TN3270E enhanced protocol will be used when connecting to the IBM zSeries (S/390) mainframe. With TN3270E support, display sessions can connect to either a generic or specific pool of LUs. TN3270E emulation provides the following advanced emulation features. The default value is No.

TN3270EResponseSupport=Yes or No
This option can only be enabled if EmulType=TN3270 is also specified, otherwise it is ignored. This option determines whether or not TN3270E Responses are supported. Normally this option is not used for display sessions. Check with your system administrator if you need to set this value to Yes. The default is No.

TN5250ESupport=Yes or No
This option can only be enabled if EmulType=TN5250 is also specified, otherwise it is ignored. If this option is set to Yes, the TN5205E enhanced protocol will be used when connecting to the IBM iSeries (AS/400) host system. With TN5250E support, display sessions can connect to either a generic or specific pool of LUs. The default value is No.

ConnectMethod=Generic or Specific
This parameter can only be configured if EmulType=TN3270 and TN3270ESupport=Yes are configured, otherwise it is ignored. The default value is Generic. For EmulType=TN5250, this value is forced to be Specific and any setting is ignored.

A generic connection is the basic TN3270 connection method. The session established with the TN3270 server comes from an unnamed pool of LUs. The unnamed pool is identified by the 3270 screen size and extended attribute settings. For example, if you configure a 3270 model 2 screen size without extended attributes, the session will be established with an unnamed pool of LUs having the device type IBM-3278-2.

A specific connection provides a connection to a specific named LU pool, or to a specific dedicated LU. A dedicated LU is basically an LU pool with a single LU in the pool. If you select the specific option, you must also specify the ResourceName that corresponds to the name of the dedicated LU or LU pool.

ResourceName=<text string 1 to 12 characters in length>
For TN3270E, this parameter can only be configured if ConnectMethod=Specific, otherwise it is ignored. Also, for TN3270E, the text string can be 1 to 8 characters in length. For TN5250E, the text string may be 1 to 12 characters in length. The ResourceName is the device or pool name used by PASSPORT and the Telnet server to identify and establish a connection to a specific LU or LU pool. Your system administrator must give you the correct information to configure here. Normally, the resource name only uses capital letters, and may also used numbers 0 through 9 as well. There is no default value.

ScreenSize=2, 3, 4, 5 or Dynamic
The screen size parameter specifies the number of rows and columns the terminal display session can display. The screen size is also known as the terminal model size. If correct screen size is not configured properly, you may not be able to make a connection to the host. For TN3270 connections you can specify 2, 3, 4, 5, or Dynamic. For TN5250 sessions you can only specify 2 or 5. The default is model 2 screen size.

ExtendedAttributes=Yes or No
This parameter can only be configured if EmulType=TN3270 is configured, otherwise it is ignored. This configuration option determines whether or not extended attributes will be decoded and place into the screen display buffer. Extended attributes includes seven-color display, underline and reverse video. The default is Yes.

AutoReconnect=Yes or No
If this parameter is configured to Yes, PASSPORT will try to reestablish a session with the host if that session times out or is unexpectedly disconnected by the gateway or host, or if the host is down when trying to connect. PASSPORT will attempt to reconnect after first waiting for 1 second, then 5, 10, 15, 20, 25 seconds, and then 30 seconds thereafter between each attempt until a connection is established. This helps reduce network traffic. Once PASSPORT successfully connects to the host, the reconnection value will be reset to 1 second again. If you log off a mainframe session using a command such as VMEXIT, LOGOFF, or CSSF LOGOFF, the host session will be disconnected and another session with the host will automatically be initiated, returning you to the host logon prompt. If this parameter is set to No, you will get a blank host screen if disconnected from your mainframe session. The default is Yes.

HostCodePage=<3 or 4 digit number representing a host code page>
This parameter can only be configured if you purchased the international version of PASSPORT Host Integration Objects. Configure the appropriate host code page for your country, or the country in which the host mainframe is located. This determines which translation tables are used to convert between the host's EBCDIC character set and the PC' Windows ANSI character set. The Euro host code pages 1140 through 1148 are identical to the non-Euro host code pages, except that the European currency symbol replaces the international monetary symbol.

For the US version, only host code pages and 1140 are supported. For the international version, all the host code pages below are supported. The default value is 037.

KeepAlive=Yes or No
When this parameter is configured to Yes, PASSPORT sends a periodic timing signal to the gateway or mainframe to ensure that the connection is not idle long enough to be terminated. This feature can also be used to keep an internet connection alive. If your host sessions stay idle for long periods of time, the host system may terminate the connection. If this happens, then set this value to Yes. The default value is No.

KeepAliveTimer=<Number indicating keep alive timing interval, in minutes>
The KeepAlive=Yes must be configured in order to use this parameter, otherwise it is ignored. This value specifies the regular interval at which PASSPORT will send a timing signal. The value may be between 1 minute and 1440 minutes (1 day). The default value is 15 minutes.

KeepAliveSequence=TM or NOP
The KeepAlive=Yes must be configured in order to use this parameter, otherwise it is ignored. The Keep Alive Sequence provides the ability to choose between two timing signal options: NOP or Timing Mark. The default setting is NOP.

Security=SSL or None
When Security=SSL is configured, SSL (Secure Sockets Layer) encryption is enabled. Both TN3270 and TN5250 terminal emulation sessions are protected from eavesdropping, tampering, or message forgery. Secure Telnet sessions using SSL typically use TCP Port 992 instead of 23, but may be re-configured to any available TCP Port desired. The host mainframe computer you are connecting to must also be configured for SSL, or a connection will not be made. The default value is None.

SSLAcceptSelfSigned=No or Yes
To accept a self-signed server certificate, set SSLAcceptSelfSigned=Yes. The default setting is No.

SSLAcceptExpired=Yes or No
To accept a server certificate that has expired, set SSLAcceptExpired=Yes. The default setting is No.

SSLAcceptNotYetValid=Yes or No
To accept a server certificate that has a starting date in the future, set SSLAcceptNotYetValid=Yes. The default setting is No.

SSLAcceptInvalid=Yes or No
To accept invalid server certificates for any reason other than the date, signature or name mismatch, then set SSLAcceptInvalid=Yes. With this parameter enabled, the server certificate check is ignored. The default setting is No.

SSLAcceptNameMismatch=Yes or No
To accept SSL certificates that have mismatched names, set SSLAcceptNameMismatch=Yes. The default setting is Yes. Host names may be either an IP address or a DNS name.

ShowSSLWarning=Ignore or Stop
If Stop is configured and the host certificate verification fails, the connection to the host will not be established. Otherwise, if Ignore is configured and the host certificate verification fails, the connection to the host will be established anyway. The default is Stop.

SSLClientCert=<text string>
If an SSL client side certificate is desired, then this parameter is used to identify the certificate. If this parameter is not set, then an SSL client side certificate will not be used. The text string is the name of the SSL certificate that is stored in the Microsoft Windows Certificate Store. The certificate name may have blanks in the name. In order to use your own SSL client certificate, it must first be added to the Microsoft Windows Certificate Store.

SSLEnabledProtocols=<integer>
Some TN3270 or TN5250 servers with SSL support require a particular SSL protocol. If this parameter is 0, Microsoft SSL implementation (Schannel) automatically selects the protocol to be used. The default is 0. The following table shows the possible values:

For example, if you want to support SSL3 and TLS1 (client), you can the following line:

Hotspot=<hotspotfile>
Provide the name of a custom hotspot file, which should exist in the same folder as the .zcc configuration file and should not include the .zhs file extension. This is only used for the Screen.AutoGUIHTML method.

SP_PROT_PCT1_SERVER	0x00000001
SP_PROT_PCT1_CLIENT	0x00000002
SP_PROT_SSL2_SERVER	0x00000004
SP_PROT_SSL2_CLIENT	0x00000008
SP_PROT_SSL3_SERVER	0x00000010
SP_PROT_SSL3_CLIENT	0x00000020
SP_PROT_TLS1_SERVER	0x00000040
SP_PROT_TLS1_CLIENT	0x00000080