action.skip

A-B-C

allowStoredMacroPassword

This parameter determines if a user can store passwords or other hidden variables. If set to true, the user can change the macro variable from Always prompt User for Value to Embed fixed user response in macro on the Save Macro dialog box after recording a macro. You must configure this parameter for each individual session you create.

Note

This parameter only affects the behavior of the Save Macro dialog box. If you have existing macros with passwords or hidden variables embedded in them, their behavior will not change.

This parameter does not apply to single sign-on macros or express logon macros for IBM 3270 sessions.

Value

true (Default)

false

Example

<param name="allowStoredMacroPassword" value="true">

answerback

See declans parameter.

archive

This optional attribute specifies the JAR (Java Archive) file containing the applet code. The archive attribute is supported by browsers using the Java Plug-in.

When applet code is packaged into a JAR file for running in the Java Plug-in, the archive attribute is used to specify the name and location of the archive. Although the archive attribute is optional in the applet tag, all Reflection for the Web applet code is packaged into JAR files, and to run Reflection using the Java Plug-in, the archive attribute is required.

Value

Launcher.jar

Example

<applet mayscript name="IBM3270"
        code="com.wrq.rweb.Launcher.class" 
        width="400" height="300"
        archive="Launcher.jar">
</applet>

Autoconnect

This parameter specifies whether the Reflection session should connect to the host specified in the host URL parameter when the session starts. If you choose not to connect automatically, you can connect to a specified host using the Reflection menu (if it is available).

Note

The recommended method for configuring most settings is to use the dialog box equivalents where available. In these cases, parameters should be restricted to scripted sessions. The equivalent setting for the autoconnect parameter is Connect at startup.

Value

true (Default)

false

Example

<param name="autoconnect" value="true">

BackgroundColor

This parameter determines the color of the background on the login and links list interface. The default background color is white.

Value

You can specify a color in one of three ways:

  • Hexadecimal - <param name="backgroundColor" value="#CCCCCC">

  • RGB (red, green, blue) - <param name="backgroundColor" value="204,204,204">

  • One of 13 named colors: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, and yellow - <param name="backgroundColor" value="lightGray">

Example

In the following applet tag, the background of the login form and links list interfaces is set to pale yellow.

Copy 

 <applet name="Launcher" code="com/wrq/rweb/Launcher.class" archive="Launcher.jar" codebase="./ex" width="500" height="440">
<param name="backgroundColor" value="#FFFFCC">
</applet>

certAndCRLSignedBySamePrivateKey

This parameter, If set to true, instructs the certificate verification code to verify that the certificate and the CRLs (Certificate Revocation Lists) are signed by the same CA (Certificate Authority) private key. The default is false.

Certificate Authorities may use one private key to digitally sign certificates and CRLs, but CAs can also use separate private keys to digitally sign certificates and CRLs. This applies to SSL/TLS sessions only, and requires that the CRL be already present.

Value

true

false (Default)

Example

<param name="certAndCRLSignedBySamePrivateKey" value="true">

certExplicitPolicyIndicator

This parameter, when set to true, instructs the certificate verification code to verify that the first CA certificate in a certificate chain has the Certificate Explicit Policy Indicator extension set. This parameter allows you to require an explicit policy identifier for certificate path processing. This applies to SSL/TLS sessions only.

Value

true

false (Default)

Example

<param name="certExplicitPolicyIndicator" value="true">

certPolicyOIDs

This parameter specifies the initial certificate policies. It instructs the certificate verification code to verify that a certificate chain meets the policy requirement. Specify the initial policy OIDs (Object Identifiers), separated by commas. The default is empty. This applies to SSL/TLS sessions only.

Value

Any string; may be empty (Default).

Example

<param name="certPolicyOIDs" value="2.16.840.1.101.2.1.48.1,2.16.840.1.101.3.1.48.3">

Code

This required attribute specifies the name of the class file used to start the applet. The value is relative to the URL specified in the codebase attribute, or if no codebase attribute is present, to the URL of the document containing the applet. This value is case sensitive.

Value

com.wrq.rweb.Launcher.class

The code attribute must be used in conjunction with the Launcher.sessions parameter.

Example

<applet mayscript name="IBM3270" 
        code="com.wrq.rweb.Launcher.class" 
        width="400" height="300">
</applet>

Codebase

This attribute specifies the URL for the folder that contains the terminal emulation applet JAR files. The URL can be relative to the location of the HTML page or it can specify the entire path.

Value

./ex/ (Default)

<Any valid URL>

Example

Codebase specifies entire path:

<applet mayscript name="Reflection" 
        codebase="http://ReflectionWeb.example.com/connections/" 
        code="com.wrq.rweb.Launcher.class" 
        width="400" height="300">
</applet>

Codebase is relative to the location of the HTML page:

<applet mayscript name="Reflection" 
        codebase="java/" 
        code="com.wrq.rweb.Launcher.class"
        width="400" height="300">
</applet>

Configuration

This parameter specifies the URL or name of a configuration file (usually with a .config extension) created by a system administrator. For more information, go to the Overview of Configuring Reflection.

The value of the configuration parameter is treated initially as an absolute URL that points directly to the file. If the file cannot be opened, Reflection appends the value to the URL of the current document base (the location of the web page that is running the applet). If using the document base does not locate the file, then the value is appended to the codebase for the page, named in the Codebase attribute of the applet. (If no codebase is specified, the codebase is the same as the document base.)

Value

<any valid URL>

Example

<param name="configuration" value="salesdept.config">

crlIssuers

This parameter specifies the URLs of the CRLs (Certificate Revocation Lists) that are used by certificate path processing for checking the certificate revocation status of a certificate chain. The default is empty. This applies to SSL/TLS sessions only. LDAP, file, and HTTP URLs are supported.

Value

Any series of URLs separated by semicolons; may be empty (Default).

Example

<param name="crlIssuers" value="ldap://myCAServer.example.com/CA/certificaterevocationlist; ldap://rootCA.verisign.com/CRL">
<param name="crlIssuers" value="file://localhost/c:/crls/TrustAnchorCRL.crl">
<param name="crlIssuers" value="http://server1.example.com/CertEnroll/server1.example.com.crl">