Previous Page Contents Page Next Page

4.3 Controlling Printer Sessions

Printer sessions are used by host applications that can print to 3287 printers using LU types 1 or 3. You control printer sessions in much the same way as you control display sessions.

You do not need a printer session to print the contents of a 3270 display on a local printer. To do that, press PRINT (default keystroke Ctrl + P) during 3270 emulation.

To control printer sessions, choose Printer Sessions from the Control menu. The dialog box shown in Control Printer Sessions Dialog Box, is displayed.

Control Printer Sessions Dialog Box

The following list describes the information contained in the Control Printer Sessions dialog box.

Long Name

The unique identifier for each session. For instructions for changing this option, see Customizing Printer Sessions.

Host Session

The name of the host session record in the configuration file.

Host Domain

The host symbolic domain name of the TCP/IP host used by the session. If the session is disabled, this field is blank. This field may be truncated on the right, if necessary.

This name may correspond to a host computer that supports direct TN3270 access over TCP/IP, or to a communications product (such as the main SNAP-IX product) providing the TN server function on another computer. For a TN server, the name shown is the domain name or Internet address of the computer where the TN server software is running.

If the System Administrator has given you permission to override the configured domain name, you can use the command line to specify the name of the host to use for a given session. For more information about overriding the configured host domain name, see Starting the 3270 Emulation Program.

LU Name

Identifies the local LU assigned to the session. If the session is disabled, the name of the configured LU or LU pool is shown (or blank if no LU name is configured). If the session is active, the name shown is the name of the actual LU used by the session. If TN3270 protocols, rather than TN3270E protocols, are being used, the name of the configured LU or LU pool is shown because the actual LU name is not available.

Display Session

Session number for the associated display session. This field is blank if no display session has been associated.

Status

Indicates whether the session is communicating with the local node. To use the session for printer emulation, you must enable it. For more information, see Enabling and Disabling a Printer Session. The following list describes the printer session status messages.

Disabled

The session is not communicating with TCP/IP. To enable this session, you must choose < Change Status>.

Enabled nnn

The session is communicating with TCP/IP but not with a host control program. The variable


nnn
is the communications check code, displayed as
-+z_nnn
on the status line of the 3270 session. For explanations of these codes, see Status Line Information. The code indicates why the 3270 emulation program has not been able to contact the host control program.

The status may also appear as

Enabled
without a communications check code for a few seconds before it changes to
SSCP
.

SSCP

The session is activated and communicating with a host control program.

NVT

The session is communicating with the host TN3270 program using data messages in Network Virtual Terminal (NVT) format. This format uses no header and ends all ASCII lines with a carriage return and line feed (CR LF).

TN3270

The session is communicating with the host TN3270 program using data messages in TN3270 format. This format uses no header, LU type 2 data, and TELNET END-OF-RECORD (EOR).

TN3270E

The session is communicating with the host TN3270 program using data messages in TN3270E format. This format uses a 5-byte header, various data types, and TELNET END-OF-RECORD (EOR).

TN3287

Session is communicating with the host TN3270 program using data messages in TN3287 format. This format uses one zero-byte prefix for LU type 1 or LU type 3 data and TELNET END-OF-RECORD (EOR).

Host_application_name

The 3270 emulation program is communicating with the named host application, but printing has not yet started. This name is shown if it is available from the BIND image exchanged during session activation. If the BIND image is not available, either the value

TN3270
or
TN3270E
is shown.

Printing

The 3270 emulation program is communicating with a host application, and printing is in progress.

The Control Printer Sessions dialog box provides the following push buttons:

<Change Status>

Choose this to enable a disabled session or to disable an enabled session. (For more information, see Enabling and Disabling a Printer Session.)

<Done>

Choose this to exit the Control Printer Sessions dialog box.

4.3.1 Enabling and Disabling a Printer Session

To conduct printer emulation, you must enable a printer session. To toggle a session's status between enabled and disabled, use the following procedure:

  1. Select a printer session in the Control Printer Sessions dialog box.

  2. Choose <Change Status>.

Once enabled, a printer session is available to direct 3270 output either to a printer attached to your Solaris computer or to a file on the Solaris computer. No display function is associated with printer sessions.

For printer sessions associated with display sessions, the 3270 emulation program automatically disables the printer session unless the display session is active. If you attempt to enable a printer session associated with a display session when the display session is not active, the 3270 emulation program displays an error message that indicates that the printer session is not enabled.

4.3.2 Maximum Print Position for LU 1 and Unformatted LU 3 Printer Sessions

When the host sends data for a printer session, it can specify the maximum number of characters to be printed on a line (the 'maximum print position'). The default value is 132; the 3270 emulation program accepts any value from the host up to 132, but will reject larger values.

If you need to accept larger values specified by the host, or to restrict the host to values below 132, you must set the environment variable SNALU1MPP before starting the 3270 emulation program. This should be set to the maximum number of characters acceptable per line (the limit is 250). The 3270 emulation program will then accept any value from the host that is less than or equal to the value of this environment variable, but will reject larger values.

Contact your System Administrator if you are not sure how to set this environment variable.

4.3.3 Code Translation for LU 1 Transparent Data

When the host sends data for a LU1 printer session, it can mark sections of the data as 'transparent data' (using the SCS code 0x35). Normally, transparent data is sent to the printer without being translated from EBCDIC to ASCII.

If you need to translate transparent data from EBCDIC to ASCII, you must set the environment variable CONVERTTRANS to the value 1 before starting the 3270 emulation program. The program will then translate transparent data. To return to the normal operation, set this environment variable to 0 (zero).

Contact your System Administrator if you are not sure how to set this environment variable.

Previous Page Contents Page Top of Page Next page