5.0 Host-initiated RCL Support

5.1 RCL Commands

Reflection Command Language (RCL) is a scripting language used in older versions of Reflection to implement host-initiated commands that allow host programs to control Reflection. Reflection for the Web has implemented a subset of RCL commands to facilitate interaction with existing Reflection for HP installations.

The information presented here is intended to augment existing RCL documentation.

5.1.1 Supported RCL $ Variables

Reflection for the Web supports $ expansion of RCL commands received from the host. In addition to ${0-9}, the following $ variables are supported:

Variable

Result

$DATE

Returns the current date (MM-DD-YYYY)

$DAY

Returns 0 (Sunday) through 6 (Saturday) indicating the day of the week.

$DIR

Returns the path to the USER_HOME folder for the client machine running the HP session.1

$SERIAL

Returns the Reflection for the Web serial number.

Example: J01-VVVL456789 (where VVV is the version number).

$TIME

Returns the current time (HH:MM:SS.CC).

$UPI

Returns the Reflection unique product identifier.

1USER_HOME varies according to operating system, browser, and VM. To find the home folder for a given operating system/browser/virtual machine combination, look for USER_HOME in the Java console.

5.1.2 Supported RCL Commands

Reflection for the Web supports the CLOSE PRINTER, OPEN PRINTER, LET, LOG, SET, and TRANSFER commands.

NOTE:Reflection for the Web ignores the QUIET and CONTINUE commands (returns a success completion code, but does nothing). Any other unrecognized RCL command will result in a failure completion code (unless completion codes are disabled or are not requested by the host).

CLOSE

The CLOSE PRINTER command closes the printer as a "to" device. CLOSE PRINTER has no effect if the printer is already closed.

OPEN

Reflection for the Web supports the OPEN PRINTER command.

LET

LET assigns a string, number, or logical value to a variable. By default, variables V0 through V9 are available and each variable can contain a 0 to 80 byte string. Strings longer than 80 bytes will be truncated.

Use the SET VARIABLES command to change the number of variables supported. Use the SET VARIABLE-LENGTH command to change the allowable variable length.

LOG

The LOG command sends, or logs, incoming data to the printer. Use LOG without any options to turn logging on; use LOG OFF to turn logging off.

SET

SET commands are used to configure Reflection. See Supported SET Parameters.

TRANSFER

The TRANSFER command does a type 3 block transfer to the host. Either a string or the value of a SET command can be transferred.

5.1.3 Supported RCL SET Parameters

Use the alphabetical index on this page to locate SET parameters supported by Reflection for the Web. Common synonyms for parameters are shown in parenthesis.

A-B-C | D-E-F | G-H-I | J-K-L | M-N-O | P-Q-R | S-T-U | V-W-X

A-B-C

  • AUTO-KEYBOARD-LOCK
  • AUTO-LINE-FEED
  • AUTO-PRINT (LOG-BOTTOM)
  • BELL-ENABLED
  • BLOCK-MODE
  • BLOCK-TERMINATOR
  • BREAK-ENABLED
  • CAPS-LOCK
  • CHECK-PARITY
  • CONFIG-LOCKED
  • CURSOR-STYLE
  • CURSOR-VISIBLE

Supported RCL SET Parameters

D-E-F

  • DESTRUCTIVE-BACKSPACE
  • DISABLE-COMP-CODES
  • DISABLE-MESSAGES
  • DISPLAY-COLUMNS (SCREEN-COLUMNS)
  • DISPLAY-CONTROL-CHARACTERS
  • DISPLAY-MEMORY-RESPONSE (PRIMARY-STATUS-RESPONSE)
  • DISPLAY-ROWS
  • DO-FORM-FEED
  • ENQ-ACK
  • FORMAT-MODE
  • FORMS-BUFFER-SIZE

Supported RCL SET Parameters

G-H-I

  • HOST-PROMPT
  • INHIBIT-DC2
  • INHIBIT-EOL-WRAP
  • INHIBIT-HANDSHAKE
  • INSERT-CHARACTER

Supported RCL SET Parameters

J-K-L

  • JUMP-SCROLL-SPEED
  • KEYBOARD-LOCK
  • KEYBOARD-TYPE (NATIONAL-REPLACEMENT-SET)
  • LEFT-MARGIN
  • LIMITED-IM
  • MEDIATES
  • LINE-PAGE
  • LITERAL-ESCAPE
  • LOCAL-ECHO
  • LOG-BOTTOM (AUTO-PRINT)
  • LOG-TOP

Supported RCL SET Parameters

M-N-O

  • MARGIN-BELL
  • MEMORY-LOCK
  • MODIFY-ALL
  • MODIFY-LINE
  • NATIONAL-REPLACEMENT-SET (KEYBOARD-TYPE)

Supported RCL SET Parameters

P-Q-R

  • PARITY
  • PASTE-DELAY
  • PRIMARY-STATUS-RESPONSE (DISPLAY-MEMORY-RESPONSE)
  • RETURN-DEFINITION
  • RETURN-ENTER
  • RIGHT-MARGIN

Supported RCL SET Parameters

S-T-U

  • SEND-CURSOR-POSITION
  • SCREEN-COLUMN
  • S (DISPLAY-COLUMNS)
  • SMOOTH-SCROLL
  • SPOW
  • START-COLUMN
  • TAB-SPACES
  • TELNET-BREAK
  • TELNET-LF-AFTER-CR
  • TELNET-NEGOTIATION
  • TELNET-TERMINAL
  • TERMINAL-ID
  • TERMINAL-TYPE
  • TRANSMIT
  • TRANSMIT-FUNCTIONS
  • TYPE-AHEAD

Supported RCL SET Parameters

V-W-X

  • VARIABLES
  • VARIABLE-LENGTH
  • XFER-NULLS-TO-DEVICES

Supported RCL SET Parameters