Appendix A

Defining a Connection in PowerTerm WebConnect Administration Tool

For each host you need to create at least one separate connection.

 

To create a host connection:

1.       Choose Action|New.

2.       Choose Connection. TheAdd Connectiondialog box appears.

3.       Type in your Connection Name.

Connection Name: Specifies the name given to a new connection that you defined.

†Note Names are not case sensitive however must be unique.

4.       Type in your Display Name (optional).

Display Name: Specifies the non-unique name given to the server that appears in the userís menu.

5.       Clear the Enabled check boxif you want the connection temporarily disconnected.

6.       Define the appropriate Usage Type.

 

Value†††††††††† Meaning†

Hidden

Can only be activated from a login script.

Child

Owned by another connection and triggered by it.

Regular

Normal connection.

 

7.       Select the Owner.

8.       Select the Terminal Type.

9.       Select the Terminal Model.

10.   Supply the information for your emulation and protocol type parameters, according to the following table:

VT52, VT100, VT220-7, VT220-8, VT320-7, VT320-8, VT420-8, VT420-8, VT525-7, VT525-8, DG, SCO-ANSI, AT386, AIXTERM,
WYSE50, WYSE60, TVI925, TVI950, BBS-ANSI, SIEMENS

TELNET

Host Name, Terminal Name, Port Number, Keep Alive Timeout, Set Window Size, Network Name, SSL enabled, Type, Show Certificate

 

LAT

 

NWLAT

Service Name, Password, Network Name

NSVT

Host Name, Service, Network Name

CTERM

Node Name, Network Name

RLOGIN

Host Name, Port Number, Keep Alive Timeout, Set Window Size, Network Name

3270

TN3270

Host Name, LU Name, Port Number, Keep Alive Timeout, User TN3270E Protocol, Network Name, SSL enabled, Type, Show Certificate

 

MS SNA Server

Use Available LU, LU Name, Network Name

NWSAA (IPX)

NWSAA (TCPIP)

Server Name, Backup, User Name, Service Name, LU Category, LU Name, Network Name

5250

TN5250

 

Host Name, Device Name, Port Number, Keep Alive Timeout, Message Queue, Message Library, Network Name, SSL enabled, Type, Show Certificate

 

APPC

System Name, Device Name, Message Queue, Message Library, Network Name

MS SNA Server

System Name, Device Name, User Name, Password, Message Queue, Message Library, Network Name

TANDEM 6530

 

TELNET

Host Name, Service, Port Number, Keep Alive Timeout, Set Window Size, Network Name, SSL enabled, Type, Show Certificate

Note Double-click on the protocol to receive explanation on its parameters.

 

11.     Click OK. The new host connection is created.

 

Settings can be accessed by clicking on the Settings button. For more information see Property Pages and their Options in the online documentation for the PowerTerm WebConnect Administration Tool.

Keyboard Mappings can be accessed by clicking on the Key Mapping button. For more information see Keyboard Mapping in the online documentation for the PowerTerm WebConnect Administration Tool.

Login Script (to be run after communication is established) can be edited by clicking on the Login Script button.

†For information on debugging connections see Testing a Specific Connection below.

 


TELNET Parameters

Host Name: Specifies the host computer name or the hostís IP address.

Terminal Name: Specifies the terminal name.

Port Number: Specifies the TELNET port number (default 23).

Keep Alive Timeout: Periodically sends a NOP (non operation) command to the host when any number greater than zero is entered in this field.

For example: you want to send a "keep alive" every 10 minutes- enter 600 (seconds) in this field.

Set Window Size: tells PowerTerm to report the window size (if asked by the host) in the telnet negotiation procedure.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

SSL enabled: Determines whether to implement the SSL protocol.

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

Type: Specify which SSL protocol to use in the host connection.

Show Certificate: Displays the Security dialog in which the user can designate which protocol to implement for his host connection.

 

RLOGIN Parameters

Host Name: Specifies the host computer name or the hostís IP address.

Port Number: Specifies the TELNET port number (default 23).

Keep Alive Timeout: Periodically sends a NOP (non operation) command to the host when any number greater than zero is entered in this field.

For example: you want to send a "keep alive" every 10 minutes- enter 600 (seconds) in this field.

Set Window Size: Instructs PowerTerm to report the window size (if requested by the host).

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

LAT AND NWLAT Parameters

Service Name: Specifies the name of the service.

Password: Supplies the password you use on the remote host system.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).


CTERM Parameters

Node Name: Specifies the host computer name or the hostís IP address through which the data is transferred.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

TN3270 Parameters

Host Name: Specifies the host computer name or the hostís IP address.

LU Name: Specifies LU name.

Port Number: Specifies the TELNET port number (default 23).

Keep Alive Timeout: Periodically sends a NOP (non operation) command to the host when any number greater than zero is entered in this field.

For example: you want to send a "keep alive" every 10 minutes- enter 600 (seconds) in this field.

Use TN3270E Protocol: Determines whether to implement the TN3270E protocol.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

SSL enabled: Determines whether to implement the SSL protocol.

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

Type: Determines which security protocol protects the connection.

Show Certificate: Shows the SSL certificate and allows you to accept or reject it.

 

MS SNA Server Parameters for 3270

Use Available LU: Indicates that the LU is available to the host.

LU Name:Specifies LU name.

Network Name:Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

NWSAAParameters

Server Name: Specifies the server name. You can specify an asterisk as the server name, and PowerTerm will connect to the appropriate NetWare for SAA server.

Backup: Specifies the backup server name.

User Name: Specifies the user name that will be relayed on to the host when attempting to logon.

Service Name: Specifies the name of the service.

LU Category: Specifies the name of the LU Category.

LU Name: Specifies LU name.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

TN5250 Parameters

Host Name: Specifies the host computer name or the hostís IP address.

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 is Test, the first session would be Test1, the next session Test2, and so on. For more information see Dynamic Device Names for 5250 Emulationsin the online documentation for the PowerTerm WebConnect Administration Tool.

Port Number: Specifies the TELNET port number (default 23).

Keep Alive Timeout: Periodically sends a NOP (non operation) command to the host when any number greater than zero is entered in this field.

For example: you want to send a "keep alive every 10 minutes- enter 600 (seconds) in this field.

Message Queue: Designates to which AS/400 message queue exception messages should be sent.

An example: the AS/400 may need to tell the printer to switch to another paper tray.

Note This field is only visible for Printer emulations.

Message Library: Specifies which library contains the message queue for exception messages.

Note This field is only visible for Printer emulations.

SSL enabled: Determines whether to implement the SSL protocol.

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

Type: Determines which security protocol protects the connection.

Show Certificate: Shows the SSL certificate and allows you to accept or reject it.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

Auto SignOn: PowerTerm tells the transport protocol to automatically log you on to the host once a connection is established.

 

APPC Parameters

System Name: Specifies the name of the system.

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 is Test, the first session would be Test1, the next session Test2, and so on. For more information see Dynamic Device Names for 5250 Emulations in the online documentation for the PowerTerm WebConnect Administration Tool.

Message Queue: Designates to which AS/400 message queue exception messages should be sent.

An example: the AS/400 may need to tell the printer to switch to another paper tray.

Note This field is only visible for Printer emulations.

Message Library: Specifies which library contains the message queue for exception messages.

Note This field is only visible for Printer emulations.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

Auto SignOn: PowerTerm tells the transport protocol to automatically log you on to the host once a connection is established.

 

MS SNA Server Parameters for 5250

System Name: Specifies the name of the system.

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 is Test, the first session would be Test1, the next session Test2, and so on. For more information see Dynamic Device Names for 5250 Emulationsin the online documentation for the PowerTerm WebConnect Administration Tool.

User Name: Specifies the user name that will be relayed on to the host when attempting to log on.

Password: Specifies the password that will be relayed on to the host when attempting to log on.

Message Queue: Designates to which AS/400 message queue exception messages should be sent.

An example: the AS/400 may need to tell the printer to switch to another paper tray.

Note This field is only visible for Printer emulations.

Message Library: Specifies which library contains the message queue for exception messages.

Note This field is only visible for Printer emulations.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

Auto SignOn: PowerTerm tells the transport protocol to automatically log you on to the host once a connection is established.

TELNET Parameters for TANDEM

Host Name: Specifies the host computer name or the hostís IP address

Service Name : Specifies the name of the service.

Port Number: Specifies the TELNET port number (default 23).

Keep Alive Timeout: Periodically sends a NOP (non operation) command to the host when any number greater than zero is entered in this field.

Set Window Size:

SSL enabled: Determines whether to implement the SSL protocol.

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

Type: Determines which security protocol protect the connection.

Show Certificate: Shows the SSL certificate and allows you to accept or reject it.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

NSVT Parameters

Host Name: Specifies the host computer name or the hostís IP address

Service Name : Specifies the name of the service.

Network Name: Specifies generic name of the network over which communication to host is being transmitted.

Note Useful only for "Fat Client (see also Server As Gateway).

 

 

 


Server As Gateway for Fat Client

The ActiveX client, in comparison to the Java client, is sometimes dependent on

the PowerTerm WebConnect Server in order to connect to a host. In such a case

when the ActiveX client cannot "see the host" (since the client and the host are

located on two distinctly separate networks), then the PowerTerm WebConnect

Server can act as a gateway. In order to acquire this capability you must specify

the network name of the predefined connectionís target (the IP address).

The PowerTerm WebConnect Server can be accessed by a client from several

different connection points, as specified in the serverís INI file. Each connection

point represents a logical or physical network, i.e. Intranet and Internet. The

NetworkName attribute of each connection point specifies the name the system

administrator assigns to the logical or physical network. The server keeps track

about each clientís accessed connection point. This information can be examined

in the Via column of the Active Sessionís list view.

 

 

Creating a User

1.        Choose Action|New.

2.        Choose User. TheAdd Userdialog box appears.

3.        Type in your User Name and provide an Internal ID if desired.

 

4.        Type in your Password.

 

5.        Retype your password in the Confirm Password text box.

 

6.        Select a particular group (s) from the Available Groups list.

Click on the arrow button .

Or

Select all the groups by clicking on the double arrow button . The desired group (s) appear in the Userís Group list.

††††††† NoteStandard Windows convention of multiple selections from a list applies here: Hold down Ctrl and select non-consecutive choices; Hold down Shift and select the first and last in a group thus encompassing the whole group.

7.       Select the connections to include in this group from the Unlinked Connections list.

Note The Unlinked Connections list consist of all those connections that have not yet been configured to a group.

Highlight the desired connection and click on the arrow button .

Or

Select all the connections by clicking on the double arrow button . The desired connection (s) appear in the User Connections list.

Note Standard Windows convention of multiple selections from a list applies here: Hold down Ctrl and select non-consecutive choices; Hold down Shift and select the first and last in a group thus encompassing the whole group.

8.       Activate this user by checking the Enabled check box.

9.       Stipulate (if relevant) if this user:

         has the status of Free User

         has been granted permission to log on simultaneously from different machines by selecting Allow Concurrent Machines

         has limited access from particular machines by specifying them in the Allow Access From text box

10.   Stipulate the maximal number of concurrent connections that this user may have.

NoteThe value Ď0í instructs the program to use the default value in the MaxUserQuotaQuotas field located in the [Server] section of the QuotasPtServer.ini file. Other values will override the default value.

11.   Select the appropriate rights to grant to the user.

12.   Click OK. A new user was created with its own unique access parameters.

 

User Name: Specifies the name of user you are defining.

Note Names are not case sensitive however must be unique.

The user named GUESThas a special meaning.

A client logging as GUEST has limited privileges and cannot:

         modify password

         send messages

         open a new terminal window

         use trace etc.

Internal ID: Optional, useful to create a dynamic device name for 5250 Printer emulations.

For information on device names, see Connections.

Password: Specifies the password for the user you are defining.

Confirm Password: Confirmsthe password for the user you are defining.

Max. Concurrent Sessions: Stipulates maximum number of concurrent sessions that this user will be allowed to have at any particular time.

Rights: Selects whose rights will be accorded to the user being created. Options: Client, Monitor and Administrator.

Enabled: Activates this user according to its configured communication parameters.

Free User: Enables user to be able to connect dynamically to any host that he stipulates the address for.

Allow Concurrent Machines: Permits the user to be logged in on multiple computers at the same time.

Access Limit Mode: Specifiesthe rule in which the user is allowed to access the PowerTerm WebConnect server.


Testing Specific Connection

 

To test a connection:

1.       Select the desired connection that you want to test from the bottom section of the Administration Toolís main screen.

2.       Right-click Test. The connection is established.

 

Assigning a command to a JAVA/PC Key

To assign a command to a JAVA/PC key:

1.       Select the desired connection.

2.       Right-click on Properties option. The Connection Properties dialog appears.

3.       Click Key Mapping. The Keyboard Mapping dialog box is displayed.

4.       Right-click on a key on the Java keyboard that you want to assign a text string.

5.       Click Enter Script Commands. The Function Button dialog box is displayed.

6.      Enter the text and click OK. The command has now been assigned to the JAVA/PC key.