PASSPORT Object API

PASSPORT Object Interface and Object Toolkit

View as a PDF

The PASSPORT Object Interface of PASSPORT PC to Host and PASSPORT Web to Host is recommended for new client-based host integration projects that require the use of Microsoft Windows. The PASSPORT Object API lets you use 3270, 5250 or UNIX host screen information as a fast, non-intrusive, inexpensive method of interfacing with host applications. The PASSPORT Object Toolkit is a resource that can assist with development efforts.

Zephyr will offer development and technical assistance, as well as the PASSPORT Object Toolkit, to customers who license at least 500 units of PASSPORT via an annual subscription license. For pricing, visit http://www.zephyrcorp.com/pricing.htm.

The PASSPORT Object API can also be used to support existing PC applications written for the Attachmate EXTRA!® Objects®. In doing so, the Zephyr PASSPORT terminal emulation can be used as a low-cost replacement for the Attachmate EXTRA! terminal emulation.

The PASSPORT Object Interface is an ActiveX COM object called PASSOBJ.DLL. There is a hierarchy of objects used for host access which includes Sessions, Session, Screen, OIA, Area, Toolbars, Toolbar, QuickPads and QuickPad. The COM object can be used with any programming language that can use ActiveX COM objects, including C++, Visual Basic, VB Script and Java Script. The PASSPORT Object Toolkit provides a sample VB Script application and source code.

When migrating an existing Attachmate EXTRA!® Objects® application to Zephyr's PASSPORT, the only change necessary is to change the name of the object used in the CreateObject () method. An Attachmate EXTRA!® application uses CreateObject ("EXTRA.SYSTEM"). For PASSPORT you would use CreateObject ("PASSPORT.SYSTEM"). The Area object can be used to select parts of the host screen, and the copy and paste methods can be used to copy data from one host session to another. The PASSPORT Object Interface does not have any event driven functions.

When to Use: The PASSPORT Object Interface is recommended when you need to integrate 3270, 5250 or UNIX host applications with other Microsoft Windows applications, when you need to run existing Attachmate OLE automation applications with the Zephyr PASSPORT terminal emulation, or when you need to convert and run complex Attachmate EXTRA!® macros for use with the Zephyr PASSPORT terminal emulation.

PASSPORT Object Toolkit

A sample web application is provided in the PASSPORT Object Toolkit. This web application contains hyperlinks on a web page. Each hyperlink corresponds to an object method or property that executes a VB Script demonstrating its use. This sample application can be used as a starting point for your own web application.

The PASSPORT Object Interface includes a system manager object, a collection of sessions, a session object, screen object, area object and OIA object. Also included are keypad and toolbar objects for complete compatibility with the Attachmate EXTRA!® OLE automation support interface. Complete documentation for the object interface is included with the PASSPORT Object Toolkit.

Object Hierarchy

Migrating Your Attachmate EXTRA!® Application to PASSPORT

Since the PASSPORT object interface is compatible with the Attachmate EXTRA!® OLE automation support interface, your Attachmate application can be easily re-linked and used with Zephyr's PASSPORT instead of Attachmate EXTRA!. There is only one change that needs to be made to your application. The parameter for the CreateObject statement must be changed from "EXTRA.System" to "PASSPORT.System". This statement is usually the first statement that references the object interface.

An example for Attachmate EXTRA!® :

SET oSystem = CreateObject ("EXTRA.System")

An example for PASSPORT:

SET oSystem = CreateObject ("PASSPORT.System")

All other object, method and property names are exactly the same. It's that easy!

Download a Copy Now

Download a fully functional trial copy of PASSPORT PC TO HOST® Terminal Emulation. The evaluation copy can be downloaded and running in minutes, and offers fully functional TN3270, TN5250, VT100, VT220, VT420, SCO ANSI and Wyse 60 emulation with a built-in expiration date. Once your evaluation is complete, you can convert the trial copy of the software into a production version with a simple license code.

Trademarks

Attachmate® and EXTRA!® are trademarks or registered trademarks of Attachmate® Corporation. Zephyr is in no way affiliated with Attachmate®. Zephyr, PASSPORT PC TO HOST, PASSPORT WEB TO HOST and PASSPORT Host Integration Objects are trademarks of Zephyr. PASSPORT PC TO HOST® and PASSPORT WEB TO HOST® are registered trademarks of Zephyr. All other trademarks, trade names, or company names referenced herein are used for identification only and are the property of their respective owners.