Programming with Reflection

image\rwnprg32.gif SetupSession method

 

Syntax object.SetupSession SessionType, TerminalModel, TransportType

 

Description

Defines the necessary settings for establishing a session. These settings must be supplied with this method, rather than independently, with properties, because they are interdependent. The following command sets up a 3270 terminal session emulating an extended Model 2 terminal using a Telnet transport:

Session.SetupSession rc3270Terminal, rc3270MODEL2E, rcTelnet

This method fails if you run it when Reflection is connected to a host or if the arguments you use aren't compatible with each other. Use the Connected property to determine if a connection already exists.

This methods returns error 4083, if you try to execute it when a connection exists, and error 4133, if the arguments (settings) you use aren't compatible with each other.

Note: The easiest way to ensure that you have a valid SetupSession statement is to use the macro recorder and configure a connection using Reflection's Setup Session dialog box.

Arguments

SessionType Argument type: Enumeration
The type of device to emulate. The possible values are:

 rc5250Terminal

 Configures Reflection to emulate a 5250 terminal.

 rc5250Printer

 Configures Reflection to emulate a 3812 printer.

 rc3270Terminal

 Configures Reflection to emulate a 3270 terminal.

 rc3270Printer

 Configures Reflection to emulate a 3287 printer.

 Note: Not all values are available with all Reflection products. To determine which session types your product supports, see the list in the Type box in Reflection's Session Setup dialog box.

TerminalModel Argument type: Enumeration
The terminal or printer to emulate. The possible values vary according to the value of both the SessionType and TransportType arguments. The following information lists all the possible values for each session type. To ensure that you are choosing a model that is available for the session type and transport you are using, use Reflection's Session Setup dialog box and record your actions.

 When SessionType is rc5250Terminal, the possible TerminalModel values are:

 rc31792
rc31802
rc3196A1
rc3196A2
rc3196B1
rc3196B2
rc3197C1
rc3197C2
rc3197D1
rc3197D2
rc3197W1
rc3197W2
rc3476EA
rc3476EC
rc3477FA
rc3477FC
rc3477FD
rc3477FE
rc3477FG
rc3477FW
rc3486BA
rc3487HA
rc3487HC
rc3487HG
rc3487HW
rc525111
rc52911
rc52912
rc52921
rc5555C01

 When SessionType is rc5250Printer, possible TerminalModel values are:

 rc3812Printer
rc3912Printer
rc5553Printer

 When SessionType is rc3270Terminal, the possible TerminalModel values are:

 rc3270MODEL2
rc3270MODEL2E
rc3270MODEL3
rc3270MODEL3E
rc3270MODEL4
rc3270MODEL4E
rc3270MODEL5
rc3270MODEL5E
rc3270ModelCustomE

 Note: rc3270ModelCustomE is not availabe when TransportType is rcCOAXDFT.

 rcAnyModel

 Note: rcAnyModel cannot be used when TransportType is rcTelnet or rcTelnetExtended. These transports require a specific Terminal Type before connection can be established.

 When SessionType is rc3270Printer, possible TerminalModel values are:

 rc3287Printer
rc3287OCSPrinter

TransportType Argument type: Enumeration
The transport to use. The possible values are:

 rcCOAXDFT

 Specifies that Reflection is using Coax DFT (SNA) as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 rcCommServer

 Specifies that Reflection is using IBM Comm Server as its transport. This value can be used with any session type.

 rcDLC8022

 Specifies that Reflection is using 802.2 DLC (SNA) as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 rcDemo

 Specifies that Reflection is using demonstration mode, where features normally available only with a host connection (for example, IND$FILE file transfer) can be examined. This value can be used when the SessionType is rc5250Terminal or rc3270Terminal.

 rcEiconGateway

 This value is no longer used.

 rcMPTN

 Specifies that Reflection is using MPTN as its transport. This value can be used when the SessionType is rc5250Terminal or rc5250Printer.

 rcMSSNAServer

 Specifies that Reflection is using Microsoft SNA Server as its transport. This value can be used with any session type.

 rcNetWareSAA

 Specifies that Reflection is using NetWare SAA as its transport. This value can be used with any session type.

 rcNetWareSAALUA

 Specifies that Reflection is using NetWare SAA (LUA)as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 rcNetWareSAANDS

 Specifies that Reflection is using NetWare SAA (NDS) as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 rcSDLC

 Specifies that Reflection is using SDLC as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 rcTelnet

 Specifies that Reflection is using Telnet as its transport. This value can be used with any session type.

 rcTelnetExtended

 Specifies that Reflection is using an extended form of Telnet as its transport. This value can be used when the SessionType is rc3270Terminal or rc3270Printer.

 

Note: If you use a value for TerminalModel that is not supported for the transport type you are using, you may receive an invalid third argument error. This is because the third argument is invalid given the second argument you have specified. You can fix the problem by changing the second argument.

 

image\jump.gif Example

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command