Contents
Contents for 3270 Applet Help

  Welcome to Microsoft SNA Server 3270 Applet

Step-by-Step Procedures

  Defining Session Settings

  Connecting to the Host Application

  Defining File Transfer Settings

  Specifying a File

  Sending or Receiving a File

  Using Macros

  Printing the Screen

  Copying and Pasting Displayed Information

  Saving a Configuration

Reference

  3270 Applet Standard Keyboard Map

  ASCII Character Set

  ANSI Character Set

  IBM Extended Character Set

  OIA Indicators


Welcome to Microsoft SNA Server 3270 Applet

The Microsoft SNA Server 3270 Applet allows your personal computer (PC) to access IBM hosts on the Systems Network Architecture (SNA) network. With the SNA Server 3270 Applet, you can establish a single logical unit (LU) for your SNA session. You can connect to the following host application environments:

Virtual Machine/Conversational Monitor System (VM/CMS)

Time Sharing Options (TSO)

Customer Information Control System (CICS)

Once connected to a host application, you can transfer information between the host system and your computer without using an intermediate storage medium. This gives you the ability to:

Transfer a file back and forth between your computer and the host. You can then continue working with the file even if the host is unavailable or slow.

Edit a file and return it to the host where it can be shared by other users.

Print the information in the active window of a host application file.

Extract information from the host for further analysis on your computer.

See Also

Defining Session Settings

Connecting to the Host Application


logical unit (LU)

A preset unit containing all the configuration information needed for a user or a program to establish a single interactive user session with another computer on the SNA network.


Defining Session Settings

Before you can connect to a host, you must define the settings you will need for your session. These settings include the LU or Pool Name and the Host Code Page.

To define session settings

1	From the Session menu, choose Session Configuration.

The 3270 Settings dialog box appears.

2	In the LU or Pool Name box, select the correct LU or pool name.

3	In the Host Code Page box, select the correct host code page.

The default is United States.

4	Choose OK.

See Also

Connecting to the Host Application


LUs or LU Pools
LU or Pool Name

LUs and LU pools are collections of configuration information that make it possible for your computer to connect to the host.


Host Code Page

The host code page specifies the EBCDIC code page translation tables used by the host. The default is United States.


Connecting to the Host Application

After defining session settings, you can use the 3270 Applet to connect to the host. Also, after defining session settings, you can automatically connect to the host every time you start the 3270 Applet.

To connect to the host application

From the Session menu, choose Connect.

A logon dialog box appears, ready for you to enter your user ID and password.

To disconnect from the host application

From the Session menu, choose Disconnect.

The host disconnects.

To turn on the Autoconnect option

From the Session menu, choose Autoconnect.

A checkmark indicates that Autoconnect is selected. When Autoconnect is selected and you start the applet, it automatically connects.

To turn off the Autoconnect option

From the Session menu, choose Autoconnect.

Autoconnect is no longer selected (no checkmark appears beside it).


Defining File Transfer Settings

Using the 3270 Applet, you can transfer a file between your computer and a host application. However, before you can send a file to the host or receive a file from the host, you must define the transfer settings that you need. These settings tell the 3270 Applet which host environment you will be using--VM/CMS, TSO, or CICS-- as well as the parameters for the connection between your computer and the host.

Hint  Before starting this procedure, review the configuration parameters under step 3 to ensure that you have the necessary information at hand.

To define file transfer settings

1	From the Transfer menu, choose Settings.

The File Transfer Settings dialog box appears.

2	Under Host Operating System, select the option button for the correct host environment.

The host environment option that you select determines the rest of the settings you enter in the File Transfer Settings dialog box. Settings you do not need for your host environment are unavailable.

3	Find the items that apply to your configuration, and supply the information as follows:

Host Program Name

Specify the host program name by typing the host name for the program used by the 3270 Applet.

Timeout

Specify the amount of time, in seconds, that the 3270 Applet will wait for a host response to the file transfer request.

Packet Size

Specify the packet size transferred at one time. The larger the size, the faster the file is transferred.

Block Size (TSO)

Select the Block Size check box, and specify the size of the data blocks, in bytes, in the new data set on your TSO volume.

Issue Clear (VM/CMS and CICS)

Select this check box to request the host to clear the terminal screen before transferring files.

Host Code Page

Select the correct EBCDIC code page translation table used by the host.

PC Code Page

Select the correct ASCII code page translation table used by your computer.

Record (VM/CMS and TSO)

Specify the type for the logical record length by selecting the correct option button for your configuration.

This parameter controls whether the logical record length---the number of characters in each record of a file transferred to the host---is fixed, variable, undefined, or default (that is, controlled by host defaults [TSO only]).

A transferred file that replaces or appends to an existing file automatically takes the logical record length of the existing file.

To update an existing host file, select Default.

To create a new host file, select the record length type:  Fixed, Variable, or Undefined.

If you select Fixed, specify the logical record length in the Fixed box.

Space (TSO)

Select this check box to specify the space for a new data set, then selecting the option button that corresponds to the unit of measurement (Blocks, Tracks, or Cylinders) and typing the number of units to allocate. To allocate additional space, in the second box, type the number of additional blocks, tracks, or cylinders to allocate. To find out the correct amount of space to specify, contact the host administrator.

4	Choose OK.

See Also

Specifying a File

Sending or Receiving a File


Default for Host Program Name

The default is IND$FILE.


Default for Timeout

The default is 30 seconds.


Default for Packet Size

The default is 8192; the maximum packet size is 32767.


Default for Block Size

The default is 80 bytes.


Default for Issue Clear

The default is selected (enabled) for CICS transfers and cleared (not enabled) for VM/CMS transfers.


Default for Host Code Page

The default is United States.


Default for PC Code Page

The default is United States.


Default for Record

If you select Fixed, the default for the logical record length is 80.


Data Block
data blocks

A data block is a string of data transmitted as a unit.


data set

A data set is a collection of data records among which there are logical relations.


packet size

The size of the data blocks transferred at one time. The host application determines the maximum for the packet size. The largest packet size for CICS is 2048; for TSO and CMS it is 32,767.


Specifying a File

Once you have defined the settings for transferring files, you can send a file to the host or receive a file from the host. You can select a file to transfer in one of two ways:  by typing the name of the specific file to send or receive, or browsing through a list of available files.

To type the name of a specific file

1	From the Transfer menu, choose Send File or Receive File.

Either the Send File dialog box or Receive File dialog box appears.

2	In the PC File Name box, type the name of the file to send or receive.

Caution  When receiving a file from the host application, if you type the name of an existing PC file, it will be overwritten by the host file.

3	To review your settings, choose Settings; to continue, see Sending or Receiving a File.

To browse through a list of available files

1	From the Transfer menu, choose Send File or Receive File.

Either the Send File dialog box or Receive File dialog box appears.

2	Choose Browse.

The Open dialog box appears.

3	In the File Name list, select the file you want to send or receive.

To see files of another type, select the type from the List Files of Type box.

4	Choose OK.

The Send File or Receive File dialog box reappears with your selection in the PC File Name box.

5	To review your settings, choose Settings; to continue, see Sending or Receiving a File.


Sending or Receiving a File

Once you have defined the settings you need to transfer files and selected the file to transfer, you can send a file to or receive a file from the host. To send or receive a file, you must supply certain configuration information. This information includes the host filename, host file type, host file mode, data set name, carriage return, whether you are appending to an existing file, EBCDIC conversion, and carriage return line feed.

Hint  Before starting this procedure, review the configuration parameters under step 1 to ensure that you have the necessary information.

To send a file to the host or receive a file from the host

1	After specifying the file, find the items that apply to your configuration, and supply the information as follows:

Host File Name (VM/CMS and CICS)

Specify the host filename.

Host File Type (VM/CMS and CICS)

Specify the host file type.

For CICS, select either ASCII File or Binary File.

Host File Mode (VM/CMS)

Specify the host file mode, the specific minidisk where the user data resides. To find out the mode for a specific file, from an applet session, type the following command, substituting the name of the file for filename:

list filename * *

In the resulting display, the third column contains the file mode.

The default host file mode is A1.

Data Set Name (TSO)

Specify the host data set name. Be sure to include the Member name, in parentheses, if you are sending to a host partitioned data set (PDS). The following is an example of a data set name for a PDS:

PROJECT.GROUP.TYPE(MEMBER)

Carriage Return (CICS)

Select the carriage return option for the file you are sending or receiving.

Delete CR/LF removes all carriage return/line feed characters from the file sent to the host. No CR/LF leaves the carriage return/line feed characters in the file when transferring to the host. None of the Above uses the default implied by the type of file (ASCII or binary) being transferred.

The default for ASCII (being converted to EBCDIC) is CR/LF. The default for binary is No CR/LF, and CRLFs will not be interpreted.

Append to Existing File (send)

Select this check box to add new data to the end of an existing host file.

Convert to EBCDIC (send)

Select this check box to convert from ASCII to EBCDIC.

Convert from EBCDIC (receive)

Select this check box to convert from EBCDIC to ASCII. Use this option for text files rather than binary files.

Delete Carriage Return/Line Feed CR/LF (send)

Select this check box to replace all CR/LF characters with end of record marks.

Insert Carriage Return/Line Feed CR/LF (receive)

Select this check box to replace all end-of-record marks with CR/LF characters. Use this option for text files rather than binary files.

2	Choose OK.

The 3270 Applet begins the transfer.

See Also

Defining File Transfer Settings

Specifying a File


PDS (Partitioned Data Set)

A PDS is a specific subset of the data in a set of files; the Member name is not necessary to identify data within a PDS.


Using Macros

The 3270 Applet provides macros for ease in using host function keys.

The macros for the 3270 Applet are as follows:

Macro	Description
Attention	Sends an Attention key to the host. The Attention key is used to temporariy stop the present display station activity.
Clear	Sends a Clear key to the host. This macro clears the display screen.
Reset	Sends a Reset key to the host. Reset unlocks the keyboard and clears operator errors.
Sys Request	Sends a Sys Req key to the host. With most systems, use this macro to notify the host system that the display station is ready to select a new program or activity.
To use a macro

From the Macro menu, choose the correct macro.

The appropriate function key is sent to the host.


Printing the Screen

After you have established a connection to the host, you can print the information in the active window.

To print the screen

From the File menu, choose Print.

To change printer options

1	From the File menu, choose Printer Setup.

The Print Setup dialog box appears.

2	To change the printer, in the Printer list, select the correct printer.

To view Advanced Document Properties, choose the More button. To view printers on the network, choose the Network button.

3	Change any other printer options as necessary.

4	Choose OK.


Copying and Pasting Displayed Information

The 3270 Applet allows you to make a copy of the information in the display, so that you can use that information in other applications. To do this, you select a portion of the displayed information and then copy it to the Microsoft Windows NT Clipboard. After copying information to the Clipboard, you can change to a different application and transfer the information into that application.

In reverse fashion, you can copy information from an application other than the applet, then paste the information into the applet. If the emulation session is in a state in which information can be received (indicated by the status line), the pasted information will be entered as a series of keystrokes.

To copy and paste displayed information

1	Select the portion of the displayed information that you want to copy, or, from the Edit menu, choose Select All.

2	From the Edit menu, choose Copy.

The selection is copied to the Clipboard.

3	Change to the program in which you will insert the contents of the Clipboard.

4	Position the cursor at the location where you want to insert the contents of the Clipboard.

5	From the Edit menu, choose Paste.

To copy information from an application and paste it into the applet window

1	From the application, copy information to the Clipboard by using the applications standard copy command(s).

2	Change to an active applet session, or start the applet and begin a session.

3	Check to see that the session is in a state in which keystrokes can be received.

4	From the Edit menu, choose Paste.

The copied information is entered as a series of keystrokes.


Clipboard

A special memory resource that stores a copy of the last information that was copied or cut. A paste operation passes data from the Clipboard to the current program. Data copied using the Clipboard is static and will not reflect later changes.


Saving a Configuration

After you have configured a connection to the host, you can save it. While you are connected to the host application, you cannot open a new or existing configuration.

To save a configuration

1	From the File menu, choose Save.

The Save As dialog box appears.

2	In the Directories box, select the appropriate directory.

3	In the File Name box, type a name for the configuration file or select a file from the list.

4	Choose OK.

Now, when you choose Open from the File menu, the configuration appears as an available configuration.

To open a configuration

1	From the File menu, choose Open.

The Open dialog box appears.

2	In the Directories box, select the appropriate directory.

To open a file from a directory on the network, choose the Network button.

3	In the File Name box, type a name for the configuration file or select a file from the list.

4	Choose OK.

To create a new configuration

From the File menu, choose New.

The configuration settings are reset to their default values.

To rename a configuration

1	From the File menu, choose Save As.

The Save As dialog box appears.

2	In the Directories box, select the appropriate directory.

To save a file to a directory on the network, choose the Network button.

3	In the File Name box, type a new name for the configuration file or select a file from the list.

4	Choose OK.

Now, when you choose Open from the File menu, the configuration is renamed and appears as an available configuration.


3270 Applet Standard Keyboard Map
3270 Keyboard	Enhanced 101 Keyboard

|	SHIFT+\
DUP	CTRL ALT INSERT
FIELD MARK	SHIFT HOME
ERASE TO END OF FIELD	SHIFT DELETE
ERASE INPUT	ALT END
RESET	CTRL + R
HOME	HOME
TAB	TAB
BACKTAB	SHIFT TAB
ENTER	ENTER
NEWLINE	SHIFT ENTER
FAST CURSOR LEFT	NOT SUPPORTED BY THIS EMULATION
FAST CURSOR RIGHT	NOT SUPPORTED BY THIS EMULATION
CURSOR UP	UP ARROW
CURSOR DOWN	DOWN ARROW
CURSOR LEFT	LEFT ARROW
CURSOR RIGHT	RIGHT ARROW
INSERT	INSERT
DELETE	DELETE
ATTENTION	ESC
SYSTEM REQUEST	CTRL+ S
CLEAR	PAUSE
PA1	ALT INSERT
PA2	ALT HOME
PA3	SHIFT PAGE UP
CurSel	ALT F3
PF1	F1
PF2	F2
PF3	F3
PF4	F4
PF5	F5
PF6	F6
PF7	F7
PF8	F8
PF9	F9
PF10	F10
PF11	F11
PF12	F12
PF13	SHIFT F1
PF14	SHIFT F2
PF15	SHIFT F3
PF16	SHIFT F4
PF17	SHIFT F5
PF18	SHIFT F6
PF19	SHIFT F7
PF20	SHIFT F8
PF21	SHIFT F9
PF22	SHIFT F10
PF23	SHIFT F11
PF24	SHIFT F12


ASCII Character Set

ASCII Character Set (Part A)

ASCII Character Set (Part B)


ANSI Character Set


IBM Extended Character Set


OIA Indicators

The Operator Information Area (OIA) is used to display the status of a 3270 screen session. The OIA is the last (bottom) line display in the terminal window of the 3270 session. Except for the initial three positions (system connection indicators), status line indicators only appear when they apply.

The following tables describe the OIA and explain each indicator. In the table, position refers to the column(s) that a specific indicator occupies on the OIA, where the left-most column of the OIA is position 1. Note that the "female" symbol used for certain system connection and input inhibited indicators cannot be displayed in this table. In its place is the "^" symbol.

Indicator (position)

Symbol	Meaning

System Connection (position 1)

Does not apply to SNA Server 3270 Applet.
System Connection (position 2)

B	Connection uses an SNA protocol.
A	Connection uses a non-SNA protocol.
System Connection (position 3)

b	Connected to a host application (LU-LU session).
^	Connected to host system services (SSCP-LU session).
?	Session is established, but is not connected to any host program (unknown).
Session ID (positions 4--7)

aaaa	First four characters of your configured long name session ID.
Input Inhibited messages (keyboard locked) (positions 9--17)

X COMMnnn	Communications error. See Communications Status (positions 19--26).
X MACHnnn	Machine check error.
X PROGnnn	Program check error. See Communications Status (positions 19--26).
X SYSTEM	Keyboard input is being processed by the host. Wait for the message to clear or press RESET.
X[]	The Host requires more time to process your request. Wait for indicator to clear or press RESET.
X -f	Function is not supported. Press RESET and select a valid function.
X^>	More data was typed than the field allows or can accept. Press RESET and re-enter the data.
X <-^->	Protected field; you cannot type data. Press RESET and move the cursor to an unprotected field.
X -f^X	Function is not authorized. Press RESET and select a valid function.
X^+?	Invalid accent/character combination typed. The accent is displayed in position 12. Press RESET and type a valid combination.

Communications Status (positions 19--26)

COMM500	All the link services configured for use by the connection were inactive.
COMM504	Communications are not established with the host. This message disappears as soon as communication is established with the host. If this message does not disappear, check to ensure proper settings of the host network address, local node ID, or local SAP.
COMM505	The host terminated the connection used by your 3270 session.
COMM510	The host has deactivated the communications link. Report the message to your system administrator.
COMM518	A segment was out of sequence. Contact your system administrator.
COMM695	A communications error occurred.
COMM5nn	The communications link is still being established; the keyboard is locked. Wait for the message to clear; also check Input Inhibited messages.
PROG703	A session control, data flow control or network control command is not supported. Press RESET, and try the operation again.
PROG705	A sequence number error has occurred. Press RESET, and try the operation again.
PROG706	A chaining error has occurred. Press RESET, and try the operation again.
PROG707	A bracket state error has occurred. Press RESET, and try the operation again.
PROG708	A data traffic reset state exists. Press RESET and try the operation again.
PROG717	The support level requested is not valid. Press RESET, and try the operation again.
PROG723	The LU type requested is not valid. Press RESET, and try the operation again.
PROG724	The screen size requested is not valid. Press RESET, and try the operation again.
Screen Session LU Address (positions 79--80)

nn	The LU address of the currently display 3270 screen session.