Reference for Enterprise OS Software

SdlcAdjLinkSta

Syntax

: ADD !<port> -APPN SdlcAdjLinkSta <type>(NN|EN|Learn) <max_btu_size>(99-8912) <station addr>(Hex 1-FE) [CPName=<[netid.]cpname] [Nodeid=<ID>] [LinkName=<name>] [TGprof=<name>] [AutoStart=(Yes|No)] [CPSess=(Yes|No)] [HPR=(Yes|No)] [ErrorRecovery=(Yes|No)] [SendWindow=<num>] [ContactTimer=<num>] [NoRspTimer=<num>] [NoRspTimRetry=<num>]
: DElete !<port> -APPN SdlcAdjLinkSta <LinkName>
: SHow [!<port>] -APPN SdlcAdjLinkSta [LinkName]

Default

No default

Description

The SdlcAdjLinkSta parameter defines for SDLC traffic an adjacent link station as a destination and defines the type of node being linked to, the destination station address, and the node name associated with the link station. To send and receive SDLC traffic from an adjacent SDLC node, both partner nodes must configure each other as SDLC adjacent link stations using the SdlcAdjLinkSta parameter.

After the SDLC adjacent link station is activated, if the APPN node is active and you want to make any configuration changes using this parameter or the LinkStaCHar parameter, you must first deactivate the link using the LinkStaCONTrol parameter. If the APPN node is not active, you do not need to deactivate the link.

APPN over SDLC connections is supported on all types of HSS-3 Port Modules, including V.35, RS-232, and RS-449.

Values

NN|EN|Learn

Specifies whether the destination is a network node (NN) or an end node (EN). Specify Learn if you do not know the node type and all you know is the node's media address; if you specify Learn, do not specify a CP name.

<max_btu_size>

Enters the maximum number of bytes in a basic transmission unit (BTU) that can be sent to this destination. The acceptable range for network nodes is 99 to 8,912, while the acceptable range for end nodes is 256 to 8,912. If you set the type to Learn, do not set the value to less than 256, since you do not know if the node is a network node or an end node. If the learned node is an end node and you set the value to less than 256, the link may not come up.

<station addr>

Specifies the station address (or polling address) of the adjacent link station. Valid address values are Hex 01 through Hex FE.

CPName

Enters the control point name of the adjacent link station. If the net ID is different than the net ID of the local node specified using the LocalNodeName parameter, you can specify the net ID. If you enter the net ID, you must type a period immediately following it, then type the CP name immediately following the period to create the fully qualified CP name. The CP name can be up to eight characters in length, and valid characters are A-Z, 0-9, $, @, #. The name cannot start with a number, a space or a period. This value is optional.

Nodeid

Enters the eight-digit hex identification that is used to identify the node. This value is optional. The node ID corresponds to the IDNUM of the IBM node ID format IDBLK/IDNUM.

<LinkName>

Specifies the name assigned to the link. All link names must be unique on the local network node. For example, you cannot use the same link name on more than one port, and you cannot use the same link name for two types of links (such as for adjacent link stations or DLUr link stations) at the same time. The link name is limited to eight characters, and cannot start with special characters. If no link name is specified, the system will assign a link name LINKXXXX where XXXX is a number between 0001 and 9999.

TGprof

Specifies the TG profile assigned to the link station. The TG profile is a set of default values that apply to the link if chosen. When a TG profile is chosen, the proper effective capacity and propagation delay values are assigned to the link station based on the link speed of the media. If no profile for the link station is specified, then the profile specified for the port using the PortDef parameter is used; if no TG profile for the port is specified, then the system automatically picks a profile corresponding to the port's baud rate.

If the port is not active and the baud rate is unknown, then the system defaults to the Ser64 profile. For a list of valid TG profile values, see Table 15 earlier in this chapter.

NN\|EN\|Learn	Specifies whether the destination is a network node (NN) or an end node (EN). Specify Learn if you do not know the node type and all you know is the node's media address; if you specify Learn, do not specify a CP name.
<max_btu_size>	Enters the maximum number of bytes in a basic transmission unit (BTU) that can be sent to this destination. The acceptable range for network nodes is 99 to 8,912, while the acceptable range for end nodes is 256 to 8,912. If you set the type to Learn, do not set the value to less than 256, since you do not know if the node is a network node or an end node. If the learned node is an end node and you set the value to less than 256, the link may not come up.
<station addr>	Specifies the station address (or polling address) of the adjacent link station. Valid address values are Hex 01 through Hex FE.
CPName	Enters the control point name of the adjacent link station. If the net ID is different than the net ID of the local node specified using the LocalNodeName parameter, you can specify the net ID. If you enter the net ID, you must type a period immediately following it, then type the CP name immediately following the period to create the fully qualified CP name. The CP name can be up to eight characters in length, and valid characters are A-Z, 0-9, $, @, #. The name cannot start with a number, a space or a period. This value is optional.
Nodeid	Enters the eight-digit hex identification that is used to identify the node. This value is optional. The node ID corresponds to the IDNUM of the IBM node ID format IDBLK/IDNUM.
<LinkName>	Specifies the name assigned to the link. All link names must be unique on the local network node. For example, you cannot use the same link name on more than one port, and you cannot use the same link name for two types of links (such as for adjacent link stations or DLUr link stations) at the same time. The link name is limited to eight characters, and cannot start with special characters. If no link name is specified, the system will assign a link name LINKXXXX where XXXX is a number between 0001 and 9999.
TGprof	Specifies the TG profile assigned to the link station. The TG profile is a set of default values that apply to the link if chosen. When a TG profile is chosen, the proper effective capacity and propagation delay values are assigned to the link station based on the link speed of the media. If no profile for the link station is specified, then the profile specified for the port using the PortDef parameter is used; if no TG profile for the port is specified, then the system automatically picks a profile corresponding to the port's baud rate.
	If the port is not active and the baud rate is unknown, then the system defaults to the Ser64 profile. For a list of valid TG profile values, see Table 15 earlier in this chapter.

AutoStart

If you specify Yes, the link is automatically activated when the local network node is enabled, and is restarted automatically if the link stops. If you specify No, the link is not automatically started and you have to activate the link by entering SET -APPN LinkStaCONTrol. The default value is Yes. In the SHow -APPN SdlcAdjLinkSta display, AutoStart support is shown in the "A" column.

CPSess

Specifies whether CP-CP sessions will be activated with the adjacent node. If you specify Yes, CP-CP sessions are activated with the node, and if you specify No, they are not activated. The default value is No if the adjacent node type is a network node, and Yes if the adjacent node type is an end node or the node type is set to LEARN. In the SHow -APPN SdlcAdjLinkSta display, CP-CP session support is shown in the "CP" column.

HPR

Specifies if the link station supports HPR on this link. If you specify Yes, then HPR is supported on the link between the local node and the adjacent link station. If you specify No, HPR is not supported. The default is Yes, meaning HPR is supported by default, so if you want the SDLC adjacent link station to support only ISR, you must specify No.

ErrorRecovery

For HPR links only, specifies if link level error recovery is used for an outgoing connection on the link. If you specify Yes, error recovery is preferred, but can be negotiated down. If you specify No, error recovery for HPR does not take place. If you want link level error recovery for the incoming connection, then you must set the ErrorRecovery value for the PortDef parameter (see "PortDef" earlier in this chapter). If you use link level error recovery, additional overhead occurs on your links. This value is only valid if the HPR value is set to Yes.

SendWindow

Specifies the send window size (in number of frames). The valid range is from 1 to 12. The default is 4.

The receive window size is always 7 if the send window size is less than or equal to 7; in this case, the normal sequence numbering (Modulo 8) is used. The receive window size is always 12 if the send window size is greater than 7 but less than 12; in this case, the extended sequence numbering (Modulo 128) is used.

ContactTimer

Specifies the number of seconds to wait between attempts to contact a failed or newly activated adjacent link station. The valid range is from 0 to 300 seconds. The default is 1 second. This value is valid on primary ports only.

NoRspTimer

This value, also known as the T1 timer, specifies the no-response time-out in milliseconds for the SDLC port on the bridge/router. If the link station does not receive a response to a poll or message before this timer expires, then the transmission is retried until the retry count is exhausted. The valid range is from 0 to 10,000 milliseconds. The default is 1000 milliseconds. This value is valid on primary ports only.

NoRspTimRetry

Specifies the number of times the bridge/router attempts to complete a protocol exchange with a connected device before stopping the attempts. The valid range is from 1 to 25. The default is 3. This value is valid on primary ports only.

AutoStart	If you specify Yes, the link is automatically activated when the local network node is enabled, and is restarted automatically if the link stops. If you specify No, the link is not automatically started and you have to activate the link by entering SET -APPN LinkStaCONTrol. The default value is Yes. In the SHow -APPN SdlcAdjLinkSta display, AutoStart support is shown in the "A" column.
CPSess	Specifies whether CP-CP sessions will be activated with the adjacent node. If you specify Yes, CP-CP sessions are activated with the node, and if you specify No, they are not activated. The default value is No if the adjacent node type is a network node, and Yes if the adjacent node type is an end node or the node type is set to LEARN. In the SHow -APPN SdlcAdjLinkSta display, CP-CP session support is shown in the "CP" column.
HPR	Specifies if the link station supports HPR on this link. If you specify Yes, then HPR is supported on the link between the local node and the adjacent link station. If you specify No, HPR is not supported. The default is Yes, meaning HPR is supported by default, so if you want the SDLC adjacent link station to support only ISR, you must specify No.
ErrorRecovery	For HPR links only, specifies if link level error recovery is used for an outgoing connection on the link. If you specify Yes, error recovery is preferred, but can be negotiated down. If you specify No, error recovery for HPR does not take place. If you want link level error recovery for the incoming connection, then you must set the ErrorRecovery value for the PortDef parameter (see "PortDef" earlier in this chapter). If you use link level error recovery, additional overhead occurs on your links. This value is only valid if the HPR value is set to Yes.
SendWindow	Specifies the send window size (in number of frames). The valid range is from 1 to 12. The default is 4.
	The receive window size is always 7 if the send window size is less than or equal to 7; in this case, the normal sequence numbering (Modulo 8) is used. The receive window size is always 12 if the send window size is greater than 7 but less than 12; in this case, the extended sequence numbering (Modulo 128) is used.
ContactTimer	Specifies the number of seconds to wait between attempts to contact a failed or newly activated adjacent link station. The valid range is from 0 to 300 seconds. The default is 1 second. This value is valid on primary ports only.
NoRspTimer	This value, also known as the T1 timer, specifies the no-response time-out in milliseconds for the SDLC port on the bridge/router. If the link station does not receive a response to a poll or message before this timer expires, then the transmission is retried until the retry count is exhausted. The valid range is from 0 to 10,000 milliseconds. The default is 1000 milliseconds. This value is valid on primary ports only.
NoRspTimRetry	Specifies the number of times the bridge/router attempts to complete a protocol exchange with a connected device before stopping the attempts. The valid range is from 1 to 25. The default is 3. This value is valid on primary ports only.