JES3 Generation Considerations [ RJE/XL Node Manager's Guide ] MPE/iX 5.0 Documentation
RJE/XL Node Manager's Guide
JES3 Generation Considerations
To generate support for an RJE/XL workstation under JES3, the
program consists primarily of defining the characteristics of the
data communications lines and the remote station facilities and
characteristics using the following macros:
RJPLINE The RJPLINE statement defines the characteristics of a
single BSC line (and its respective adapter) that will
be used by the JES3 global processor for remote job
processing. Additionally, this statement may assign a
specific RJP workstation, defined by the N parameter of
an RJPTERM statement, to this line.
RJPTERM The RJPTERM statement defines a single remote BSC
workstation to the JES3 system. This statement causes a
default description to be provided for each workstation
device (printer, punch, or card reader) indicated by the
PR, PU, or RD parameters along with the operating
characteristics of the workstation. If the JES3 default
characteristics for a remote printer or punch device are
not acceptable, a DEVICE statement should be coded to
indicate desired characteristics. If a workstation is
to have the facilities of a JES3 operator console, then
a CONSOLE statement must be coded.
CONSOLE The CONSOLE statement is required to define each SNA RJP
console and is optional for BSC RJP consoles. This
statement is used to assign JES3 destination classes to
that console. Only one console can be specified on each
CONSOLE statement. You must have at least one CONSOLE
statement in your initialization stream; however, the
first CONSOLE statement cannot be a CONSOLE statement
for an RJP console.
DEVICE RJPTERM will give acceptable defaults for the defined
printer, punch, and card reader. You may wish to define
them to change some of the defaults.
RJPLINE
The RJPLINE macro parameters are described below.
N= linename
This parameter is required to specify the name for this
line up to eight characters. It must be different from
the N parameter of the RJPTERM statement.
A= adaptadr
This parameter is required to indicate the
three-character line adapter address associated with
this line. For multiple processors, the parameter
indicates the adapter addresses associated with each
processor.
For a single processor, specify:
A = xxx where xxx is the adapter address
For multiple processors, specify:
A =(A,xxx,B,yyy,C,zzz) where A, B, and C are the
processors and xxx, yyy, and
zzz are the adapter addresses
F= NTRS
This parameter is used to indicate a dial feature for
this line (DIAL) and/or the absence of a transparency
feature for the line (NTRS). If both DIAL and NTRS are
selected, both F parameters are specified, as shown
previously.
Default. Dedicated or leased line environment.
Transparency feature assumed on terminals on this line.
RJPTERM
The RJPTERM macro parameters are described below.
N= name
Required. This parameter indicates the name for this
workstation. The name must be five characters and
cannot be the same as an N parameter specified on an
RJPLINE or RJPWS statement.
T= termtype
This parameter indicates a four-character identifier
specifying the type of workstation. The valid types for
this parameter are:
ID Workstation
2780 2780 nonprogrammable terminal
3780 3780 nonprogrammable terminal
B= Bufsize
This parameter indicates the terminal buffer size in
bytes. The value specified can be up to four numeric
characters. For programmable terminals, the bufsize
must correspond to the workstation package. For
nonprogrammable terminals, the default buffer value is
used. Default: 400
For fixed buffer size devices, such as the IBM 2780, the
B parameter is forced to 400. For the IBM 3780, 512 is
used.
C= S
This parameter indicates the type of console support for
this workstation. If the C parameter is specified, a
CONSOLE statement should be specified also. If no
CONSOLE statement is found for this workstation, the C
parameter is ignored. If a CONSOLE statement is found
and the C parameter is not specified, then the default
value for C is assumed. S applies to both programmable
and nonprogrammable terminals. This subparameter
specifies that regardless of any real console attached
to this workstation, the printer designated as PR1 is to
be used as a simulated console output device. If S is
specified for a programmable terminal that has a real
console, that console can still be used to enter console
commands. However, all console output will be directed
to the printer.
F= HTAB
Optional. This parameter specifies that this terminal
has the printer horizontal format control feature. This
parameter is used to indicate an IBM 2770, IBM 2780, or
IBM 3780 with the horizontal format control feature.
Default. It is assumed that the terminal does not have
this feature.
F= NTRS
This parameter specifies that the terminal transparency
feature is not present on this terminal.
Default. It is assumed that the terminal has the
transparency feature.
F= PRES
Optional. This parameter is specified for a
nonprogrammable terminal only, to indicate the blank
compression/expansion feature for that terminal.
Default. It is assumed that the terminal does not have
this feature.
F= XBUF
This parameter specifies that an IBM 2770 terminal has
the extended buffer feature, that an IBM 2780 terminal
has the multirecord feature, or that an IBM 3740 has the
expanded communications feature. For an IBM 2770, the B
parameter must be specified large enough to incorporate
this feature.
Default. It is assumed that the terminal does not have
this feature.
O= BFIX
This parameter indicates a workstation option which
specifies that the output buffers used by RJP must be
dedicated, that is, obtained at OPEN time and freed at
CLOSE.
PR= 1
This parameter indicates the number of remote printers
associated with this workstation.
PRW= recsize
Optional. For programmable terminals, the value
specified on the PRW parameter must not exceed the
buffer size minus 16. The B parameter defines the
buffer size.
For nonprogrammable terminals, the value specified on
the PRW parameter must not exceed the maximum print
record size defined by the design of the specific
printer. The component manual for the printer defines
the maximum print record size.
Default. 132
PU= 1
This parameter indicates the number of remote punches
associated with this workstation.
D= 1
This parameter indicates the maximum number of readers
at this workstation.
CONSOLE
The CONSOLE macro parameters are described below.
TYPE= RJP
This parameter specifies that the console being defined
is an RJP console.
DEST= none
This is the destination code.
DEVICE
RJPTERM will give acceptable defaults for the defined printer, punch, and
card reader. The user may wish to define them to change from some of the
defaults.
For more details refer to the JES3 System Programming Library
Intiallization and Tuning Manual.
MPE/iX 5.0 Documentation