7021510: Configuring VBA Events for Host Screen Text in Reflection for IBM

For more information on VBA programming, see the product documentation at http://support.microfocus.com/manuals.

The functionality of having an “action” run when a specific event occurs on a Host session screen has been added to Reflection Desktop 16.0 and later. See Reflection Desktop 16.0 New Features and Release Notes at https://support.microfocus.com/kb/doc.php?id=7021426#

An Events Mapper utility has been added for Reflection events in 3270, 5250, and UNIX/OpenVMS (VT) sessions. Using the Events Mapper, you can associate events with a Reflection action or command, Reflection macro, terminal keystroke, or any combination of these. There are 17 events you can select with which to associate actions. Each event can execute once per session, or every time the event occurs. Events can also be defined so that they execute one after another, in the order shown in the Events list in the Events Mapper dialog box. Legacy-Reflection events can now be migrated to new Reflection Desktop session files and then updated and modified. See https://www.attachmate.com/documentation/reflection-desktop-v16/rdesktop-guide/data/setup-actions-for-events-howto-cs.htm for more information on how to use Reflection event mapping.

Legacy KB ID

This document was originally published as Attachmate Technical Note 2339.

Related:

7023225: VBScript utility that will close all Reflection Desktop sessions

This document (7023225) is provided subject to the disclaimer at the end of this document.

Environment


Reflection Desktop (including Pro, for X, for IBM, or for UNIX and OpenVMS) 16.1 and later

Situation

It is easy to start Reflection using the command-line (or .bat file) to run Attachmate.Emulation.Frame.exe and supplying the name of a session document. But how to stop all sessions started like that might not be so apparent. This VBScript provides a quick automated method of closing all Reflection Workspace windows. It will close all separate Classic-UI Reflection windows, and all Reflection Workspace Ribbon-UI windows that may have multiple sessions running.

Resolution

  1. Create and save a new text file named CloseAll.vbs.
  2. Open CloseAll.vbs in Notepad, and copy the VBScript code below to it.
  3. Save, and close Notepad.
  4. To run, just double-click CloseAll.vbs, or you can run it from a .bat file.
””””””””””””””””””””””””’

‘ CloseAll.vbs



‘ VBScript to close all sessions in all Reflection

‘ Workspace windows. This works as long as the default

‘ “AutomationServerName” has not been changed from the

‘ default value of “Reflection Workspace”.



‘ Example code provided without warranty or support.

‘ Please review and understand it before running.

”””””””””””””””””””””””””

const CloseAlwaysSave = 3

dim reflection

on error resume next

do while true

set reflection = GetObject(“Reflection Workspace”)

if err = 0 then

reflection.Close CloseAlwaysSave

Wscript.Sleep 1000 ‘wait 1 second to give R a chance to close

else

err.clear

exit do

end if

loop

Disclaimer

This Support Knowledgebase provides a valuable tool for NetIQ/Novell/SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented “AS IS” WITHOUT WARRANTY OF ANY KIND.

Related:

7021698: DDE Support in Terminal Emulation Products

DDE is supported in Reflection version 14.x and earlier (Windows-based emulation for IBM, HP, UNIX, and OpenVMS). This functionality can be disabled by group policy (see Technical Note 1819).

DDE is not supported by Extra! X-treme; InfoConnect products; KEA!; Reflection for the Web; Reflection Desktop, 2014, 2011, 2008, or 2007 products; or Verastream products.

It is strongly recommended that you update your applications to use a newer API instead of DDE. For more information on programming with Attachmate products, see Technical Note 2183.

Related:

7022943: Attachmate.Emulation.Frame.EXE experiences crash on load when .NET machine.config file has malformed XML

The Attachmate.Emulation.Frame.EXE from Reflection Desktop 16 can experience a crash on load when the .NET machine.config file has malformed XML. The IBM ACCESS application for .NET can corrupt the .NET interface file named “machine.config” as noted in the following link.

http://www-01.ibm.com/support/docview.wss?uid=nas8N1012022

Then when the Attachmate.Emulation.Frame.EXE from Reflection Desktop 16 loads, the .NET framework will generate an exception code that is passed to the Reflection Desktop software and this exception causes the Reflection Workspace to crash with the following types of errors listed below:

First error that appears:

Faulting application name: Attachmate.Emulation.Frame.exe, version: 16.0.209.0, time stamp:0x561cc4a5

Faulting module name: KERNELBASE.dll, version: 6.1.7601.19110, time stamp: 0x56842600

Exception code: 0xe0434352

Fault offset: 0x0000c42d

Faulting process id: 0xeb4

Faulting application start time: 0x01d15ed2aa44d69a

Faulting application path: C:Program Files (x86)Micro FocusReflectionAttachmate.Emulation.Frame.exe

Faulting module path: C:Windowssyswow64KERNELBASE.dll

Second error:

Application: Attachmate.Emulation.Frame.exe

Framework Version: v4.0.30319

Description: The process was terminated due to an unhandled exception.

Exception Info: System.Xml.XmlException

at System.Xml.XmlTextReaderImpl.Throw(System.Exception)

at System.Xml.XmlTextReaderImpl.Throw(System.String, System.String[])

at System.Xml.XmlTextReaderImpl.ThrowTagMismatch(NodeData)

at System.Xml.XmlTextReaderImpl.ParseEndElement()

at System.Xml.XmlTextReaderImpl.ParseElementContent()

at System.Xml.XmlTextReaderImpl.Read()

at System.Xml.XmlTextReader.Read()

at System.Xml.XmlTextReaderImpl.Skip()

at System.Xml.XmlTextReader.Skip()

at System.Configuration.XmlUtil.StrictSkipToNextElement(System.Configuration.ExceptionAction)

at System.Configuration.BaseConfigurationRecord.ScanSectionsRecursive(System.Configuration.XmlUtil,System.String, Boolean, System.String, System.Configuration.OverrideModeSetting, Boolean)

at System.Configuration.BaseConfigurationRecord.ScanSections(System.Configuration.XmlUtil)

at System.Configuration.BaseConfigurationRecord.InitConfigFromFile()

Exception Info: System.Configuration.ConfigurationErrorsException

at System.Configuration.ConfigurationSchemaErrors.ThrowIfErrors(Boolean)

at System.Configuration.BaseConfigurationRecord.ThrowIfParseErrors(System.Configuration.ConfigurationSchemaErrors)

at System.Configuration.BaseConfigurationRecord.ThrowIfInitErrors()

at System.Configuration.ClientConfigurationSystem.EnsureInit(System.String)

Exception Info: System.Configuration.ConfigurationErrorsException

at System.Configuration.ConfigurationManager.PrepareConfigSystem()

at System.Configuration.ConfigurationManager.GetSection(System.String)

at System.Configuration.PrivilegedConfigurationManager.GetSection(System.String)

at System.Diagnostics.DiagnosticsConfiguration.Initialize()

at System.Diagnostics.DiagnosticsConfiguration.get_SwitchSettings()

at System.Diagnostics.Switch.InitializeConfigSettings()

at System.Diagnostics.Switch.InitializeWithStatus()

at System.Diagnostics.Switch.get_SwitchSetting()

at Attachmate.Utilities.ProfileTrace.WriteLine(System.Object, System.String)

at Attachmate.Emulation.Frame.FrameApplication..ctor()

at Attachmate.Emulation.Frame.Program.Main()

Related:

7021356: Which Products include HP Emulation?

The following table lists current Attachmate products that include support for HP terminal types, and the manner of installation. HP support is either part of an integrated product installation or a separate download and installation, depending on the entitled product.

Entitled Product
Installation Type
Reflection Desktop
Optional feature**
Reflection Desktop Pro
Optional feature**
InfoConnect Desktop Pro for Airlines 16.x
Optional feature**
InfoConnect Desktop Pro for Unisys 16.x
Optional feature**
InfoConnect Desktop Pro for Unisys with X 16.1
Optional feature**
Reflection 2014
Separate, see Technical Note 2706
Reflection Pro 2014
Separate, see Technical Note 2706
Reflection Professional Suite 2011
Separate, see http://docs.attachmate.com/reflection/2011/r2/product_overview_ps_r2.pdf
Reflection for the Multi-Host Professional Edition, version 14.x
Integrated
Reflection for HP with NS/VT, version 14.x
Integrated
Reflection for the Web 2014/2011/2008 (all editions except Limited or Standard)
Integrated
Verastream Host Integrator (or Verastream Standard Kit)
Integrated*

*Verastream Host Integrator provides support for SOAP/JSON Web Services and custom Web Builder forms-based HTML5 web applications to HP hosts (after modeling HP host application in Design Tool), but not support for “zero-footprint” HP terminal emulation (screen-based web applications).

**Beginning in version 16.0, the Reflection for HP application is an optional feature in the installer. In Setup, on the Feature Selection tab, open Reflection > Workspace > Emulation to enable the “HP with NS/VT” feature as shown below.

HP Graphics Not Supported

Graphical terminal types, such as HP 2397A, were supported in WRQ Reflection 7 for DOS (included in Reflection for DOS CD product) and WRQ Reflection 7+ for the Macintosh. HP graphical terminal support is not available in current products for Windows or other platforms.

Technical Resources

Refer to the following pages for links to downloads, technical notes, and other resources.

Product
Technical Resources
Reflection Desktop
http://support.attachmate.com/product/?prod=RD
Reflection Desktop Pro
http://support.attachmate.com/product/?prod=RDPRO
InfoConnect Desktop Pro for Airlines
http://support.attachmate.com/product/?prod=INFODPROAIR
InfoConnect Desktop Pro for Unisys
http://support.attachmate.com/product/?prod=INFODPROUN
InfoConnect Desktop Pro for Unisys with X
http://support.attachmate.com/product/?prod=INFODPROUNX
Reflection 2014
http://support.attachmate.com/product/?prod=RX2014
Reflection Pro 2014
http://support.attachmate.com/product/?prod=RPRO2014
Reflection Professional Suite 2011
http://support.attachmate.com/product/?prod=RPS11
Reflection for the Mulit-Host Professional Edition. version 14.x
http://support.attachmate.com/product/?prod=RMHEPRO
Reflection for HP with NS/VT, version 14.x
http://support.attachmate.com/product/?prod=RNSVT
Reflection for the Web
http://support.attachmate.com/product/?prod=RWEB
Verastream Host Integrator
http://support.attachmate.com/product/?prod=VHI

Related:

7021278: EXTRA! Developer Tools: API Code Samples and Manuals

This technical note is organized into the following sections:

API Reference Manuals

The following documentation is available for EXTRA! APIs.

API
Reference Information
OLE Automation (COM)
See the EXTRA! Macro Editor component help (EPC_OLE.HLP installed with product), or http://docs.attachmate.com/extra/x-treme/apis/com/
WinHLLAPI
WinHLLAPI Language Reference

http://docs.attachmate.com/extra/x-treme/apis/whllapi.pdf
EHLLAPI
EHLLAPI Language Reference

http://docs.attachmate.com/extra/x-treme/apis/ehllapi.pdf
Attachmate HLLAPI
HLLAPI Language Reference

http://docs.attachmate.com/extra/x-treme/apis/hllapi.pdf
EAL
Enterprise Access Library Language Reference

http://docs.attachmate.com/extra/x-treme/apis/eal.pdf
PCSHLL
PCSHLL Language Reference (IBM PCOMM 4.01 EHLLAPI)

http://docs.attachmate.com/extra/x-treme/apis/pcshll.pdf
WD_API
Wall Data (RUMBA) WD_API Language Reference

http://docs.attachmate.com/extra/x-treme/apis/wd_api.pdf

EXTRA! Basic Code Samples

A collection of over 20 EXTRA! Basic macros is available for download. These educational samples demonstrate:

– displaying Windows dialogs,

– checking the host 3270 OIA status line,

– transferring a file at a regular interval,

– calling Win32 API functions (e.g., modify Windows registry),

– copying host screen text to a Microsoft Excel spreadsheet,

– and more.

Download eb-samples.zip and see the enclosed _ReadMe.txt file for more information.

Test Tool Code Samples

The following additional test tool code samples are available for older APIs and IDEs.


VB 5.0 / 6.0
VC++ 5.0 / 6.0
WinHLLAPI
hllvb32w.exe
hlltes32.exe
EHLLAPI
hllvb32e.exe
hlltes32.exe
HLLAPI

hlldem32.exe
EAL
atmapi32.exe
ealtutor.exe
PCSHLL

pcshll32.exe

By default, EXTRA! X-treme is configured to use 32-bit Enhanced Transport for HLLAPI. You can confirm the HLLAPI Transport Type selection by clicking Options > Global Preferences > Advanced.

For information on tracing API calls for debugging purposes, see Technical Note 2249.

Related:

7022039: Attachmate Products and Virtualization Platforms

Attachmate Products Tested in a Virtual Environment

The following Attachmate products have been successfully installed and run on one or more virtualization platforms.

Attachmate Product
Version
Virtual Platform
EXTRA! X-treme

See Technical Note 2520
InfoConnect Desktop products

See Technical Note 2826
INFOConnect

See Technical Note 2662.
Reflection Desktop

See Technical Note 2809
Reflection 2014

See Technical Note 2698
Reflection X Advantage

See Technical Note 2632 or 2704
Reflection for IBM 2011

Reflection for UNIX and OpenVMS 2011

Reflection Standard Suite 2011


See Technical Note 2511
Reflection X 2011

Reflection Suite for X 2011


See Technical Note 2632
Reflection for HP

Reflection for IBM

Reflection for UNIX and OpenVMS

Reflection X


See Technical Note 2498
Reflection for the Web 2014
R1
VMware Workstation/Player
Reflection for the Web 2011
R1
VMware Workstation/Player
Reflection for the Web 2008
R3
VMware Workstation/Player
Reflection Security Gateway 2014
R1
VMware Workstation/Player
Reflection for Secure IT Client and Server for UNIX

See Technical Note 1944
Reflection for Secure IT Server for Windows

See Technical Note 1944
Reflection for Secure IT Client for Windows

See Technical Note 1944
Reflection for Secure IT Gateway

See Technical Note 1944
Reflection PKI Services Manager

See Technical Note 2427
Verastream Host Integrator

See Technical Note 10030
Verastream Process Designer

See Technical Note 10153

The versions listed above are expected to run on a virtualization desktop infrastructure (VDI). If you encounter a problem while running with one of these or later versions of Attachmate products on VDI, contact Attachmate Technical Support.

Support for Attachmate Products in Virtual Environments

Support for Attachmate products on virtualization platforms is limited to issues that are Attachmate product-related.

Attachmate provides technical support to maintained customers on Attachmate client desktop products that are being run on supported operating systems and meet the criteria in the Product Support Lifecycle.

Virtualization software, such as Citrix XenApp, VMware ThinApp, Novell ZENworks Application Virtualization, Symantec Solutions for Virtualization, and Microsoft App-V, operates as a hardware abstraction layer, and Attachmate client emulation software is expected to run seamlessly in these virtual environments. For product specific information, see your product’s technical specifications or supported platform information, available in product documentation or technical notes.

If an issue does occur in a virtualization environment, Attachmate Technical Support will work to isolate the cause of the problem and may ask you to duplicate the issue in a non-virtual environment. If we believe that the cause of the problem is in the hardware or operating system layer of the virtual environment and does not occur outside the virtual environment, we may direct you to your virtualization software vendor for technical support.For assistance with virtualization platform-related issues, contact the virtualization vendor:

If you prefer to work with Attachmate to help investigate virtualization software-related issues, you have the option to purchase consulting services. Our consulting provides specialized expertise and assistance to maintained customers when the technical issues are directly related to third-party software products or extend beyond the scope of supporting Attachmate products.

Accessing APIs

If an emulator is running in a virtual environment, APIs (like COM and HLLAPI) cannot be accessed by client applications that are running on the desktop outside of the virtual environment. Client applications like these that depend on components found in the directory where the emulator is installed will not work unless they are also installed on the server where the emulator software is located.

Related:

7021933: Attachmate Security Updates for US-CERT Vulnerability #845620: RSA Public Exponent 3

Vulnerability Details

There is a flaw in signature verification that affects RSA public keys and digital certificates created with a public exponent of 3. This flaw results from improper processing of the PKCS-1 padding before generating the hash. This allows a remote attacker to forge the PKCS#1 v1.5 signature signed by the RSA key and attempt a man-in-the-middle attack by masquerading as the valid server.

For details, see the CERT web site at http://www.kb.cert.org/vuls/id/845620.

Affected Attachmate Applications

The following Attachmate applications are vulnerable:

Secure Shell connections:

Reflection SFTP Client 6.0 – 6.1

Reflection for Secure IT 6.0 – 6.1

Reflection for HP 10.0 – 13.0.4, 14.0

Reflection for UNIX and OpenVMS 10.0 – 13.0.4, 14.0

Reflection for ReGIS Graphics 10.0 – 13.0.4, 14.0

Reflection X 10.0 – 13.0.4, 14.0

Reflection FTP Client 10.0 – 13.0.4, 14.0

SSL/TLS connections:

Reflection for HP 8.0 – 13.0.4, 14.0

Reflection for UNIX and OpenVMS 2008 R1

Reflection for UNIX and OpenVMS 8.0 or higher

Reflection for ReGIS Graphics HP 8.0 – 13.0.4, 14.0

Reflection for IBM 2008 R1

Reflection for IBM 2007

Reflection for IBM HP 8.0 – 13.0.4, 14.0

Reflection FTP Client HP 8.0 – 13.0.4, 14.0

EXTRA! X-treme 9.0 SP1 or higher

Solution

Product patches and service packs are available to correct this vulnerability in all affected applications. Maintained customers can obtain all necessary product updates from the Attachmate Download Library as directed below.

Reflection for Secure IT Windows Client

Maintained users of Reflection for Secure IT Windows Client version 6.0 and 6.1 should upgrade to Reflection for Secure IT Windows Client 6.1 Service Pack 1 (SP1) or higher.

Reflection for Secure IT Windows Server

Maintained users of Reflection for Secure IT Windows Server version 6.0 and 6.1 should upgrade to Reflection for Secure IT Windows Server 6.1 Service Pack 2 (SP2) or higher.

Reflection for Secure IT UNIX Client or UNIX Server

Maintained users of Reflection for Secure IT UNIX Client or UNIX Server version 6.0 and 6.1 should upgrade to Reflection for Secure IT UNIX Client or UNIX Server 6.1 Service Pack 2 (SP2) or higher.

Reflection 2008 and 2007 Products

Maintained users of the following Reflection 2008 products should apply the Reflection service pack appropriate for their product:

Reflection for IBM 2008 R1 SP1 or higher

Reflection for UNIX and OpenVMS 2008 R1 SP1 or higher

Reflection Standard Suite R1 SP1 or higher

Maintained users of Reflection for IBM 2007 should upgrade to Reflection for IBM 2008 R1 SP1 or higher.

Reflection 13.0 – 14.x Products

Maintained users of the following Reflection products (version 13.0 – 14.x) should apply the appropriate Reflection patch or service pack.

Reflection for HP

Reflection for UNIX and OpenVMS

Reflection for IBM

Reflection for Multi-Host Professional

Reflection for Multi-Host Standard

Reflection X

Reflection Suite for X

Maintained users of Reflection 14.0 should upgrade to Reflection 14.0 SP1 or higher. For information about Reflection 14.0 SP1 or higher (including file download details), see Technical Note 2127.

Maintained users of Reflection 13.0–13.0.4 should upgrade to Reflection 13.0.5 or higher.

For Reflection Windows-based products version 8.012.0.X, contact your sales representative for information about upgrading your product to correct this vulnerability. For information about contacting Attachmate, see http://www.attachmate.com/Worldwide/.

EXTRA! 9.0 SP1 – SP2

Maintained EXTRA! users should upgrade to EXTRA! 9.1 or higher.

Workaround

To workaround this security vulnerability, make sure that all RSA keys are generated with a public exponent greater than 3. The Reflection ssh-keygen utility has never generated RSA keys with public exponents of 3, so any keys generated by this utility are not subject to this vulnerability.

Important Security Note

The security for all of the Reflection and EXTRA! products using the Reflection and EXTRA! security features depends upon the security of the operating system, host, and network environment. Attachmate strongly recommends that you evaluate and implement all relevant security service packs, updates, and patches recommended by your operating system, host, and network manufacturers.

Related: