Step 4: Defining Modem and Communication Settings

Modem settings enable you to add customized modem definitions and edit initialization strings by selecting a modem from a list of existing modems.

Communication settings enable you to define the session type, session parameters and select the script file and setup file. Communication and terminal settings are both saved to a setup (.PTS) file. This file can be used on PowerTerm Pro startup (see Step 1: Starting PowerTerm Pro ), or open a PowerTerm Pro session (see Step 5: Saving the Terminal Setup File)

All sessions in the sessions list are saved in the PTCOMM.INI file.

1) From the Communication menu, select Modem Setup. The Modem Setup dialog box is displayed:

Modem Information

Modem Name: Specifies the name of the modem.

Init String: Specifies the initialization string, which defines the way the modem communicates with another modem.

Modem List: If you added modem settings previously using the Add button in the Modem Setup dialog box, the available modems will appear in the Modem List. You can select a modem by double-clicking on its name. When you select a modem, its name and initialization string appear in the Modem Information fields.

Add: Adds the modem settings to the Modem List.

Options

Clear: Clears the Modem Information fields for the selected modem. You can clear the Modem Information fields as follows:

    1. Select the modem from the Modem List. The parameters of the selected modem appear in the Modem Information fields.
    2. Click the Clear button. The Modem Information fields are cleared, and you can redefine this information for the defined modem.

Modify: Updates the data entered in the Modem Information fields for the selected modem in the Modem List. Modem settings are modified as follows:

    1. Select the modem you want to modify from the Modem List.
    2. Clear the Modem Information fields, as described above.
    3. Enter the new parameters in the Modem Name and Init String fields.
    4. Click the Modify button. The Modem Information fields of the selected modem are updated.

Delete: Deletes settings for a modem. You can delete a modem as follows:

1. Select the modem to delete from the Modem List. The parameters of the selected modem appear in the Modem Information fields.

2. Click the Delete button. A confirmation message is displayed.

3. Click OK to delete the selected modem from the Modem List.

2) Enter the modem name in the Modem Name field.

3) Enter the initialization string in the Init String field.

4) Click Add. The new modem settings appear in the Modem List.

5) Click OK once you have selected the required modem settings. You can now define your communication settings, as described below:

1) From the Communication menu, select Connect. The Connection dialog box is displayed:

Available session types differ according to the selected terminal emulation.

2) Select a terminal type from the dropdown list.

3) Click a session type. For each session type, PowerTerm Pro displays a set of session parameters on the right side of the dialog box (some types have identical parameters). For example, under a VT session, you will see TELNET.

A description for each session type follows:

Session Type

Description

TELNET

Uses the Telnet protocol over TCP/IP for network communication. For this session type, you must specify the host computer name or the IP address in the Parameterís Host Name text box. You can also specify the TELNET port number (default 23).

The WINSOCK.DLL file must be on the search path.

COM

Uses serial communication with the PC's COM ports. For this type, you must define the baud rate, port number, parity, stop bits and flow control. Optionally, you can specify a phone (dial) number.

INT 14

Uses BIOS interrupt 14. For this type, you must define the baud rate, port number, parity, stop bits and flow control. Optionally, you can specify a phone (dial) number.

BAPI

For TCP/IP connections with parameters similar to those of TELNET. Before you use this option, make sure you have installed the BAPI support software on your PC.

CTERM

Uses the DIGITAL CTERM protocol for network communication with a remote or local VAX/OpenVMS host via DIGITAL PATHWORKS 32. For this session type, you must specify the host computer name in the parameterís Node Name.

LAT

Uses DIGITAL LAT protocol for network communication with a VAX/OpenVMS host via DIGITAL PATHWORKS 32. For this type, you must specify a service name and optionally, a password, if required.

TN3270

TELNET for 3270. Select the Use TN3270E protocol box if you want to work with TELNET SNA extensions. You can also specify the LU name of the host (LU name or LU pool).

MS SNA Server

For connection via Microsoft SNA Server. Specify the LU Name (or LU pool).

NWSAA (IPX)

For connection via IPX to Novell Netware for SAA. Note that Service Name is the same as Novelís file. You must select an LU Category. You can specify an asterisk as the server name and PowerTerm Pro will connect to the appropriate Netware for SAA server.

NWSAA (TCP/IP)

Same as previous for TCP/IP connection. You must specify the server's IP address or host name in the Server Name field.

TN5250

TELNET for 5250.

APPC

In System Name and Device Name, specify the appropriate AS/400 names. Select Auto SignOn if you want to skip the sign on stage.

RLOGIN

Uses the RLOGIN protocol over TCP/IP for network communication. For this type you must specify the host computer name or the IP address. You can also specify the port number in the Host Name field.

SUPERLAT

This is a version of the LAT protocol for network communication with a VAX/Open VMS host, which requires Meridian's SUPERLAT. For this type, you must specify a service name and, if necessary, a password.

Terminal

Type: Changes the currently supported emulation.

To change the emulation, select the required emulation from the dropdown list.

If the terminal type 5250 Display is selected, the Device Name field is enabled.

ID: Changes the ID returned by the emulation program to the host.

To change the ID, select the required ID from the dropdown list.

Device Name: When using multiple sessions, each new session can be automatically given a new name, followed by the session number. For example, if the device name was Test, then the first session would be Test1, and the next Test2 and so on.

To enter the device name, simply enter "devicename+" in the Device Name field and save the setup file.

Enable SSL: This parameter determines whether to implement the SSL protocol. SSL called Secure Sockets Layer (SSL), is a widely-implemented protocol which provides data encryption, server authentication, message integrity and optional client authentication for a TCP/IP connection. Enabled with SSL, PowerTerm gives you the choice to transmit the data to a secure server, which is equipped with SSL.

Contact the system administrator of the system that you are accessing to determine the correct port to use.

  This field is visible to those who have the SSL dll installed on their computer.

Script File: Specifies the name of a script to be run before communication is established.

To specify the file name, either type it in the text box or click the browse button. The Browse Login Script dialog box, shown below, displays the script files located in the PowerTerm Pro directory.

Select a file and click Open.

By default, scripts are listed with a .PSL extension. You can, however, specify any name for your script. If your script file carries a different extension, you can list them by typing the extension (proceeded by an asterisk and a dot) in the File name text box, and then press the <Enter> key.

Setup File: Specifies the name of the setup file to be opened before communication is established.

To specify the setup file name, either type it in the Look in text box or click the browse button. The Browse Terminal Setup dialog box, shown below, displays the setup files located in the PowerTerm Pro directory:

Select a file and click Open.

By default, scripts are listed with a .PTS extension. You can, however, specify any name for your script.

Sessions List

If you saved session settings using the Save As button in the Connect dialog box, you will see the session names in this list. Select a session by double-clicking its name. This establishes communication with the host. Note that as you select a session, its parameters appear in the dialog box.

Connect: Connects to the host according to the displayed session parameters.

Save As: Saves the current session settings.

You can save a session as follows:

1. Define session parameters.

2. Click the Save As button. The Save Session dialog box is displayed:

PowerTerm Pro offers a default session name. You can overwrite this name and specify your own session name.

3. Click OK.

The session is displayed in the sessions list. After saving a set of communication parameters from the Sessions List area, you can use it to start a communication session.

Modify: Updates the selected session in the sessions list area, with the data entered in the upper section of the dialog box. A session is modified as follows:

    1. Select the session you want to modify from the Sessions List.
    2. Enter the new parameters in the upper section of the Connect dialog box.
    3. Click the Modify button. Saves the new parameters for the selected session.

Delete: Deletes a session setting. You can delete a session as follows:

1. Select the session to delete from the Sessions List.

2. Click the Delete button.

3. A confirm message is displayed. Click OK to delete the session setting.

2) From the Emulation tab, select 5250 Display.

3) Click OK.

4) From the Communication menu, select Connect. The Connection dialog box is displayed:

5) In the Host Name field enter the name of the AS/400 host.

6) In the Device Name field enter the device name for the emulation session (up to a maximum of 10 characters).

When using multiple sessions enter "devicename+" and each session will be automatically assigned a new name. For example, if the device name entered was John+, then the first session will be John1, the second John2 and so on.

7) Click Connect.

The AS/400 session begins and is assigned the device name specified above.

Step 5: Saving the Terminal Setup File

Once both terminal and communication settings have been defined, you can save them to a setup (.PTS) file. This file can be used to start PowerTerm Pro, or opened manually during a PowerTerm Pro session in order to define terminal and communication settings.

PowerTerm Pro asks you if you want to save setting changes to the currently loaded setup file. If you do not want to overwrite the parameters in the current setup file, save the settings under a different file name.

You can also create an icon for your current PowerTerm Pro settings, which can be accessed from the Windows 95 Start menu, or by double-clicking on the icon on your desktop. Your session starts automatically with the desired parameters.

You can also save settings when you exit PowerTerm Pro. For more information, see Step 9: Exiting PowerTerm Pro

From the File menu, select Save Terminal Setup. The current terminal settings are saved to the currently loaded terminal settings (.PTS) file.

This option overwrites parameters previously defined in the setup file.

1) From the File menu, select Save Terminal Setup As. The Save File As dialog box is displayed:

  The default Terminal Setup file extension is .pts.

3) Click Save. The file will be saved with the specified file name.

1) From the File menu, select Save As Shortcut. The Save As Shortcut dialog box is displayed:

2) Enter the Shortcut Target Information that you want to use for your PowerTerm Pro session.

The name of the setup file should be changed to avoid confusion. If you use the default name, PTDEF.PTS, these settings will become the default settings when PowerTerm Pro is launched, if no other settings file has been specified.

Opening a Setup File

Once you have created a setup file, you can open it in PowerTerm Pro in order to connect to a host by using the predefined terminal and communication parameters.

Step 6: Connecting to a Host

This step describes how to connect to a host once you have defined terminal and communication parameters, as described in Step 4 of this chapter

This option is not relevant if you started PowerTerm Pro automatically with a terminal setup (.PTS) file (see Step 1: Starting PowerTerm Pro) or with a script file (see Running a Script upon Startup).

2) Click Connect. This connects you to the host computer using the current communication (session) parameters. The newly created session is displayed in the Sessions List. At the same time, the communication mode appears beside the application name on the PowerTerm Pro window title bar, as displayed below. When communication ends, the mode name disappears from view.

Modify Connection to a Host

PowerTerm Pro provides the option to modify connection parameters for COM type communication. This option is only available once you are connected to a host.

  Clicking Apply, Connect or selecting a different session from the Session List saves the terminal settings of the previously modified session.

Automatically Connecting to the Host Using a PowerTerm Pro Script

When you are working with more than one host, PowerTerm Pro enables you to connect to a host using a customized PowerTerm Pro script. You need to define and name a different script for each host. This option provides you with a Windows 95 shortcut to a host.

For details of how to start PowerTerm Pro using a customized setup file, see the section Running a Script upon Startup

Step 7: Working with the Host

Once you have connected to a host, PowerTerm Pro enables you to perform the following functions:

Transferring Files

PowerTerm Pro enables you to transfer files between the PC and the host. PowerTerm Pro operates with both ASCII and non-ASCII files.

File transfer for 3270 emulations . File transfer for 5250 emulations are not supported.

1) Connect to a host. For more information, see Step 6: Connecting to a Host

2) Type the command that the host uses in the work area to receive a file and then press <Enter>.

By selecting Show Always the expanded Options panel will automatically open each time.

File Name: The name of the file that resides on the PC.

Protocol: Select the type of communication protocol implemented in transferring files.

Show Always: Displays the PC and Host options as a default.

Settings

Data Type

Host: The format of the file that resides on the host.

PC: The format of the file that resides on the PC.

1) Connect to a host. For more information, see Step 6: Connecting to a Host

2) In the work area, type in the command that displays the file (For example: for UNIX, cat filename; for VAX, type filename). Do not press Enter.

By selecting Show Always the expanded Options panel will automatically open each time.

1) Connect to a host. For more information, see Step 6: Connecting to a Host

2) In the work area, type the hostís file reception command and press Enter.

By selecting Show Always the expanded Options panel will automatically open each time.

Click Send. The PC starts to send the file. The sent file will be saved on the host under the name you specify (in the directory you selected).

1) Activate the command that will accept the data on the host (examples: for UNIX, -cat > filename, or enter an editor and move to the data entry state within the editor).

2) From the Communication menu, select Send File. The Send File dialog box is displayed:

By selecting Show Always the expanded Options panel will automatically open each time.

Click Send. The PC starts to send the file. The received file will be saved on the PC disk under the name you specify (in the directory you selected)

Transferring Files for 3270 Emulations

PowerTerm Pro provides IND$FILE transfer for 3270 emulation.

1) From the Communication menu, select Receive File. The IND$FILE: Receive File window is displayed:

  By selecting Show Always the expanded Options panel will automatically open each time.

PC File Name: The name of the file that resides on the PC.

Host File Name: The name of the file that resides on the mainframe.

Protocol: Select the type of communication protocol implemented in transferring the files.

Show Always: Displays the PC and Host options as a default.

Settings

Data Type

Host: The format of the file that resides on the host.

PC: The format of the file that resides on the PC.

File Creation

Append: Specifies the appending ofthe transferred file onto the existing file of same name.

Overwrite: Specifies that the transferred file overwrites the existing file of same name.

File Conversion

ASCII: Specifies converting the file to ASCII format.

CR/LF: Specifies deleting a carriage return character and a linefeed character from the end of each line of the file that you are sending, or their addition to the end of each line of the file you are receiving from the host. CR/LF processing is typically appropriate for ASCII files (but not for binary files).

Local Conversion: Specifies converting the file according to the format specifications that appear in the above Host and PC boxes.

Allocation Units

The primary and secondary space allocations (see Advanced property page) are measured in either track, cylinder or average block units. Each type is represented by one of the following fields:

Tracks: Specifies Tracks as the allocation unit of disk space.

Cylinders: Specifies Cylinders as the allocation of disk space.

AvBlocks: Specifies the size (in blocks) for an average block.

  Relevant only where you are using blocks as your allocation unit.

Record Format

Default: Specifies the Default Record Format for the file residing on the mainframe.

Fixed: Specifies the Fixed Record Format for the file residing on the mainframe.

Variable: Specifies Variable Record Format for the file residing on the mainframe.

Undefined: Specifies Undefined Record Format for the file residing on the mainframe.

Advanced

LRECL (Logical Record Length): Specifies the record size (in bytes) for the file being created on the host. For ASCII files, set this value to accommodate the longest line in your file.

Range of values: 0 and 32768.

The default: lines of up to 80 characters.

Block Size: Specifies the block size (in bytes) for the file being created by the host. This value must be a multiple of the LRECL (Logical Record Length) for files with fixed-length records.

Space: Specifies the size (in allocation units) of the primary (left box) and secondary (right box) allocation for the host file being created. In the event that the primary allocation is insufficient, then a secondary allocation is used.

Additional Options: Specifies any parameters specific to the IND$FILE program on your host system. The contents of this text box are attached to the end of the transfer command.

Host Program: Specifies the name of the host program to be utilized by PowerTerm Pro to initiate a file transfer.

The default and only valid choice: IND$FILE.

Printing

PowerTerm Pro enables you to define print parameters and print the terminal screen or data transferred from the host application.

From the File menu, select Print Setup. The Print Setup dialog box is displayed:

This dialog box contains a set of printing parameters. The displayed parameters change according to the printer you select. For details, consult your printer documentation.

From the File menu, select Form Feed.

From the File menu, select Line Feed.

1) From the File menu, select Start Auto Print. The Start Auto Print command starts accumulating incoming data (while it is displayed on the screen). After you select this command, the menu option changes to Stop Printing.

2) On the File menu, click Stop Printing. The Stop Printing command prints all the data accumulated in the printing buffer of the slave printer, or in the autoprint buffer. Select this command to print the accumulated information if data was buffered with a printing request and communication failed before the data was sent to the slave printer.

1) Open a session.

2) From the Terminal menu, select Setup. The Terminal Setup window is displayed.

3) From the Emulation tab, select 5250 Printer.

4) Select the Printer tab, and from the Print Device dropdown list select File.

5) In the File Name field enter Lpt1 and click OK.

6) From the Communication menu, select Connect. The Connect dialog box is displayed.

7) In the Host Name field, enter the name of the AS/400 host. Enter the name of the device for the printer session in the Device Name field.

8) Click Connect. The Printer Session window is displayed. Leave it open. The AS/400 automatically creates a queue with the specified device name.

9) Open another session - a 5250 display session and send your print jobs to the queue created by the AS/400.

Print the Terminal Screen

From the File menu, select Print Screen to print selected text, or the entire contents of the work area.

Starting a New PowerTerm Pro Session

PowerTerm Pro enables you to run two or more sessions concurrently by opening a new instance of the PowerTerm Pro window.

Each session is identified by a letter (A to Z) which appears in the session window title bar. A session is assigned the first available letter. The first session is (A), the second (B) and so on. For example, if A, B and D are opened, the next session is assigned C.

From the File menu, select New Terminal window.

A new instance of the PowerTerm Pro window is displayed.

You can switch to a specific session by pressing <Shift> + <Ctrl> + <X>, where X is the session letter. For example, if you want to work in session C, you would press <Shift> + <Ctrl> + <C>.

You can switch between sessions by pressing <Ctrl> + <Spacebar>.

Hotspots

A hotspot is a section of text that activates a function when selected. Hot spots are particularly common in where selecting a hot spot can display another menu, run an application, or open a new window of information.

Name

The name of the hotspots.

Enabled

The hotspot is enabled.

Identify By Text

The chosen text that has been made into a hotspot.

Row

The location of the row where the hotspot is located.

Col

The location of the column where the hotspot is located.

Case Sensitive

The text on the host screen must match the case of the hotspot text exactly to activate that text as a hotspot (i.e. "mainframe" would not be sufficient to activate the hotspot, "Mainframe"). When this option is cleared, the text does not need to match the case.

Type Key

If selected then you must specify the function key from the list.

Script Command

If selected then you must specify the script command.

Script File

If selected then you must specify the script file.

Step 8: Ending a PowerTerm Pro Session

You need to end a session before exiting the PowerTerm Pro application. PowerTerm Pro provides four options for the end of a session:

For details on how to exit PowerTerm Pro, see Step 9: Exiting PowerTerm Pro

Automatic Closing

PowerTerm Pro enables you to close PowerTerm Pro automatically when you close a session.

    • To define parameters for closing a PowerTerm Pro session automatically:

1) From the Terminal menu, select Setup. The Terminal Setup dialog box is displayed.

2) Select the Preferences tab.

3) Click the Auto Exit PowerTerm Pro box to select it.

4) Click the OK button.

If you have modified terminal parameters during a session, a message displays, asking if you want to save the setup (.PTS) file before closing.

To automatically reconnect a PowerTerm Pro session when you exit the current session, select the Auto ReConnect option in the Terminate Setup dialog box.

Optional Closing

For non-IBM emulations only - if you have not selected the Auto Exit PowerTerm Pro option in the Terminal Setup dialog box (as described above), and the communication session has been terminated, PowerTerm Pro displays the following message: "Session closed (<exit code>). Press Enter to restart session."

<exit code> may have one of the following values:

    • (zero). Communication ended successfully.
    • A number other than 0. Communication aborted. The exit code points to the error that caused the problem.

Press Enter to re-establish communication based on the current terminal and communication parameters.

User-Initiated Closing

You can close a session at any time by selecting Disconnect from the Communication menu.

User-Initiated Fast Exit

If you request a fast exit while communication is in progress (for example, by pressing <Alt> + <F4>), PowerTerm Pro reacts according to the parameters that you selected in the Preferences tab of the Terminal Setup dialog box.

If you have selected the Auto Exit PowerTerm Pro parameter, PowerTerm Pro closes the session and exits. If this parameter is not selected, a message is displayed enabling you to decide what to do next.

To access the Preferences tab, select Setup from the Terminal menu.

PowerTerm Pro enables you to run two or more sessions concurrently by opening a new instance of the PowerTerm Pro window. To open a new instance of the PowerTerm Pro window, select New Terminal window from the File menu. For more details, see new session

Step 9: Exiting PowerTerm Pro

    • To exit PowerTerm Pro:

From the File menu, select Exit (Alt+F4).

If you have changed the terminal settings, PowerTerm Pro displays a warning message asking if you want to update the terminal settings file (.PTS). The message will indicate the name of the setup file currently loaded (PTDEF.PTS, if you used the default). Click OK to update the file, or No to cancel the latest changes and restore the default setup (PTDEF.PTS) file.