 |
» |
|
|
|
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. 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.
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
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 faddress 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
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.
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
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
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. - lunameLU
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. |  |  |  |  |
This macro specifies certain common characteristics and functions
for a group of links and devices. - COMPSWP=NO
COMPSWP=YES
Specifies whether the control block structure
used in 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 DIAL=YES
Specifies whether the lines in the group require
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, PERIPHERAL) ECLTYPE=(LOGICAL,
PERHIPHERAL
Specifies whether this
GROUP definition statement defines a physical or a
logical connection to the token ring. At least one physical connection must be 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.
This macro defines a communications link to the host. - ADAPTER=TIC1 ADAPTER=TIC2
Specifies which type of token-ring adapter (type
1 or 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 4000
abbbbbbb, 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
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. |  |  |  |  |
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
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
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 VCCIND 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
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
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.
- 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
The X25.VC macro causes a LINE, a PU, and LU macros to be generated
for each logical channel defined in the LCN operand. - LCN
Specifies the logical channel number used by the
virtual circuits. If LCNO=USED is specified in
the X25.MCH statement, then LCN=0 must be
used.
Default: None
Range: 0-
255 (Note that some networks do not use the value
0). - TYPE
Specifies whether this X25.VC statement defines
a switched virtual circuit (SVC) or a permanent virtual circuit
(PVC). Code TYPE=SWITCHED to
define an SVC. If you code this value, you must also code the
OUFIND keyword, which points to the X25.OUFT entry that
name the facility set you wish to use for this line. Code TYPE=PERMANENT to
define a PVC. If you code this value, you must also code the
LLC keyword, which specifies the type of PVC being
defined. Default: None Range: SWITCHED, PERMANENT - OUFINDX
Specifies the index value of the entry in the
Optional Facility Set Table that creates the facility field and the
end of the CUD field in the Call request packet. This keyword must
be specified if TYPE=SWITCHED. This value must
correlate to the value of the appropriate
INDEX keyword of the X25.OUFT statement. - VCCINDX
Specifies the X25.VCCPT statement that describes
the connection parameters to be used by this virtual circuit. This
value must match the X25.VCCPT index value of the table with the
desired connection parameters.
Default: N/A
Range: 1-99 - CALL
Specifies whether an SVC is established through
an incoming request or an outgoing request, or through either type
of request.
CALL=IN specifies that the
SVC is to be established at the request of a remote DTE.
CALL=OUT specifies that
the SVC is to be established at the request of the host.
CALL=INOUT specifies that
the SVC can be established by either method.
Default:
IN
Range: OUT, IN, INOUT - COMMITO
Specifies the time interval that X.25 NPSI waits
before decommitting buffers that were committed to this virtual
circuit.
Default: 4
Range: 1, 2, 4, 8 (coded in seconds) - ISTATUS
Specifies the value of this keyword is used in
the NCP LINE statement generated by X.25 NPSI.
Default: None
Range: ACTIVE,
INACTIVE - NCPGRP
Specifies the label of the NCP GROUP statement
that includes this virtual circuit. If you specify
NEW, or do not specify this keyword, the label is
generated by NDF.
Default: NEW
Range: N/A - OWNER
Passes the OWNER parameter to the NCP LINE
statement generated by this X25.VC statement.
Default: N/A
Range: N/A - RETVCCT
Specifies how many times a physical services
command is to be retransmitted. This keyword is used for virtual
circuits connected to SNA DTEs.
Default:
3
Range: 0-255 - RETVCTO
Specifies the time interval between
retransmissions of physical services commands. This keyword is only
valid when the virtual circuit is associated with a DTE. Note that
for an IBM 3710, you should configure a value greater than the time
needed to perform recovery for a downstream device.
Default: 30
Range: 0-255 - SPAN
Specifies the access that the NetView operator
has to this virtual circuit. Refer to the appropriate NetView
documentation for more information. - STATOPT
Used by the NetView program. Refer to the
appropriate NetView documentation for more information.
The X25.LINE macro can be used to specify each virtual circuit
within a logical channel group within an MCH. Each X25.LINE macro
allows the user to describe his own PU and LU characteristics using
the X25.PU and X25.LU macros. - LCN
Specifies the logical channel number used by the
virtual circuits being defined. If LCNO=USED
is specified in the X25.MCH statement, then
LCN=0 must be coded. Default: None Range: 0-255
(Note that some networks do not use the value 0). - TYPE
Specifies whether this X25.LINE statement
defines a switched virtual circuit (SVC) or a permanent virtual
circuit (PVC). Code TYPE=SWITCHED to
define an SVC. If you code this value, you must also code the
OUFIND keyword, which points to the X25.OUFT entry that
name the facility set you wish to use for this line. Code TYPE=PERMANENT to
define a PVC. If you code this value, you must also code the LLC keyword, which specifies the type of PVC being
defined. Default: None Range: SWITCHED, PERMANENT - OUFINDX
Specifies the index value of the entry in the
Optional Facility Set Table that creates the facility field and the
end of the CUD field in the Call request packet. This keyword must
be specified if TYPE=SWITCHED. This value must
correlate to the value of the appropriate
INDE keyword of the X25.OUFT statement. - LLC
Specifies the type of permanent virtual circuit
defined. LLC=LLC3 means that the PVC is
attached to an SNA peripheral node. This keyword must be specified if
TYPE=PERMANENT. - VCCINDX
Specifies the X25.VCCPT statement that describes
the connection parameters that this virtual circuit uses. This value
must match the X25.VCCPT index value of the table with the desired
connection parameters.
Default: N/A
Range: 1-99 - CALL
Specifies whether an SVC is established through
an incoming request or an outgoing request, or through either type
of request.
CALL=IN specifies that the
SVC is to be established at the request of a remote DTE.
CALL=OUT specifies that
the SVC is to be established at the request of the host.
CALL=INOUT specifies that
the SVC can be established by either method.
Default:
IN
Range: OUT, IN, INOUT - DSTNODE
Specifies the type of destination node.
DSTNODE=BNN means that the
destination node is a boundary node, such as a cluster controller or
terminal.
DSTNODE=INN means that the
destination node is defined as an INN
node.
Default: BNN
Range: BNN, INN - COMMITO
Sets the time interval that X.25 NPSI waits
before decommitting buffers that were committed to this virtual
circuit.
Default: 4
Range: 1, 2, 4, 8 (coded in seconds) - ISTATUS
Specifies the value used in the NCP LINE
statement generated by X.25 NPSI. ISTATUS
controls whether the line automatically activates when the NCP is
started.
Default: None
Range: ACTIVE,
INACTIVE - NCPGRP
Specifies the label of the NCP GROUP statement
that includes this virtual circuit. If you specify
NEW, or do not specify this keyword, the label is
generated by NDF.
Default: NEW
Range: N/A - OWNER
Passes the OWNER parameter
to the NCP LINE statement generated by this X25.LINE statement. The
OWNER parameter is used to control the division of resources within
VTAM.
Default: N/A
Range: N/A - RETVCCT
Specifies how many times a physical services
command is retransmitted. This keyword is used for virtual circuits
connected to SNA DTEs.
Default:
3
Range: 0-255 - RETVCTO
Specifies the time interval between
retransmissions of physical services commands. This keyword is only
valid when the virtual circuit is associated with a DTE. Note that
for an IBM 3710, you should configure a value greater than the time
needed to perform recovery for a downstream device.
Default: 30
Range: 0-255 - SPAN
Specifies the access that the NetView operator
has to this virtual circuit. Refer to the appropriate NetView
documentation for more information. - STATOPT
Used by the NetView program. Refer to the
appropriate NetView documentation for more information.
The X25.PU macro defines a physical unit residing in an SNA DTE. - PUTYPE
Specifies the PU type of the DTE.
Default: None
Range: N/A - MAXDATA
Specifies the maximum bytes in a Path
Information Unit (PIU)
Default:
265 is the default for PU.T2
This statement is used to define an LU. - LOCADDR
Defines the local address of the LU. This value
must be coded in decimal with no leading zeros.
Default: None
This macro is coded
for all VTAM switched major nodes. One VBUILD macro must be included
in each VTAMLST member. The VBUILD macro must be placed before the
first PU macro. - TYPE
TYPE=SWNET defines a
switched major node to VTAM. VTAM parameter
The PU 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). - punamePU
A symbolic name for this PU. The PU name consists
of one to eight characters; it must be unique throughout the
network. - 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 - 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 - DISCNT
Specifies that the PU-SSCP session is to
terminate after the last LU-LU session logs off. VTAM
parameter
Default: NO - ISTATUS
Specifies whether automatic activation of this
PU occurs when the NCP is started. VTAM parameter
Default: ACTIVE - MAXDATA
Specifies the maximum frame size (in bytes)
allowed in one data transfer on the link. For a PU type 2 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. 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) - MAXPATH
Specifies the maximum number of dial-out paths
to the PU. Specify 0 if only dial-in paths to
the PU are used. NCP parameter (switched
only)
Range: 0-256 - 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 - SRT
Specifies threshold values for the total number
of transmissions and the total number of error retries for this PU.
Default: (32768,32768)
Range: 1-32768
The PATH statement defines a dial-out path to a PU residing in a
switched major node. Up to 256 PATH statements may be defined for
each PU. - USE
Specifies to VTAM whether or not this path is
initially usable or not. The effect of this parameter is similar to
that of ISTATUS for a minor node.
Default: YES
Range: NO - DIALNO
DIALNO must be specified
for SVCs when CALL=OUT or
CALL=INOUT in the X25.LINE statement. It is coded in the
following format:
{HP X.25 net addr}{IBM X.25 net addr}{pi}{VCCINDX}{OUFINDX}
|
Each field is explained below: - HP X.25net addr
Specifies the HP X.25 Network Address.
Range: 1-15 characters - IBM X.25 net addr
Specifies the IBM X.25 Network Address.
IBM X.25 net addr
may be 15 characters long. HP requires that the IBM X.25 Network
Address be included in the DIALNO definition
because the X.25 Call Packet header is checked for the IBM address
when a call is received at the HP system. If the address is not
included in the packet header (because it was omitted in the
DIALNO definition) or if the address does not agree with
the remote address configured in the HP configuration, the call will
be rejected.
Range: 1-15 characters - pi
Specifies the protocol used over the
connection. If this value is coded, it must equal 3 for HP-IBM SNA
X.25 connections. The value 3 indicates that the protocol is LLC3
(QLLC). - VCCINDX
A 2-byte index that references an entry in
the X25.VCCPT macro. The VCCPT entries contain parameters that are
used when the X.25 connection is established. Range: 00-99 - OUFINDX
A 2-byte index that references an entry in the X25.OUFT macro. The OUFT entries define the X.25 user facility sets. Thus OUFINDX specifies the user facility set used when the host dials out to the HP 3000. Range: 00-99 - GRPNM
Specifies the symbolic name of a GROUP statement
in an NCP major node that defines a group of SDLC switched links.
The group referenced must have all the characteristics necessary to
handle the telephone number, and must be compatible with the type of
physical unit. - PID
Specifies the path being defined. This identifier is unique for a given PU. Range: 0-255
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 one-to-eight character symbolic name for this LU, which is 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. NCP parameter Range: 1-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 - 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 host and NCP. VTAM parameter Default: 1 Range: 0-63 - USSTAB
Specifies the unformatted system services (USS) table that VTAM uses to translate character-coded requests. VTAM parameter Default: IBM-supplied USS table, ISTINCDT
Logmode Table Parameter Descriptions |  |
- COMPROT
Specifies the common LU protocols to be used. Default: 0 Range: 0-FFFF - FMPROF
A hexadecimal value which represents the
function management profile. - logmode
Used as a key for the session parameters in this
table entry. Default: Blanks are substituted. - PSNDPAC
Specifies the primary send pacing count. Default: 0 Range: 0-3F - SSNDPAC
Specifies the secondary send pacing count. Default: 0 Range: 0-3F - SRCVPAC
Specifies the secondary receiving pacing count. Default: 0 Range: 0-3F - PRIPROT
Specifies the primary protocol for the LU. Default: 0 Range: 0-FF - PSERVIC
The LU presentation services profile. This
parameter is 12 bytes long and is broken down as follows:
PSERVIC=X'xx......................'
(PS Profile - LU Type) 1 byte
PSERVIC=X'..xxxxxxxxxx............'
(PS Usage - Presentation Services Characteristics) 5 bytes
PSERVIC=X'............xxxx........'
(PS Usage - Default Screen Size) 2 bytes
PSERVIC=X'................xxxx....'
(PS Usage - Alternate Screen Size) 2 bytes
PSERVIC=X'....................xx..'
(PS Usage - Screen Selection) 1 byte
PSERVIC=X'......................xx'
(Cryptography Options)
Default: 000000000000000000000000 Range: 0-FFFFF...FF 24 places - RUSIZES
This is a hexadecimal value, in the format 'abcd', where '2b * a' equals the inbound to host RU size in bytes, and '2d * c' equals the outbound from host RU size, in bytes. Possible values are shown in table 1-25. To use the table, locate the desired RU size in table 1-25. The values of the Ax columns and Bx rows determine the first and second hexadecimal values for the RU size. For example, an
inbound RU size of 256 has Ax and Bx values of '8' and '5', respectively, or a hexadecimal value of '85'. Therefore, an inbound/outbound RU size of 256 is '8585'. - SECPROT
Specifies the secondary protocol for the LU. Default: 0 Range: 0-FF - TSPROF
A hexadecimal value which represents the transmission services profile. Default: 0 Range: 0-FF
Table 1-25 RUSIZES Values in BIND
|