HP 3000 Manuals HP 3000 Manuals
IBM 3705, IBM 3725 Emulation Program (EP) Generation
To support a binary synchronous communications line used by RJE/XL and
your host system, you must generate a program to run on the host
communication controller that performs emulation of the IBM 2701, IBM
2702, or IBM 2703 transmission control units. This can be done by
generating an Emulation Program (EP) or, if the program is to also
perform network control functions, by generating a Network Control
Program (NCP) with the Partitioned Emulation Program (PEP) extension.
For clarity, the EP generation is described in this section. To generate
the PEP refer to the controller manuals listed under "Host System
Generation Considerations." The information for those parameters and
macros not used with the IBM 3725 is coded into its Generation Two-Stage
JCL. The EP generation consists of defining the following five macros and
associated parameters:
BUILD This macro defines the physical environment in which the
EP is to run including the control unit being emulated,
the type of communication controller being used for the
emulation, and the diagnostics capabilities.
CSB This macro defines the communication scanner being used
in the communications controller and its environment; it
is not used with the IBM 3725.
GROUP This macro defines common characteristics of all the
data communication lines within one group. For example,
the GROUP macro is used to define whether the lines are
switched or nonswitched and whether the lines are BSC or
start-stop.
LINE This macro defines the characteristics of one particular
line attached to the communication controller including
the address of the line, some of the transmission
characteristics (speed, transmission code, etc.), some
of the modem characteristics (duplex, clocking, etc.),
and the type of remote terminal to which the line is
connected.
GENEND This macro defines the end of the IBM 3705 and the IBM
3725 control program file (input deck) and must be the
last macro coded in the program.
These parameters apply to BSC or start-stop
(asynchronous) lines only, and are used in support of
IBM 2780/3780 emulation. Undefined parameters need not
be specified to provide complete support for RJE/XL.
BUILD Macro
The BUILD macro parameters are described below.
BUILD The BUILD macro is required for Emulation Program or
PEP.
HICHAN= (addr1[,addr2]) (for the IBM 3705)
(addr0[,addr1][,addr2]... [,addr5]) (for the IBM 3725)
Required. This parameter defines the high end of the
range of subchannel addresses associated with the
channel adapters in the communication controller. The
HICHAN address must be equal to or greater than the
highest EP subchannel address that you specify in the
ADDRESS parameter of any LINE macro.
LOCHAN= (addr1[,addr2]) (for the IBM 3705)
(addr0[,addr1][,addr2]... [,addr5]) (for the IBM 3725)
Required. This parameter defines the low end of the
range of addresses associated with the channel adapters
in the communications controller. The LOCHAN address
must be the lowest EP subchannel address, regardless of
whether it is used for dynamic dump data transfer or for
an EP line.
NOTE For additional information on addresses you may specify for HICHAN
and LOCHAN, and how to handle the use of multiple type 4 channel
adapters, refer to the controller manuals listed under "Host System
Generation Considerations."
LOADLIB= dsname
Required for OS/VS generation. This parameter does not
apply to DOS/VS generation. It identifies the name of
the cataloged, partitioned data set (file) containing
the load module produced by the program generation
procedure.
OBJLIB= dsname
Required for OS/VS generation. This parameter does not
apply to DOS/VS generation. It identifies the name of
the cataloged partitioned data set (file) containing the
output from all EP assemblies produced during stage two
of the generation procedure. OBJLIB is not used with
IBM 3725 software.
CA= (adapter1[,adapter2])
This parameter is required with an adapter other than a
type 1 for a 3705-1, a type 4 for a 3705-2 , or a type 5
for a 3725 (default values). It identifies the types of
channel adapters being used in your host communication
controller.
DYNADMP= YES,NSC
This parameter is recommended in order to include the
dynamic dump facility in the EP. This facility allows
transfer of the storage contents of the communication
controller to the host processor without interrupting
execution of the EP. The NSC specification invokes the
use of the native subchannel address for dynamic dump
communication.
JOBCARD= YES
Recommended default. This parameter applies to OS/VS
generation only. It causes the EP generation procedure
to create a job card for the stage two input stream. If
you specify NO, you must supply your own job card.
JOBCARD is not used with IBM 3725 software.
LESIZE= size
This parameter applies to OS/VS generation only. It
specifies the region size in K bytes to be used by all
linkage editor job steps during stage two of the EP
generation. LESIZE is not used with IBM 3725 software.
LINETRC= YES (for the IBM 3705)
Recommended. This parameter enables you to perform
channel and line interrupt tracing on the host side.
YES[,n[,blocks]] (for the IBM 3725)
The above configuration is for emulation mode on the IBM
3725. n is the number of active SIT (scanner interface
traces) (116). The default is 4. blocks is the number
of 512K blocks in the line trace table. The default is
4.
TEST= YES
Recommended. This parameter enables you to perform
control panel-initiated line testing on the host side.
MODEL= 3705
3705-2
3704
3725
Required. This parameter identifies the type of
communications controller you are using to run the EP.
NEWNAME= EP001
string (for the IBM 3725)
Required. This parameter supplies a name for the
generated program. You can use any valid string of
seven characters or less. There is no default.
OPCSB2= YES
NO
This parameter affects type 2 channel adapters only. If
you specify YES, a 20-byte data buffer is provided for
communication lines serviced by a type 2 adapter and for
which you specify CHNPRI=HIGH in the LINE macro. Not
used with the IBM 3725.
TYPGEN= EP
PEP
Required. This parameter indicates that the program you
are generating performs emulation functions (EP) or NCP
and EP functions (PEP). Use PEP for the IBM 3725.
TYPSYS= DOS
OS
VSE
VM
This parameter is required if your host operating system
is DOS, VSE, or VM (OS is the default value). It
identifies the type of operating system under which
stage two of the control program generation procedure is
to run.
NOTE The following four parameters are not used with the IBM 3725. They
are included in Generation Two-Stage JCL.
UNIT= unit type
This parameter applies to OS/VS program generations
only. It identifies the type of disk device used during
stage two of the EP generation for assembler and linkage
editor utility data sets.
UT1= dsname
This parameter applies to OS/VS program generations
only. It identifies a sequential data set (file) to be
used as a work space for the EP assembly steps (SYSUT1).
If omitted, a temporary data set is automatically
created during each assembly step.
UT2= dsname
UT2 functions the same as UT1 for EP assembly steps
(SYSUT2).
UT3= dsname
This parameter applies to OS/VS program generation only.
It identifies a sequential data set to be used as a work
space for the EP assembly (SYSUT3) and linkage editor
(SYSUT1) steps. If omitted, a temporary data set is
automatically created during each assembly step.
CSB Macro
The CSB macro is not used with the IBM 3725. The CSB macro parameters
are described below.
CSB The CSB macro is required for Emulation Program for the
IBM 3704 and the IBM 3705.
SPEED= (rate1,...,rate4)
Required. Identifies the bit rates for each of up to
four oscillators installed in the scanner in the
communications controller.
WRAPLN= line addr
Required. This parameter identifies the interface
address for the line you want to use to send test data
to the communications controller. The address specified
here is used in the wraparound test which checks out the
interface hardware on a different line. Line addr is a
hexadecimal address that must appear in the ADDRESS
operand of one of the LINE macros. The range available
for use as line addr can be found in the IBM 3704 and
3705 Control Program Generation and Utilities Guide and
Reference Manual.
MOD= n
This parameter identifies the communications controller
module in which the scanner is found, as follows:
Scanner Location MOD=
3704 0 (default value)
3705 base module 0 (default value)
3705 first expansion module 1
3705 second expansion module 2
3705 third expansion module 3
GROUP Macro
The GROUP macro parameters are described below.
GROUP The GROUP macro is required.
DIAL= NO
YES
This parameter indicates if the lines in the group are
switched (DIAL=YES), or not switched (DIAL=NO, or omit
the parameter).
LNCTL= BSC
Required for BSC line. This parameter identifies the
line control protocol as either BSC or start-stop
(asynchronous). RJE/XL uses BSC lines.
LINE Macro
The LINE macro parameters are described below.
LINE Required. One LINE macro must be included for each line
attached to the communications controller.
ADDRESS= (lnaddr, subchaddr1)
Required. For the line being defined by this LINE
macro, this parameter identifies the line interface
address and the corresponding subchannel address. For
information on addressing requirements and restrictions,
refer to the controller manuals listed under "Host
System Generation Considerations."
SPEED= rate
Required. This parameter identifies the data transfer
rate, in bits per second, for the line being defined.
If all the lines in the group have the same speed, this
parameter may be defined under the GROUP macro.
AUTO= address
This parameter is required if the line being defined has
the automatic call facility. address identifies the
automatic calling unit (ACU) interface address.
NOTE Each of the remaining parameters defined for the LINE macro may
instead be defined under the GROUP macro if the parameter value is
the same for all lines in the group.
BUFSIZE= n
For a BSC line, n identifies the size of the emulation
mode buffers. It also identifies the amount of data (up
to 32 bytes) transferred between the communications
controller and the host processor over the channel
connection (3705 type 3 scanner only). Values you may
specify for n (in bytes) are:
4, 8, 16, 32, 64, 96, 128, 160, 192, or 224
For n>32, the channel transfer is still 32 bytes.
CHNPRI= NORMAL
Recommended default. Unless the line being defined is
to operate at a data rate of 19.2 Kbps or higher and the
majority of the other lines operate at 2400 bps of
lower. This parameter identifies the relative priority
of the subchannel for this line to the other subchannels
used by the emulation program. If the data rate
difference exists, specify CHNPRI=HIGH.
CLOCKNG= EXT
Recommended default for BSC line. This parameter
identifies the source of clocking for the line being
defined. EXT indicates that the modem is the clocking
source. Specifying CLOCKNG=INT, indicates that the
scanner provides clocking.
CODE= EBCDIC
Required for communications with RJE/XL. This parameter
identifies the transmission line code as EBCDIC.
CSPMODE= [EM]ULATE
[NO]RMAL
For the IBM 3725 only. This parameter is for
start-stop and BSC lines in emulation mode only. Use
CSPMODE=EMULATE or EM for start-stop lines. If you omit
CSPMODE, EMULATE is the default for start-stop lines.
NORMAL or NO is the default for BSC lines. This must be
coded appropriately if BUFSIZE is used.
CU= 2701
2702
2703
This parameter identifies the transmission control unit
that is being emulated by the EP. The default value is
2703.
DATRATE= LOW
HIGH
If you have a dual-rate modem, use this parameter to
specify which rate applies to this line. Omit this
parameter if this line is using a single data rate
modem.
DISABLE= NO
YES
This parameter applies to modems that require a long
disable timeout when disconnecting from the line.
Specifying YES causes a timeout value of 25.6 seconds.
For most modems, specify NO (default value), or omit the
parameter.
DUPLEX= FULL
HALF
Required. This parameter must match the type of modem
and line you are using. This should also match the
corresponding RJE/XL configuration file element.
INTPRI= 0
1
2
3
This parameter identifies the relative interrupt
priority for this line, with 3 being the highest (the
default value is 1). Lines with higher data rates
should have higher relative priorities. A method for
determining interrupt priorities can be found in IBM
3704 and 3705 Control Program Generation Utilities Guide
and Reference Manual. This parameter is not used with
the IBM 3725.
MODEM= OPTION1
OPTION2
NTT
This parameter indicates when and how the communication
line is enabled. The default value (OPTION2) indicates
that the line is disabled after the controller has been
loaded (IPL) or the command from the access method. For
information on the other options, refer to the
controller manuals listed under "Host System Generation
Considerations."
PAD= YES
NO
This parameter applies to emulation of an IBM 2703
Transmission Controller only. A YES value (default
value) indicates that the communications controller is
to verify that the first four bits of trailing PAD
characters received from the line are all 1s.
QUIET= NO
YES
This parameter indicates which line quiet timeout period
is to be used by the emulation program. A YES value
indicates that the long timeout period of 25.6 seconds
is to be used. A NO value (default value) is
recommended and indicates that the normal timeout of 3
seconds is to be used.
RING= NO
YES
This parameter applies to some modems used outside the
U.S. and Canada and to switched lines only. It
indicates if the modem used for this line has the ring
indicator interface lead. A NO value (default value)
indicates that the modem does not have this lead.
TERM= 2780
Required. Only 2780 may be used as the type of
workstation. TERM=3780 is only valid when operating in
NCP mode.
GENEND Macro
The GENEND macro parameters are described below.
GENEND This macro is required for control program generation.
[HSPDSEL= ([msk1 ],...,[msk4 ])
This parameter applies to 3705 type 3 scanners only.
mskn are eight bit masks used to identify the high speed
lines. These lines are identified to increase the
amount of scanning they receive. Refer to the IBM 3704
and 3705 Control Program Generation and Utilities Guide
and Reference Manual for the effects of the different
bit patterns. This parameter is not used with the IBM
3725.
Example Partial IBM 3705 Generation
This configuration would be used under an OS operating system on a 3705-2
communications controller emulating a 2701 control unit. The type 3
communications scanner being used is located in the 3705 base module.
Its three oscillators have bit rates of 150, 600, and 1200. The group of
lines being defined are leased BSC lines. One of the lines (address= hex
020, subchannel address= hex AC) has a data rate of 19.2 Kbps. It is a
half duplex line transmitting and receiving EBCDIC code with an IBM 2780
terminal, or terminal emulator.
BUILD MODEL=3705-2,CA=TYPE4,LOCHAN=80,HICHAN=FF,
DYNADMP=YES,NSC,LINETRC=YES,TEST=YES,NEWNAME=EP001
****************************************************
CSB MOD=0,TYPE=TYPE3,WRAPLN=020,SPEED=(150,600,1200)
****************************************************
GROUP DIAL=NO,LNCTL=BSC,CU=2701
****************************************************
LINE ADDRESS=(020,AC),SPEED=19200,CLOCKNG=EXT,
CODE=EBCDIC,DUPLEX=HALF,TERM=2780
.
.
. [repeats for each line]
.
****************************************************
GENEND HSPDSEL=(10000000)
GENEND END
Example Partial IBM 3725 Generation
The following example is a partial IBM 3725 generation.
BUILD MODEL=3725,CA=TYPE5,LOCHAN=020,HICHAN=02B,
DYNADMP=NO,LINETRC=(YES,4,4),TEST=YES,
NEWNAME=PEP001
****************************************************
GROUP CU=2701,TERM=2780,LNCTL=BSC,PAD=NO,CLOCKNG=
EXT,CODE=EBCDIC,TYP=EP,DUPLEX=FULL,DIAL=NO
****************************************************
LINE ADDRESS=(00,20-0)SPEED=19200
.
. [repeats for each line]
.
.
****************************************************