DISPLAY TGPS command


>>-DISPLAY-- --NET--,--TGPS------------------------------------->

>--+---------------------------------------------+-------------->
   |                                         (1) |   
   '-,--ID--=--+-tg_profile_name-----------+-----'   
               |    .-,---------------.    |         
               |    V                 |    |         
               '-(----tg_profile_name-+--)-'         

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------><
   '-,--MAX--=--+-*-------------------+-----'   
                '-number_of_resources-'

Notes:

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.

Abbreviations

Operand	Abbreviation
DISPLAY	D
TGPS	TGP

Purpose

The DISPLAY TGPS (transmission group profiles) command displays the currently defined TG profiles by name, along with the transmission group characteristics that they represent. For more information about defining a transmission group profile, see the z/OS Communications Server: SNA Resource Definition Reference. This command is valid only when it is issued at an APPN node (network node, end node, interchange node, or migration data host).

Operands

ID=tg_profile_name

Specifies the name of one or more transmission group profiles to display. If you omit the ID operand, all profiles are displayed.

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand. For more information about using wildcards, see Using wildcard names.

Attention: Specifying a wildcard name might degrade performance because VTAM® checks every transmission group profile in the network.

MAX

Specifies the maximum number of transmission group profiles that VTAM displays for this command.

MAX=*: Specifies that the value of the DSPLYMAX start option is used to limit the display output.
MAX=number_of_resources: Specifies the number of transmission group profiles that VTAM displays for this command. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.
Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer transmission group profiles are found than you have specified on MAX, VTAM displays only the transmission group profiles that are found.

Resulting display

The resulting display shows the TG profile names and the TG characteristics that are defined to VTAM. The TG characteristics are shown in a 16-byte hex string.

Byte

Description

1

Flag byte. This byte is zero when you display a TG profile, but other values might appear when you display the TG characteristics for an active resource (for example, the output of the DISPLAY ADJCP command).

2

Capacity. This value corresponds to the CAPACITY value coded in the TGP definition statement. The displayed value is an internal representation of the coded value. For more information about how the CAPACITY value coded in the TG profile is mapped to the internal representation used by VTAM, see the z/OS Communications Server: SNA Resource Definition Reference.

3–7

Reserved (zero)

8

Cost per unit time. This value corresponds to the COSTTIME value coded in the TGP definition statement.

9

Cost per byte. This value corresponds to the COSTBYTE value coded in the TGP definition statement.

10

Reserved (zero)

11

Security. This value corresponds to the SECURITY value coded in the TGP definition statement as follows:

X'01': UNSECURE
X'20': PUBLIC
X'40': UNDERGRO
X'60': SECURE
X'80': GUARDED
X'A0': ENCRYPT
X'C0': SHIELDED

12

Propagation delay. This value corresponds to the PDELAY value coded in the TGP definition statement as follows:

X'4C': NEGLIGIB
X'71': TERRESTR
X'91': PACKET
X'99': LONG

13

Reserved (zero)

14–16

User-defined. These values correspond to the values coded for UPARM1, UPARM2, and UPARM3 respectively in the TGP definition statement.

Examples

Displaying a specific transmission group profile:

d net,tgps,id=secure
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TGPS
IST1107I TGP NAME TG CHARACTERISTICS
IST1108I SECURE   00750000000000969600604C00000000
IST1454I 1 TGP(S) DISPLAYED FOR ID=SECURE
IST314I END

Displaying all transmission group profiles:

d net,tgps
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TGPS
IST1107I TGP NAME TG CHARACTERISTICS
IST1108I UNSECURE 00750000000000646400014C00000000
IST1108I UNDERGRO 007500000000007D7D00404C00000000
IST1108I SECURE   00750000000000969600604C00000000
IST1108I GUARDED  00750000000000C8C800804C00000000
IST1108I SHIELDED 00750000000000C8FF00C04C00000000
IST1108I TGPL11   00750000000000000000014C00000000
IST1108I TGPL12   00B40000000000000000604C00808080
IST1108I TGPL21   00430000000000000000014C00000000
IST1108I TGPL22   00B400000000000A0A006071003C3C3C
IST1108I TGPL31   00520000000000000000204C003D3D3D
IST1108I TGPL32   00B400000000000A0A00409100808080
IST1108I LOWSWCH  002D00000000003CB400207100808080
IST1108I MEDSWCH  002D0000000000787800207100808080
IST1108I HIGHSWCH 002D0000000000B43C00207100808080
IST1108I LOWLEASE 002D0000000000507800017100808080
IST1108I MEDLEASE 002D0000000000645000017100808080
IST1108I HIGHLEAS 002D0000000000782800017100808080
IST1108I TRINGLOW 007500000000000A1400014C00808080
IST1108I TRINGHI  008500000000000A1400014C00808080
IST1108I CHANNEL  002D0000000000050500604C00808080
IST1108I CHANESCA 002D0000000000050A00604C00808080
IST1108I TGPTESTA 00140000000000FF0000804C00818181
IST1108I TGPTESTB 004A0000000000640000014C003D3D3D
IST1108I TGPTESTC 005200000000000A0000204C003D3D3D
IST1108I TGPLOW   00140000000000FFC800804C00818181
IST1108I TGPMED   004A0000000000006400014C003D3D3D
IST1454I 26 TGP(S) DISPLAYED
IST314I END

Displaying transmission group profiles, limiting output to three resources:

d net,tgps,max=3
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TGPS
IST1107I TGP NAME TG CHARACTERISTICS
IST1108I PROFILE1 002D0000000000082000014C00808080
IST1108I PROFILE2 003C0000000000000000017100808080
IST1108I PROFILE3 002D0000000000000000019100808080
IST1315I DISPLAY TRUNCATED AT MAX = 3
IST1454I 3 TGP(S) DISPLAYED
IST314I END