README.md in te3270-0.8.1 vs README.md in te3270-0.9.0

- old
+ new

@@ -1,13 +1,15 @@ # TE3270 -This gem can be used to drive a 3270 terminal emulator. You have to have a supported emulator installed on the -machines on which you use the gem. Currently the supported emulators are +This gem can be used to drive a 3270 terminal emulator. You have to have a supported emulator installed on the +machines on which you use the gem. Currently the supported emulators are [EXTRA! X-treme](http://www.attachmate.com/Products/Terminal+Emulation/Extra/xtreme/extra-x-treme.htm) by -Attachmate, [Quick3270](http://www.dn-computing.com/Quick3270.htm) by DN-Computing, [Virtel Web Access](http://www.virtelweb.com/solutions/3270-terminal-emulation.html), +Attachmate, [Quick3270](http://www.dn-computing.com/Quick3270.htm) by DN-Computing, +[Rocket BlueZone](https://www.rocketsoftware.com/products/rocket-bluezonepassport-terminal-emulator/rocket-bluezone-terminal-emulation), +[Virtel Web Access](http://www.virtelweb.com/solutions/3270-terminal-emulation.html), and [X3270](http://x3270.bgp.nu/). -The first three are commercial products and need to be purchased. +The first four are commercial products and need to be purchased. X3270 is open source. Support for other emulators will be added as time permits. ## Documentation @@ -27,11 +29,11 @@ $ gem install te3270 ## Usage -You can create classes that are similar to page-object classes. In these classes you can define +You can create classes that are similar to page-object classes. In these classes you can define the various fields that you wish to interact with on the screen. class MainframeScreen include TE3270 @@ -88,19 +90,32 @@ on(MainframeScreen) do |screen| screen.userid = 'the_id' screen.password = 'the_password' end -There is also a way to pass in a `Hash` and have it populate an entire screen. Just simply +There is also a way to pass in a `Hash` and have it populate an entire screen. Just simply ensure the key for an entry in the `Hash` matches the name you gave a text field and it will -find and set the value. This allows the gem to easily work with the DataMagic gem. +find and set the value. This allows the gem to easily work with the DataMagic gem. # given this Hash my_data = { userid: 'the_id', password: 'the_password' } # you can simply call this method on(MainframeScreen).populate_screen_with my_data +## Troubleshooting + +If you plan to use the BlueZone emulator support, make sure the version of BlueZone +that you install matches the architecture of the Ruby version you are using. + +_ex: x86 for both or 64 bit for both_ + +Also, if you intend to take screenshots with BlueZone, Extra, or Quick emulators +you will need to use the x86 version of Ruby as the 64 bit version of +[win32screenshot](https://rubygems.org/gems/win32screenshot/) depends on +[rautomation](https://rubygems.org/gems/rautomation/) which +[does not support 64 bit installs](https://github.com/jarmo/RAutomation/issues/68) +at this time. ## Contributing 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`)