The ActiveX printer page

The ActiveX Printer page (AXP400.HTM or AXP3270.HTM) is the page that hosts the ActiveX Printer session. It contains information that allows Internet Explorer to launch the corresponding ActiveX control installed on the client PC. This control provides the Connection information stored in the Printer Control Properties.

<OBJECT ID= "AXPRINTER" CLASSID= "CLSID:A4941F89-4EAB-11D1-B5B4-0000C0FA639E" CODEBASE= "Http://DomainName/ActiveXVirtualPath/HFPRT.CAB#Version=1,650,0,1" 
TYPE="application/x-oleobject">
<PARAM NAME="Secure" VALUE="FALSE">
<PARAM NAME="AutoConnect" VALUE="TRUE">
<PARAM NAME="AutoSave" VALUE="TRUE">
<PARAM NAME="Persistent" VALUE="FALSE">
<PARAM NAME="ServerHTTP" VALUE="192.168.1.113">
<PARAM NAME="ServerTCPIP" VALUE="192.168.1.113">
<PARAM NAME="PortHTTP" VALUE="80">
<PARAM NAME="PortTCPIP" VALUE="0">
<PARAM NAME="CGIPath" VALUE="HFCGI_5250"> (or HFCGI_3270)
<PARAM NAME="CGIName" VALUE="HFCGI.DLL">
<PARAM NAME="RSASecurID" VALUE="FALSE">

<PARAM NAME="SessionLoadBalancing" VALUE="TRUE"> 
<PARAM NAME="DisableAutoSignonChange" VALUE="TRUE">
<PARAM NAME="AutoSignon" VALUE="TRUE">
<PARAM NAME="ASUserName" VALUE="GUEST">
<PARAM NAME="ASUserPassword" VALUE="PASSWORD">
<PARAM NAME="NTAutoSignon" VALUE="TRUE">
<PARAM NAME="AutoSignonLastAccount" VALUE="TRUE">
<PARAM NAME="ClusterCGIName" VALUE="HFCLUSTER.DLL">
<PARAM NAME="ClusterCGIPath" VALUE="HFCLUSTER">
<PARAM NAME="UseCluster"  VALUE="TRUE">
<PARAM NAME="Emulation"  VALUE="HFM">
<PARAM NAME="ServerVersion"  VALUE="400">
<PARAM NAME="iChain"  VALUE="TRUE">

</OBJECT>

The most important parameters of the ActiveX Object definition are:

•

CODEBASE

•

TYPE

Note

The OBJECT definition section from this page (the part highlighted in bold) has been moved to another page called AXPnnnn.HTM.JS in the same folder in order to avoid having the problem of having to click the mouse or press the space bar to start working with the ActiveX control (due to changes done by Microsoft on the Internet Explorer.) This changes does not affect the functionality of the ActiveX control at all. The only effect is that if you had to change the version number of the ActiveX in case of a manual upgrade of the CAB file, that number needs to be changed in the JS file rather than in the HTML file.

You can define the rest through the browser sizing for Width and Height. The PARAM NAME settings contain data that Internet Explorer transmits to the ActiveX control to fill in the Connection tab of the Printer Control Properties dialog box.

ActiveX parameter

Description

DomainName

This is either the Registered Domain Name or the TCP/IP Host Name of the PC that contains the server.

ActiveXVirtualPath

This is the virtual path name, as configured in your Web Server software, for the ActiveX controls folder. The Setup program defines the virtual path in the AXPnnnn.HTM file.

Secure

This is the parameter that specifies if you are using a Secure Socket Layer (SSL) Connection.

Auto Connect

This parameter specifies whether you have selected the Auto Sign on feature on your ActiveX Client

Auto Save

This parameter displays whether you have chosen to have the Auto save feature on (true) or off (false)

Persistent

This parameter shows TRUE if you are using a persistent connection

ServerHTTP

This is the IP address or Host Name of the cluster entry point. This can be the address of one server machine running the Cluster Service or the virtual IP of a BlueZone Access Server Cluster or HostFront Server Cluster. This address will be used for HTTP (non-persistent) connections

ServerTCP/IP

PortHTTP

This is the TCP/IP port used by the Web browser to access the HTML page. The default port for a Web Server is 80.

PortTCPIP

This is the TCP/IP port used by the Web browser to access the HTML page, and will display the server Port when using a persistent connection.

CGIPath

This is the name of the virtual path, as configured in your Web Server software, of the CGI folder. The Setup program defines the virtual path in the AXPnnnn.HTM file.

CGIName

This is the name of the CGI application or ISAPI Dynamic Link Library (DLL) that server services use to interface with the Web browser.

•

For Microsoft Internet Information Server (IIS), it is possible to use the ISAPI interface (HFCGI.DLL) to enhance performance.

•

For other Web Servers, you must use the CGI interface (HFCGI.EXE).

ClusterCGIName

This is the name of the CGI application or ISAPI Dynamic Link Library (DLL) the Cluster Service uses to interface with the Web browser.

•

For Microsoft Internet Information Server (IIS), it is possible to use the ISAPI interface (HFCLUSTER.DLL) to enhance performance.

•

For other Web Servers, you must use the CGI interface (HFCLUSTER.EXE).

ClusterCGIPath

This is the name of the virtual path, as configured in your Web Server software, of the cluster CGI folder. The Setup program defines the virtual path in the AXP400.HTM/AXP3270.HTM file. This is the path of the virtual folder of the cluster service that the printer ActiveX will use.

UseCluster

This parameter notifies the ActiveX display client to use the Cluster Service. If it does not exist or is set to False, the ActiveX client will use the connection mechanism of the older version

ServerVersion

This value informs the printer ActiveX about the version of the server so it connects using the applicable method (used for backwards compatibility)

Emulation

As one cluster service serves three emulation types, this value helps maintaining proper reference between the clients and the server.

DisableAutoSignonChange

This parameter disables the Auto Signon Section in the Session Properties practically preventing the user from changing these parameters. Use this feature when you want to force the end user to use a certain signon name and password configured in the HFPRT.CFG file that can be pushed to the user along with the MSI package.

The next three parameters should be used together as a group

AutoSignon

This parameters enables the Auto Signon feature in the ActiveX control so that the user name and password provided in the ASUserName and ASUserPassword parameters are used to sign on automatically.

ASUserName

This parameter provides the user name used by the Auto Signon process that was enabled by the AutoSignon parameter.

ASUserPassword

This parameter provides the password used by the Auto Signon process that was enabled by the AutoSignon parameter.

NTAutoSignon

This parameter enables the Windows Domain Auto Signon feature in the ActiveX control so that it always tries to signon automatically using the Domain credentials on the user's machine.

AutoSignonLastAccount

This parameter enables ActiveX to automatically sign on using the user name and password that was last used to sign on. This parameter is independent from the AutoSignon parameter.

SABPassPrint

This parameter forces direct printing and ignores LF/CR. It is useful when the printer expects a raw text input from the host (such as boarding passes for airlines).

iChain

This parameter is used to force the ActiveX to sign on using iChain authentication method.