Overriding HATS Application Connection Properties in the URL

Technote (troubleshooting)


Problem(Abstract)

You can enable users of your HATS application to override some connection settings when they connect to your HATS application.

Resolving the problem

You can enable users of your HATS application to override some connection settings when they connect to your HATS application. This enables you, the application developer, to build a generic application, and leave it to individual users to customize some settings to work for them. For example, a user can override the LUName for a 3270E connection or the workstationID for a 5250 connection.

The connection between the HATS application and the host machine is managed by IBM® Host On-Demand. Use overrides only if you are familiar with the Host On-Demand settings involved. Be sure to test any overrides that you plan to suggest to your users. Overriding connection settings improperly will cause your HATS application to malfunction or be inoperable.

To enable your users to override connection settings, adjust the Connection Parameter Overrides security settings in the Other tab of the Project Settings editor.

After you have configured your HATS application to accept overrides, your users can override connection settings by adding them to the URL that they use to access your HATS application. The format is:

http://<myServer>:<myPort>/<myApp>/index.jsp?host=9.42.141.26&sessionType=1&port=523&LUName=LU00001&TNEnhanced=true 

After the server name, port, and HATS application name, you must specify the target name, index.jsp, followed by a question mark (?) and then the name=value pairs for the settings, separated by ampersands (&). The values are the text values defined by Host On-Demand, not the values that are used elsewhere in the application.hap file. For example, sessionType=1 for 3270, and sessionType=2 for 5250.

The workstationID setting accepts 10 characters including A-Z, 0-9, .(period), _(underscore), @(commercial), #(hash), and $(dollar sign), but you must escape # and $ with %23 and %24, respectively. So workstationID=abc#$3 must be coded as workstationID=abc%23%243.

You can override any values you want, if the override function is enabled. Not all of these properties are useful for your HATS connection. For example, VTLocalEcho cannot be used for HATS because HATS does not support VT transformation connections at this time. HATS does not validate the values, but passes them on to Host On-Demand as they are specified. Any values you do not override default to the settings configured in the HATS project. If the HATS developer did not specify a value for a setting, the list below shows the default values that will be used. If you turn on tracing (trace.RUNTIME=7), HATS displays the settings used for the connection.

Your users cannot override the following settings. They will always have these values:

autoConnect=false
autoReconnect=false
History=false


Here are the connection display settings you can specify on the URL, and the default value for each setting that is not specified on the URL or in the HATS project settings:

AllocateSpaceForLamAlef=LAMALEFOFF,
BIDIMode=BIDIMODEON,
CICSGWCodePage=000,
CICSInitialTrans=CECI,
CICSInitialTrans=CECI,
CICSInitialTransEnabled=true,
CICSServerName=,
CursorMovementState=true,
ENPTUI=false,
EntryAssist_DOCmode=false,
EntryAssist_DOCwordWrap=true,
EntryAssist_bell=false,
EntryAssist_bellCol=75,
EntryAssist_endCol=80,
EntryAssist_startCol=1,
EntryAssist_tabstop=8,
EntryAssist_tabstops=,
HTMLDDS=false,
HistorySize=64,
InsertOffOnAIDKEY=false,
LPAS400Name=,
LUMLicensing=HOD,
LUMPort=80,
LUMServer=,
LUName=,
LUNameBackup1=,
LUNameBackup2=,
NVTLocalEcho=false,
NumericSwap=false,
RTLUnicodeOverride=RTLUNICODEOFF,
SESSION_PROXY_AUTHEN_BASIC=SESSION_PROXY_AUTHEN_BASIC,
SESSION_PROXY_AUTHEN_CLEAR_TEXT=SESSION_PROXY_AUTHEN_CLEAR_TEXT,
SESSION_PROXY_AUTHEN_NONE=SESSION_PROXY_AUTHEN_NONE,
SESSION_PROXY_BROWSER_DEFAULT=SESSION_PROXY_BROWSER_DEFAULT,
SESSION_PROXY_HTTP=SESSION_PROXY_HTTP,
SESSION_PROXY_SOCKS_V4=SESSION_PROXY_SOCKS_V4,
SESSION_PROXY_SOCKS_V5=SESSION_PROXY_SOCKS_V5,
SESSION_PROXY_SOCKS_V5_THEN_V4=SESSION_PROXY_SOCKS_V5_THEN_V4,
SLPAS400Name=,
SLPEnabled=false,
SLPMaxWaitTime=200,
SLPScope=,
SLPThisScopeOnly=false,
SSHPublicKeyAlias=mykey,
SSHPublicKeyAliasPassword=,
SSL=false,
SSLBrowserKeyringAdded=false,
SSLCRYPTOLABEL=,
SSLCRYPTOMODULE=,
SSLCRYPTOPWD=,
SSLCertificateHash=,
SSLCertificateName=,
SSLCertificatePassword=,
SSLCertificatePromptBeforeConnect=false,
SSLCertificatePromptHowOften=SESSION_SSL_CERTIFICATE_PROMPT_FIRST_CONNECT,
SSLCertificateProvided=false,
SSLCertificateSource=SESSION_SSL_CERTIFICATE_IN_URL,
SSLCertificateURL=,
SSLServerAuthentication=false,
SSLTelnetNegotiated=false,
SecurityProtocol=SESSION_PROTOCOL_TLS,
SymmetricSwap=false,
TNEnhanced=true,
ThaiDisplayMode=5,
VTAnswerBackMsg=,
VTAutowrap=false,
VTBackspace=false,
VTCursor=false,
VTID=VT420,
VTKeypad=false,
VTLocalEcho=false,
VTNewLine=true,
VTReverseScreen=false,
VTTerminalType=1,
VTasciiConvert=false,
WFEnabled=false,
bind7FArchitectureViolation=false,
codePage=037,
connectionTimeout=0,
copyAltSignLocation=false,
copyOnlyIfTrimmed=false,
cursorDirection=CURSOR_LEFTTORIGHT,
enableStartupResponseRecord=true,
graphicsCellSize=0,
host=,
hostBackup1=,
hostBackup2=,
hostGraphics=false,
hostPrintTransform=true,
ignoreAttr=false,
keepAlive=false,
keyStoreFilePath=,
keyStorePassword=,
lastHostWithoutTimeout=true,
negotiateCResolution=true,
netName=,
numeralShape=NOMINAL,
numeralShapeDisp=CONTEXTUAL_DISP,
numericFieldLock=false,
numericSwapEnabled=true,
panelOnlyTCPIPInactivityTimeout=0,
pasteFieldWrap=false,
pasteLineWrap=false,
pasteStopAtProtectedLine=false,
pasteTabColumns=4,
pasteTabOptions=2,
pasteTabSpaces=1,
pasteToTrimmedArea=false,
pasteWordBreak=true,
port=23,
portBackup1=23,
portBackup2=23,
proxyAuthenMethod=SESSION_PROXY_AUTHEN_NONE,
proxyServerName=,
proxyServerPort=1080,
proxyType=SESSION_PROXY_BROWSER_DEFAULT,
proxyUserID=,
proxyUserPassword=,
roundTrip=ON,
screenSize=2,
serviceMgrHost=,
sessionID=,
sessionName=,
sessionType=1,
showTextAttributesEnabled=true,
skipTRNData=false,
smartOrdering=SMART_ORDERING_OFF,
socksV4UserID=,
sslJSSETrustStore=,
sslJSSETrustStorePassword=,
sslJSSETrustStoreType=,
sslUseJSSE=false,
ssoBypassSignonPassword=,
ssoBypassSignonUserid=,
ssoCMServer=,
ssoEnabled=false,
ssoType=ssoTypeNone,
ssoUseKerberosPassticket=false,
ssoUserIdentityType=ssoNetworkID
symmetricSwapEnabled=true,
textOrientation=LEFTTORIGHT,
textType=VISUAL,
textTypeDisp=LOGICAL_DISP,
timeout=0,
timeoutNoDataAtInitialization=false,
trimRectRemainAfterEdit=false,
trimRectSizingHandles=true,
unicodeDataStreamEnabled=false,
useAccentedCharacters=false,
useDBCSInUnicodeField=false,
useSSHPublicKeyAuthentication=false,
userID=,
userPassword=,
viewJobInBrowser=false,
workstationID=,

Beginning with HATS Version 6.0.3 and Version 7.0, you can override 3270E print connection parameters, if the override function is enabled and printing is enabled.

Here are the print settings you can specify on the URL, and the default value for each setting that is not specified on the URL or in the HATS project settings:

FFTakesPrintPos=true,
PDTFile=,
RTLFile=false,
SCSSense=true,
bestFit=false,
drawFieldAttr=0,
faceName=Courier New,
formFeedPosition=true,
hostPrintTransform=
ignoreAttr=
ignoreFFFirstPos=false,
inheritParms=false,
intervTime=10,
linesPerInch=6
maxCharsPerLine=80,
maxLinesPerPage=60,

pdfFont=Courier,
pdfPaperOrientation=0,
pdfPaperSize=51,
printBufferSize=1920,
printDestination=true,
printFileName=,
printMimeType=application/pdf,
printNullsAsSpaces=true,
printSaveAsExtension=.pdf,
printerFontCodePage=0,
printerManufacturer=IBM,
printerModel=*IBM42011,
printerName=LPT1,
separateFiles=false,

skipTRNData=
suppressAutoNewlineCR=false,
suppressAutoNewlineNL=false,

suppressNullLines=false,
termTime=0,
tractor=false,
useAdobePDF=false,
useWindowsDefaultPrinter=true,
useWindowsPrinter=true,

viewJobInBrowser=
windowsPrinterName=
 
For information describing these parameters, including the valid values, please refer to the Host On-Demand Version 9 Information Center.

Cross Reference information
Segment Product Component Platform Version Edition
Software Development Rational Host Access Transformation Services 7.1

Historical Number

DLF 1180279

Rate this page:

(0 users)Average rating

Document information


More support for:

WebSphere Host Access Transformation Services

Software version:

6.0, 7.0

Operating system(s):

AIX, HP-UX, Linux, Linux iSeries, Linux pSeries, Linux zSeries, Solaris, Windows, i5/OS, z/OS

Reference #:

1251884

Modified date:

2008-03-19

Translate my page

Machine Translation

Content navigation