HP 3000 Manuals HP 3000 Manuals
Command Syntax for Starting Pass Thru
The info string of the MPE RUN command used for Pass Thru may contain the
following parameters:
* CONFIG= config SNA node name, and SNA LU class name (MPE V) or
security class name (MPE XL)
* DEVID= devid Device identifier (LU.T1, LU.T2, or LU.T3)
* LDEV= ldev Logical device number(s) or device class
* FORMAT= format Format for printing the internal screen image
* PRIORITY= priority Output spool priority
* BLANKS Disable translation of leading blanks to nulls
* ENHANCE= enhance Display enhancements (brightness, underlining,
inverse video)
* SPRIORITY= spriority Spooler priority
* READTO= readto Terminal timeout value
* TRACE SNA IMF internal tracing
* PFN= pfn Printer filename
* LJ2 HP LaserJet Series II or Series III printer
Syntax
_______________________________________________________________________________
| |
| RUN TTSSON.PUB.SYS;INFO="CONFIG=config; DEVID=devid [;LDEV=ldev] |
| |
| [;FORMAT=format] [;PRIORITY=priority] [;BLANKS] [;ENHANCE=enhance] |
| |
| [;SPRIORITY=spriority] [;READTO=readto] [;TRACE] [;PFN= pfn] [;LJ2]"|
_______________________________________________________________________________
Info String Parameters
The following parameters comprise the info string. The info string can
be up to 256 characters long, including blanks. It must be enclosed in
double quotes. Parameters are separated by semicolons.
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 for 3287 printer
(LU.T2) emulation: (LU.T1 or LU.T3) emulation:
D (Display station) P (Printer)
T (Terminal) -1 (LU.T1)
-2 (LU.T2) -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 disc:
(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.
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 lists the possible values and their effects.
Table 3-1. Display Enhancement Options
-------------------------------------------------------------------------------------------
| |
| Option 3278 normal intensity 3278 high intensity |
| converted to converted to |
| |
| 0 264x half-bright or 23xx/262x 23xx/262x/264x normal |
| normal (full-bright) (full-bright) |
| |
| 1 23xx/262x/264x normal 23xx/262x/264x underline |
| (full-bright) |
| |
| 2 23xx/262x/264x normal 23xx/262x/264x inverse video |
| (full-bright) |
| |
| 3 23xx/262x/264x inverse video 23xx/262x/264x normal |
| (full-bright) |
| |
-------------------------------------------------------------------------------------------
If you are using an HP 264x terminal, you must have the Display
Enhancements optioninstalled, because half-bright and underline are not
standard features. Without the Display Enhancements option, if you
specify ENHANCE=0 (the default), all characters appear at normal
intensity. Half-bright is not available on the 23xx or 262x terminals.
You cannot turn off inverse video for part of a field on an HP terminal.
Therefore, if you choose inverse video, the white strip of the inverse
video occupies the entire field, regardless of where the end of your data
falls in the field. Display enhancement options 2 and 3 use inverse
video. (See table 3-1.)
spriority
Optional parameter used to specify the spooler priority. This is an
integer from 1 through 13. The default is 8.
readto
Optional parameter used to set the terminal timeout valuein seconds. The
value must be an integer between 10 and 255. The default is 10 seconds.
You may need to specify a value greater than 10 if your terminal's
response time is longer than 10 seconds. Long response time can be
caused by a remote connection through multiple HP 3000 systems and can be
complicated by modem connections and slow line speeds.
TRACE
Optional parameter used to turn on SNA IMF internal tracing. If TRACE is
not specified, internal tracing is turned off by default.
Internal tracing degrades performance and should be specified only at the
request of your HP representative. It is used to collect data for
problem determination.
Trace data is sent to a trace file named IMF nnTxx, where nn is the NAU
number and xx is a unique two-digit identifier for the trace file. The
file will reside in the current group and account of the user running
Pass Thru. (For acquired terminals or printers, the file will reside in
PUB.SYS.)
pfn
Optional parameter used to specify a printer file name other than the
default value. The printer file name must be an alphanumeric string of
up to 8 characters, beginning with an alphabetic character. The default
printer file name is a string of blank characters. This parameter is
valid only in LU.T1 or LU.T3 printer sessions.
LJ2
Optional parameter used to inform Pass Thru that printer output files
will be directed to an HP LaserJet Series II or Series III printer. If
LJ2 is not specified, Pass Thru defaults to the former method of printing
output files on impact and high-end laser printers. LJ2 can be used only
in an LU.T1 or LU.T3 printer session.