Syntax

SET -APPN LinkStaCONTrol = <LinkName> <Activate | Deactivate [Orderly | Immediate]>

SHow -APPN LinkStaCONTrol [linkname]

No default

Description

The LinkStaCONTrol parameter dynamically activates or deactivates a specific link without taking the physical port up or down. (To take an APPN port up or down, use the PortCONTrol parameter described in this chapter.) This parameter activates and deactivates both regular adjacent link stations and DLUr link stations. To display the names of the links to any adjacent link stations, and the status of those links, use the SHow command.

This parameter uses the SET command, which means the changes you make are dynamic to that link.

Values

<LinkName>	Enters the link name assigned to the link between the network node and the adjacent node. The link name is assigned by the local network node or by assigning a link name with the AdjLinkSta or DlurLinkSta parameters. To determine which link name to use, enter the SHow -APPN LinkStaCONTrol command.
Activate | Deactivate	Enter Activate to take up a previously deactivated link to an adjacent link station. Enter Deactivate to take down a link to an adjacent link station.
Orderly | Immediate	If you specify Deactivate to take down a link, you can specify either Orderly or Immediate. If you specify Orderly, the link is deactivated when all ISR sessions are stopped. If you specify Immediate, all sessions are first stopped and then the link is deactivated.

Example 1

To deactivate a link on port 3 named "LINK002" and take the sessions down in an orderly manner, enter:

SET !3 -APPN LinkStaCONTrol = LINK002 Deactivate Orderly

When you activate or deactivate a link to an adjacent link station (and the link supports CP-CP sessions), you receive messages similar to the following two messages on the console indicating that the CP-CP session has been activated or deactivated:

CONLOSER CP-CP SESSION WITH US3COMHQ.GOLD IS UP

CONWINNER CP-CP SESSION WITH US3COMHQ.GOLD IS UP

If deactivating a link to an adjacent link station, the link will be deactivated until you reactivate it.

To reactivate a link to an adjacent link station you previously deactivated, use:

SET !<port> -APPN LinkStaCONTrol

Specify the Activate value. For example, to reactivate the link to link station "LINK002" deactivated in Example 1, enter:

SET !3 -APPN LinkStaCONTrol = LINK002 Activate

If you try to activate or deactivate a link over an APPN port that is not active, you will receive the following warning:

WARNING: Port is not active. Use set !<port> -appn PortCONTrol = Activate

The following is an example of the display obtained using the SHow LinkStaCONTrol command. The display shows adjacent link stations, DLUr link stations, and link stations learned from remote sites. Table 26 describes the meanings of the headings and status messages included in the display.

==================== SHow -APPN LinkStaCONTrol ====================
-------------Current Defined Link Stations and Status--------------
Port	LinkName	AdjCPName	Type	#Sess	LinkStatus
!1	@I000001	US3COMHQ.COM20E	NN	4	ACTIVE
!1	LINK0000	US3COMHQ.IBM4	NN	4	ACTIVE
!1	LINK0064			0	INACTIVE

Table 26 LinkStaCONTrol Display Meanings

Display Heading	Meaning
Port	Port on the local network node the link is on.
LinkName	Name assigned to the link by the local network node or by assigning a link name using the AdjLinkSta parameter. If the name includes the @ character, this indicates an incoming link station that is not locally defined.
AdjCPName	Adjacent control point at the other end of the link.
Type	Node type of the adjacent control point, either NN or EN.
#Sess	Number of CP-CP sessions between the local node and the adjacent control point. If there are no CP-CP sessions between the local node and adjacent control point, that does not mean the link is inactive. The link may still be active without CP-CP sessions.
(continued)
LinkStatus	Status of the link. Inactive means the link is inactive. Active means the link is active. PEND_ACTIVE means the link is in the process of coming up while PEND_INACTIVE means the link is in the process of going down.