JBM electronics C102, C112 Reference Manual

JBM Electronics

Gateway C102/C112

Reference Guide

Gateway C102/C112 Reference Guide Page 2

Table of Contents

1. Items Included in Shipment………………………………………Page 2

2. Installing the Configuration Program……………………………Page 3

3. Information Required……………………………………………..Page 4

4. GWLNX Configuration Procedures…………………………….. Page 5

5. Establishing Console Access to the Unit………………………. Page 24

6. Common Linux Commands………………………………………Page 29

7. Using the NICCFG Script for IP Interface Configuration…….. Page 30

8. Using Zmodem to Transfer Files to the Unit………………….. Page 31

9. Starting the GWLNX Application……………………………….. Page 35

10. Configuring the Auto Start Feature…………………………….. Page 37

11. Troubleshooting, Testing and Statistics……………………….. Page 40

Items Included with Shipment

A. Gateway Unit B. 9 to 25 Pin DCE Adapter Cable (Ships only with the C100) C. Power Adapter D. Console Cable E. Rubber Feet F. Manual

Note: Use the picture below for comparison. If any items are missing, please contact JBM at 1-800-489-7781. (Because the Manual’s appearance can change, it has not been included in the product picture.)

Gateway C102/C112 Reference Guide Page 3

C102/C112 I/O Diagram

Installing the Configuration Program

The following steps provide information on how to install the Configuration Program onto your computer. The configuration program is used to create a configuration file.

1. The Configuration program is available on the JBM website

www.jbmelectronics.com. This program is a self-extracting file.

2. Using the root drive of a DOS compatible PC, execute the zip file that comes on this CDROM under the ‘Programs’ section. Contact JBM Electronics customer support to determine if there is an upgrade for the application.

Important Information: Unless otherwise instructed, use only the default path and filenames at the root directory of the PC that will be used to develope and load configurations onto the Gateway Unit. In order to retain the integrity of all JBM programs, and ensure the proper functioning of the Gateway Unit(s), default folders and filenames will automatically be extracted from the configuration program executable as JBMGATEW.

Gateway C102/C112 Reference Guide Page 4

Type SETUP at the \JBMGATEW prompt to initialize the self-extraction of the sub-directories and associated files.

3. Enter the default User ID and Password, gateway, to enter the configuration program. This default password must be entered in lowercase

4. You can find additional information and support on our website:

www.jbmelectronics.com

Gathering Information

Determine what protocols will be used in this config. Select the corresponding worksheet located on the software CD or at www.jbmelectronics.com. Use this worksheet as an information-gathering tool. Complete and accurate information on these sheets is essential to a successful installation.

For the IP interface(s) configuration you will need to have an IP address, default gateway, and subnet mask assigned by your network staff for the new unit.

Gateway C102/C112 Reference Guide Page 5

Using the Gwlnx Configuration Utility

The JBM Electronics Gateways are used to convert Legacy serial data to IP protocols. Because of the wide range of parameters that can be selected, JBM has prepared a walk through to illustrate how the Gateway can be configured. JBM supplies an offline configuration program that is used to build the configuration file. The file is then transferred to the Gateway where it is used to customize the unit to the specific environment.

The following information provides the proper steps and examples of how to build a configuration converting Bisync 3270 (Host) to TCP (Client) using the Configuration Utility.

Note: All setup worksheets should be filled out accordingly before configuring the Gateway!!

You must navigate through all RED FIELDS!!!

At the login screen the default user logon ID and password are “gateway” (please note that these fields are case sensitive). Press <Enter> after you have completed these fields. For security purposes the user ID and password can be changed in the ‘Define Remote Access Information’ section.

Gateway C102/C112 Reference Guide Page 6

You are now at the ‘Main Menu’ screen. Tab the cursor down and select ‘Unit Configuration’ by pressing <Enter>.

When the selection box appears, select ‘New’ by pressing <Enter> on the field. This will allow you to begin creating a new configuration to load into the Gateway.

Gateway C102/C112 Reference Guide Page 7

Assign a unique name to describe your configuration. Once you have entered a name press <Enter> to advance to the next screen.

At this screen select the unit model you will be configuring by tabbing the cursor to the appropriate field and pressing <Enter>. For example, if you are configuring a G1000, tab your cursor to ‘Gateway 1000’ and press <Enter>.

Gateway C102/C112 Reference Guide Page 8

At the ‘Unit Parameters’ screen, highlight the ‘Define Remote Access Information’ field and press <Enter>. This will allow you to customize the LAN properties of the Gateway.

Note: The Define Remote Access Information Field configures the LAN properties for the Gateway 50 through 80 units only. The Gateway 100 through 900 series and the Gateway 1000’s LAN information is configured at the Linux prompt by issuing the command niccfg eth0. Once the command has been issued, you will be prompted to enter the correct IP information. If you are using a G100-G1000 series unit, simply navigate into the Define Remote Access screen and then press F12 to return to the Unit Paramters screen leaving the fields on the Remote Access Information screen blank.

Gateway C102/C112 Reference Guide Page 9

Once returned to the ‘Unit Parameters’ screen, tab down to the ‘Define Port IDs’ field and press <Enter>. This allows you to customize the characteristics performed by the port controllers of the Gateway.

Assign an identity to each port that you will be configuring. Complete the name for the port and press <Enter> to continue to the ‘Port Parameters’ screen.

Gateway C102/C112 Reference Guide Page 10

Tab down to the ‘Protocol’ field and press <Enter> to choose the appropriate protocol for the port controller.

Choose from a list of protocols that are supported by the Gateway. Use the arrow keys to navigate to the appropriate protocol and press <Enter>. For this example, select the Bisync 3270 (Host) protocol by highlighting its name and pressing <Enter> on Bisync 3270 (Host).

The selected protocol determines how the Gateway port will behave. For example, when Bisync 3270 (Host) is selected, the Gateway port will poll attached Bisync 3270 protocol terminals.

Gateway C102/C112 Reference Guide Page 11

Complete the ‘Bisync 3270 (Host)’ Setup Worksheet that has been provided on this CD-ROM before modifying any parameters of the Gateway!

*REMINDER, you must navigate through all RED FIELDS.

The CU Address specifies the address used by the host to poll a specific device.

Gateway C102/C112 Reference Guide Page 12

The Device Address is assigned to a specific device that is to be polled by the host.

After modifying all the parameters to fit your environment, press <F12> to save your progress and return to the ‘Port Parameters’ screen.

Gateway C102/C112 Reference Guide Page 13

Tab down and highlight the ‘Define Hardware Information’ field and press <Enter>.

At this screen enter the appropriate hardware address and press <Enter>, this number reflects the labeled port number on the Gateway faceplate. After you have entered this information press <F12> to save your progress and return to the ‘List of Port IDs’ screen where you will choose the next Port ID and Protocol for the remote side of your configuration

Note: For ports labeled ttyS* you need to add “1” to the ttyS* numbers for COM port mapping.

Gateway C102/C112 Reference Guide Page 14

Assign a name for the remote port that will be routed to the previously configured port controller and press <Enter>.

Choose from a list of protocols that the Gateway will support by navigating down to the appropriate protocol and pressing <Enter>. For example, select TCP (Client) protocol by tabbing down and pressing <Enter> on TCP (Client).

Gateway C102/C112 Reference Guide Page 15

Tab the cursor down to ‘Edit Current Port Configuration’ and press <Enter>.

Complete the ‘TCP (Client)’ Setup Worksheet from our website before modifying any parameters of the Gateway!

*REMINDER, you must navigate through all RED FIELDS.

Gateway C102/C112 Reference Guide Page 16

After you have modified all the parameters to fit your environment, press <F12> to save your progress and return to the ‘Port Parameters’ screen.

Tab the cursor down to ‘Define Routing Table’ and press <Enter>. This option allows you to route data from one port to another.

Gateway C102/C112 Reference Guide Page 17

The ‘List of Port IDs’ screen will list the different Port IDs that you have assigned for the Gateway. In this example we will be routing the ‘Bisync 3270 (Host)’ port to the ‘TCP (Client)’ port. The ports must be routed “back to back.”. Start by highlighting a Port ID and pressing <Enter>.

Confirm the sub address that you will be routing by highlighting the selection and pressing <Enter>.

Note: A route is a data source not destination.

Gateway C102/C112 Reference Guide Page 18

Select the route for the specific Port ID. Highlight TCP (Client) and press <Enter>. This step is an example of the Bisync port receiving data from the TCP (Client) port.

This screen will verify the source that the Bisync 3270 (Host) port will be receiving data from. Verify the address and press <F12> to save your progress and return to the ‘List of Port IDs’ screen.

Gateway C102/C112 Reference Guide Page 19

Select the remote Port ID you are routing and repeat the same steps you just performed for the ‘Bisync 3270 (Host)’ Port ID.

Confirm the sub address by highlighting the selection and pressing <Enter>.

Gateway C102/C112 Reference Guide Page 20

Highlight the route for the specific Port ID and press <Enter>. Remember that you must route the IDs “back to back.” For example, route the ‘TCP (Client)’ port with the ‘Bisync 3270 (Host)’ port.

Verify the destination that the ‘TCP (Client)’ port will receive data from. If configuring numerous port IDs and sub addresses route them accordingly based on the steps provided above. After routing all sub-addresses within the configuration, press <F12> to save your progress and return to the ‘Configuration Menu’ screen.

Gateway C102/C112 Reference Guide Page 21

Save your configuration by highlighting the ‘File’ field and pressing <Enter>. Highlight ‘Save & Exit’ from the selection box and press <Enter>. Your configuration is now successfully saved. Once the configuration is saved you will be brought back to the ‘Main Menu’ screen.

Tab the cursor down and highlight the ‘Transfer Mode’ field and press <Enter>.

The transfer mode formats the configuration file so that it can be read by the Gateway.

Gateway C102/C112 Reference Guide Page 22

Highlight the ‘File’ field and press <Enter> from the selection box.

Note: If you are using an application prior to version 334, you need to select “old cfg” from the transfer mode menu.

A list of configurations that you created will then be displayed. Highlight the configuration file that you will be transferring and press <Enter>.

Gateway C102/C112 Reference Guide Page 23

A pathway will display where your configuration file will be transferred in the format that the Gateway unit can read. It should match the above filename. Confirm this information and press <Enter>. Verify by pressing ‘Y’ to confirm that the pathway is correct.

The configuration file has now been successfully transferred to the ‘jbmgw50’ directory on your PC. See “Transferring files to unit using Zmodem” on page 29 for loading the config file to the unit.

Gateway C102/C112 Reference Guide Page 24

Establishing Console Access to the Unit

Note: Before opening your terminal emulation program, please have the console cable plugged into the 9-pin port on the back of the unit labeled ttyS0 Console (DCE) and to an available COM port on your PC. Also make sure unit is plugged in and receiving power.

Step 1: From the Windows Desktop click Start > Run and type “hypertrm.exe”. This will start the Hyper Terminal application.

Step 2: Enter a name for the connection (Any alphanumeric combination is acceptable) and select an icon to represent the connection. Click OK.

Gateway C102/C112 Reference Guide Page 25

Step 3: Once you clicked OK, it will open a window called “Connect To”. Look for the setting called “Connect Using” and select COM1. Then click OK.

Step 4: Use the following parameters to configure the port settings. Click OK when you have input the settings.

 Bits per second: 9600  Data bits: 8  Parity: None  Stop bits: 1  Flow Control: Hardware

Note: Regardless of the Terminal Emulator program you use, these settings MUST be used.

Gateway C102/C112 Reference Guide Page 26

Step 5: Click on File> Properties> Settings Tab. Set emulation to VT100.

Step 6: Click on File > Save. This will store the connection settings under the name and icon previously selected (Step 2).

Gateway C102/C112 Reference Guide Page 27

Step 7: Press Enter and the Hyper Terminal session will connect to the Gateway (using the parameters previously saved), and a connection window will appear with the JBM Gateway Login Screen,

Log into the Gateway

Note: The JBM Gateway comes with two Linux accounts. The first is root,

which has full control, and the second is jbmgatew, which has partial control.

1. Log into the Gateway through the console-using root for the user name

and gateway for the password. Both entries are case sensitive and must be entered in lower case.

2. Change the default root user password.

a. Type passwd and press Enter. b. Select a new password by following the onscreen instructions.

3. Change the default jbmgatew user password.

a. Type passwd jbmgatew and press Enter. b. Select a new password by following the onscreen instructions.

Gateway C102/C112 Reference Guide Page 28

Common Linux Commands

UNIX DOS Function

Directory Functions

ls dir Displays the contents of the current directory.

cd cd Changes directories (moves from one directory to

another.

mkdir md Creates a new subdirectory under the current

directory.

rmdir rd Deletes (or removes) an existing directory.

File Functions

cat type Displays the contents of a file.

cp copy Copies a file (or a group of files).

mv ren Renames a file.

rm del Deletes a file (or group of files).

ln -s shortcut Forms a link to a file.

chmod - Sets file or directory permissions.

grep find Lists lines in a file that meet criteria.

find - Lists file names that meet criteria.

tail - Views the end of the file.

nano -edit edit Creates and edits text.

Other Functions

ps ax - View running processes.

Gateway C102/C112 Reference Guide Page 29

NICCFG Script Walkthrough

This script assists the user in configuring the Ethernet port of the Gateway 300 through 1000 series. Below are the instructions on using the niccfg stand-alone script.

1. Connect to the Gateway using a terminal emulation program such as HyperTerminal…The login screen appears.

2. Login to the Gateway as root user.

3. Type niccfg eth0 at any prompt. The IP configuration walkthrough begins.

4. Follow the onscreen prompts and supply the necessary info. (IP address, subnet mask, and default gateway.

5. Verify all IP information is correct and apply the changes to eth0. See screen shot below for example.

Gateway C102/C112 Reference Guide Page 30

Transferring Files to the Unit Using Zmodem

Once the console connection is established, the configuration file can be transferred using an error checking async file transfer program such as ZModem. The following are the instructions for using the Hyperterminal with the console connection to transfer the configuration program to the Gateway. The actual steps may vary slightly when other emulators are used.

Note: There are 4 steps in this process; where necessary these steps will have screenshots. For this example we will be using bsctest.cfg.

Gateway C102/C112 Reference Guide Page 31

1. Change to the jbmgatew directory by typing cd /home/jbmgatew.

2. Click "Transfer" on the top task bar of the Hyperterminal session and select "Send File."

Gateway C102/C112 Reference Guide Page 32

3. Browse to the file you wish to transfer. The protocol under the filename should be "Z Modem with Crash Recovery." Click "Send" to transfer the file.

4. At the jbmgatew prompt, type ll (LL in lowercase.) This will show you the contents of the jbmgatew directory. You should now see that file in the jbmgatew directory. If it is capitalized when you issue the ll command, type mv FILENAME filename. Type ll again to see if it is in lower case letters.

Gateway C102/C112 Reference Guide Page 33

Gateway C102/C112 Reference Guide Page 34

Starting the GWLNX Application

Once you have your configuration file transferred to the unit and have defined your IP interface parameters using the NICCFG script, you are ready to test the application.

1. Log into the gateway as root.

2. Change directories to /home/jbmgatew using the following command: cd /home/jbmgatew

3. Once in this directory use this command to start the application:

./gwlnx ***.cfg –d540 –l –t5000 &

Note: Since we will not know the name of the config file that you created, it is

represented by ***.cfg.

Gateway C102/C112 Reference Guide Page 35

4. Issue the ps ax command. This will return a list of the running processes on the unit. Look for your command line from step 3. If it is present you are ready to test. If that line is not present repeat steps 1,2 and 3.

Gateway C102/C112 Reference Guide Page 36

5. Physically connect the unit to the corresponding devices using the proper cables.

6. Attempt some test transactions.

Configuring JBMControl to Automatically

Start the GWLNX Application

Our units are pre-configured to use the jbmcontrol application to auto start gwlnx on boot, and to restart should the application stop running for any reason. To enable this feature, the jbm.conf file will need to be created.

1. Change directories on the unit to /home/jbmgatew

In that directory is a file named jbm.conf.sample. Copy this file to a new

2.

file called jbm.conf by using the following command: cp jbm.conf.sample jbm.conf.

Gateway C102/C112 Reference Guide Page 37

3.

Now use the vi editor to modify that file. Run the command vi jbm.conf The file contains some descriptive text at the top of the file and a single line below. All of these lines start with a # sign. Move the cursor under the # in front of the gwlnx line. Type dd this will remove that line of text. Then with the cursor in the same position, type o This will put the editor in insert mode on a new blank line. Now type the exact command line that you would use to manually start the application. Note: You do not need

the (&) character at the end of the command line in the jbm.conf file.

Gateway C102/C112 Reference Guide Page 38

4. When the line is complete and looks correct, hit the <esc> key. This will take the editor out of insert mode. Now type :wq and press the <enter>

Gateway C102/C112 Reference Guide Page 39

key. You will get a short message saying that the changes were written. To verify that the file format is correct, type cat jbm.conf If the file looks correct proceed to the next section. Note: if you make a mistake while

entering that line hit the <esc> key and type :q! This will quit the editor without saving the changes.

Testing the Auto Start Feature

The following procedure will verify that the jbm.conf modifications were successful and that the application will auto start.

1. Type sync;reboot. This will reboot the Gateway. A typical reboot takes about 30 seconds.

2. When the Gateway is finished rebooting, you will see the JBM Electronics login screen. Login in with "root" as the ID and "gateway" as the password.

3. Type ps ax. This will show you a list of running processes. You should see a line that includes the command you entered in the jbm.conf file.

4. If the ./gwlnx line is present in the list of running processes, type telnet localhost

5000. After logging into the telnet session, check the configuration name to be sure that configuration name is the same one you have given it in the setup program.

Gateway C102/C112 Reference Guide Page 40

Troubleshooting, Testing and Statistics

The following commands are available for statistics gathering and troubleshooting. Note: In order to use these commands you must first telnet into the application (gwlnx). From your Linux prompt, issue the following command to telnet into the application: telnet localhost 5000 You will be prompted to log in, any character will work for both the user and password fields.

Command Option Variable Function or Action Taken

Help Returns the list of available commands.

Ping IP Address

Reset

Logout

Logfile

Show

Task ID # Resets an individual task. The Task ID # is

Ena

Dis

Task Returns a list of current tasks and their ID

Stat Port

Memory Hex

Type

Addr xxxx

Indicates whether a device is active.

Terminates the Telnet session and resets the Gateway.

displayed through the Show Task command.

Terminates the Telnet session with the Gateway.

Enables the logging mechanism on the Gateway and starts logging transactions.

Stops logging and disables the logging mechanism on the Gateway.

numbers.

Returns the current status of the requested port. The Port types are: RS232, X25, Frame, Appl, Multi, TCP, UDP.

Allows memory dump of any area in the Gateway. The default length is 16 bytes. (xxxx - Optional Length in bytes)

Gate IP Returns the Gateways default router IP

App Version Returns the current Gateway Application

Conf Load

Dump

Up Starts a Port. And Subaddress Set Port # Subaddress #

Down

address.

version number.

Returns a memory dump of the configuration load.

Gateway C102/C112 Reference Guide Page 41

Viewing Show Stat’s

BiSync Contention to TCP Example

RS232

TCP

Gateway C102/C112 Reference Guide Page 42

SNA to TCP Example

RS232

TCP

Gateway C102/C112 Reference Guide Page 43

TC500 Example

RS232

Note: This configuration does not have TCP.

Modifying your Config File

Gateway C102/C112 Reference Guide Page 44

At the login screen the default user logon ID and password are “gateway” (please note that these fields are case sensitive). Press <Enter> after you have completed these fields. For security purposes the user ID and password can be changed in the ‘Define Remote Access Information’ section.

You are now at the ‘Main Menu’ screen. Tab the cursor down and select ‘Unit Configuration’ by pressing <Enter>.

Select Edit and press <Enter>. This will take you to the next screen and allow you to select the file to edit.

Gateway C102/C112 Reference Guide Page 45

Select the file that you want to edit and press <Enter>.

Select the Parameter that you want to edit and press <Enter>.

Gateway C102/C112 Reference Guide Page 46

Select the port ID that need to be changed. Press <Enter> once to change the name of the ID. Press <Enter> twice to enter that port and make parameter changes.

Select the Port Parameter that needs to be changed and press <Enter>.

Gateway C102/C112 Reference Guide Page 47

Select the Configuration Parameter that needs to be changed and press <Enter> to bring up the parameter options.

The options you can select will appear in a small gray box. Highlight the needed parameter and press <Enter> to lock it in.

Gateway C102/C112 Reference Guide Page 48

Once you have made all of the needed changes, press the <F12> key till you reach this screen.

Press <Enter> and select “Save As” in the gray options box, press the <Enter> key to select it.

Gateway C102/C112 Reference Guide Page 49

You will now have the option to change the Description of the configuration file. Press enter after you have made your changes.

After you have saved your changes, it will reopen the options in the “File” menu. Select “Save & Exit” to return to the main screen.

Gateway C102/C112 Reference Guide Page 50

At the main menu, select “Transfer Mode”. This will bring up a small gray box with your transfer options. Select “File” and press<Enter>.

You will now see a large gray box with a list of at least one configuration description. Select the one that you made the changes to and just saved and press <Enter>.

Gateway C102/C112 Reference Guide Page 51

Here you will be able to change the Directory and Filename. Change the name of the .cfg file to one that will make it easy for you to recognize. Just be sure to remember that the file is limited to the DOS naming standard, 8.3. (Example:

12345678.cfg) Press <Enter> after you have named the file.

At this point you have completed the process of changing and saving your configuration file. Exit the program and go to PAGE 29 of this manual for instructions on transferring the new file to your Gateway unit.

JBM electronics C102, C112 Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual