HPlogo HP SNA Products Remote System Configuration Guide: HP 3000 MPE/iX Computer Systems > Chapter 1 ACF/NCP and ACF/VTAM Configuration

Parameter Descriptions

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 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

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.

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.

GROUP

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.

LINE

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.

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 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

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

X25.VC

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.

X25.LINE

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.

X25.PU

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

X25.LU

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

VBUILD

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

PU

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

PATH

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

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 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

 

Feedback to webmaster