MODIFY TGP command

Read syntax diagramSkip visual syntax diagram
>>-MODIFY-- --procname--,--TGP---------------------------------->

>--,--TGPNAME--=--tg_profile_name------------------------------->

>--+-,--ID--=--adjacent_link_station_name----+-----------------><
   '-,--ID--=--cp_name--,--TGN--=--tg_number-'   

Abbreviations

Operand Abbreviation
MODIFY F

Purpose

Using the MODIFY TGP (transmission group profile) command, you can change the TG profile associated with a type 2.1 connection. A specific connection is identified by the combination of a control point (CP) name and TG number, or by the adjacent link station (PU) name.

If this command is issued while the connection is active and the new TG profile can be located, the topology database is updated and the new characteristics are used immediately. If the connection is not active, the new TG profile name is saved and is reported the next time the connection is activated.

This command is valid only when it is issued at an APPN node (network node, end node, interchange node, or migration data host).

Operands

procname
The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM® start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

ID=name
Specifies an adjacent control point (CP) name or an adjacent link station (PU) name. If a CP name is specified, then the TGN operand must also be specified.
A CP name can be network-qualified. If the network ID is not specified, VTAM uses the network ID of the host from which the command is issued. You can specify * (or *NETWORK) as the network ID portion of a network-qualified adjacent CP name to modify the TG profile for adjacent CPs that do not currently have a network identifier assigned to them. For example, the following command is valid if A01N currently does not have a network ID associated with it:
F procname,TGP,TGPNAME=BATCH,ID=*.a01n,TGN=3
TGN=tg_number
Specifies the transmission group number associated with the CP. For virtual-route-based TG connections, TGN must be specified as 255.
TGPNAME=tg_profile_name
Specifies the name of a transmission group profile definition.
Result: If you have specified the PSRETRY start option, a TG profile that changes characteristics for a TG triggers path switches for all RTP pipes, regardless of the PSWEIGHT start option value. This means that the RTP pipes might be switched to the same path even if PSWEIGHT is set to LESSTHAN. See z/OS Communications Server: SNA Resource Definition Reference for additional information about the PSRETRY and PSWEIGHT start options.