NCLHELP.HLB  —  SNA Peer Server Module, SNA CP Services, SNA CP Services Transmission Group Subentity
   The SNA CP Services Transmission Group subentity represents a link
   between a Peer Server local link station and an adjacent SNA system
   link station.  The connection type can be permanent in which the
   datalink connection remains active when unused, or temporary in which
   the connection is automatically terminated and restarted in
   response to local session or remote link activation requests.

1  –  create

   create sna cp services transmission group

   The create sna cp services transmission group command creates the
   SNA CP Services Transmission Group subentity, which represents a link
   between a Peer Server local link station and an adjacent SNA system
   link station.  The connection type can be permanent in which the
   datalink connection remains active when unused, or temporary in which
   the connection is automatically terminated and restarted in
   response to session or link activation requests.

   During creation you can specify that the Transmission Group be an
   Intranode type. An Intranode Transmission Group provides routing
   of PIUs for sessions between NAUs that reside on the same (local)
   node. Only one Intranode Transmission Group instance may exist.

   Ex,  ncl> create sna cp services transmission group data link = sdlc

1.1  –  Characteristics

   Intranode       yes | no        Specifies whether this Transmission
                                   Group is an Intranode Transmission
                                   Group. The default is no. If you
                                   specify yes, note the characteristics
                                   that do to apply.

   Connection      permanent |     Permanent means that the Transmission
   Type            temporary       Group is activated when it is enabled
                                   and remains active until it is
                                   disabled. Temporary means that
                                   the Transmission Group is activated
                                   when a local session is created or
                                   when a remote link station is
                                   activated, and deactivated when there
                                   are no sessions. The default is
                                   permanent.

   Dependent       yes | no        Specifies whether Dependent LUs
   LU Support                      exist for the Transmission Group.
                                   This attribute controls the
                                   acceptance of ACTPU, DACTPU, ACTLU,
                                   and DACTLU RUs as well as the LFSID
                                   address space assignments for the
                                   Transmission Group. The default is
                                   no. Characteristic does not apply if
                                   Intranode is yes.

   Segmentation    session |       Specifies the kind of segmentation to
   Support         station |       be performed by the Peer Server when
                   none            communicating with the adjacent link
                                   station. The default is session.
                                   Characteristic does not apply if
                                   Intranode is yes.

   Bind Pacing     (1-32767)       Specifies the amount that the
   Window                          adaptive BIND pacing algorithm
   Increment                       increases the receiver window size
                                   when a larger window size is
                                   requested by the BIND sender and
                                   when there are adequate
                                   resources.  This parameter is valid
                                   when receiver BIND pacing is in
                                   effect for the Transmission Group.
                                   The default is 1. Characteristic
                                   does not apply if Intranode is yes.

   Disconnect      (0-3600)        Specifies the amount of time (in
   Timer                           seconds) a temporary Transmission
                                   Group should delay after zero
                                   sessions are active before
                                   deactivating the link station.
                                   The default is 30.

   XID Retry       (1-60)          Specifies the interval (in seconds)
   Timer                           specified for XID send expiration
                                   (retry). The default is 3.
                                   Characteristic does not apply if
                                   Intranode is yes.

   Data Link       Simplename      Specifies the local entity name for
                                   data link and instance used by the
                                   Transmission Group (TG). In the ex-
                                   ample, qllc link qllc-0 station ncp,
                                   ncp is the name of the local entity
                                   used by the TG.

   Node ID         1- to 8-hexa-   Specifies the node identifier value
                   decimal char-   for the Peer Server. This value is
                   acters (pre-    used in XID exchange if the value is
                   ceded by %x)    specified. The default is hexadecimal
                                   00000000. Characteristic does not
                                   apply if Intranode is yes.

   Required        1- to 8-hexa-   Specifies the node identifier value
   Adjacent        decimal char-   of the adjacent node. If specified,
   Node ID         acters (pre-    value must match that of the adjacent
                   ceded by %x)    node. Characteristic does not apply
                                   if Intranode is yes. If you do not
                                   specify this characteristic, no
                                   checking is done by the Peer Server.
   Required        Simplename      Specifies the network id of the
   Adjacent                        adjacent node. If specified, this
   Network ID                      value must match the network ID
                                   supplied by the adjacent node at
                                   connect time or the connection will
                                   fail. The value must be a valid SNA
                                   network name. Characteristic does not
                                   apply if Intranode is yes. If you do
                                   not specify this characteristic, no
                                   checking is done by the Peer Server.

   Required        Simplename      Specifies the cp name of the adjacent
   Adjacent                        node. If specified, the CP Name must
   CP name                         match the name supplied by the
                                   adjacent link station at connect time
                                   or the connection will fail. The
                                   value must be a valid SNA network
                                   name. Characteristic does not apply
                                   if Intranode is yes. If you do not
                                   specify this characteristic, no
                                   checking is done by the Peer
                                   Server.

2  –  delete

   delete sna cp services transmission group

   The delete sna cp services transmission group command deletes the
   SNA CP Services Transmission Group entity instance.  To succeed with
   the delete command, the entity must be in the Off state.

   Ex,  ncl> delete sna cp services transmission group tg-1

3  –  disable

   disable sna cp services transmission group

   The disable sna cp services transmission group command makes the SNA
   CP Services Transmission Group unavailable for use by disabling its
   normal operation. If the disable command is issued with the Immediate
   argument set to no, the Transmission Group enters the Shut entity
   state (this is the default action). Similarly, if the disable command
   is issued without specifying Immediate=Yes, the entity state is then
   Shut. Current sessions remain unaffected, but new sessions (whether
   initiated locally or remotely) cannot be established. When the last
   session ends, the Transmission Group changes from the Connected
   protocol state to the Idle protocol state, and, finally, to the Reset
   protocol state (the Idle protocol state status is not displayed). The
   entity state modulates from Shut to the Off. The Transmission Group
   then reports the Deactivated event.

   If the disable command is issued with the Immediate argument set to
   Yes, all active sessions terminate without regard to their status. The
   entity state then changes to Off and the protocol state is set to Reset.
   The Transmission Group then reports the deactivated event.

   Ex,  ncl> disable sna cp services transmission group tg-1

3.1  –  Arguments

   Immediate       yes | no        Determines the performance of the
                                   disable command according to the
                                   following:

                                   If no (the default), the possible
                                   entity states* of the Transmission
                                   Group are

                                   Off     The Transmission Group is
                                           disabled and not available
                                           for use.

                                   Shut    The Transmission Group is
                                           waiting for all active
                                           sessions to end.  This is the
                                           result of issuing the disable
                                           command without immediate
                                           yes.

                                   If yes, all currently active sessions
                                   are aborted. The only possible
                                   resulting entity state* is

                                   Off     The Transmission Group is
                                           disabled and not available
                                           for use.

   *Refer to the show sna cp services transmission group command Status
   Attributes listings for the Protocol States and the entity States
   for the Transmission Group.

4  –  enable

   enable sna cp services transmission group

   The enable sna cp services transmission group command makes a
   Transmission Group available for use, setting the entity state to On
   and the protocol state to Connecting, unless the Connection Type is
   Temporary, in which case the protocol state is set to Idle. If the
   Transmission Group Connection Type is Temporary, the connection is
   not initiated. However, the Transmission Group can be activated either
   locally by a session initiation request from the non-SNA network or
   remotely when the link station is activated from the adjacent node.

   If the connection type is permanent, the Transmission Group initiates
   a datalink connection with the adjacent link station.

   Ex,   ncl> enable sna cp services transmission group tg-1

5  –  set

   set sna cp services transmission group

   The set sna cp services transmission group command lets you set the
   characteristics for the SNA CP Services Transmission Group subentity.
   You can set the attributes for SNA CP Services Transmission Group only
   when the entity is disabled.

   Ex,   ncl> set sna cp services transmission group tg-1 -
         _ncl> connection type = temporary

5.1  –  Characteristics

   Intranode       yes | no        Specifies whether this Transmission
                                   Group is an Intranode Transmission
                                   Group. The default is no. If you
                                   specify yes, note the characteristics
                                   that do to apply.

   Connection      permanent |     Permanent means that the Transmission
   Type            temporary       Group is activated when it is enabled
                                   and remains active until it is
                                   disabled. Temporary means that
                                   the Transmission Group is activated
                                   when a local session is created or
                                   when a remote link station is
                                   activated, and deactivated when there
                                   are no sessions. The default is
                                   permanent.

   Dependent       yes | no        Specifies whether Dependent LUs
   LU Support                      exist for the Transmission Group.
                                   This attribute controls the
                                   acceptance of ACTPU, DACTPU, ACTLU,
                                   and DACTLU RUs as well as the LFSID
                                   address space assignments for the
                                   Transmission Group. The default is
                                   no. Characteristic does not apply if
                                   Intranode is yes.

   Segmentation    session |       Specifies the kind of segmentation to
   Support         station |       be performed by the Peer Server when
                   none            communicating with the adjacent link
                                   station.  The default is session.
                                   Characteristic does not apply if
                                   Intranode is yes.

   Bind Pacing     (1-32767)       Specifies the amount that the
   Window                          adaptive BIND pacing algorithm
   Increment                       increases the receiver window size
                                   when a larger window size is
                                   requested by the BIND sender and
                                   when there are adequate
                                   resources. This parameter is valid
                                   when receiver BIND pacing is in
                                   effect for the Transmission Group.
                                   The default is 1. Characteristic
                                   does not apply if Intranode is yes.

   Disconnect      (0-3600)        Specifies the amount of time (in
   Timer                           seconds) a temporary Transmission
                                   Group should delay after zero
                                   sessions are active before
                                   deactivating the link station.
                                   The default is 30.

   XID Retry       (1-60)          Specifies the interval (in seconds)
   Timer                           specified for XID send expiration
                                   (retry). The default is 3.
                                   Characteristic does not apply if
                                   Intranode is yes.

   Data Link       Simplename      Specifies the local entity name for
                                   data link and instance used by the
                                   Transmission Group (TG). In the
                                   example, qllc link qllc-0 station
                                   ncp, ncp is the name of the local
                                   entity used by the TG.

   Node ID         1- to 8-hexa-   Specifies the node identifier value
                   decimal char-   for the Peer Server. This value is
                   acters (pre-    used in XID exchange if the value is
                   ceded by %x)    specified.  Default is hexadecimal
                                   00000000. Characteristic does not
                                   apply if intranode is yes.

   Required        1- to 8-hexa-   Specifies the node identifier value
   Adjacent        decimal char-   of the adjacent node. If specified,
   Node ID         acters (pre-    this value must match that of the
                   ceded by %x)    adjacent node. Characteristic does
                                   not apply if Intranode is yes. If you
                                   do not specify this characteristic,
                                   no checking is done by the Peer
                                   Server.

   Required        Simplename      Specifies the network id of the
   Adjacent                        adjacent node. If specified, this
   Network ID                      value must match the network ID
                                   supplied by the adjacent node at
                                   connect time or the connection will
                                   fail. The value must be a valid SNA
                                   network name. Characteristic does not
                                   apply if Intranode is yes. If you do
                                   not specify this characteristic, no
                                   checking is done by the Peer Server.

   Required        Simplename      Specifies the cp name of the adjacent
   Adjacent                        node. If specified, the CP Name must
   CP name                         match the name supplied by the
                                   adjacent link station at connect time
                                   or the connection will fail. The
                                   value must be a valid SNA network
                                   name. Characteristic does not apply
                                   if Intranode is yes. If you do not
                                   specify this characteristic, no
                                   checking is done by the Peer
                                   Server.

6  –  show

   show sna cp services transmission group

   The show sna cp services transmission group command displays the
   values of the attributes for the SNA CP Services Transmission Group
   entity.  The SNA CP Services Transmission Group subentity represents
   a link between a Peer Server local link station and an adjacent SNA
   system link station.  The connection type can be permanent in which
   the data link connection remains active when unused, or temporary in
   which the connection is automatically terminated when unused.

   Ex,  ncl> show sna cp services transmission group tg-1 -
        _ncl> connection type, node id

6.1  –  Identifier

   Name            The unique Simplename of the Transmission Group
                   entity that is maintained by the Peer Server.

6.2  –  Status

   UID               Displays the unique identifier that the
                     Peer Server associates with the
                     Transmission Group.

   State             Displays the operational state of
                     the Transmission Group subentity.
                     Setting the state is a result of
                     execution of the enable/disable
                     commands.  The states are

           Off       The Transmission Group is disabled
                     and not available for use.

           On        The Transmission Group is enabled
                     and available for use.

           Shut      The Transmission Group is waiting
                     for the end of active sessions, if any.

   Protocol          Displays the protocol state of the
   State             Transmission Group.  These states are

      Connected      The Transmission Group is active.
                     The Transmission Group enters this
                     state from the connecting state after
                     successful XID exchange.

      Connected      The link station is active and the
      Pending        Transmission Group connection type
      Disconnect     is temporary. A transition to zero
                     sessions has started the disconnect timer.

      Connected -    The link station is active and capable
      PU Active      of supporting dependent LUs. The
                     Transmission Group enters this state
                     from the connected state when an
                     ACTPU is successfully processed.

      Connecting     An enabled Transmission Group is
                     being activated locally by a session
                     initiation request from a non-SNA
                     network or remotely when a link
                     station is activated from an adjacent
                     node.

      Disconnecting  The link station is in the process of
                     deactivating. This is for permanent
                     Transmission Groups. The entity state
                     remains on.

      Disconnect     For temporary Transmission Groups, the
      Reset          link station is in the process of de-
                     activating. The entity state is off.

      Idle           The link station is available but
                     inactive. This state is entered when
                     the Transmission Group is enabled. A
                     temporary Transmission Group is
                     activated locally by a session
                     initiation request from a non-SNA network
                     or remotely when a link station is
                     activated from an adjacent node.

      Reset          Resets the link station. This is the
                     creation state.

   INIT_SELF         Displays whether the adjacent link
   Supported         station supports receipt of INIT_SELF.
                     This attribute is relevant only if the
                     Transmission Group is active.

   BIND              Displays, if the Transmission Group is
   Supported         active, whether the Peer Server can
                     send Rq (BIND) RUs to the adjacent
                     link station.

   Adjacent Node     Displays whether the adjacent node
   BIND Assembly     can assemble BIND segments.

   BIND Pacing       Displays, if the Transmission Group is
   Support           active, the type of BIND pacing that
                     the Transmission Group supports.

   Dependent LU      Displays, if the Transmission Group is
   BIND Pacing       active, whether BIND pacing applies
                     to dependent LUs.

   SSCP              Displays whether the adjacent node
   Mediated          requires ACTPU.
   Sessions

   Adjacent          Displays the node id of the adjacent
   Station           node. This value is supplied during
   Node ID           connection.

   Adjacent          Displays the network id of the
   Network ID        adjacent node.

   Adjacent          Displays the non-network qualified
   Station           name of the CP of the adjacent link
   CP Name           station.

   Adjacent          Displays the network name of the PU
   Station           at the adjacent link station.  This
   PU Name           attribute is either blank or it contains
                     the non network qualified PU name of
                     the adjacent link station.
   Adjacent          Displays the local name of the Adjacent
   Station ALS       Link Station at the XID sender.
   Name

6.3  –  Characteristics

   Intranode       yes | no        Displays whether this Transmission
                                   Group is an Intranode Transmission
                                   Group. The default is no. If you
                                   specify yes, note the characteristics
                                   that do to apply.

   Connection      permanent |     Permanent means that the Transmission
   Type            temporary       Group is activated when it is enabled
                                   and remains active until it is
                                   disabled.  Temporary means that the
                                   Transmission Group is activated when
                                   a local session is created or a rem-
                                   ote link station is activated, and
                                   deactivated when there are no
                                   sessions. The default is permanent.

   Dependent       yes | no        Displays whether Dependent LUs
   LU Support                      exist for the Transmission Group.
                                   This attribute controls the
                                   acceptance of ACTPU, DACTPU, ACTLU,
                                   and DACTLU RUs as well as the LFSID
                                   address space assignments for the
                                   Transmission Group. The default is
                                   No. Characteristic does not apply if
                                   Intranode is yes.

   Segmentation    session |       Displays the kind of segmentation to
   Support         station |       be performed by the Peer Server when
                   none            communicating with the adjacent link
                                   station.  The default is session.
                                   Characteristic does not apply if
                                   Intranode is yes.

   BIND Pacing     (1-32767)       Displays the amount that the adaptive
   Window                          BIND pacing algorithm increases the
   Increment                       receive window size when a larger
                                   window size is requested by the BIND
                                   sender and when there are adequate
                                   resources.  This parameter is valid
                                   when receive BIND pacing is in
                                   effect for the Transmission Group.
                                   The default is 1. Characteristic does
                                   not apply if Intranode is yes.

   Disconnect      (0-3600)        Displays the amount of time (in
   Timer                           seconds) a temporary Transmission
                                   Group should delay after zero
                                   sessions are active before
                                   deactivating the link station.
                                   The default is 30.

   XID Retry       (1-60)          Displays the interval (in seconds)
   Timer                           specified for XID  send expiration
                                   (retry). The default is 3.
                                   Characteristic does not apply if
                                   Intranode is yes.

   Data Link       Simplename      Specifies the local entity name for
                                   data link and instance used by the
                                   Transmission Group (TG). In the ex-
                                   ample, qllc link qllc-0 station ncp,
                                   ncp is the name of the local entity
                                   used by the TG.

   Node ID         1- to 8-hexa-   Displays the node identifier value
                   decimal char-   for the Peer Server. This value is
                   acters (pre-    used in XID exchange if the value is
                   ceded by %x)    specified. The default is hexadecimal
                                   00000000. Characteristic does not
                                   apply if Intranode is yes.

   Required        1- to 8-hexa-   Displays the node identifier value of
   Adjacent        decimal char-   the adjacent node. If specified, this
   Node ID         acters (pre-    value must match that of the adjacent
                   ceded by %x)    node. Characteristic does not apply
                                   if Intranode is yes.

   Required        Simplename      Displays the network id of the
   Adjacent                        adjacent node. If specified, this
   Network ID                      value must match the network ID
                                   supplied by the adjacent node at
                                   connect time or the connection will
                                   fail. The value must be a valid SNA
                                   network name. Characteristic does not
                                   apply if Intranode is yes.

   Required        Simplename      Displays the CP Name of the adjacent
   Adjacent                        node. If specified, the CP Name must
   CP Name                         match the name supplied by the
                                   adjacent link station at connect time
                                   or the connection will fail. The
                                   value must be a valid SNA network
                                   name.  Characteristic does not apply
                                   if Intranode is yes.

6.4  –  Counters

   Creation          Displays the time that the Transmission
   Time              Group subentity was created.

   Successful        Displays the number of Transmission
   Activations       Group activation procedures that
                     Transmission Group completed
                     successfully.

   Activation        Displays the number of Transmission
   Failures          Group activation procedures that
                     failed due to an XID exchange error.

   Deactivations     Displays the number of times the
                     Transmission Group has been
                     deactivated.

   Connections       Displays the number of times the
   Lost              Transmission Group reported the
                     connections lost event.

   Octets Sent       Displays the number of octets that the
                     Transmission Group sent.

   Octets            Displays the number of octets that the
   Received          Transmission Group received.

   BTUs Sent         Displays the number of BTUs that the
                     Transmission Group sent.

   BTUs              Displays the number of BTUs that the
   Received          Transmission Group received.

   COLD ACTPUs       Displays the number of COLD ACTPUs
   Received          that the Transmission Group received.

   ERP ACTPUs        Displays the number of ERP ACTPUs
   Received          that the Transmission Group received.

   ACTPUs            Displays the number of negative
   Rejected          responses sent to ACTPU requests.

   DACTPUs           Displays the number of DACTPUs
   Received          that the Transmission Group received.

   Protocol          Displays the number of SNA protocol
   Violations        violations that the Transmission
                     Group detected.
Close Help