HP 3000 Manuals HP 3000 Manuals
Parameter Descriptions
ACF/NCP and ACF/VTAM Macro and Operands Descriptions
This section describes the ACF/NCP and ACF/VTAM operands for the
LUDRPOOL, GROUP, LINE, SERVICE, VBUILD, PU, and LU macros. This section
contains generic descriptions of the macros and operands. Refer to the
tables earlier in this chapter for operand values that are specific to
the configuration of the HP SNA products. See the NCP or VTAM manual for
the remote system for a more thorough explanation of the parameters and
their values.
The GROUP macro can contain all of the operands of the LINE, PU, and LU
macros that are allowed to be defined at a higher level. This results in
a "shift-down" effect of these operands to the LINE, PU, and LU macros
defined below it. The operands could have also been defined on the
lowest level macro allowed. The resulting VTAM/NCP configuration is
identical using either method. The placement of operands in higher level
macros saves time and space when trying to determine which operands
affect which macros.
LUDRPOOL.
This macro defines a pool of LU control blocks for switched lines.
NUMTYP2 Specifies the number of LUs to be included in the
LU pool for type 2 PUs.
GROUP.
This macro specifies certain common characteristics and functions for a
group of links and devices.
DIAL Specifies whether switched or nonswitched protocols
are invoked. NCP parameter
Default: NO
Range: YES,NO
LNCTL Indicates the line control protocol used. NCP
parameter
Default: SDLC if LNCTL=SDLC is specified in a
preceding GROUP macro
Range: SS,BSC,SDLC
REPLYTO Specifies the response time-out value for all the
lines in the group. If no response is received
from the station by the time specified, a time-out
error is indicated and NCP makes no further attempt
to communicate. NCP parameter
Default: 1.0
Range: 0-1632
__________________________________________________
NOTE Network delays must be considered when
specifying REPLYTO.
__________________________________________________
TEXTTO Specifies the time-out value between characters in
a message. If the time between characters exceeds
this value, the NCP ends the read or write
operation with a text time-out error. NCP
parameter
Default: 3.0
Range: 0-1632
TYPE Specifies the mode in which the lines in the group
operate. NCP parameter
Default: NCP
Range: EP,NCP,PEP
LINE.
This macro defines a communications link to the host.
ADDRESS Specifies the physical location of the line
interface hardware on the line interface base (LIB)
and the type of scanner. For SDLC links, line
address is the communications controller address to
which the line is attached. NCP parameter
Range: 0-255
SPEED Specifies the data rate in bits per second. NCP
parameter
Range: 0-56000
CALL Specifies whether the line is to be used for
incoming (to the host) calls, outgoing (from the
host) calls, or both incoming and outgoing calls.
VTAM parameter (switched only)
Default: IN
Range: IN,OUT,INOUT
CLOCKNG Specifies the device that provides clocking for the
line. NCP parameter
Default: EXT
Range: INT, EXT
DATRATE Specifies the high or low rate for a dual-rate
modem. This operand must not be coded for modems
that have only one data rate. NCP parameter
Default: LOW
Range: HIGH,LOW
DUPLEX Specifies the type of communication facility
constituted by the communication line and modem.
NCP parameter
Default: HALF
Range: FULL,HALF
ETRATIO Specifies the error-to-transmission ratio for
programs that analyze statistical maintenance
records. NCP parameter
Default: 30
Range: 1-255
HDXSP Specifies whether the NCP has priority over polling
when sending data. NCP parameter
Default: NO
Range: YES,NO
LPDATS Specifies whether modems support LPDA commands.
NCP parameter
Default: NO
Range: YES,LPDAT1,[LPDATA1,3867],LPDA2
MAXPU Specifies the maximum number of PUs that may be
defined on this line. Value must be at least equal
to the number of PUs defined. Coding this operand
is not necessary unless dynamic reconfiguration is
used. NCP parameter
Default: The number of PUs defined.
Range: 1-255
NRZI Specifies whether equipment at the end of the SDLC
link operates in Non-Return-to-Zero-Inverted mode.
NCP parameter
Default: YES
Range: YES,NO
PAUSE Specifies the average duration of the polling
cycle. NCP & VTAM parameter
Default: .2,2.8
POLLED POLLED=YES is required for a PU type 2 for ACF/NCP
version 1 release 2.1 and earlier releases. The
operand is invalid for an SDLC line for ACF/NCP
version 1 release 3, and later releases. NCP
parameter
Default: See the NCP manual for the release.
RETRIES Specifies the number of times to retransmit a
frame. NCP parameter
Default: 7
Range: See the NCP manual for the remote system.
RING Not applicable in the U.S. and Canada. See the NCP
installation manual for the remote system for
details. NCP parameter (switched only)
Default: NO
Range: YES,NO
SERVLIM Specifies the maximum number of scans of the
service order table. NCP parameter (non-switched
only)
Default: 4
Range: 1-255
SPDSEL Specifies whether VTAM is allowed to change the
data rate of the modem. SPDSEL=YES is valid only
if CLOCKNG=EXT. NCP parameter
Default: NO
Range: YES,NO
TRANSFR See the ACF/NCP installation manual for the remote
system for restrictions. NCP parameter
OWNER Used for the division of resources within VTAM. See
the NCP/VTAM manual for the remote system. VTAM
parameter
SERVICE.
This macro creates a service order table for non-switched lines. Service
order refers to the order in which devices on the line are serviced by
the scanner. The SERVICE macro is invalid for switched lines.
ORDER Each entry is the name of a station (the label of
the PU macro).
MAXLIST The value of MAXLIST specifies the maximum number
of table entries. The default is the number of
entries specified with the ORDER operand.
VBUILD.
This macro is coded for all VTAM switched major nodes. One VBUILD macro
must be included in each VTAMLST member that defines a switched major
node. The VBUILD macro must be placed before the first PU macro.
TYPE TYPE=SWNET defines a switched major node to VTAM.
VTAM parameter
PU.
This macro defines variables associated with data link control, such as
the station address and link buffer size, and other variables, such as
initial status and Exchange ID (XID).
puname PU A symbolic name for this PU. The PU name consists
of one to eight characters; it must be unique
throughout the network.
ADDR Specifies the hexadecimal representation of the
address (STATION ID) of the secondary SDLC device.
On a switched line, this operand must appear in the
member in which the VBUILD macro is defined. NCP
and VTAM parameter (non-switched only)
Range: 01-FE
IDBLK Specifies the hexadecimal value given to a specific
device type. This value is part of the network
address assigned to this station. VTAM parameter
(switched only)
IDNUM Specifies the hexadecimal number assigned to this
station. The combination of IDBLK and IDNUM must
form a network unique station identifier. VTAM
parameter (switched only)
Range: 00000-FFFFF
ANS Specifies whether the station stops or continues
when the ACF/NCP goes into automatic network
shutdown. NCP parameter
Default: STOP
Range: STOP,CONTINUE,CONT
DISCNT Specifies that the PU-SSCP session is to terminate
after the last LU-LU session logs off. VTAM
parameter
Default: NO
Range: YES, NO
ISTATUS Specifies whether automatic activation of this PU
occurs when ACF/VTAM is started. VTAM parameter
Default: ACTIVE
Range: ACTIVE, INACTIVE
IRETRY Specifies whether the NCP services the next device
polled or immediately retries when an idle-detect
time-out condition follows a polling operation.
NCP parameter
Default: NO
Range: YES, NO
MAXDATA Specifies the maximum frame size (in bytes) allowed
in one data transfer on the link. For a type 2.0
and type 2.1 node, this includes 3 bytes for the
RH, and 6 bytes for the TH. This value depends on
the network card installed on the HP system. For
NCP version 5, release 2 and later releases, the
MAXDATA parameter does not need to be coded for PU
2.1 nodes. NCP parameter (non-switched only)
Range: 0-65535
MAXLU Specifies the maximum number of LUs that may be
associated with this PU. Default is the value of
MAXLU operand of the PUDRPOOL or the number of LUs
defined for this PU, whichever is greater. NCP
parameter (for switched lines and dynamic
reconfiguration only)
MAXOUT Specifies the maximum number of frames the NCP
sends to this PU before requesting a response. NCP
parameter (non-switched only)
Range: 1-7
PASSLIM Specifies the maximum number of PIUs sent from the
host to a PU before the host services another PU.
NCP parameter (non-switched only)
Default: 1
Range: 1-254
PUTYPE Specifies the physical unit type of this PU. NCP
parameter
RETRIES Specifies the number of attempts to recover. NCP
parameter (non-switched only)
Default: 7
Range: See the NCP manual for the remote system.
SRT Specifies threshold values for the total number of
transmissions and the total number of error retries
for this PU. NCP parameter
Default: (32768,32768)
Range: 1-32768
XID Specifies whether or not the host sends an XID to
the remote PU. For type 2.1 node operation, XID
must be set to YES. NCP parameter
Range: YES, NO
LU.
There must be an LU definition for each LU associated with a PU. An LU
macro must be coded for each IBM 3270 emulation device attached to an IBM
3270 service. For example, emulation of an IBM 3274 cluster controller
with three IBM 3278 keyboard/displays and one IBM 3286 printer requires
four separate LU macro statements.
luname LU A symbolic name for this LU. The name consists of
one to eight characters and must be unique
throughout the network. luname is used by
application subsystems, such as CICS, to specify a
particular LU.
LOCADDR Specifies the local address of the LU. This value
should be set to 0 for independent LUs. NCP
parameter
Range: 0-255
BATCH Specifies the priority of the LU. A value of NO
specifies a high priority (appropriate for
interactive sessions). A value of YES specifies a
low priority (appropriate for batch sessions).
Note that this parameter is not supported on
ACF/NCP version 5 or later. NCP parameter
Default: NO
Range: YES,NO
DLOGMOD Specifies the name of the logmode table entry that
corresponds to the LU you are configuring. Refer
to "Logmode Table Definitions" in this section.
VTAM parameter
Default: First entry in the logmode table
ISTATUS Specifies whether this LU is automatically
activated when the major node it is associated with
is started. VTAM parameter
Default: ACTIVE
Range: ACTIVE,INACTIVE
LOGAPPL Specifies the application program that the terminal
is automatically logged on to when activated. The
program name is from one to eight alphanumeric
characters. VTAM parameter
MODTAB Specifies the name of the logmode table that
contains the LU's logmode entry. Refer to "Logmode
Table Definitions" in this section. VTAM parameter
Default: IBM supplied table, ISTINCLM
PACING Specifies two values, represented by m and n. The
value m specifies in which segment the pacing
indicator (PI) is to be turned on. The value n
specifies the number of PIUs or PIU segments that
can be sent before waiting for a pacing response.
NCP parameter
Default: (1,1)
Range: 0-255
SSCPFM Specifies whether an LU can support character-coded
messages, or only formatted commands for
communication with the SSCP. VTAM parameter
Default: FSS
Range: FSS,USSSCS
VPACING Specifies pacing between NCP and host on a specific
LU-LU session. VTAM parameter
Default: 1
Range: 0-63
USSTAB Specifies the unformatted system services (USS)
table that VTAM uses to translate character-coded
requests. This parameter must be specified only at
the LU macro level. VTAM parameter
Default: an IBM USS table, ISTINCDT, is searched
NTRI Macro and Operand Descriptions
This section describes the NCP macros and operands listed in the
preceding tables for NTRI configuration. This section contains generic
descriptions of NCP macros and operands required for NTRI. Refer to the
tables earlier in this chapter for operand values that are specific to
the configuration of HP SNA products. See the Network Control Program
Resource Definition documentation for the remote system for a more
thorough explanation of the parameters and their values.
NOTE NTRI is not supported with any MPE/V SNA products.
GROUP.
This macro specifies certain common characteristics and functions for a
group of links and devices.
COMPSWP=NO Specifies whether the control block structure used in
COMPSWP=YES user-written line control, user-written code, or IBM
special products is compatible with the NCP control
block structure. Compatible control block structure
allows port swapping of the lines that are controlled
by IBM special products or user-written code. For
NCP version 5, release 2.1 and earlier, COMPSWP=NO
should be specified for NTRI resources.
Default: COMPSWP=NO
DIAL=NO Specifies whether the lines in the group require
DIAL=YES switched line control procedures. For generation of
NTRI physical connections, DIAL=NO must be
specified. For generation of NTRI logical
connections, DIAL=YES must be specified.
ECLTYPE=(PHYSICAL, Specifies whether this GROUP definition statement
PERIPHERAL) defines a physical or a logical connection to the
ECLTYPE=(LOGICAL, token ring. At least one physical connection must be
PERHIPHERAL coded in a GROUP definition statement to define the
token-ring interface coupler (TIC). At least one
logical connection must be coded in a GROUP
definition statement to define the devices attached
to the token ring.
LNCTL=SDLC Specifies the line control for lines in the group.
Range: SS, BSC, SDLC, CA, USER
PHYPORT=n Specifies the physical port address or TIC with which
the logical lines in the group communicate. The
value must match the value coded for PORTADD in the
LINE definition.
Range: 0-99
TYPE=NCP Specifies that lines in the group operate in network
control mode. TYPE=NCP must be specified to include
NTRI resources in the generation.
LINE.
This macro defines a communications link to the host.
ADAPTER=TIC1 Specifies which type of token-ring adapter (type 1 or
ADAPTER=TIC2 type 2) is attached to the NTRI physical line.
Default: TIC1
ADDRESS=lnbr, FULL Specifies the relative line number and data transfer
mode for the line represented by the LINE definition.
For NTRI physical line definition, FULL must be
specified.
LOCADD=n Specifies the locally-administered address for the
TIC. LOCADD is required for physical line
definition. The format for n is 4000abbbbbbb, where
a is a number between 0-7 and b is a number between
0-9.
PORTADD=n User-assigned value that associates an NTRI physical
line with its corresponding logical line. The same
value must be specified for PHYPORT in the logical
line definition.
RCVBUFC Specifies the NTRI buffer.
Default: 1440