Utilities

Z and I Emulator for Windows provides the following utilities:

32-bit ODBC Administrator
Allows you to add, configure, or delete an ODBC data source.
Scratch Pad
The Scratch Pad is a lightweight text editor with the capability of normal edit operations, such as cut, copy and paste.

Note that Scratch Pad requires .NET Framework 3.5 or lower versions installed. The menu item is grayed out in Windows 8 or 8.1 as .NET Framework 3.5 is not available by default on these operating systems. Install .NET Framework 3.5 to resolve the problem.

Multiple Sessions
Provides the capability to run multiple host sessions using a single icon.
ZipPrint
Allows you to print PROFS™ notes, calendars, CMS files, XEDIT workspaces, and 3270 session screens.
Convert Macro
Allows an existing Z and I Emulator for Windows Macro file to be converted to an XML or VBScript file.
Data Transfer
Transfers data from the iSeries®, eServer™ i5, or System i5® to your workstation, or from your workstation to the iSeries, eServer i5, or System i5 (record-level data transfer).
iSeries Connection Configuration
Define connections to each iSeries, eServer i5, or System i5 host that will use the data transfer function.
Preferences
Configuration of certain advanced parameters.
PcsSound
The PcsSound utility, available under the product installation directory, allows you to:
Note:
Saving and restoring a sound scheme will be useful while changing Windows themes.

32-Bit ODBC Administrator

ODBC is a programming interface that enables applications to access data in database management systems that use Structured Query Language (SQL) as a data access standard.

Use the following steps to set up the Z and I Emulator for Windows ODBC data source:

  1. Select the 32-bit ODBC Administrator icon from the Windows Control Panel. The Data Sources window appears.
  2. Select IBM® DB2® ODBC Driver data source in the Data Sources (Drivers) list. Then click Finish.
  3. Click Add Database. The Z and I Emulator for Windows Add Database SmartGuide appears to prompt you through the set up.
  4. Select the Manually Configure a Connection to a DB2 Database radio button.
  5. Specify the information to set up the data source, by clicking Next.
  6. When you are finished specifying the information, click Done.
  7. You will be prompted to test the connection. To test the connection, click OK.
Notes:
  1. Z and I Emulator for Windows uses ODBC 32-bit drivers. Applications, such as Lotus® 1-2-3® included in the Lotus SmartSuite® 96 package, require a 16-bit driver and will not work with Z and I Emulator for Windows. You should see your product vendor for a version that utilizes 32-bit ODBC drivers (Lotus 1-2-3 included in Lotus SmartSuite 97 for example).

Multiple Sessions

The Z and I Emulator for Windows Multiple Sessions Batch Program enables you to start several host sessions by clicking a single icon; the necessary commands are specified in a batch file (.BCH). You can include in a batch file other programs, which may communicate with a host session using the DDE or EHLLAPI interface.

ZipPrint

ZipPrint is a 3270 utility that enables you to print PROFS notes, calendars, OV documents, CMS files, XEDIT workspaces, and 3270 session screens. By default, it uses the Windows printer currently set up for the host session, but you can change it if you wish.

You do not have to install ZipPrint--you just start it. It adds itself to the menu bar of the sessions for which you define it, so you can use it in the same way as any other menu bar function. You must start ZipPrint before you start a session in which you want to use it.

ZipPrint needs the DDE/EHLLAPI, so you must make sure that this is enabled for the sessions for which you want to use ZipPrint. (It is enabled by default, but you should check that it has not been turned off.)

For more information about ZipPrint, see ZipPrint (3270 Only).

File Transfer Considerations

ZipPrint uses the Z and I Emulator for Windows file transfer function to print VM/CMS notes and files. In order for this function to work correctly, you should use the VM/CMS host type for 3270 file transfer.

In the emulator session window, click Settings -> Transfer. On the File Transfer Settings -> General tab, select VM/CMS from the Host Type drop-down list.

On slow communications lines, if you are using a large packet or block size, you may experience a file transfer timeout. If you do, you should increase the timeout delay. To change the timeout delay, do the following:

  1. From the session menu, click Settings -> Transfer.
  2. On the General tab, change the File Transfer Timeout to 150 seconds.

Convert Macro

The Convert Macro utility enables you to convert an existing Z and I Emulator for Windows Macro file to XML or a VBScript file.

Note:
Macros that are converted to XML are intended for use in ZIEWeb (Z and I Emulator for Web) and will not function in Z and I Emulator for Windows emulation sessions. Use the ZIEWeb Macro Manager to import a converted Z and I Emulator for Windows macro into ZIEWeb. These converted macros will not appear in the list of available Z and I Emulator for Windows macros.

To use the conversion utility, click HCL Z and I Emulator for Windows -> Utilities -> Convert Macro.

To convert an existing macro to XML or a VBScript, do the following:

  1. Select the name of an existing macro to be converted.
    Note:
    The macro must exist in the application data directory specified during installation.
  2. Select VBScript or XML as the type of macro to which to convert.
  3. Click Convert.
  4. Enter a name for the new XML file or VBScript or accept the generated name. The extension will be added automatically.
    Note:
    When saving a converted XML macro you can choose where you would like to save it. You should not change the location of the converted VBScript macros.
  5. Click Save.
  6. Repeat the procedure to convert another macro, or click Close to end the application.

Data Transfer

Z and I Emulator for Windows Data Transfer enables you to transfer data between an iSeries system and your workstation. To use the Data Transfer function, select the Data Transfer icon.

Transferring data is quite different from transferring files, which is described in Transferring Files.

Requirements

Before you can transfer data with Z and I Emulator for Windows:

There are two types of data transfer, depending on the direction of the transfer.

Data sending
Data is transferred from your workstation to the iSeries, eServer i5, or System i5.You can transfer data to any of the following destinations:
Note:
You cannot transfer data from a workstation file to an iSeries, eServer i5, or System i5 logical file.
Data receiving
Data is transferred from the iSeries, eServer i5, or System i5 to your workstation.

While receiving data from the host, you can specify the data to be received and where the data is to be output.

Receivable data includes:

Specify the following output destinations:

Also, you can specify the numeric value format.

For more information about data transfer, refer to Emulator User's Reference.

iSeries Connection Configuration Utility

The iSeries Connection Configuration Utility is used to define connections to each iSeries, eServer i5, or System i5 host that will use the data transfer function. The connection definitions are saved in an .NDC file in ASCII format.

You can use this utility for TCP/IP connections.

For more information on Data Transfer see Data Transfer.

To use the utility, click Start -> Programs -> HCL Z and I Emulator for Windows -> Utilities -> iSeries Connection Configuration; the resulting iSeries, eServer i5, or System i5 configuration screen has the following options:

Show IP Host Connections
Click this button to display and configure IP connections to the iSeries, eServer i5, or System i5 host.
Add
Click the type of connection and then click Add. Enter the Host name and Alias in the resulting dialog box.
Modify
Select a host name from the connection list, and then click Modify to edit the Host name and the Alias in the .NDC file.
Remove
Select a host name from the connection list, and click Remove to delete this connection definition from the .NDC file.
Note:
When disabling a connection, if you want to preserve the connection definition but disable the connection, clear the checkbox next to the name in the connection list.
Global Parameters
Click this button to edit the Extension list and Cache size.

Extension List

The extension list parameter specifies the extension of a file on an iSeries, eServer i5, or System i5. You can specify more than one extension parameter in the extension list. The code pages of files with the specified extensions are translated from the EBCDIC code page to the ASCII code page when the file is transferred between the iSeries, eServer i5, or System i5 and the client. Up to three characters are allowed. There are two special cases:

Cache Size

The cache size parameter specifies the number of kilobytes of iSeries, eServer i5, or System i5 data that is buffered in the read-ahead cache of the client. The default is 256 KB; the maximum is 4 MB. A value of zero requests that no cache be used. iSeries, eServer i5, or System i5 data can be retrieved in amounts that are first cached locally on the client. The client retrieves the data from the cache to populate the local device. This read-ahead caching reduces the number of times the client has to access the iSeries, eServer i5, or System i5 to retrieve the data.

Preferences

The Preferences utility provides a method for changing configuration and setup items.

Notes:
  1. Preferences set with the Preferences Utility pertain to you whenever you log on to the same user ID on the affected workstation; they apply to all of your sessions while you are logged on.
  2. Preferences set using the session Edit menu apply to all sessions controlled by the workstation profile created or changed while using a session--when that session profile is used again, the preferences are applicable, regardless of the user ID at the time.
  3. One of the capabilities of the Preferences Utility is to allow specification of a directory to be used for storing your profiles; this allows full control of your environment.

To access the Preferences Utility, click Programs -> HCL Z and I Emulator for Windows -> Utilities -> Preferences from the Windows Start menu. Select the Basic tab to change the preferences and select Advanced tab to change the maximum number of emulator sessions and pass through host certification validation.

Basic

Emulator Profile File Location

If the All User application data directory location was selected during installation of Z and I Emulator for Windows, you can specify the default location of workstation profiles.

Macro/Script Location

You can specify where emulator macro and script files are to be placed. This directory will be common to all sessions.

By default, macros are placed in the application data directory specified during the installation of Z and I Emulator for Windows, and the macro/script location field value is blank.

User Interface Language

You can view the language of the installed package by selecting Help > About Z and I Emulator for Windows from the session menu bar.

If your system was installed with multiple-language support, the Basic property page shows a section labeled Select a default user interface language. If you click on the radio button for Z and I Emulator for Windows User Interface Language Preference, it also shows a drop-down list box, with the language selected that is currently being used; you can select any other language from the list, and that language will be used for the user interface when you subsequently restart Z and I Emulator for Windows. Or you can click the radio button User Default from Regional Settings if you want the language to be that specified in the Windows settings. You can also click the radio button Post a Language Selection Dialog for each process; this results in a pop-up dialog each time you start a new application from the Z and I Emulator for Windows group of programs.

Note:
You might receive a warning message, if the selected language is incompatible with your system's current code page. You can ignore this, if you are planning to reboot your computer to select a new system locale with a compatible code page.

Advanced

Maximum number of emulator sessions

Specify the maximum number of Telnet emulator sessions. It can be either 26 or 52 sessions. Default is 26 sessions.

Pass Through Host Certificate Validation

Choose whether to enable or disable the default certificate validation process during SSL/TLS handshake. Default is enable the certification validation. Applicable only for Microsoft schannel provider.

Note:
By default, schannel (MSCAPI) is responsible for validating the host certificate chain received during SSL/TLS handshake. Schannel runs several checks on the received certificate chain, one of which is verifying that the signature affixed to the certificate is valid. The hash value computed on the certificate contents must match the value that results from decrypting the signature field using the public component of the issuer. In order to perform this operation, you must possess the public component of the issuer, either through some integrity-assured channel, or by extracting it from another (validated) certificate. The default certificate validation process is exhaustive and runs several checks on the host certificate chain in order to successfully validate it. By enabling this option, you would effectively suppress the default validation done by schannel and the identity of the host would not be verified. Using this option is not recommended.

ZIE Server Details

The ZIE Server can either be configured by providing the required server details in the ‘InstallShield Wizard' at the time of ZIEWin installation itself, or can be added/updated in the ‘ZIE Server Detail' section of the Advanced tab within the Preferences.

Web Server Details : The URL of the Web Server from where Z and I Emulator for Windows installer or fix pack file will be downloaded for installation. Z and I Emulator for Windows prompts the user with a Pop-Up message for an Auto-Upgrade, if a newer version of ZIEWin is available on the Web Server. Upon receiving a confirmation from the user to upgrade, the latest version of installer or fix pack will be installed on the system by Z and I Emulator for Windows Session Manager ONLINE.

Config Server : DNS Name or IP address of the ZIE server, where the User profiles are stored in a centralized location.

Config Server Port : The port that is used to connect to the ZIE server.

ZIE Server Details
Figure : ZIE Server Details section in the ‘InstallShield Wizard' of ZIEWin.
Preferences
Figure : ZIE Server Details section within the Advanced tab of Preferences utility in ZIEWin.

Standby/Hibernate

Choose whether to prompt for acceptance when the system attempts to go to standby or hibernate (power saving) mode. If you select Standby/Hibernate without prompting, Z and I Emulator for Windows allows the system to standby or hibernate without prompting you, even if sessions are connected. By default, this option is clear.

See Power Management for more information.

Z and I Emulator for Windows FTP client

The Z and I Emulator for Windows FTP client implements the client functionality specified by File Transfer Protocol (FTP), which is the standard protocol for transferring files to and from remote machines running FTP servers. The FTP client enables file and directory upload and download, and directory navigation of remote and local file systems.

The Z and I Emulator for Windows FTP client supports the following servers:

The following limitations apply:

Command Line FTP

The command line FTP is used to achieve the FTP functionality over the command line. It is used to transfer files using FTP to and from a host with a UNIX file system, using pcsftpcmd.exe. It can be invoked from the command line using a set of parameters and switches. The functions supported by the executable are:

The necessary arguments for invoking the executable are:

hostname
This is the first argument and you need to specify the FTP server host name to which you want to connect.
username / password
These are the second and third arguments, which specify the user credentials to access the given host.
operation
In this argument you can specify the operation that needs to be performed. Possible operations are:

The transfer mode is set to AUTOMATIC, that is, the executable automatically checks to see if the extension of the file to be transferred is one of .log, .ini, .txt, .bat, .inf, in which case the mode is set to ASCII. For everything else it is set to BINARY mode.

Use one of the following switches to invoke help:

The issue here is that the password would be in plain text, which would be a security concern which can be overcome by requesting the customer to explicitly enter the password when the connection is being made.

The initial command line FTP being developed would entertain non-secure connections alone and would not support secure connections. The command line FTP currently under development would support only Windows/Unix style file systems. Other file systems would be supported in future releases.

If the user does not want to give the password in plain text along with the other parameters, a - can be entered in the password field, and then run the command which asks for the user to input the password dynamically.

The command line FTP is currently available only in English language.