Reference for Enterprise OS Software

PortDef

Syntax

: SETDefault !<port> -APPN PortDef = <DLC type> (LLC2|FR|PPP|DLSW|SDLC|UNdef) <max_btu_size>(99-8192) [ActLimit=<limit>(1-512)] [TGprof=<name>] [HPR=(Yes|No)] [ErrorRecovery=(Yes|No)] [DatMode=(Half|Full)] [ROle=(Neg|Pri|Sec)]
: SHow [!<port>] -APPN PortDef

Default

No default

Description

The PortDef parameter defines the characteristics of the local APPN port, including the type of communications used, the maximum basic transmission unit (BTU) size, and optionally, the activation limit and TG profile. After the APPN port is activated, if you want to make any configuration changes using this parameter or the PortCHar parameter, you must first deactivate the port using the PortCONTrol parameter. Re-enabling the CONTrol parameter in the PORT Service does not change the configuration. Without re-enabling the APPN CONTrol or APPN PortCONTrol parameters, the link on the port whose definition was modified is not activated. This parameter does not support virtual ports.

Values

<DLC type>

Selects the data link control communication type that is used on the port. Enter SDLC for synchronous data link control traffic. Enter LLC2 for token ring, Ethernet, and FDDI. Enter FR for Frame Relay, PPP for Point-to-Point links, or DLSw for using Data Link Switching over an IP network. If you specify the DLC type as DLSw, the port number specified must be !0. Do not specify !0 if using a DLC type other than DLSw. To remove a port definition entry, enter UNdef.

If a port has been previously defined for a particular DLC type, you need to remove the port definition entry using UNdef before specifying the new DLC type.

If you specify the DLC type as SDLC, then use the SdlcAdjLinkSta parameter or the SdlcDlurLinkSta parameter to add adjacent link stations or DLUr link stations to the port.

<max_btu_size>

Enters the maximum number of bytes in a BTU that can be received on the port. The acceptable range is 99-8192. To determine the maximum BTU size to use, first you determine the appropriate request/response unit (RU) size, then add an additional nine bytes (three bytes for the request header (RH) plus six bytes for transmission header). The RU size plus the additional nine bytes comprise the BTU size. For optimal buffer utilization, the recommended maximum BTU size for Ethernet and if bridging LLC2 over serial lines using source route transparent (SRT) bridging is 1,500. For token ring and all other media, including bridging over serial lines using source route (SR) bridging, the recommended maximum is 5,005.

ActLimit

Specifies the activation limit, or the number of LLC2 sessions allowed on the port. The valid range for all DLC types other than SDLC is 1-512. The default value is 32.

If you specify the DLC type as SDLC, then this value is valid only if ROle is set to Primary. The valid range for SDLC ports is 1-254. If the SDLC port ROle is Secondary or Negotiable, then the activation limit is set to 1 internally.

TGprof

Specifies the TG profile assigned to the port. The TG profile is a set of default values that apply to the port if chosen. When a TG profile is specified, the proper capacity and propagation delay values is assigned to the port based on the link speed of the media. If a TG profile for the port is not specified, then the system automatically uses a profile matching the port 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 TG profiles, see Table 15 earlier in this chapter.

HPR

Specifies whether HPR is supported on the port. If you specify "Yes," HPR can take place over the port. If you specify "No," HPR is not supported on the port and Intermediate Session Routing (ISR) is used. Using this option, you can have some ports supporting HPR and other ports supporting ISR at the same time. The default is Yes.

ErrorRecovery

For HPR links only, specifies if link level error recovery is used on this port for an incoming connection. If you specify "Yes," error recovery is preferred on the port, but it can be negotiated down. If you specify "No," error recovery is not supported on the port. If you want link level error recovery for the outgoing connection, then you must set the ErrorRecovery value for the AdjLinkSta parameter (see "AdjLinkSta" earlier in this chapter). The default is Yes if the DLC type is set to DLSw or SDLC (SDLC requires error recovery; do not change it to No). The default is No if the DLC type is set to LLC2, FR, or PPP. If you use link level error recovery, this creates additional overhead on your links. This value is only valid if the HPR value is set to "Yes."

DatMode

Specifies the data transmission mode of the port to half duplex or full duplex. This value applies to the port and all link stations on that port. Set this value to match the capabilities of the attached device. The de- fault is half duplex. This value is only valid if you set the DLC type to SDLC.

Some IBM and SNA documents refer to half duplex as "two-way alternate," and full duplex as "two-way simultaneous."

ROle

Specifies whether the role of the SDLC port is primary or secondary, or whether the role is negotiable (Neg). The default is Neg. This value is only valid if you set the DLC type to SDLC

<DLC type>	Selects the data link control communication type that is used on the port. Enter SDLC for synchronous data link control traffic. Enter LLC2 for token ring, Ethernet, and FDDI. Enter FR for Frame Relay, PPP for Point-to-Point links, or DLSw for using Data Link Switching over an IP network. If you specify the DLC type as DLSw, the port number specified must be !0. Do not specify !0 if using a DLC type other than DLSw. To remove a port definition entry, enter UNdef.
	If a port has been previously defined for a particular DLC type, you need to remove the port definition entry using UNdef before specifying the new DLC type.
	If you specify the DLC type as SDLC, then use the SdlcAdjLinkSta parameter or the SdlcDlurLinkSta parameter to add adjacent link stations or DLUr link stations to the port.
<max_btu_size>	Enters the maximum number of bytes in a BTU that can be received on the port. The acceptable range is 99-8192. To determine the maximum BTU size to use, first you determine the appropriate request/response unit (RU) size, then add an additional nine bytes (three bytes for the request header (RH) plus six bytes for transmission header). The RU size plus the additional nine bytes comprise the BTU size. For optimal buffer utilization, the recommended maximum BTU size for Ethernet and if bridging LLC2 over serial lines using source route transparent (SRT) bridging is 1,500. For token ring and all other media, including bridging over serial lines using source route (SR) bridging, the recommended maximum is 5,005.
ActLimit	Specifies the activation limit, or the number of LLC2 sessions allowed on the port. The valid range for all DLC types other than SDLC is 1-512. The default value is 32.
	If you specify the DLC type as SDLC, then this value is valid only if ROle is set to Primary. The valid range for SDLC ports is 1-254. If the SDLC port ROle is Secondary or Negotiable, then the activation limit is set to 1 internally.
TGprof	Specifies the TG profile assigned to the port. The TG profile is a set of default values that apply to the port if chosen. When a TG profile is specified, the proper capacity and propagation delay values is assigned to the port based on the link speed of the media. If a TG profile for the port is not specified, then the system automatically uses a profile matching the port 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 TG profiles, see Table 15 earlier in this chapter.
HPR	Specifies whether HPR is supported on the port. If you specify "Yes," HPR can take place over the port. If you specify "No," HPR is not supported on the port and Intermediate Session Routing (ISR) is used. Using this option, you can have some ports supporting HPR and other ports supporting ISR at the same time. The default is Yes.
ErrorRecovery	For HPR links only, specifies if link level error recovery is used on this port for an incoming connection. If you specify "Yes," error recovery is preferred on the port, but it can be negotiated down. If you specify "No," error recovery is not supported on the port. If you want link level error recovery for the outgoing connection, then you must set the ErrorRecovery value for the AdjLinkSta parameter (see "AdjLinkSta" earlier in this chapter). The default is Yes if the DLC type is set to DLSw or SDLC (SDLC requires error recovery; do not change it to No). The default is No if the DLC type is set to LLC2, FR, or PPP. If you use link level error recovery, this creates additional overhead on your links. This value is only valid if the HPR value is set to "Yes."
DatMode	Specifies the data transmission mode of the port to half duplex or full duplex. This value applies to the port and all link stations on that port. Set this value to match the capabilities of the attached device. The de- fault is half duplex. This value is only valid if you set the DLC type to SDLC.
	Some IBM and SNA documents refer to half duplex as "two-way alternate," and full duplex as "two-way simultaneous."
ROle	Specifies whether the role of the SDLC port is primary or secondary, or whether the role is negotiable (Neg). The default is Neg. This value is only valid if you set the DLC type to SDLC