Parameter Descriptions (contd) [ HP SNA Products Remote System Configuration Guide ] MPE/iX 5.0 Documentation
HP SNA Products Remote System Configuration Guide
Parameter Descriptions (contd)
NPSI Macro and Operand Descriptions
This section describes the NPSI macros and operands listed in the
preceding tables. This section contains generic descriptions of NPSI
macros and operands. Refer to the tables earlier in this chapter for
operand values that are specific to the configuration of HP SNA products.
See the X.25 Network Control Program Packet Switching Interface manual
for the remote system for a more thorough explanation of the parameters
and their values.
NOTE NPSI is not supported with any MPE/V SNA products.
BUILD.
The BUILD macro starts the generation process of control blocks,
including those for X.25.
NOTE The BUILD parameters listed in this chapter are additional
parameters required by X.25 NPSI. The list does not contain all
parameters necessary for a complete BUILD statement.
X25.MAXPIU Specifies the maximum inbound Path Information Unit
(PIU) length. Can be coded in bytes or kilobytes.
Default: 64K
Range: (in kilobytes) 2K-64K, (in bytes)
1296-65535
X25.MWINDOW Specifies the frame window size used by Link Access
Protocol Balanced (LAPB).
Default: None
Range: (decimal) 1-7
X25.PREFIX Specifies the first letter that will be used for X.25
NPSI default resource names.
Default: X
Range: A-X
X25.SNAP Specifies whether the SNAP trace facility is turned
on during system generation.
Default: NO
Range: YES, NO
X25.USGTIER Specifies the usage tier of the operations of the
X.25 NPSI level module. Value must be less than or
equal to the usage tier installed with the remote
system. Refer to the IBM licensing agreement to
determine the usage tier installed.
Default: 1
Range: (decimal) 1-5
X25.NET.
The X25.NET statement describes a Packet Switched Data Network. Each
PSDN connected to the host must be described by a separate X25.NET
statement. Up to nine X25.NET statements may be specified.
DM Specifies whether the Packet Switched Data Network
(PSDN) receives or sends the LAPB DM command. Note
that the DM command is not supported by all PSDNs.
Default: None
Range: YES, NO
CPHINDX Specifies the highest index value coded for the
X25.VCCPT statements in this NPSI generation.
Default: 1
Range: 1-99
NETTYPE Specifies the network type in terms of the RESET
commands that are exchanged.
NETTYPE=1. When X.25 NPSI receives a RESET 07, it
stops sending physical services commands to the
remote DTE until it receives a RESET 00, 09, or 0F.
NETTYPE=3. When X.25 NPSI receives a RESET 07, it
continues sending physical services commands to the
remote DTE, because a network defined as type 3
(DDX-P) does not compensate a RESET 07 by a RESET
09.
Default: 1
Range: 1, 3
OUHINDX Specifies the highest index value coded for any
X25.OUFT statement within this NPSI generation.
Default: 1
Range: 01-99
X25.VCCPT.
The X25.VCCPT statement defines the connection parameters for one or more
virtual circuits. One statement is required for each entry in the
virtual circuit connection parameter table. Up to 99 can be coded.
INDEX Specifies an index number to an entry in the
Virtual Circuit Connection Parameter Table. Must
correlate to the VCCINDX keyword of the X25.LINE
statement.
Default: None
Range: 1-99
MAXPKL Specifies the maximum length of the data in the
packets to be sent or received over the virtual
circuits associated with this X25.VCCPT entry.
Default: None
Range: 32, 64, 128, 256, 512, 1024, 2048, 4096
INSLOW Specifies the percentage of free buffers that must
be used before entering unsafe or danger conditions
for the virtual circuits associated with this VCCPT
entry. When this keyword is coded, two percentages
must be supplied, separated by a comma.
Percentage 1--the unsafe percentage
Percentage 2--the danger percentage
These values are not absolute; they are defined in
relation to the value of the NCP SLODOWN keyword.
For example, coding INSLOW=(12,6) means that the
unsafe buffer use level is 12 percent higher than
the value of SLODOWN and the danger buffer use
level is 6 percent higher than the value of
SLODOWN. The unsafe percentage must be greater than
the danger percentage.
Default: (50,12)
Range: 0, 6, 12, 25, 50, 100
VWINDOW Specifies the size of the transmit or receive
window for the virtual circuits indexed to this
VCCPT entry. The value specified must be less than
the packet modulo value defined in the X25.MCH
statement.
Default: 2
Range: 1-127
X25.OUFT.
The X25.OUFT statement specifies the user facilities and call user data
that will be included in the Call Request Packet for an outgoing call.
No X25.OUFT statement is required for Permanent Virtual Circuits. At
least one X25.OUFT statement is required for each NPSI generation that
defines Switched Virtual Circuits.
INDEX Identifies the entry in the optional user
facilities table. This index number is used in the
TYPE keyword of the X25.LINE statement to reference
the facility set to be used on the line.
Default: None
Range: 1-99
X25.MCH.
The X25.MCH statement describes a physical circuit (serving one or more
virtual circuits) to X.25 NPSI.
ADDRESS Specifies the full duplex line interface address.
Code one to three decimal digits.
Default: N/A
Range: 0-63 (for 3720), 0-511 (for 3745)
FRMLGTH IBM requires that the value specified for FRMLGTH
equal the MAXPKL (see X25.VCCPT macro) size plus 3
bytes for the modulo 8 X.25 packet header. (HP
supports modulo 8 only). IBM's FRMLGTH does not
equal the X.25 N1 parameter divided by 8.
Note that this value will not be the same as the
Frame Size value in the HP DTC configuration. HP
DTC configuration interprets Frame Size to equal
the value of the X.25 N1 parameter divided by 8,
which is the sum of the data packet size plus 3
bytes for the packet header and 4 bytes for the
LAP-B header and LAP-B trailer.
HP's Frame Size value reflects the maximum frame
length in bytes flowing over the physical circuit.
Default: None
Range: 35-4100
LCGDEF Specifies the highest logical channel number for
each logical channel group defined. Values are
defined in pairs, as follows:
LCG--specifies the number of the LCG
LCGI--specifies the highest number for that LCG
Default: N/A
Range: Refer to LCGN operand of the X25.LCG
statement
MWINDOW Specifies the frame window size to be used by X.25
link access protocol level 2.
Default: None
Range: 1-7
ANS Specifies whether the station is to stop or
continue when ACF/NCP goes into automatic network
shutdown.
Default: None
Range: [CONT]INUE, STOP
CONNECT Specifies whether X.25 NPSI fast connect is to be
used on this physical circuit.
Default: NO
Range: YES, NO, CUD0, SUBD
DBIT Specifies whether the deliver confirmation bit
should be used. Used for non-SNA DTEs.
Default: NO
Range: YES, NO
DIRECT Specifies whether the physical circuit described by
this MCH is directly attached to a communications
controller, or a peripheral node.
Default: NO
Range: YES, NO
DSABLTO Specifies the delay during which the DTE expects
DSR to be dropped after the disable command is
issued.
Default: 3.0 seconds
Range: 0.1-1632.0 seconds (specified in tenths of
a second)
ENABLTO Specifies the maximum delay during which the DTE
expects the DSR signal to come up after the enable
command is issued.
Default: 3.0 seconds
Range: 0.1-1632.0 seconds (specified in tenths of
a second)
GATE Specifies whether the physical circuit supports
General Access to X.25 Transport Extended (GATE),
or Dedicated Access to X.25 Transport Extended
(DATE).
Default: NO
Range: NO, DEDICAT GENERAL
SUBADDR Specifies whether the incoming call packets use
subaddressing to select LLC types.
Code SUBADDR=YES to select subaddressing. If YES
is coded, you must also specify the subaddresses by
coding the LLC3 keyword, explained below.
Code SUBADDR=NO for no subaddressing. Specifies
that subaddressing is not used.
Default: NO
Range: YES, NO
LLC3 Specifies the value of the subaddress field of the
Incoming Call packets for SNA peripheral nodes
communicating with the BNN QLLC protocol. This
keyword must be coded if SUBADDR=YES.
Range: 0-9
ISTATUS Specifies whether the NPSI physical circuit, LU,
and PU will automatically activate when the NCP is
activated.
Default: None
Range: ACTIVE, INACTIVE
ITRACE Specifies whether the Link Access Protocol (LAP)
internal trace facility is to be performed on this
physical circuit.
Default: YES
Range: YES, NO
LCN0 Specifies whether logical channel 0 of logical
group 0 is used to designate a virtual circuit. If
you specify USED (the default), LCN=0 must be
coded in a subsequent X25.LINE or X25.VC statement.
Default: USED
Range: USED, NOTUSED
LLCLIST Specifies the types of SVCs that are supported.
LLCLIST must be coded if SVCs are to be configured
on this physical circuit. LLCLIST can be coded
with multiple values separated by commas, as in
LLCLIST=(LLC0,LLC3,LLC4). The value LLC3 signifies
that multiple SVCs can connect to an SNA peripheral
node using the QLLC protocol.
Default: None
Range: LLC0, LLC2, LLC3, LLC4, LLC5
NCPGRP Specifies the label of the NCP GROUP statement that
includes this physical circuit. Omitting this
keyword, or specifying NEW causes a label to be
created by X.25 NPSI. If you specify a label, an
NCP GROUP statement is generated with a name
matching the label.
Default: NEW
Range: label, NEW
NDRETRY Specifies how many times the NP/TP sequence is
executed.
Default: 1
Range: 1-3
NPRETRY Specifies the number of transmissions of an I or U
frame in a TP time out recovery.
Default: 7
Range: 3-31
OWNER Specifies the value of the OWNER parameter on the
NCP LINE statement generated by this X25.MCH
statement.
PAD Specifies how PAD-supported terminals are attached.
Default: NO
Range: INTEG, TRANSP, NO
PKTMODL Specifies the packet protocol modulo. You must
specify a value higher than the VWINDOW values
coded for the X25.VCCPT statements associated with
this MCH.
Default: 8
Range: 8, 128
PUNAME Specifies the PU name associated with this physical
circuit.
PWPROT Specifies whether the physical circuit supports
password protection for its associated virtual
circuits.
Default: NO
Range: YES, NO
SPAN Specifies restricted access to this MCH for NetView
operators. Refer to the appropriate NetView
documentation for more information.
SPEED Specifies the physical circuit's data rate in bits
per second.
Default: 9600
SPNQLLC Specifies whether an SDLC PAD is used to connect
this physical circuit.
Default: NO
Range: YES, NO
STATION Specifies whether the MCH operates as a DTE or a
DCE. The value DTE must be used to support a
normal connection to a network node.
Default: DTE
Range: DCE, DTE
STATOPT This keyword is used by Netview. Refer to the
appropriate NetView documentation for more
information.
T1TIMER Specifies how many seconds the DCE waits for frame
acknowledgment. Note that the value of 0 does not
allow for link-level piggybacking. Can be
specified in tenths of a second.
Default: 0
TDTIMER Specifies the value of the X.25 NPSI internal delay
timer between ND transmissions.
Default: 1
Range: 1, 2, 3
TPTIMER Specifies the value of the X.25 T1 timer. This
timer determines the maximum delay during which the
DTE expects the acknowledgment of a transmitted I
or U frame with or without the poll bit set, or of
a transmitted S frame with the poll bit set.
Default: 1.0 second
Range: 0.5-25.5 seconds (in .1 second
increments)
VMODTAB Specifies the name of the mode table for the
virtual circuit LUs defined in the X25.FCG
statements that correspond to this X25.MCH
statement.
X25.LCG.
LCGN Specifies the logical group number for all virtual
circuits specified by subsequent X25.VC or X25.LINE
statements. Code in decimal, in ascending order.
Default: None
Range: 0-15
MPE/iX 5.0 Documentation