- config
Required. A byte array that
identifies the section of the Node Management Services configuration
file used by SNA IMF.
On MPE V, config is the SNA node name (PU name) and the SNA class name.
The syntax is as follows:
CONFIG=SNA node name#SNA class name
On MPE XL, config is the SNA node name (PU name) and the security class
name. The syntax is as follows:
CONFIG=SNA node name#security class name
- devid
Required. Device identification
for printer or terminal. Possible values are as follows:
for 3278 display station (LU.T2) emulation:
- D
(Display station)
- T
(Terminal)
- -2
(LU.T2)
for 3287 printer (LU.T1 or LU.T3) emulation:
- P
(Printer)
- -1
(LU.T1)
- -3
(LU.T3)
For terminal emulation, D, T, and -2 can be used interchangeably. For LU.T1 or LU.T3
printer emulation, specifying -1 or -3 will make your startup time slightly shorter than
specifying P. If you specify one type of printer session, and
your first session turns out to be the other type, no error will
occur. SNA IMF will start up the appropriate emulator.
If you specify a printer ldev and an LU.T2 bind is received, an error will occur.
Likewise, if you specify a display station ldev and an LU.T1 or LU.T3 bind is received, an error will
also occur.
- ldev
Optional. MPE logical device
number of the HP terminal or printer, or device class for printer emulation.
The default is 0. Use 0 to represent your own terminal.
This parameter can be used to specify device classes
for printer emulation. For example, the following info string causes
Pass Thru to use the device class name "UNISPOOL" in
the FOPEN call:
:RUN TTSSON;INFO="CONFIG=IBMNODE#LU3; DEVID=P; LDEV=UNISPOOL"
The file system will then be responsible for determining which
logical device in the "UNISPOOL" class name to open.
If the device class name you specify is not configured, or if you
specify a device class name for a terminal, Pass Thru will return
an error message.
- format
Optional parameter used for LU.T2 and LU.T3 sessions only.
The format value tells SNA IMF which form of screen printing to
use when you press the PRINT softkey. It is an integer from 1 through 4. The default is 2.
Possible values are as follows:
- 1
Prints the contents of the internal screen image
and the location and characteristic of each 3270 attribute character.
- 2
(Default) Prints the internal screen image in the
same format in which it appears on a terminal. Attribute and null
characters appear as blanks. This clean print is similar to the
function of the IBM 3278 local print key.
- 3
Prints the contents of the internal screen image
and the location and characteristic of each 3270 attribute character.
Automatically prints the internal screen image that is created whenever
Pass Thru calls the TRAN3270 or RECV3270 intrinsic for a particular device.
- 4
Prints the internal screen image in the same format
in which it appears on a terminal. Attribute and null characters appear
as blanks. Automatically prints the internal screen image that is created
whenever Pass Thru calls the TRAN3270 or RECV3270 intrinsic for a particular device.
Unless a FILE command has been issued in MPE, pressing the PRINT softkey produces a copy of the internal screen image and
sends it to an output spool file named LOGIMF. Use the following
file equation to send the internal screen to disk: (This is the
only file equation that works.)
:FILE LOGIMF,NEW;DEV=DISC;REC=-133,,,ASCII;NOCCTL;SAVE |
A format value of 2 or 4 prints the exact contents of the internal
screen image. Each screen image has a numeric border that numbers
the rows and columns. Null characters are represented by tildes
(~), or by hyphens on some terminals, to distinguish them from blanks.
Attribute characters appear as overprints. The hexadecimal value
of the first 16 attribute characters in each row is printed to the
right of the row. The cursor appears as an underline. The cursor
position and state of the keyboard (enabled or disabled) are printed
at the bottom of the screen image.
When you use the PRINT key with a format value of either 1 or 2, Pass Thru reads the terminal
screen and updates the internal screen image with any recent data entered
on the screen. Do not confuse the read for this PRINT operation with the one associated with the transmission
of data to the host. To send data to the host, use either the [ENTER] key or a PF (program function) key.
A format value of 3 or 4 prints the internal screen image when
you press the PRINT softkey, and it automatically prints the internal screen
image that is created whenever Pass Thru calls the SNA IMF TRAN3270 or RECV3270 intrinsic for a particular device. Automatic printing
is started when Pass Thru comes up and continues until you exit
Pass Thru. For information on SNA IMF intrinsics, see the SNA
IMF Programmer's Reference Manual.
A format value of 3 is useful for testing an SNA IMF application
as you write it. It helps you determine two things: the location
of 3270 attribute characters within a screen image, and whether
the host is doing multiple writes to create a single screen image.
A format value of 4, which produces a clean print, helps create
an automatic hard-copy log of transactions.
- priority
Optional parameter used for LU.T2 and LU.T3 only.
It is an integer from 1 through 13 specifying an output spool priority
for the output file LOGIMF. The default is 7.
The LOGIMF file contains the output from the PRINT softkey or the SNA IMF PRINT3270 intrinsic.
An output spool priority specified in an MPE FILE command overrides the value in this parameter.
- BLANKS
Optional parameter used for LU.T2 and LU.T3 only. Informs
Pass Thru to keep leading blanks. If BLANKS is not specified, all leading blanks in unprotected
fields are converted to nulls, on a field-by-field basis, for transmission
to the host. The BLANKS parameter does not affect embedded or trailing blanks;
only leading blanks are affected.
Specifying the BLANKS parameter is equivalent to specifying the LB: YES option in the PTCONFIG file. You can use the LBNULL softkey to override the BLANKS parameter and the LB: YES option in the PTCONFIG file.
For more information on leading blanks, see "Leading Blanks,
Trailing Blanks, and Trailing Nulls," in Chapter 2 “Configuring Pass Thru”
- enhance
Optional parameter used for LU.T2 and LU.T3 only. This
is an integer from 0 through 3 specifying a display enhancement
value. The default is 0. Table 3-1 “Display Enhancement Options” lists the possible
values and their effects.