Syntax

SETDefault -APPN LinkStaCHar = <LinkStation name> [EffectCap=<string>] [ConnectCost=<0-255>] [ByteCost=<0-255>] [Security=<string>] [PropDelay=<string>] [Usd1=<0-255>] [Usd2=<0-255>] [Usd3=<0-255>]

SHow -APPN LinkStaCHar [LinkStation name]

No default

Description

The LinkStaCHar parameter defines the characteristics of the link to an adjacent link station. The characteristics used to define adjacent link stations also determine the characteristics of transmission groups (TGs). Once the adjacent link station is activated, if you want to make any changes using this parameter or the AdjLinkSta parameter, you must first deactivate the link using the LinkStaCONTrol parameter.

CAUTION: If you change any of the default characteristics for a link to a network node, the characteristic must also be changed on the partner network node. For example, if you set the security level of the TG as GUarded on the local node, then you must also configure the security level as GUarded on the partner node. Otherwise, the characteristic is valid in one direction only, from the local node to the partner node; the characteristic on the link in the opposite direction does not match.

Values

<LinkStation name>

Specifies the name assigned to the link by the system, or by specifying the link name with the ADD -APPN AdjLinkSta command.

EffectCap

Specifies the highest bit transmission rate that the TG can obtain. Specify one of the following values: MINimum, MAXimum, 2400, 4800, 9600, 19200, 56000, 64000, 2560000, T1, 4M, 10M, 16M, 25M, 100M, or 155M. The default values are those used by the link station's TG profile. You must enter this value using one of these strings; however, these strings map to specific hex values. For information on mapping the hex values to these strings, see Table 23. If you have previously specified an effective capacity by assigning a TG profile to the port the link is on, the effective capacity you specify for the adjacent link station would be used, and would override the capacity specified by the TG profile.

Table 23 Effective Capacity Values

String	Hex Value Equivalent
MIN	0x00
2400	0x20
4800	0x28
9600	0x30
14400	0x34
19200	0x38
56000	0x43
64000	0x45
256000	0x55
T1	0x69
4M	0x75
10M	0x80
16M	0x85
25M	0x8A
100M	0x9A
155M	0x9F
MAX	0xFF

ConnectCost	Specifies the relative cost per unit time of using a TG. Valid values are from 0-255. The default is 0.
ByteCost	Specifies the relative cost per byte for using a TG. Valid values are from 0-255. The default is 0.
Security	Specifies the level of security available on the TG. Specify one of the following strings: NONsecure, PKTswtnet, UNDgndcbl, SECurcnd, GUArdcnd, ENCryptd, guardRAD, or MAX. The default values are those used by the link station's TG profile. You must enter this value using one of these strings; however, these strings map to specific hex values. For information on mapping the hex values to these strings, see Table 24.

Table 24 Security Values

String	Hex Value Equivalents
NONsecure	0x01
PKTswtnet	0x20
UNDgndcbl	0x40
SECurecnd	0x60
GUArdcnd	0x80
ENCryptd	0xA0
guardRAD	0xC0
MAX	0xC0 (for TG characteristics) 0xFF (for COS tables)

PropDelay	Specifies the duration for a signal to propagate from one end of the TG to the other. Specify one of the following strings: MINimum, LAN, TELephone, PKTswitch, SATellite, or MAXimum. You must enter this value using one of these strings; however, these strings map to specific hex values.
	For information on mapping the hex values to these strings, see Table 25. If you have previously specified a propagation delay by assigning a TG profile to the port the link is on, the effective capacity you specify for the adjacent link station would be used, and would override the delay specified by the TG profile.

Table 25 Propagation Delay Values

String	Hex Value Equivalent
MINimum	0x00
LAN	0x4C
TELephone	0x71
PKTswitch	0x91
SATellite	0x99
MAXimum	0xFF

Usd1	Specifies the value for user-defined parameter 1. The user-defined parameters represent TG characteristics defined by the network administrator. Valid values are from 0-255. The default is 128. These values also apply to user-defined parameters 2 and 3.
Usd2	Specifies the value for user-defined parameter 2.
Usd3	Specifies the value for user-defined parameter 3.

Example

To define the characteristics of a link named "ENGREEN1" for an effective capacity of 9600, a byte cost of 128, and a security value of SECurcnd, enter:

SETDefault -APPN LinkStaCHar = ENGREEN1 EffectCap=9600 ByteCost=128 Security=SECurecnd

You can enter the options for this parameter in any combination. You can configure one option, some options, or all of them with each command. For example, you can define the same characteristics on the link by entering the following three commands:

SETDefault -APPN LinkStaCHar = ENGREEN1 EffectCap=9600

SETDefault -APPN LinkStaCHar = ENGREEN1 ByteCost=128

SETDefault -APPN LinkStaCHar = ENGREEN1 Security=SECurecnd