Reference for Enterprise OS Software

: SHow -APPN TG [<node name> | ALL]

Default

Description

The TG parameter displays all information in the transmission group (TG) topology database. If the network node specified does not own any TG, then a message indicates that no transmission group is defined for the specified node.

This display may include TGs that no longer exist which have not been removed from the database. For a list of active connections only, enter SHow -APPN CONNection.

Values

<node name> | ALL

Enters the specific network node name to display transmission group information for that network node only. Enter ALL to display TG information for all network nodes.

When entering a node name, you can enter either a fully qualified name (such as US3COMHQ.NB2BLUE), or a name that is not qualified (such as NB2BLUE).

If no value is specified, then all transmission groups owned by this node are displayed.

<node name> \| ALL	Enters the specific network node name to display transmission group information for that network node only. Enter ALL to display TG information for all network nodes.
	When entering a node name, you can enter either a fully qualified name (such as US3COMHQ.NB2BLUE), or a name that is not qualified (such as NB2BLUE).
	If no value is specified, then all transmission groups owned by this node are displayed.

Example

To display the transmission group information for network node US3COMHQ.CN7, enter:

: SHow -APPN TG US3COMHQ.CN7

A display similar to the following appears:

: ========================== SHow -APPN TG ==========================
: -------------------Network Node Transmission Group-----------------
: Owning node name (type) = US3COMHQ.CN7 (VRN)
: TG partner CP name (type) = US3COMHQ.CUBE (NN)
: TG number = 1
: Days left before deletion = 15
: RSN = 2
: TG Status = OPERATIVE
: Effective Capacity = 56000
: Cost per connect time = 68
: Cost per byte = 68
: Propagation Delay = 68
: User defined parameter 1 = 68
: User defined parameter 2 = 68
: User defined parameter 3 = 68

This example shows only one TG. If you enter the command without specifying a network node, then the display will show all TGs.

Table 30 explains the headings in the transmission group display.

Table 30 Transmission Group Display Meanings

Display Heading

Meaning

Owning Node name (type)

Name of the node (and node type) to which the transmission group belongs.

TG partner CP name

Control point name assigned to the network node's transmission group partner. The network node's transmission group partner is the end node.

TG number

Number assigned to the transmission group. If you have parallel TGs between two nodes, one TG is designated 1 and the other is designated 2. With parallel TGs, one TG may be up and the other may be down.

Days left before deletion

Number of days left before the entry will be deleted from the TG database. APPN deletes the information after 15 days. If the value shown is 15, then the entry is new; the lower the value, the older the entry.

RSN

Resource Sequence Number. This indicates how up-to-date the information regarding the TG is. The higher the RSN number is, the more up-to-date the information.

TG Status

State of the TG. Possible states include Operative, Inoperative, or Quiescing. Quiescing indicates the TG is in the process of shutting down. All of the status messages also indicate whether there is or is not CP-CP sessions over the TG.

Effective Capacity

The effective link speed and throughput the link on the transmission group can handle without getting overloaded. The number shown is rounded, so the capacity displayed may not be exactly the amount entered at configuration.

Cost per byte

Relative cost per byte for the link.

Security

Level of security for the transmission group.

Propagation delay

Time in microseconds for a signal to propagate from one end of the transmission group to another.

User defined parameter 1, 2, 3

Values assigned to the user-defined parameters.

Display Heading	Meaning
Owning Node name (type)	Name of the node (and node type) to which the transmission group belongs.
TG partner CP name	Control point name assigned to the network node's transmission group partner. The network node's transmission group partner is the end node.
TG number	Number assigned to the transmission group. If you have parallel TGs between two nodes, one TG is designated 1 and the other is designated 2. With parallel TGs, one TG may be up and the other may be down.
Days left before deletion	Number of days left before the entry will be deleted from the TG database. APPN deletes the information after 15 days. If the value shown is 15, then the entry is new; the lower the value, the older the entry.
RSN	Resource Sequence Number. This indicates how up-to-date the information regarding the TG is. The higher the RSN number is, the more up-to-date the information.
TG Status	State of the TG. Possible states include Operative, Inoperative, or Quiescing. Quiescing indicates the TG is in the process of shutting down. All of the status messages also indicate whether there is or is not CP-CP sessions over the TG.
Effective Capacity	The effective link speed and throughput the link on the transmission group can handle without getting overloaded. The number shown is rounded, so the capacity displayed may not be exactly the amount entered at configuration.
Cost per byte	Relative cost per byte for the link.
Security	Level of security for the transmission group.
Propagation delay	Time in microseconds for a signal to propagate from one end of the transmission group to another.
User defined parameter 1, 2, 3	Values assigned to the user-defined parameters.