1 SNA_Peer_Server_Module 2 SNA_Access_Server The SNA Access Server entity provides an interface to the Peer Server for client applications in the TCP/IP and DECnet-Plus networks. By means of its two subentities: Port and Object, the Access Server manages client connections and provides ports through which the clients can communicate with their partners in the SNA network. 3 create The create verb generates a new instance of the SNA Access Server entity or subentity. Create sets the entity state to off, sets the entity's attributes to their default values, and allocates resources for the entity. create sna access server The create sna access server command creates the SNA Access Server entity. The create command allocates resources for the single entity and sets its characteristic attributes to their defaults. Ex, ncl> create sna access server 4 Characteristic Maximum (0-1024) Specifies the number of concurrent Connections client connections supported by the Peer Server. Set this number according to the number of SNA sessions required by client applications during peak usage. The default is 1024. 3 delete delete sna access server The delete sna access server command deletes the single instance SNA Access Server entity. The entity must be in the Off entity state and have no Object or Port subentities before it can be deleted. Ex, ncl> delete sna access server 3 disable disable sna access server The disable sna access server command discontinues the service provided by the SNA Access Server. Current Port subentities, if any, are unaffected and the entity goes into the Shut entity state. The server enters the Off entity state when all the Ports are deleted. Ex, ncl> disable sna access server 3 enable enable sna access server The enable sna access server command enables the Access Server for operation and use. The Server entity enters the on entity state. Ex, ncl> enable sna access server 3 set set sna access server The set sna access server command lets you modify the number of concurrent client connections supported by the Peer Server. This is done through the Maximum Connections characteristic. Ex, ncl> set sna access server maximum connections = 512 4 Characteristic Maximum (0-1024) Specifies the number of concurrent Connections client connections supported by the Peer Server. Set this number according to the number of SNA sessions required by HP SNA applications during peak usage. The default is 1024. 3 show show sna access server The show sna access server command displays the attributes for the SNA Access Server entity. The SNA Access Server manages client connections and provides ports through which TCP/IP and DECnet-Plus applications can communicate with their partners on the IBM side. Ex, ncl> show sna access server all 4 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. State Displays the operational state of the SNA Access Server entity. The operational states are Off The Access Server is disabled and not available for use. On The Access Server is enabled and available for use. Shut The Access Server is acting on a disable command. It enters the off state at the end of active sessions, if any. Active Displays the current number of active client Connections connections to the SNA Access Server module. Peak Displays the peak number of client connections Connections that have been active at any one time. 4 Characteristics Maximum (0-1024) Displays the number of concurrent Connections client connections supported by the Peer Server. Version Displays the version number of the SNA Access Server software that is executing. 4 Counters Creation Displays the time when the entity was created. Time Connections Displays the total number of client connections Created created to and from the SNA Access Server module. Connection Displays the total number of client connection Failures creation failures. Inbound Displays the total number of client connections Connections accepted by the SNA Access Server module from Accepted non-SNA applications. The Peer Server increments this counter each time the SNA Access Server entity generates an Inbound Connection Accepted event. Outbound Displays the total number of client connections Connections started by the SNA access server module and Accepted accepted by non-SNA applications. The Peer Server increments this counter each time the SNA Access Server entity generates an Outbound Connection Accepted event. Inbound Displays the total number of client connections Connections rejected by the SNA Access Server module from Rejected nonSNA applications. The Peer Server increments this counter each time the SNA Access Server entity generates an Inbound Connection Rejected event. Outbound Displays the total number of client connections Connection attempted by the SNA access server module and Rejected rejected by nonSNA applications. The Peer Server increments this counter each time the SNA Access Server entity generates an Outbound Connection Rejected event. Transport Displays the number of times that an SNA Access Abnormal Server Port entity was disconnected as a result Terminations of failures within DECnet or TCP/IP. Such failures include any client connection termination that is not initiated from either the SNA Access Server module or the nonSNA application. The Peer Server increments this counter each time the SNA Access Server entity generates a Transport Abnormal Termination event. SNA Abnormal Displays the number of instances when an SNA Access Terminations Server Port entity was disconnected as a result of failures within the SNA network. Such failures include any session termination that is not initiated from either the SNA Access Server module or the remote CP. The Peer Server increments this counter each time the SNA Access Server entity generates an SNA Abnormal Termination event. Protocol Displays the total number of Gateway Access Protocol Violation (GAP) violations that have occurred with nonSNA Errors applications. This is a measure of internal functioning. Refer problems involving this counter to your customer support representative. The Peer Server increments this counter each time the SNA Access Server entity generates a Protocol Violation Error event. Resource Displays the total number of resource allocation Allocation failures (for example, failures caused by Failures insufficient memory). 3 SNA_Access_Server_Object_Subentity The SNA Access Server Object entity describes an endpoint in the non-SNA network to connect to when the SNA network sends an unsolicited SNA Session startup request (BIND) to the Peer Server. The SNA Access Server Object contains parameters that describe how to connect to a remote application using TCP/IP, DECnet-Plus, or a local transport for applications that run on the same system as the Peer Server. Objects are not needed to handle inbound sessions to the SNA network (3270 Terminal emulator sessions for example). 4 create create sna access server object The create sna access server object command creates an object and defines values for the parameters that define the connection. The create command also sets the characteristics to their default values and allocates resources for the entity. Depending on the transport type, different parameters are used during creation. o For decnet, the node name and number or task are used. o For tcpip, the internet node name and service or port are used. o For local transport, the task or command name and local username are used. The following three examples illustrate the use of the create command for (i) decnet, (ii) tcpip, and (iii) a local transport. i) In the following example, a connection is made to the DECnet-Plus node .lkg.axp object number 143. Instead of an object number, you may specify a named DECnet object (or Session Control application). ncl> create sna access server object cpicprog node = .lkg.axp, - _ncl> number = 143, transport = decnet ii) In this example, a connection is made to the tcpip port number 7004 on the Internet node xxx.yyy.dec.com. Instead of using a numbered port, you may use a TCP service name. The mapping of name to number occurs on the local machine at the time of connection. ncl> create sna access server object dspiprog - _ncl> internet node = xxx.yyy.dec.com, number = 7004, - _ncl> transport = tcpip iii) In this example, a process is started on the local machine by running the command line specified in the command attribute under the local username that has been set. If a username has not been set, the program is run under the root username. ncl> create sna access server object localprog - _ncl> command = "/usr/local/app1.ksh", local username = barney, - _ncl> transport = local 5 Characteristics Transport tcpip | Specifies the type of transport decnet | protocol used to reach the object. local The choices are decnet, tcpip, and local. Node dns-fullname Specifies the DECnet-Plus node to which to connect. Applies to DECnet transport only. Number (0-255) Specifies the number of the object. Applies to decnet transport only. Task Simplename Specifies the task name of the object. This characteristic is used only when the number characteristic is non-zero. If this characteristic is specified for objects with a non-zero number characteristic, the value is ignored. Local Simplename Specifies the name of the user to run Username the application as. Applies to local transport only. Command alpha-string Specifies the command to be passed to the local object. Applies to local transport only. Internet alpha-string Specifies the name of the Internet Node node to which to connect in the named or "dotted" number format. Applies to tcpip transport only. Port (0-32767) The integer that identifies the TCP port number on the remote node. The port characteristic should not be set when the service characteristic is set. Applies to tcpip transport only. Service Simplename The name of the service on the remote node. Applies to tcpip transport only. 4 delete delete sna access server object The delete sna access server object command deletes the named instance of the Object entity. Ex, ncl> delete sna access server object obj-1 4 set set sna access server object The set sna access server object command lets you modify the values for the characteristics of the Object entity. The Object entity of the SNA Access Server is the end-user address (called an Object) to which the Peer Server connects in response to an IBM request. The following three examples illustrate the use of the set command for (i) decnet, (ii) tpcip, and (iii) a local transport. i) In the following example, a connection exists to the DECnet-Plus node .lkg.axp. The following set command establishes a connection to object number 153. Instead of an object number, you may specify a named DECnet object (or Session Control application). ncl> set sna access server object cpicprog node = .lkg.axp, - _ncl> number = 153, transport = decnet ii) In this example, a connection is made to the Internet node xxx.yyy.dec.com. The following example connects to port number 1009. Instead of using a numbered port, you may use a TCP service name. The mapping of name to number occurs on the local machine at the time of connection. ncl> set sna access server object dspiprog - _ncl> internet node = xxx.yyy.dec.com, number = 1009, - _ncl> transport = tcpip iii) In this example, a process exists on the local machine. The following set command establishes an object for the specified username by running the command line specified in the command attribute. If a username is not set, the program is run under the root username. ncl> set sna access server object localprog - _ncl> command = "/usr/local/app1.ksh", - _ncl> local username = barney, transport = local 5 Characteristics Transport tcpip | Specifies the type of transport decnet | protocol used to reach the object. local The choices are decnet, tcpip, and local. Node dns-fullname Specifies the DECnet-Plus node to which to connect. Applies to DECnet transport only. Number (0-255) Specifies the number of the object. Applies to DECnet transport only. Task Simplename Specifies the task name of the object. This characteristic is used only when the number characteristic is non-zero. If this characteristic is specified for objects with a non-zero number characteristic, the value is ignored. Local Simplename Specifies the name of the user to run Username the application as. Applies to local transport only. Command alpha-string Specifies the command to be passed to the local object. Applies to local transport only. Internet alpha-string Specifies the name of the Internet Node node to which to connect in the named or "dotted" number format. Applies to tcpip transport only. Port (0-32767) The integer that identifies the Port on the remote node. Applies to tcpip transport only. Service Simplename The name of the service on the remote node. Applies to tcpip transport only. 4 show show sna access server object The show sna access server object command displays the values of the attributes for the SNA Access Server Object entity. The Object entity of the SNA Access Server is the end-user address (called an Object) to which the Peer Server connects in response to an IBM request. Ex, ncl> show sna access server object obj-1 all 5 Characteristics Transport tcpip | Displays the type of transport decnet | protocol used to reach the object. local The choices are tcpip, decnet, and local. Node dns-fullname Displays the name of the DECnet node to which to connect. Number (0-255) Displays the number of the object. Applies to DECnet transport only. Task Simplename Displays the task name of the object. This characteristic is used only when the Number characteristic is non-zero. If this characteristic is specified for objects with a non-zero Number characteristic, the value is ignored. Local Simplename Displays the name of the user that Username is running the local object. Applies to local transport only. Command alpha-string Displays the command to be passed to the local object. Applies to local transport only. Internet alpha-string Displays the name of the internet Node node to which to connect. Applies to tcpip transport only. Port (0-32767) The integer that identifies the TCP/IP Port on the remote node. Applies to tcpip transport only. Service Simplename The name of the TCP/IP service name on the remote node. Applies to tcpip transport only. 5 Identifier name Displays the string that you provided to identify the entity. 3 SNA_Access_Server_Port_Subentity The SNA Access Server Port entity represents an access point to the services of the SNA Access Server module. Ports are created dynamically by the Peer Server to handle client connections. 4 show show sna access server port The show sna access server port command displays the attributes for the SNA Access Server Port entity. Ex, ncl> show sna access server port 37 all status 5 Identifier Name Displays the name created by the Peer Server for this Port. 5 Status Protocol Displays the protocol state of the client State connection. Connecting The SNA Access Server is initiating a connection Inbound to an IBM system. Connecting The SNA Access Server is initiating a connection Outbound to a nonSNA access routine. Disconnect- The SNA Access Server is terminating the ing connection. In Session The SNA Access Server has established the connection and the session partners have exchanged a BIND request and a positive response. Not In Connection has been established; the BIND request Session and its positive response have not yet been exchanged. Off The initial state of a port when the Access Server first creates it Client Displays the name of the SNA LU Services LU Session entity using this port. Protocol Displays the negotiated Gateway Access protocol Version version (GAP) in use over this client connection. Authorization Displays the identifier of the SNA LU Services Authorization entity that granted access to this port. Node Displays the name of the user's node (relevant only if the underlying transport is decnet). User Name Displays the name of the user connected by the client connection. Terminal Name Displays the name of the user's terminal. Process Displays the user's process identifier. Note Identifier that the identifier is always displayed as zero if the GAP protocol version is less than V3.0. Program Name Displays the name of the program on the remote node that is using this port. Local Transport Displays the client connection identifier used Identifier on the Peer Server node. Remote Transport Displays the client connection identifier used Identifier on the nonSNA application's node. Internet Displays the name of the connected node Node (relevant only if the underlying transport is TCP/IP). Transport Displays the name of the underlying transport. 2 SNA_LU_Services The SNA LU Services module contains the SNA Logical Services functions for the Peer Server. SNA LU Services contains the following subentities: LU, Access Name, Authorization, and Partner LU. The LU entity supports the Session subentity. 3 create create sna lu services The create sna lu services command creates a single instance of the SNA LU Services entity, allocates resources for the entity, and initializes the entity's attributes to their default values. Ex, ncl>create sna lu services default transmission group = tg-1 4 Characteristics Default Simplename Specifies the Transmission Group Transmission that should be used when processing Group a Primary LU connection if the Partner LU entity associated with the connection has no Transmission Group defined. This allows Partner LU entities to name the remote network ID and the LU name for the remote LU but does not require that the Transmission Group be named. The default is to have no Default Transmission Group name set. 3 delete delete sna lu services The delete sna lu services command deletes a single instance of the SNA LU Services module. Before the entity can be deleted, all subentities of this entity must have been deleted. Ex, ncl> delete sna lu services 3 set set sna lu services The set sna lu services command lets you set the default transmission group characteristic for the SNA LU Services entity. Ex, ncl> set sna lu services default transmission group = tg-1 4 Characteristic Default Simplename Specifies the Transmission Group that Transmission should be used when processing a Group primary LU connection if the Partner LU entity associated with the connection has no Transmission Group defined. This allows Partner LU entities to name the remote network id and the LU name for the remote LU but does not require that the Transmission Group be named. 3 show show sna lu services The show sna lu services command displays the values of the attributes for the SNA LU Services entity. Ex, ncl> show sna lu services default transmission group 4 Status Uid Displays the unique identifier for the SNA LU Services entity. Active Displays the number of active LU-LU sessions. Sessions Queued Displays the total number of queued session Sessions requests. SNA LU Services queues sessions when the session limit for the Peer Server LU is reached in either direction (PLU or SLU) when the session initiation requests queueing. On the Peer Server the session limit for an LU is established with the Maximum Active Sessions characteristic. Active SSCP- Displays the number of currently active LU Sessions SSCP-LU sessions. 4 Characteristics Version Displays the version number of the SNA LU Services module. PU Type independent Displays the type of physical unit on which SNA LU Services operates. The type defines the services and its subentities. Default Simplename Displays the Transmission Group that Transmission should be used when processing Group a Primary LU connection if the Partner LU entity associated with the connection has no Transmission Group defined. This allows Partner LU entities to name the remote network ID and the LU name for the remote LU but does not require that the Transmission Group be named. 4 Counters Creation Displays the date and time this entity was Time created. Total Displays the number of LU-LU sessions started Started by the SNA LU Services entity. Sessions Total Displays the number of sessions terminated Terminated since the SNA LU Services entity was Sessions created. Session Displays the number of session requests that Start the SNA LU Services entity could not honor. Failures SNA LU Services increments this counter each time the SNA LU Services entity generates a Session Start Failure event. ACTLUs Displays the number of ACTLU requests Received received. DACTLUs Displays the number of DACTLU requests Received received. Resource Displays the total number of resource allocation Allocation failures, such as failures caused by Failures insufficient memory. Protocol Displays the number of protocol violations Violation detected for all the sessions supported by Errors the SNA LU Services entity. SNA LU Services increments this counter each time the SNA LU Services entity generates a Protocol Violation Error event. 3 Access_Name_Subentity An SNA LU Services Access Name entity contains information that is required to establish a connection to the SNA network. The use of access names offers the client applications a way of connecting to the SNA network without having to know the exact IBM application names or logon mode names required. The use of access names is optional. 4 add add sna lu services access name The add sna lu services access name command adds a set of additional LU names to the LU List characteristic of an existing Access Name. The LU names may be complete names or contain wild cards (? or *). The only characteristic that this command takes is the LU List, which adds new LU names to an Access Name entity's LU List. Ex, ncl> add sna lu services access name cics - _ncl> lu list = {lu001,lu002,lu1*} 5 Characteristics LU List list of sna Optional characteristic that specifies network the entire set or a member of the set names of LUs accessible using this Access Name entity. The default is No names. The elements of the list must be separated by commas, and the list must be enclosed in braces, { }. 4 create create sna lu services access name The create sna lu services access name creates a single instance of the Access Name entity, allocates resources, and initializes attributes to their default values. Ex, ncl> create sna lu services access name cics - _ncl> lu list = {lu003, lu004, lu20*}, partner lu = cics17 5 Characteristics LU List sna-network- Specifies the set of SNA LU name[,...]} Services LU entities accessible using this Access Name entity. When users specify this access name, the Peer Server can assign the user to any available LU in the set. This characteristic is optional. You can use wild cards to specify the entire set of LUs (for example, L1*) or to specify one of the members in the set of LUs (for example, L1786, L19*, L18*). Logon Mode sna-network- Specifies the Logon Mode entity name that LU Services should use if the user does not specify a logon mode. This characteristic is optional. User Data text-string Specifies optional user-level data (surrounded by quotation marks) to pass to the remote LU. This data may include, for example, user name identification information. This characteristic is optional. The user data is entered as ASCII text and is translated to EBCDIC before being sent to the remote LU. Partner LU sna-network- Specifies the instance name of the name Partner LU entity that defines the remote LU. For a secondary LU connection, the Partner LU contains the name of the IBM application that the connection is to communicate with. For a primary LU connection, the Partner LU attribute names a Partner LU entity in the Peer Server. The Partner LU entity contains the actual qualified SNA Network Name and the Transmission Groups to use when establishing a connection to the remote application or terminal. This characteristic is optional. 4 delete delete sna lu services access name The delete sna lu services access name command removes the Access Name and deallocates its resources. Ex, ncl> delete sna lu services access name acnam-1 4 set set sna lu services access name The set sna lu services access name command lets you set the characteristics of the SNA LU Services Access Name entity. Refer to the create sna lu services access name command for more information about the Access Name subentity. Ex, ncl> set sna lu services access name lusvc2 - _ncl> logon mode = user08, partner lu = prtlu1 5 Characteristics LU List sna-network- Specifies the set of SNA LU name[,...]} Services LU entities accessible using this Access Name entity. When users specify this access name, the Peer Server can assign the user to any available LU in the set. This characteristic is optional. You can use wild cards to specify the entire set of LUs (for example, L1*) or to specify one of the members in the set of LUs (for example, L1786, L19*, L18*). Logon Mode sna-network- Specifies the Logon Mode entity name that LU Services should use if the user does not specify a logon mode. This characteristic is optional. User Data text-string Specifies optional user-level data (surrounded by quotation marks) to pass to the remote LU. This data may include, for example, user name identification information. This characteristic is optional. The user data is entered as ASCII text and is translated to EBCDIC before being sent to the remote LU. Partner LU sna-network- Specifies the instance name of the name Partner LU entity that defines the remote LU. For a secondary LU connection, the Partner LU attribute contains the name of the IBM application that the connection is to communicate with. For a primary LU connection, the Partner LU attribute names a Partner LU entity in the Peer Server. The Partner LU entity contains the actual qualified SNA Network Name and the Transmission Groups to use when establishing a connection to the remote application or terminal. This characteristic is optional. 4 show show sna lu services access name The show sna lu services access name command displays the values of the attributes for the SNA LU Services Access Name entity. Access names are optional; they serve as shortcuts for supplying several parameter values with one name. Ex, show sna lu services access name cics logon mode, lu list 5 Identifier Name Identifies the name given to the Access Name entity when it was created. 5 Characteristics LU List sna-network- Displays the set of SNA LU name[,...]} Services LU entities accessible using this Access Name entity. When users specify this access name, the Peer Server can assign the user to any available LU in the set. This characteristic is optional. You can use wild cards to specify the entire set of LUs (for example, L1*) or to specify one of the members in the set of LUs (for example, L1786, L19*, L18*). Logon Mode sna-network- Displays the Logon Mode entity name that SNA LU Services should use if the user does not specify a Logon Mode. This characteristic is optional. User Data text-string Displays optional user-level data (surrounded by quotation marks) to pass to the remote LU. This data may include, for example, user name identification information. This characteristic is optional. The user data is entered as ASCII text and is translated to EBCDIC before being sent to the remote LU. Partner LU sna-network- For a secondary LU connection, the name Partner LU attribute contains the name of the IBM application that the connection is to communicate with. For a primary LU connection, the Partner LU attribute names a Partner LU entity in the Peer Server. The Partner LU entity contains the actual qualified SNA Network Name and the Transmission Groups to use when establishing a connection to the remote application or terminal. This characteristic is optional. 3 Authorization_Subentity The Authorization subentity of the SNA LU Services entity is created to describe connection parameters that are optionally matched to an incoming client connection to validate access to Peer Server LUs. You can create multiple instances of the Authorization entity each with different characterisitics. If the information passed by a user matches the characteristics of an Authorization entity associated with the specified LU, then SNA LU Services allows the user to access the LU. An Authorization entity can describe DECnet, TCP/IP, or local connections. For a TCP/IP connection, the internet node characteristic is used instead of node. 4 create create sna lu services authorization The create sna lu services authorization command creates an SNA LU Services Authorization entity. The command allocates and sets the characteristics to their defaults. Ex, ncl> create sna lu services authorization programmers - _ncl> node=star, user=prg_*, password=axp, transport=decnet 5 Characteristics User Simplename Specifies the user name that the user must supply to be granted access to the LU. If the null user name is specified, SNA LU Services does not perform any user name checking when using this Authorization entity. The user name can contain wild card characters. Password Simplename Specifies the password that the user must supply to be granted access to the LU. If the null password is specified, SNA LU Services does not perform password checking when using this Authorization entity. Note that you cannot display this characteristic. Node full name Specifies the DECnet node that the user must supply to be granted access to the LU. If you do not specify the node name (0:), SNA LU Services does not perform node name checking when using this Authorization entity. Applies only if the transport is DECnet. Terminal Simplename Specifies the terminal that the user must use to be granted access to the LU. If the null terminal name is specified, SNA LU Services does not perform any terminal name checking when using this Authorization entity. The terminal name can contain wild card characters. Transport decnet | Specifies the transport that must tcpip | underlie a connection for the local connection to be authorized. Internet alpha-string Specifies the node name of the Node internet node that the user must use to be granted access to the LU. You can use wild cards when specifying the node name, Further, SNA LU Services performs no node checking if no node name is specified. 4 delete delete sna lu services authorization The delete sna lu services authorization command deletes the Authorization entity and deallocates its resources. Ex, ncl> delete lu services authorization auth-1 4 set set sna lu services authorization The set sna lu services authorization command lets you set the characteristics of the SNA LU Services Authorization entity. Ex, ncl> set sna lu services authorization luauth1 password = secret 5 Characteristics User Simplename Specifies the user name that the user must supply to be granted access to the LU. If the null user name is specified, SNA LU Services does not perform any user name checking when using this Authorization entity. The user name can contain wild card characters. Password Simplename Specifies the password that the user must supply to be granted access to the LU. If the null password is specified, SNA LU Services does not perform password checking when using this Authorization entity. Note that you cannot display this characteristic. Node full name Specifies the DECnet node that the user must supply to be granted access to the LU. If you do not specify the node name (0:), SNA LU Services does not perform node name checking when using this Authorization entity. Applies only if the transport is DECnet. Terminal Simplename Specifies the terminal that the user must use to be granted access to the LU. If the null terminal name is specified, SNA LU Services does not perform any terminal name checking when using this Authorization entity. The terminal name can contain wild card characters. Transport decnet | Specifies the transport that must tcpip | underlie a connection for the local connection to be authorized. Internet alpha-string Specifies the node name of the Node internet node that the user must use to be granted access to the LU. You can use wild cards when specifying the node name. Further, SNA LU Services performs no node checking if no node name is specified. 4 show show sna lu services authorization The show sna lu services authorization command displays the values of the attributes for the SNA LU Services Authorization entity. The password characteristic cannot be displayed. Ex, ncl> show sna lu services authorization payroll internet node, - _ncl> terminal, user 5 Identifier Name Identifies the name given to the Authorization entity when it was created. 5 Characteristics User Simplename Displays the user name that the user must supply to be granted access to the LU. If the null user name is specified, SNA LU Services does not perform any user name checking when using this Authorization entity. The user name can contain wild card characters. Node full name Displays the DECnet node that the user must use to be granted access to the LU. If you specify the node name (0:), SNA LU Services does not perform node name checking when using this Authorization entity. Applies only if the transport is DECnet. Terminal Simplename Displays the terminal that the user must use to be granted access to the LU. If the null terminal name is specified, SNA LU Services does not perform any terminal name checking when using this Authorization entity. The terminal name can contain wild card characters. Transport decnet | Displays the transport that must tcpip | underlie a connection for the local connection to be authorized. Internet character Displays the node name of the Node string Internet node. Applies only if the transport is tcpip. 3 LU_Subentity A logical unit is a named access point into an SNA network. The SNA LU Services LU entity defines one logical unit that is owned and managed by the Peer Server. Each logical unit has a corresponding SSCP-LU session which is also owned and managed by the entity. An LU can participate in one or more LU-LU sessions, each of which is supported by a corresponding Session subentity 4 add add sna lu services lu The add sna lu services lu command adds a set of additional Authorization entities to the authorization list characteristic of an existing LU. The names of the Authorization entities may be complete names or contain wildcards (? or *). Ex, ncl> add sna lu services lu l1905 - _ncl> authorization list = {programmers, managers} 5 Characteristics Authorization list of Specifies the set of Authorization List simple names entities securing this LU. Each value in the list is the name of an Authorization entity that defines a set of user characteristics. By associating particular Authoriz- tion entities with this LU, you authorize the users identified in those entities to use this LU. In order to activate the authorization check, you must set the access attribute of the LU to restricted. There is no default. 4 create create sna lu services lu The create sna lu services lu command creates one instance of an LU entity . The command also allocates resources for the entity and initializes attributes to their default values. An LU entity can be defined so that is has the capability to represent a secondary LU, a primary LU, or either a primary or secondary LU. You must define secondary LUs for non-SNA applications that communicate with primary LUs on an IBM system. You must define primary LUs for non-SNA applications that communicate with secondary LUs owned by an IBM system. Ex, ncl> create sna lu services lu lu01 access = restricted, _ncl> capability = primary 5 Characteristics Dependent LU Simplename Specifies the Transmission Group on Transmission which the LU acts as a dependent Group LU. Dependent 1-byte Specifies the LU address on the LU Address decimal transmission group on which the LU acts as a dependent LU. Maximum (0-65535) Specifies the maximum number of Active sessions allowed on this LU. If Sessions this LU is going to support HP SNA 3270 terminal emulation or any other application requiring single sessions on an LU, set the capacity to 1. Otherwise, you can set the capacity to 0, indicating unlimited sessions. If you later find that you want to restrict the number of sessions on this LU, you can change this characteristic to the maximum number of sessions you want to allow. Capability primary | Specifies whether this LU can act as secondary | a primary LU, secondary LU, or both. both The setting you choose depends on the capability of the HP SNA applications that will use this LU. If this LU is for applications that emulate a primary LU, set the capability as primary. If this LU is for non-SNA applications that emulate a secondary LU, set the capability as secondary. If you want this LU to be used for both types of non-SNA applications, set the capability to both. Object Simplename Specifies the name of an SNA Access Server Object entity that the SNA Access Server should use to initiate a connection to an access routine in response to an IBM-initiated session request. When the IBM side requests a session using this LU, the Peer Server uses the information provided in the Object entity to determine how to connect to the access routine. Destination Simplename Specifies an optional parameter that Unit the Peer Server name passes to HP SNA access routine products to identify a resource within the HP SNA access routine. It applies to IBM-initiated connections only. The HP SNA access routine determines the use of this characteristic. This characteristic is used in conjunction with Object characteristics to identify the non-SNA resource the Peer Server must connect to. Access restricted| Specifies whether SNA LU Services unrestricted should check authorization when a non-SNA user or application accesses this LU. If you set this LU as restricted, you must also define the specific authorization information required by using Authorization entities, and you must name those entities in the Authorization List characteristic for this LU. Authorization {simple- Specifies the set of authorization List name[,...]} entities securing this LU. Each value in the list is the name of an Authorization entity that defines a set of user characteristics. By associating particular Authorization entities with this LU, you authorize the users identified in those entities to use this LU. In order to activate the authorization check, you must set the access characteristic to restricted. Old Name [pu-name] Specifies an alternative name for session- this LU, usable by applications that number pair support only the older style of LU identification. One application that uses this older form is the HP SNA 3270 Terminal Emulation product. An Old Name characteristic must be defined for a Peer Server LU only when the application does not support using an access name for LU specification. If the name supplied contains a period (.), you must enclose it with quotes (""). 4 delete delete sna lu services lu The delete sna lu services lu command deletes an SNA LU Services LU entity instance and deallocates resources that were allocated for it. The LU must be in the off state for the delete to succeed. Ex, ncl> delete sna lu services lu lu001 4 disable disable sna lu services lu The disable sna lu services lu command disables the ability of the LU to establish a new LU-LU session without affecting current sessions. Any passively connected user Ports are terminated and the LU enters the Off entity state. You can also use the disable command to suspend the operation of an entity temporarily. An LU cannot be disabled if its dependent LU protocol state is in the active state. Ex, ncl> disable sna lu services lu lu002 4 enable enable sna lu services lu The enable sna lu services lu command puts the LU in a state wherein it is able to become active. The LU's entity state is set to on. Sessions can be started on a dependent LU when it is activated by the SSCP. For a dependent LU, the enable succeeds if the transmission group that is named exists in the SNA CP Services definition and the dependent LU address is unique. Ex, ncl> enable sna lu services lu lu002 4 set set sna lu services lu The set sna lu services lu command lets you set the characteristics for the SNA LU Services LU entity. Ex, ncl> set sna lu services lu l1905 access = restricted, - _ncl> capability = primary 5 Characteristics Dependent LU Simplename Specifies the Transmission Group on Transmission which the LU acts as a dependent Group LU. Dependent 1-byte Specifies the LU address on the LU Address decimal transmission group on which the LU acts as a dependent LU. Maximum (0-65535) Specifies the maximum number of Active sessions allowed on this LU. If Sessions this LU is going to support HP SNA 3270 terminal emulation or any other application requiring single sessions on an LU, set the capacity to 1. Otherwise, you can set the capacity to 0, indictaing unlimited sessions. If you later find that you want to restrict the number of sessions on this LU, you can change this characteristic to the maximum number of sessions you want to allow. Capability primary | Specifies whether this LU can act as secondary | a primary LU, secondary LU, or both. both The setting you choose depends on the capability of the HP SNA applications that will use this LU. If this LU is for applications that emulate a primary LU, set the capability as primary. If this LU is for non-SNA applications that emulate a secondary LU, set the capability as secondary. If you want this LU to be used for both types of non-SNA applications, set the capability to both. Object Simplename Specifies the name of an SNA Access Server Object entity that the SNA Access Server should use to initiate a connection to an access routine in response to an IBM-initiated session request. When the IBM side requests a session using this LU, the Peer Server uses the information provided in the Object entity to determine how to connect to the access routine. Destination Simplename Specifies an optional parameter that Unit the Peer Server name passes to HP SNA access routine products to identify a resource within the HP SNA access routine. It applies to IBM-initiated connections only. The HP SNA access routine determines the use of this characteristic. This characteristic is used in con- junction with Object characteristics to identify the non-SNA resource the Peer Server must connect to. Access restricted| Specifies whether SNA LU Services unrestricted should check authorization when a non-SNA user or application accesses this LU. If you set this LU as restricted, you must also define the specific authorization information required by using Authorization entities, and you must name those entities in the Authorization List characteristic for this LU. Authorization {simple- Specifies the set of authorization List name[,...]} entities securing this LU. Each value in the list is the name of an Authorization entity that defines a set of user characteristics. By associating particular Authorization entities with this LU, you authorize the users identified in those entities to use this LU. In order to activate the authorization check, you must set the access characteristic to restricted. Old Name [pu-name] Specifies an alternative name for session- this LU, usable by applications that number pair support only the older style of LU identification. One application that uses this older form is the HP SNA 3270 Terminal Emulation product. An Old Name characteristic must be defined for a Peer Server LU only when the application does not support using an access name for LU specification. If the name supplied contains a period (.), you must enclose it with quotes (""). 4 show show sna lu services lu The show sna lu services lu command displays the values of the attributes for the SNA LU Services LU entity. Ex, ncl> show sna lu services lu lu01 all counters 5 Identifier Name Identifies the name given to the LU entity when it was created. 5 Status UID Displays the unique identifier for the LU entity. State Displays the operational state of this LU entity. Off You have issued a disable command for this LU. The LU is in the inactive or pending inactive state. On You have issued an enable command for this LU. The LU is operational and is either supporting sessions, is ready to support sessions, or is in the pending active state. Protocol Displays the protocol state of this LU. State Active This LU is enabled and is ready to be used in sessions. Inactive This LU is not enabled. You must issue an enable command before SNA LU Services can activate the LU. In Use This LU is active and is in session, has a link to a non-SNA application, or both. Active Ports Displays the number of SNA ACCESS Server Port entity instances that are using this LU, which may or may not be involved in an active LU-LU session. Active Displays the number of active LU-LU sessions sessions on this LU. You can limit this number by setting the Maximum Active Sessions characteristic of the LU entity. Peak Active Displays the highest number of LU-LU sessions Sessions active at any one time on this LU. Queued Displays the number of outstanding queued Sessions session requests for this LU. Peak Queued Displays the highest number of LU-LU sessions Sessions queued at any one time on this LU. Activation Displays the time at which the LU was last Time activated by the SSCP. Dependent LU Displays an indication of whether the Protocol State dependent LU has been activated by the SSCP. 5 Characteristics Dependent LU Simplename Displays the Transmission Group on Transmission which the LU acts as a dependent Group LU. Dependent 1-byte Displays the LU address on the LU Address decimal Transmission Group on which the LU acts as a dependent LU. Maximum (0-65535) Displays the maximum number of Active sessions allowed on this LU. A Sessions value of 0 means unlimited sessions. Capability primary | Displays whether this LU can act as a secondary | primary LU, secondary LU, or both. both Object Simplename Displays the name of an SNA Access Server Object entity that the SNA Access Server should use to initiate a connection to a non-SNA access routine in response to an IBM-initiated session request. Destination Simplename Displays an optional parameter that Unit the Peer Server name passes to non-SNA access routine products to identify a resource within the non-SNA access routine. It applies to IBM-initiated connections only. Access restricted| Displays whether SNA LU Services unrestricted should check authorization when a non-SNA user or application accesses this LU. Authorization {simple- Displays the set of Authorization List name[,...]} entities securing this LU. Each value in the list is the name of an Authorization entity that defines a set of user characteristics. Old Name [pu-name] Displays an alternative name for session- this LU, usable by non-SNA number pair applications that support only the older style of LU identification. 5 Counters Creation Displays the date and time this entity was Time created. SSCP-LU Displays the total number of bytes sent on the Octets Sent SSCP-LU session. SSCP-LU Octets Displays the total number of bytes received Received on the SSCP-LU session. SSCP-LU Displays the total number of RUs sent on the RUs Sent SSCP-LU session. SSCP-LU RUs Displays the total number of RUs received on Received SSCP-LU session. Total Octets Displays the total number of bytes sent by the Sent LU for all sessions (LU-LU and SSCP-LU). Total Octets Displays the total number of bytes received by Received the LU for all sessions (LU-LU and SSCP-LU). Total RUs Displays the total number of RUs sent by the Sent LU for all sessions (SSCP-LU and LU-LU). Total RUs Displays the total number of RUs received by Received the LU for all sessions (SSCP-LU and LU-LU). ACTLUs Displays the number of ACTLU requests Received received. Started Displays the number of times an LU-LU Sessions successfully started on this LU. Terminated Displays the number of LU-LU sessions that Sessions have terminated on the LU since it was created. SNA LU Services increments this counter each time the LU entity generates a Session Terminated event. DACTLUs Displays the number of DACTLU requests Received received. BIND Displays the number of BIND requests that Failures have been rejected on this LU. Authorization Displays the total number of access violations Failures caused by lack of authorization. Access violations occur when the Access characteristic of an LU entity is set to Restricted and valid authorization information has not been supplied in the session request. 3 Partner_LU_Subentity The SNA LU Services Partner LU entity is an internal definition that corresponds to a remote LU. Partner LUs contain information that describes an LU in the SNA network that is to be connected to when the non-SNA application acts as the Primary LU (PLU). The real IBM LU name and network ID are contained in the Partner LU definition, along with a list of Peer Server Transmission Groups that can be used to connect to the remote LU. The Partner LU database is not used for Dependent LU sessions (3270 TE or RJE, for example). An instance of the Partner LU entity must exist to describe each LU in the SNA network that is to be connected to by non-SNA PLU applications. 4 add add sna lu services partner lu The add sna lu services partner lu command lets you add a set of additional transmission group entries to the list of transmission groups for the Partner LU. Be sure to use braces to confine a list of values. Remember to separate list values and two or more characteristics with commas. Ex, ncl> add sna lu services partner lu l1905 - _ncl> transmission group = {tg03} 5 Characteristics Transmission list of Specifies a list of the Transmission Group Simplenames Groups to be used to connect to the remote LU. 4 create create sna lu services partner lu The create sna lu services partner lu command creates an SNA LU Services Partner LU entity instance. The create command allocates resources for the entity and initializes entity attributes to their default values. Ex, ncl> create sna lu services partner lu cics17 5 Characteristics Destination Simplename Specifies the name of the remote LU Name as known to the SNA network. Destination Simplename Specifies the network id of the Network network in which the remote LU resides. Transmission list of Specifies a list of the Transmission Group Simplenames Groups to be used to connect to the remote LU. 4 delete delete sna lu services partner lu The delete sna lu services partner lu command removes the entity and deallocates its resources. Ex, ncl> delete sna lu services partner lu cics17 4 set set sna lu services partner lu The set sna lu services partner lu command lets you set the attributes for the SNA LU Services Partner LU entity. Ex, ncl> set sna lu services partner lu l1905 - _ncl> transmission group = {tg01, tg02} 5 Characteristics Destination Simplename Specifies the name of the remote LU Name as known to the SNA network. Destination Simplename Specifies the network ID of the Network network in which the remote LU resides. Transmission list of Specifies a list of the Transmission Group Simplenames Groups to be used to connect to the remote LU. 4 show show sna lu services partner lu The show sna lu services partner lu command displays the attributes for the SNA LU Services Partner LU entity. The SNA LU Services Partner LU has no counter attributes. Ex, ncl> show sna lu services partner lu cics17 all characteristics 5 Identifier Name Displays the name given to the Partner LU by the Peer Server when it was created. 5 Status Definition Displays how the Partner LU was created. Values are "Static" and "Dynamic." 5 Characteristics Destination sna-network- Displays the name of the remote LU Name name as known in the SNA network. Destination sna-network- Displays the network ID of the Network name network in which the remote LU resides. Transmission list of Displays a list of the Transmission Group Simplenames Groups to be used to connect to the remote LU. 3 LU_Session_Subentity The SNA LU Services LU Session entity is created dynamically by the Peer Server in response to LU-LU session initiation requests. It is deleted dynamically when the corresponding session terminates. Multiple instances of this entity can exist. 4 show show sna lu services lu session The show sna lu services lu session command displays the values of the attributes for the SNA LU Services LU Session entity. The SNA LU Services LU Session entity has no characteristic attributes. Ex, ncl> show sna lu services lu lu01 session 2 transmission group, - _ncl> lfsid 5 Identifier Name Identifies the name given to the Session entity by the Peer Server when it was created by the Peer Server. 5 Status SID Displays the 8-byte identifier assigned to the session by the CP of the initiating LU. This identifier is used in control messages. LFSID Displays the session identifier for a given session. Protocol State Displays the operational state of this LU-LU session: Active The LU-LU session BIND negotiation was successful, and the two LUs are now exchanging data on this session. BINDing The primary and secondary LUs are negotiating the BIND for the LU-LU session. Initiating The Peer Server has started internal session startup operation. Ready The session has initiated and is waiting for a BIND request from either the SNA or non-SNA session partner. Terminating The LUs have unbound the session, and the Peer Server and the remote CP are now terminating the session. UNBINDing The two LUs are exchanging UNBIND commands to end the session. Port Displays the name of the SNA Access Server Port entity supporting this session. Each Port entity represents a non-SNA application link. Remote LU Displays the name of the external LU that the Peer Server LU is in session with. Remote Network Displays the name of the network in which the remote LU resides. Initiating Displays the name of the LU that requested the LU session. Role Displays the role (primary or secondary) this LU is assigned in he LU-LU session. Transmission Displays the name of the Transmission Group Group that the LU-LU session is using. Logon Mode Displays the logon mode used to establish this session. Primary Displays the maximum RU size that can be RU Size sent by the primary LU on this session. Primary Displays the primary LU's send pacing window Send Pacing size for this session. Primary Displays the primary LU's receive pacing Receive Pacing window size for this session. Secondary Displays the maximum RU size that can be RU Size sent by the secondary LU on this session. Secondary Displays the secondary LU's send pacing Send Pacing window size for this session. Secondary Displays the secondary LU's receive pacing Receive Pacing window size for this session. LU Type Displays the LU type specified in the BIND for this session. Session Type Displays whether the session is a dependent or independent LU session. 5 Counters Creation Displays the date and time this entity was Time created. Octets Sent Displays the total number of bytes sent on this session by the LU. Octets Displays the total number of bytes received Received on this session by the LU. RUs Sent Displays the total number of RUs sent on this session by the LU. RUs Displays the total number of RUs received on Received this session by the LU. 4 stop stop sna lu services lu session The stop sna lu services lu session command starts the protocol procedures that terminates the LU-LU session. The stop command completes without waiting for the session to complete. Ex, ncl> stop sna lu services lu lu01 session 2 severity = cleanup 5 Arguments Severity The type of termination of the LU-LU session that you want to initiate. The argument values are as follows: Cleanup This is the severest form of termination. The session is ended without acknowledgment from the Remote LU or the Remote SSCP. Use this form as a last resort. Forced This type is also a severe form of termination. The session is being ended immediately and unconditionally. Orderly This type of termination ends the session as soon as the PLU can do so. It is the least severe form of termination. 2 SNA_CP_Services The SNA CP Services entity contains all the information that pertains to the Control Point, Path Control, and DLC Manager components. The module represents the SNA T2.1 node component that manages the T2.1- specific node component. Its only subentity is the Transmission Group entity. 3 create create sna cp services The create verb creates the SNA CP Services entity. The create sna cp services command also allocates resources for the entity and sets its characteristics to their default values. Ex, ncl> create sna cp services cp name = xcp01, - _ncl> network id = usdec101 4 Characteristics Network ID Simplename Specifies the network id of the T2.1 node. The required name must conform to SNA naming conventions. You should consult with the SNA administrator about this name. CP Name Simplename Specifies the network name of the CP. The required name must conform to SNA naming conventions. You should consult with the SNA administrator about this name. Maximum (1-2048) Specifies the maximum number of Active TGs Transmission Groups that can be concurrently active. This optional value can be set at any time. The default value is 4. 3 delete delete sna cp services The delete sna cp services command deletes the SNA CP Services entity. Before you can delete the SNA CP Services entity, you must first delete all its Transmission Group subentities. Ex, ncl> delete sna cp services 3 set set sna cp services The set sna cp services command lets you set the characteristics for the SNA CP Services entity. The SNA CP Services entity contains all the information that pertains to the Control Point, Path Control, and DLC Manager components. Ex, ncl> set sna cp services maximum active tgs = 250 4 Characteristic Maximum (1-2048) Specifies the maximum number of Active TGs Transmission Groups that can be concurrently active. If you specify a value less than the number of currently active Transmission Groups, you cannot activate new Transmission Groups until the number of currently active Transmission Groups falls below this value. This value can be set at any time. 3 show show sna cp services The show sna cp services command displays the values of the attributes for the SNA CP Services entity. The SNA CP Services entity contains all the information that pertains to the Control Point, Path Control, and DLC Manager components. Ex, ncl> show sna cp services cp name, network id 4 Status UID Display the UID associated with the SNA CP Services entity. Active PUs Displays the number of active PUs. Active TGs Displays the number of active Transmission Groups. 4 Characteristics Version Displays the version number of the SNA CP Services software that is executing. Network ID Simplename Specifies the network ID of the T2.1 node. The required name must conform to SNA naming conventions. You should consult with the SNA administrator about this name. CP Name Simplename Specifies the network name of the CP. The required name must conform to SNA naming conventions. You should consult with the SNA administrator about this name. Maximum (1-2048) Specifies the maximum number of Active TGs Transmission Groups that can be concurrently active. This optional value can be set at any time. 4 Counters Successful TG Displays the total number of successfully Activations completed Transmission Group activation procedures. TG Activation Displays the total number of Transmission Failures Group activations procedures that have failed to complete due to an XID exchange error. TG Deactivations Displays the total number of times Transmission Groups have been deactivated. TG Connections Displays the total number of times a Lost Connection Lost event has been generated. COLD ACTPUs Displays the total number of COLD ACTPUs Received received. ERP ACTPUs Displays the total number of ERP ACTPUs Received received. ACTPUs Rejected Displays the total number of negative responses sent to ACTPU requests. DACTPUs Displays the total number of DACTPUs received. Received Protocol Displays the total number of SNA protocol Violations violations detected by the Peer Server. Resource Displays the number of resource allocation Allocation failures (for example, insufficient memory). Failures Creation Time Displays the time that the SNA CP Services entity was created. 3 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. 4 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 5 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. 4 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 4 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 5 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 4 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 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. 4 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 5 Identifier Name The unique Simplename of the Transmission Group entity that is maintained by the Peer Server. 5 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 5 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. 5 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. 2 LLC2 The LLC2 entity represents the LLC2 protocol on the Peer Server and its accessibility by client applications. The LLC2 module controls the operation of the LLC Type 2 data link protocol for local area networks (LANs). The Peer Server supports a single instance of the LLC2 entity. The subordinate entities of the LLC2 entity are the Port and the SAP (service access point). The Port subentity exists when an LLC2 connection is established to an adjacent link station. Ports are dynamically created and deleted as connections are made and broken. An instance of the SAP subentity must exist for each LLC2 port. The SAP subentity is the access point to the underlying LAN station. There is one SAP for each protocol on the LAN adapter. The SAP entity has the Link subentity, which represents a remote LAN station and its associated SAP. 3 create create llc2 The create llc2 command creates an LLC2 entity, which provides support for LLC Type 2 data link protocol for local area networks. There is only one instance for each node. Ex, ncl> create llc2 3 delete delete llc2 The delete llc2 command deletes the single LLC2 entity. You cannot delete the entity while subentities (Ports and SAPs) exist. Ex, ncl> delete llc2 3 show show llc2 The show llc2 command displays the attributes of the LLC2 entity. Ex, ncl> show llc2 all 4 Characteristic version Displays the version number of the SNA LLC2 software that is executing. 3 SAP_subentity An instance of the SAP subentity must exist for each LLC2 port. The SAP (service access point) subentity is the access point to the underlying LAN station. There is one SAP for each protocol on the LAN adapter. 4 create create llc2 sap The create llc2 sap command creates an instance of the LLC2 SAP subentity for each protocol that LLC2 uses. The create command also allocates resources for the subentity and sets its characteristics to their default values. Ex, ncl> create llc2 sap sna-0 4 delete delete llc2 sap The delete llc2 sap command deletes a named LLC2 SAP instance. You can delete a SAP instance only when it has no active Link subentities and it is disabled. Ex, ncl> delete llc2 sap sna-0 4 disable disable llc2 sap The disable llc2 sap command disables a named LLC2 SAP instance. Ex, ncl> disable llc2 sap sna-0 4 enable enable llc2 sap The enable llc2 sap command enables a named LLC2 SAP instance. Ex, ncl> enable llc2 sap sna-0 4 set set llc2 sap The set llc2 sap command lets you set the attributes for the LLC2 SAP subentity. Ex, ncl> set llc2 sap sna-0 lan station token ring station trn-0 5 Characteristics LAN Station Local entity Specifies the name of the LAN station entity used by the name SAP. You must specify this value before trying to enable the SAP. Local LSAP 2 characters Specifies the local link service Address (hexadecimal) access point (LSAP) to be used. The address must be unique. For use with the Peer Server, this value is normally set to 04. 4 show show llc2 sap The show llc2 sap command displays the attributes for the LLC2 SAP subentity. Ex, ncl> show llc2 sap sna-0 all 5 Identifier Name Displays the simplename assigned when the LLC2 SAP was created. 5 Status State Displays the entity state of the LLC2 SAP entity. Possible values are: off The SAP is disabled. on The SAP is enabled. LAN Port Displays the name of the LAN Port that is opened and enabled when this SAP is successfully enabled. The status has a null value if the SAP is not enabled. Maximum PDU Displays the largest frame size, in octets, that Size can be used to send or receive data on this SAP. UID Displays the entity's unique identifier that was assigned when the entity was created. 5 Characteristics LAN Station Local entity Displays the name of the LAN station entity used by the name SAP. You must specify this value before trying to enable the SAP. Local LSAP 2 characters Displays the local link service Address (hexadecimal) access point (LSAP) to be used. 5 Counters Creation Displays the time that the entity was created. Time Times SAP Displays the number of times the SAP state has State Changed changed from on to off, or from off to on. 3 SAP_Link_subentity The Link subentity of the SAP represents a remote LAN station and its associated SAP. 4 create create llc2 sap link The create llc2 sap link command creates a link to a remote LAN station that operates over a particular service access point (SAP). Ex, ncl> create llc2 sap sna-0 link link-2 4 delete delete llc2 sap link The delete llc2 sap link command deletes a named LLC2 SAP Link instance. You can delete a SAP Link instance only when it is disabled and the transmission group that uses it is disabled. Ex, ncl> delete llc2 sap sna-0 link link-2 4 disable disable llc2 sap link The disable llc2 sap link command disables a named LLC2 SAP Link instance. Ex, ncl> disable llc2 sap sna-0 link link-2 4 enable enable llc2 sap link The enable llc2 sap link command makes a named LLC2 SAP Link instance available for connections. Ex, ncl> enable llc2 sap sna-0 link link-2 4 set set llc2 sap link The set llc2 sap link command lets you set the attributes for the LLC2 SAP Link subentity. Ex, ncl> set llc2 sap sna-0 link link-2 acknowledge timer = 2000 5 Characteristics Acknowledge (1-60000) Specifies the time (in milliseconds) Timer that the link waits for an acknowledgment before initiating recovery action. The default is 1000. Holdback Timer (0-60000) Specifies the delay (in milliseconds) before an acknowldgment must be sent. The default is 500. Maximum (1-65531) Specifies the largest frame size (in Data Size octets) that the link can use to send or receive data. This value does not include the size of the frame header. The default is 1028. Local Receive (1-127) Specifies the size of the window used Window Size by the link for receiving frames. The default is 127. Retry Maximum (1-255) Specifies the maximum number of times that the link retransmits a frame before assuming a fatal error and taking more drastic recovery action. The default is 10. Remote Mac LAN Specifies the unique destination MAC Address address address to be used by the link. The default is 00-00-00-00-00-00. Remote LSAP 2 character Specifies the unique address of the Address (hexa- destination LSAP (local service decimal) access point) to be used by the link. For use with the Peer Server, this value is normally set to 04. 4 show show llc2 sap link The show llc2 sap link command displays the attributes for a link that operates over a particular service access point (SAP). Ex, ncl> show llc2 sap sna-0 link link-2 all 5 Identifier Name Displays the Simplename assigned to the link when it was created. 5 Status Active Maximum Displays the negotiated maximum frame size Data Size (excluding the header) that can be sent and received on this link. The value is the smallest maximum data size of the Link, the SAP, and the adjacent link. State Displays the entity state of the llc2 link. Possible values are: off The link is disabled. on The link is enabled. Protocol Displays the state of the LLC2 protocol with State respect to the remote station. Possible states are: error The protocol is in a recognized error state. disconnecting The protocol is being disconnected. halted The protocol has halted. initializing The protocol is being initialized. inoperative The protocol cannot be started because the LAN station cannot provide a connection to a remote station. resetting The protocol is being reset. running The protocol is running normally. Remote LLC Class Displays the class of the remote LLC. Possible classes are: 1 Class 1 LLC. Only type 1 operation is supported. 2 Class 2 LLC. Both type 1 and type 2 operations are supported. unknown The class has not yet been established. The class is established during XID exchange between the local and remote LLC implementations. Remote Receive Displays the window size used by the remote Window Size station for receiving frames. The local station uses this value as its window for transmitting frames. UID Displays the unique identifier of the entity, which is generated when the entity is created. 5 Characteristics Acknowledge (1-60000) Displays the time (in milliseconds) Timer that the link waits for an acknowledgment before initiating recovery action. Holdback Timer (0-60000) Displays the delay (in milliseconds) before an acknowledgment must be sent. Maximum (1-65531) Displays the largest frame size (in Data Size octets) that the link can use to send or receive data. This value does not include the size of the frame header. Local Receive (1-127) Displays the size of the window used Window Size by the link for receiving frames. Retry Maximum (1-255) Displays the maximum number of times that the link retransmits a frame before assuming a fatal error and taking more drastic recovery action. Remote MAC LAN Displays the unique destination MAC Address address address to be used by the link. Remote LSAP 2 characters Displays the unique address of the Address (hexa- destination LSAP (local service decimal) access point) to be used by the link. 5 Counters Data Octets Displays the number of data octets received in Received I-frames and UI-frames from the remote end of the link. This value does not include retransmissions. Data Octets Displays the number of data octets sent in Sent I-frames and UI-frames to the remote end of the link. This value does not include retransmissions. Data PDUs Displays the number of I-frames and UI-frames Received received from the remote end of the link. This value does not include retransmissions. Data PDUs Displays the number of I-frames and UI-frames sent Sent to the remote end of the link. This value does not include retransmissions. REJs Received Displays the number of REJ (reject) frames received. REJs Sent Displays the number of REJ (reject) frames transmitted. RNRs Received Displays the number of RNR (receive not ready) frames received. RNRs Sent Displays the number of RNR (receive not ready) frames transmitted. XIDs Received Displays the number of XID frames received. XIDs Sent Displays the nubmer of XID framed transmitted. FRMRs Received Displays the number of FRMR (frame reject) frames received. FRMRs Sent Displays the number of FRMR (frame reject) frames generated as a result of invalid incoming frames. Polls Received Displays the number of command frames received with the P-bit set. Times Acknowledge Displays the number of times the local acknowledge Timer Expired timer has expired. Times Poll Displays the number of times the local poll timer Timer Expired has expired. Times Reject Displays the number of times the local reject Timer Expired timer has expired. Times Busy Displays the number of times the local busy timer Timer Expired has expired. Times Link Displays the number of times the link's state State Changed changed from on to off, or from off to on. Times Link Displays the number of times the link's protocol Running state status attribute was set to running. When the link enters the running state, the protocol has been successfully initialized or reset. Times Link Displays the number of times the link's protocol Initializing state status attribute was set to initializing. Times Link Displays the number of times the link's protocol Resetting state status attribute was set to resetting. Times Link Displays the number of times the link's protocol Halted state status attribute was set to halted. Times Link Displays the number of times the link's protocol Inoperative state status attribute was set to inoperative. Times Link Displays the number of times the LLC2 fails to Setup Failed initialize correctly after the maximum number of retries. Creation Time Displays the time at which the entity was created. 3 Port_subentity The Port subentity exists when an LLC2 connection is established to an adjacent link station. Ports are dynamically created and deleted as connections are made and broken. 4 show show llc2 port The show llc2 port command displays the attributes of the LLC2 Port entity. Ex, ncl> show llc2 port llc2-port-000 all 5 Identifier name A unique value assigned to the Port by the LLC2 entity. The value is in the form LLC2-port-nnn, where nnn is an unsigned integer. 5 Status Client Displays the name of the client that opened the port. Link Displays the name of the SAP Link entity associated with this port. State Displays the entity state of the port. Possible state values are: open The port is assigned to a client and is enabled. open disabled The port is assigned to a client but is disabled. 2 QLLC The QLLC entity represents the QLLC protocol on the Peer Server and its accessibility by client applications. The Peer Server supports a single instance of QLLC. The subordinate entities of the QLLC entity are the Port and the Link. Ports exists when a QLLC connection is established to an adjacent link station. Ports are dynamically created and deleted as client connections are made and broken. A Link must exist for each X.25 communication line. The Link defines the local link station to the Peer Server and contains the management attributes for the operation of all supported station components. It also contains information that permits the identification of the associated X.25 server component. The Link entity has the Station subentity that represents the remote DTE (Data Terminal Equipment address) of a station that operates over a particular X.25 logical link. 3 create create qllc The create qllc command creates a QLLC entity, which provides support for communication over X.25 networks. There is only one instance for each node. There is one QLLC Link for each local X.25 DTE address (only one link can exist on the Peer Server). For each remote X.25 DTE address that can be reached using a QLLC link, QLLC uses a subordinate Station entity. For each QLLC connection between a QLLC link and a QLLC station, QLLC creates a dynamic PORT entity to represent the connection to the network. Ex, ncl> create qllc 3 delete delete qllc The delete qllc command deletes the single QLLC instance. You cannot delete the QLLC entity while subentities (Links and Ports) exist. Ex, ncl> delete qllc 3 show show qllc The show qllc command displays the attributes for the qllc entity. Ex, ncl> show qllc all counters 4 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. Connections Displays the number of connections that are currently active. 4 Characteristic Version Displays the version number of the SNA QLLC software that is executing. 4 Counters Resource Allocation The total number of resource allocation Failures failures; for example, insufficient memory. Creation Time The time that the QLLC entity was created. 3 Link_subentity The Link subentity defines the local link station to the Peer Server and contains the management attributes for the operation of all supported station components. It also contains information that permits the identification of the associated X.25 server component. An instance of this subentity must exist for each X.25 communication line. 4 create create qllc link The create qllc link command creates an instance of the QLLC Link subentity for each local X.25 DTE address. The Link subentity is the access point into the X.25 protocol for QLLC connections to remote system. The create command also allocates resources for the subentity and sets its characteristics to their default values. Ex, ncl> create qllc link qllc-0 dte address = 12345678901 5 Characteristics Subsequent 1-8 characters Specifies an octet string that is Protocol (hexadecimal) used to filter incoming X.25 calls Identifier for a specific protocol. This value corresponds to the Data Call value in the X.25 configuration. It is only needed to handle incoming connections. The default value is hexadecimal C3 (QLLC Protocol). Filter Name Simplename Specifies the name of the Filter to be used for incoming QLLC (X.25) connections. This name must be specified for links that will use both incoming or outgoing connec- tions. The name must also match an X25 Access Filter that exists in the node's X.25 configuration. The default is filter_qllc. Template Name Simplename Specifies the name of the Template to be used for creating an outbound QLLC connection. This name must match an X25 Access Template in the node's X.25 configuration. The default is template_qllc. DTE Class Simplename Specifies the name of the DTE class to be used for creating an outbound connection. This name must match an X25 Access DTE Class names that exists in the local node's X.25 configuration. The default is class_qllc. 4 delete delete qllc link The delete qllc link command deletes an instance of the QLLC Link subentity and deallocates resources for the subentity. The Link subentity must be in the off state and must have no Station subentities. Ex, ncl> delete qllc link qllc-0 4 disable disable qllc link The disable qllc link disables an instance of the QLLC Link subentity. You can only disable a previously enabled entity. The disable command stops the operation of the Link subentity. For the disable command to be successful, all Station subentities on the Link must have been disabled. At the completion of the command the subentity is in the off entity state. Ex, ncl> disable qllc link qllc-0 4 enable enable qllc link The enable qllc link command places the QLLC Link subentity in its enabled state (on). Ex, ncl> enable qllc link qllc-0 4 set set qllc link The set qllc link command lets you set the attributes of the QLLC Link subentity. The QLLC Link subentity defines the data link attributes that are shared by its Station subentities. Ex, ncl> set qllc link qllc-0 dte address = 12345678901 5 Characteristics Subsequent 1-8 characters Specifies an octet string that is used Protocol (hexadecimal) to filter incoming X.25 calls for a Identifier specific protocol. This value corres- ponds to the Call Data value in the X.25 configuration. It is only needed to handle incoming connections. The default value is hexadecimal C3 (QLLC Protocol). Filter Name Simplename Specifies the name of the Filter to be used for incoming QLLC (X.25) connec- tions. This name must be specified for links that will use both incoming or outgoing connections. The name must also match an X25 Access Filter that exists in the node's X.25 configuration. The default is filter_qllc. Template Simplename Specifies the name of the Template to Name be used for creating an outbound QLLC connection.This name must match an X25 Access Template in the node's X.25 configuration. The default is template_qllc. DTE Class Simplename Specifies the name of the DTE class to be used for creating an outbound connection. This name must match an X25 Access DTE Class names that exists in the local node's X.25 configuration. The default is class_qllc. 4 show show qllc link The show qllc link command displays the attributes for the QLLC Link subentity. The QLLC Link subentity defines the data link attributes that are shared by its Station subentities. Ex, ncl> show qllc link qllc-0 all status 5 Identifier Name Displays the name of the Link. 5 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. State Displays the operational state of this QLLC Link subentity. inoperable The Link cannot be enabled. off You have issued a disable command for this Link. The Link is in the Inactive or Pending Inactive state. on You have issued an enable command for this Link. 5 Characteristics Subsequent 1-8 characters Displays an octet string that is used Protocol (hexadecimal) to filter incoming X.25 calls for a Identifier specific protocol. This value corres- ponds to the Call Data value in the X.25 configuration. It is only needed to handle incoming connections. Filter Simplename Displays the name of the Filter to be Name used for incoming QLLC (X.25) connec- tions. This name must be specified for links that will use both incoming or outgoing connections. The name must also match an X25 Access Filter that exists in the node's X.25 configuration. Template Simplename Displays the name of the Template to Name be used for creating an outbound QLLC connection.This name must match an X25 Access Template in the node's X.25 configuration. DTE Class Simplename Displays the name of the DTE class to be used for creating an outbound connection. This name must match an X25 Access DTE Class names that exists in the local node's X.25 configuration. 5 Counters Creation Time Displays the time that the QLLC Link subentity was created. 3 Link_Station_subentity The QLLC Link Station subentity represents the remote DTE (Data Terminal Equipment address) of a station that operates over a particular X.25 logical link. 4 create create qllc link station The create qllc link station command creates an instance of the Station subentity of a QLLC Link entity for each remote DTE address and allocates resources for the subentity. There is a station subentity for each remote DTE (data terminal equipment) address with which a virtual circuit can be associated. The create command sets the characteristic attributes to their default values. Ex, ncl> create qllc link qllc-0 station stn-0 5 Characteristics Usage Type outgoing | Specifies the type of connections that incoming | can run over this station. If set to both incoming, then only IBM initiated X.25 connections are allowed. If set to outgoing, then the Peer Server will initiate connections. If set to both both either end can initiate connections. The default is outgoing. Retry (0-255) Specifies the maximum number of times Maximum to retry when an error occurs. The default is 4. Retry (1-600) Specifies the time in seconds to wait Timeout between retries. The default is 10. Contact yes | no Specifies whether the secondary Terminal station awaits receipt of a QRR command or of the first data frame before establishment of the link connection is acknowledged. The default is no. Capability primary | Specifies the capability of the secondary| Station subentities of this negotiable Link entity. Negotiable stations can become either primary or secondary. The default is negotiable. Call User 2 characters Specifies the hexadecimal string that Data (hexadecimal) identifies the type of X.25 to be made to create a QLLC connection. The default value is hexadecimal C3 (QLLC protocol). Remote DTE DTEaddress Specifies the X.25 DTE address of the Address remote station. If the Peer Server initiates the connection, this is the address that will be called. For an IBM initiated connection, if the Usage Type parameter is set to Incoming, this address will be matched against the caller's address and if not matched, the call will be rejected. Maximum BTU (128-4095) Specifies the size that SNA messages Size will be segmented into before being sent to the X.25 network. (The X.25 network may further segment packets based on the level 2 profile information being used.) The default is 512. 4 delete delete qllc link station The delete qllc link station command deletes the Station subentity. The Station subentity must be in the off state before it can be deleted Ex, ncl> delete qllc link qllc-0 station stn-0 4 disable disable qllc link station The disable qllc link station command stops the operation of the Station subentity of the Link. If a connection exists, the disable command halts protocol operation. When execution of the command completes, the Station entity enters the off entity state. Ex, ncl> disable qllc link qllc-0 station stn-0 4 enable enable qllc link station The enable qllc link station command enables the Station for use. An enabled Station can accept incoming connection requests or initiate outgoing connection requests. The Link entity must be enabled before you issue this command. An association may be made between the station subentity and the X.25 service provider by selecting an X.25 logical channel on which the QLLC protocol operates. Ex, ncl> enable qllc link qllc-0 station stn-0 4 set set qllc link station The set qllc link station command let you set the attributes for QLLC Link Station subentity. The QLLC Station subentity contains the data link attributes that are configured for this connection. Ex, ncl> set qllc link qllc-0 station stn-0 capability = primary 5 Characteristics Usage Type outgoing | Specifies the type of connections that incoming | can run over this station. If set to both incoming, then only IBM initiated X.25 connections are allowed. If set to outgoing, then the Peer Server will initiate connections. If set to both then either end can initiate connec- tions. The default is outgoing. Retry (0-255) Specifies the maximum number of times Maximum to retry when an error occurs. The default is 4. Retry (1-600) Specifies the time in seconds to wait Timeout between retries. The default is 10. Contact yes | no Specifies whether the secondary Terminal station awaits receipt of a QRR command or of the first data frame before establishment of the link connection is acknowledged. The default is no. Capability primary | Specifies the capability of the secondary| Station subentities of this negotiable Link entity. Negotiable stations can become either primary or secondary. The default is negotiable. Call User 2 chars Specifies the hexadecimal string that Data (hexa- identifies the type of X.25 to be made decimal) to create a QLLC connection. The default value is hexadecimal C3 (QLLC protocol). Remote DTEaddress Specifies the X.25 DTE address of the DTE Address remote station. If the Peer Server initiates the connection, this is the address that will be called. For an IBM initiated connection, if the Usage Type parameter is set to Incoming, this address will be matched against the caller's address and if not matched, the call will be rejected. Maximum BTU (128-4095) Specifies the size that SNA messages Size will be segmented into before being sent to the X.25 network. (The X.25 network may further segment packets based on the level 2 profile information being used.) The default is 512. 4 show show qllc link station The show qllc link station displays the attributes of the QLLC Link Station subentity. The QLLC Station subentity contains the data link attributes that are configured for this connection. Ex, ncl> show qllc link qllc-0 station stn-0 maximum btu size 5 Identifier Name Displays the name of the Station. 5 Status UID Displays the UID that is associated with the station. Client Displays the name of the user of this station, an instance of the SNA CP Services Transmission Group entity. XPI State Displays the internal state of the XPI interface (the service interface to X.25) that QLLC uses. State Displays the operational state of the link station. Possible values are: off The station has been disabled. on The station has been enabled. 5 Characteristics Usage Type outgoing | Displays the type of connections that incoming | can run over this station. If set to both incoming, then only IBM initiated X.25 connections are allowed. If set to outgoing, then the Peer Server will initiate connections. If set to both then either end can initiate connections. Retry Maximum (0-255) Displays the maximum number of times to retry when an error occurs. Retry Timeout (1-600) Displays the time in seconds to wait between retries. Contact yes | no Displays whether the secondary station Terminal awaits receipt of a QRR command or of the first data frame before establish- ment of the link connection is acknowledged. Capability primary | Displays the capability of the Station secondary| subentities of this Link entity. negotiable Negotiable stations can become either primary or secondary. Call User Data 2 chars Displays the hexadecimal string that (hexa- identifies the type of X.25 to be made decimal) to create a QLLC connection. Remote DTE DTEaddress Displays the X.25 DTE address of the Address remote station. If the Peer Server initiates the connection, this is the address that will be called. For an IBM initiated connection, if the Usage Type parameter is set to Incoming, this address will be matched against the caller's address and if not matched, the call will be rejected. Maximum BTU (128-4095) Displays the size that SNA messages Size will be segmented into before being sent to the X.25 network. (The X.25 network may further segment packets based on the level 2 profile information being used.) 5 Counters Octets Sent Displays the total number of octets in all information packets sent by this station. Octets Received Displays the total number of octets in all information packets received by this station. Data PDUs Sent Displays the total number of information packets sent to this station. Data PDUs Received Displays the total number of information packets received by this station. QXID Frames Sent Displays the total number of QXID messages sent by this station. QXID Frames Received Displays the total number of QXID messages received by this station. QTEST Frames Sent Displays the total number of QTEST messages sent by this station. QTEST Frames Displays the total number of QTEST messages Received received by this station. Outgoing Calls Displays the total number of outgoing call Accepted made by this station. Incoming Calls Displays the total number of incoming calls Accepted received and accepted by this station. Clears Received Displays the total number of clears received by this station. Retry Exceeded Displays the total number of unsuccessful outgoing calls. Protocol Error Displays the total number of QLLC protocol errors detected on this station. Local Error Displays the total number of times that the client has not reacted according to the QLLC protocol. Receive Over Size Displays the total number of oversized frames received. QFRMR Frames Displays the total number of times a Received frame-reject type frame was received. QFRMR Frames Sent Displays the total number of times a frame-reject type frame was sent. XPI Error Displays the number of X.25 interface Indication errors reported. Creation Time Displays the time at which the entity was created. 3 Port_subentity show qllc port The show qllc port command displays the attributes for the QLLC Port subentity. A Port subentity is created dynamically for each connection to a remote station. Each Port is created when a connection is established and deleted when the connection is terminated. To show all the existing ports issue the show qllc port * command. Ex, ncl> show qllc port 1 all counters 4 Identifier Name A unique value assigned to the Port by the QLLC entity. 4 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. Station Displays the name of the QLLC Link Station subentity that the client specified in the connection request. Client Displays the name of the user of this station, an instance of the SNA CP Services Transmission Group entity. Protocol Displays the currently defined state of the QLLC State entity. The possible state values are: outgoing call An X.25 outgoing call is being made on this port. inoperable The initial state for a QLLC link connection. closed An X.25 connection is established, but a QLLC link connection has not yet taken place. The XID negotiation is executed in this state. opening The QLLC link connection is being established. If negotiation is enabled, the role must change to primary or secondary within this state. opened The normal operation state. Data link PDUs are exchanged in both directions across the X.25 logical channel connection. closing The QLLC link is in the process of closing. recovery A secondary station may enter this state to recover after a QLLC protocol error was detected. Predicate Displays a substate of the current protocol state. For more information, please refer to the IBM documentation. Role Displays whether the Peer Server is primary or secondary in the QLLC connection that this Port represents. Maximum Displays the size that SNA messages will be segmented BTU Size into before being sent to the X.25 network. (The X.25 network may further segment packets based on the level 2 profile information being used.) Remote Displays the X.121 coded DTE address of the remote DTE Address station to which this port is connected. 4 Counters Octets Displays the total number of octets in all information Sent packets sent in on QLLC connection represented by this port. Octets Displays the total number of octets in all information Received packets received in on QLLC connection represented by this port. Data PDUs Displays the total number of data packets sent on the Sent QLLC connection. Data PDUs Displays the total number of data packets received on Received the QLLC connection. Creation Displays the time that the QLLC Port subentity was Time created. 2 SDLC The SDLC entity provides support for communication links. There is only one instance per node. For each physical line, SDLC creates a Link subentity, which manages all stations on the line. For each logical station, SDLC creates a Station subentity that is subordinate to the Link entity, which manages the station. For each enabled Station that establishes a connection, SDLC creates a Port entity. 3 create create sdlc The create verb generates a new instance of the SDLC entity or subentity. Create sets the entity state to off and sets the entity's attributes to their default values. There are no attributes for the create sdlc command. Ex, ncl> create sdlc 3 delete delete sdlc The delete sdlc command deletes the single SDLC instance. You cannot delete the SDLC entity while subentities (Links, Stations) exist. Ex, ncl> delete sdlc 3 show show sdlc The show sdlc command displays the attributes for communication lines or links. There is only one instance per node. Ex, ncl> show sdlc all counters 4 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. Connections Displays the number of connections that are currently active. 4 Characteristics Version Displays the version number of the SDLC software that is executing. 4 Counters Creation The time that the SDLC entity was created. Time Resource The total number of resource allocation failures; Allocation for example, insufficient memory. Failures 3 Link_subentity The SDLC Link subentity instance exists for each physical line and manages all stations on the line. 4 create create sdlc link The create sdlc link command creates an instance of the SDLC Link subentity for each physical line, which manages all stations on the line. Creation also allocates resources for the subentity, and set its characteristics to their default values. Ex, ncl> create sdlc link sdlc-1 line modem connect line line-0, - _ncl> capability primary 5 Characteristics Line local entity Specifies the Modem Connect Line on name which the SDLC protocol operates. For more information about Modem Connect Line refer to the DECnet-Plus Network Control Language Reference. Capability primary | Specifies the capability of the secondary | Station subentities of this Link negotiable entity. Negotiable stations can become either primary or secondary. The default is negotiable. Configuration pointtopoint | Specifies whether the Link supports multipoint only a point-to-point connection or can also support a multipoint connection. Multipoint supports one or more than one connection. The default is pointtopoint. The Peer Server does not support multipoint primary connections. Connection nonswitched | Specifies whether the Link supports Type switched switched or nonswitched connections. The default is nonswitched. Receive (1-32764) Specifies the maximum frame size Frame Size (excluding the header) that can be received on the line represented by this Link. The default is 1000. Reply Timer (100-60000) Specifies the time (in milliseconds) to wait for an acknowledgment before starting the recovery procedure. The default is 3000. Retry (0-128) Specifies that, when the Link is Maximum secondary, this is the maximum number of times a frame is retransmitted before assuming a fatal error. When the Link is primary, this is the number of times that a retry will be attempted. The default is 15. Poll Pause (0-60000) The time in milliseconds to pause when the end of the polling list is reached. Used only when the Link is primary. The default is 200. Service (1-255) Specifies the maximum number of Limit regular scans of the service order table for secondary Stations that will be made before a special scan is made. Used when the Link is multipoint primary. The default is 4. Not used at this time. TWA Send no | yes Specifies whether the Link provides Priority priority for outbound services when configured for Two-Way Alternating (half-duplex) data transfer in the multipoint primary mode. Yes means that PIUs that arrive for transmission while data is being re- ceived are transmitted immediately. No, the default, means that outbound transmission is strictly determined by the position of station service order entries in the Service Order Table. This attribute is not relevant to SDLC point-to-point operations. Not used at this time. 4 delete delete sdlc link The delete sdlc link command deletes an instance of the SDLC Link subentity and deallocates resources for the subentity. The Link subentity must be in the off state and must have no Station subentities. Ex, ncl> delete sdlc link sdlc-0 4 disable disable sdlc link The disable sdlc link command disables an instance of the SDLC Link subentity. You can only disable a previously enabled entity. The disable command stops the operation of the Link subentity. To be successful with this command, all Station subentities on the Link must have been disabled. At the completion of the command the subentity is off. Ex, ncl> disable sdlc link sdlc-0 4 enable enable sdlc link The enable sdlc link command places the SDLC Link subentity in its enabled state (on). An association may be made between the Link subentity and the Modem Connect Line entity of the physical line on which the protocol operates. For more information about Modem Connect Line refer to the DECnet-Plus Network Control Language Reference. Ex, ncl> enable sdlc link sdlc-0 4 set set sdlc link The set sdlc link command let you set the attributes for the SDLC Link subentity. The SDLC Link subentity defines the data link attributes that are shared by its Station subentities. Ex, ncl> set sdlc link sdlc-0 capability = primary 5 Characteristics Line local entity Specifies the Modem Connect Line on name which the SDLC protocol operates. This attribute is settable only when the Link is disabled. For more information about Modem Connect Line refer to the DECnet-Plus Network Control Language Reference. Capability primary | Specifies the capability of the secondary | Station subentities of this Link negotiable entity. Negotiable stations can become either primary or secondary. This attribute is settable only when the Link is disabled. The default is negotiable. Configuration pointtopoint | Specifies whether the Link supports multipoint only a point-to-point connection or can also support a multipoint connection. Multipoint supports one or more than one connection. This attribute is settable only when the Link is disabled. The default is pointtopoint. The Peer Server does not support multipoint primary connections. Connection nonswitched | Specifies whether the Link supports Type switched switched or nonswitched connections. This attribute is settable only when the Link is disabled. The default is nonswitched. Receive (1-32764) Specifies the maximum frame size Frame (excluding the header) that can be Size received on the line represented by this Link. This attribute is settable only when the Link is disabled. The default is 1000. Reply Timer (100-60000) Specifies the time (in milliseconds) to wait for an acknowledgment before starting the recovery procedure. The default is 3000. Retry (0-128) Specifies that, when the Link is Maximum secondary, this is the maximum number of times a frame is retransmitted before assuming a fatal error. When the Link is primary, this is the number of times that a retry will be tried. This attribute is settable only when the Link is disabled. The default is 15. Poll Pause (0-60000) The time in milliseconds to pause when the end of the polling list is reached. Used only when the Link is primary. The default is 200. Service (1-255) Specifies the maximum number of Limit regular scans of the Service Order Table for secondary Stations that will be made before a special scan is made. Used when the Link is primary. Is settable only when the Link is disabled. The default is 4. Not used at this time. TWA Send no | yes Specifies whether the Link provides Priority priority for outbound services when configured for Two-Way Alternating (half-duplex) data transfer in the multipoint primary mode. Yes means that PIUs that arrive for transmission while data is being received are transmitted immediately. No, the default, means that outbound transmission is strictly determined by the position of station service order entries in the service order table. This attribute is not relevant to SDLC point-to-point operations. This attribute is settable only when the Link is disabled. Not used at this time. 4 show show sdlc link The show sdlc link command displays the values of the attributes for the SDLC Link subentity. The SDLC Link subentity defines the data link attributes that are shared by its Station subentities. Ex, ncl> show sdlc link sdlc-0 all status 5 Identifier Name A Simplename that is unique among the SDLC Link entities maintained by the SDLC module. The network manager specifies Name when the Link is created. 5 Status UID Displays the entity's unique identifier, which is generated when the the entity is created. State Displays the operational state of this SDLC Link subentity. Possible states are Inoperable The Link cannot be enabled. Off You have issued a disable command for this Link. The Link is in the inactive or pending inactive state. On You have issued an enable command for this Link. Role Displays the role this Link has taken. Values for Role are: Idle No role has been assumed yet. Primary The role is that of a primary Link. Secondary The role is that of a secondary Link. 5 Characteristics Line local entity Displays the Modem Connect Line on name which the SDLC protocol operates. You must specify a value in order to enable the link. For more information about Modem Connect Line refer to the DECnet-Plus Network Control Language Reference. Capability primary | Displays the capability of the secondary | Station subentities of this Link negotiable entity. Negotiable stations can become either primary or secondary. The default is negotiable. Configuration pointtopoint | Displays whether the Link supports multipoint only a point-to-point connection or can also support a multipoint connection. Multipoint supports one or more than one connection. The default is pointtopoint. The Peer Server does not support multipoint primary connections. Connection nonswitched | Displays whether the Link supports Type switched switched or nonswitched connections. The default is nonswitched. Receive (1-32764) Displays the maximum frame size Frame (excluding the header) that can be Size received on the line represented by this Link. The default is 1000. Reply Timer (100-60000) Displays the time (in milliseconds) to wait for an acknowledgment before starting the recovery procedure. The default is 3000. Retry (0-128) Displays that, when the Link is Maximum secondary, this is the maximum number of times a frame is retransmitted before assuming a fatal error. When the Link is primary, this is the number of times that a retry will be tried. The default is 15. Poll Pause (0-60000) Displays the time in milliseconds to pause when the end of the polling list is reached. Used only when the link is primary. The default is 200. Service (1-255) Displays the maximum number of Limit regular scans of the Service Order Table for secondary Stations that will be made before a special scan is made. Used when the Link is primary. The default is 4. Not used at this time. TWA Send no | yes Displays whether the Link provides Priority priority for outbound services when configured for Two-Way Alternating (half-duplex) data transfer in the multipoint primary mode. Yes means that PIUs that arrive for transmission while data is being received are transmitted immediately. No, the default, means that outbound transmission is strictly determined by the position of station service order entries in the service order table. This attribute is not relevant to SDLC point-to-point operations. Not used at this time. 5 Counters Group Polls The number of unnumbered group polls received on this link. Frame Receive The number of times the physical layer encountered Errors an error trying to receive a frame. Underlying The number of times the Link's underlying Line was Lines deleted after the Link had established a connection Deleted to it. Creation Time The time that the SDLC Link subentity was created. 3 Link_Station_Subentity For each logical station on a line, SDLC creates a Station subentity that is subordinate to the Link entity, which manages the station. 4 create create sdlc link station The create sdlc link station command creates an instance of the Station subentity of the SDLC Link entity for each logical station on a line and allocates resources for the subentity. The create command sets the characteristic attributes to their default values. Ex, ncl> create sdlc link sdlc-0 station stn-0 address = c2 5 Characteristics Address 2 characters Specifies the address defined for hexadecimal the secondary Station. The default is 40. Group 2 characters Specifies the group poll address for Address hexadecimal this Station. A value of 0 indicates that the Station is not in a group. The default value is 0. Transfer twa | tws Specifies the link level transmit/- Mode receive capability of the Station. The default is twa. TWA is Two Way Alternate; TWS is Two Way Simultaneous. Modulo normal | Specifies that the Station supports extended normal response mode (window size ranges from 1 to 7) or normal response mode extended (window size ranges from 1 to 127). This attribute is ignored for connections that perform XID3 negotiation. The default is normal. Window Size (1-127) Specifies the maximum number of received I-frames that may be outstanding before this station requires an acknowledgment response. This value allows for the detection of erroneous sequence numbers in received frames. The default is 7. Send Frame (1-32764) Specifies the maximum frame size Size (excluding the header) this Station can send. This value may be reduced during preconnection XID negotiation or by the Station's client. The default is 265. Inactivity (0-7200) Specifies the time (in seconds) to Timer wait for a command before initiating recovery action. This is used when the Link is secondary. The default is 30. Pass Limit (1-254) Specifies the maximum number of BLUs that can be sent to the second- ary Station before starting data transmission to the next Station in the Link Service Order Table. This is used when the Link is primary. The default is 1. Not used at this time. Select (1-60000) Specifies the time (in milliseconds) Pause to pause before sending a response with the final bit set. This is used when the Link is secondary. The default is 50. Retry (0-255) Specifies the time (in seconds) to Sequence pause after completing a retry Pause sequence before beginning a new retry sequence. This is used when the Link is primary. The default is 0. Not used at this time. Retry (0-127) Specifies the maximum number of Sequence retry sequences allowed. This is Limit used when the Link is primary. The default is 0. Not used at this time. Immediate no | yes Specifies whether a Station Poll subentity will be repolled when there Retry is a reply time-out before proceeding to next Station on the Link's Service Order Table. The default is no. Not used at this time. 4 delete delete sdlc link station The delete sdlc link station command deletes the Station subentity. The Station subentity must be in the off state before it can be deleted. Ex, ncl> delete sdlc link sdlc-0 station stn-0 4 disable disable sdlc link station The disable sdlc link station command stops the operation of the Station subentity of the Link. If a connection exists, the disable command halts protocol operation. When execution of the command completes the Station entity enters the off entity state. Ex, ncl> disable sdlc link sdlc-0 station stn-0 4 enable enable sdlc link station The enable sdlc link station command enables the Station for use. You must enable the link to be successful with this command. An association may be made between the Link subentity and the Modem Connect Line entity of the physical line on which the protocol operates. An enabled Station can accept incoming connection requests or initiate outgoing connection requests. For more information about Modem Connect Line refer to the DECnet-Plus Network Control Language Reference. Ex, ncl> enable sdlc link sdlc-0 station stn-0 4 set set sdlc link station The set sdlc link station command let you set the attributes for SDLC Link Station subentity. The SDLC Station subentity contains the data link attributes that are configured for this connection. Ex, ncl> set sdlc link sdlc-0 station stn-0 address = 62 5 Characteristics Address 2 characters Specifies the address defined for the hexadecimal secondary Station. You can set this attribute only when the Station is disabled. The default is 40. Group 2 characters Specifies the group poll address Address hexadecimal for this Station. A value of 0 indicates that the Station is not in a group. The default value is 0. Transfer twa | tws Specifies the link level transmit/- Mode receive capability of the Station. The default is twa. TWA is Two Way Alternate; TWS is Two Way Simultaneous. This attribute is settable only when the Station is disabled. Modulo normal | Specifies that the Station supports extended normal response mode (window size ranges from 1 to 7) or normal response mode extended (window size ranges from 1 to 127). This attribute is ignored for connections that perform XID3 negotiation. The default is normal. This attribute is settable only when the Station is disabled. Window Size (1-127) Specifies the maximum number of received I-frames that may be outstanding before this station requires an acknowledgment response. This value allows for the detection of erroneous sequence numbers in received frames. This attribute is settable only when the Station is disabled. The default is 7. Send Frame (1-32764) Specifies the maximum frame size Size (excluding the header) this Station can send. This value may be reduced during pre-connection XID negotiation or by the Station's client. This attribute is settable only when the Station is disabled. The default is 265. Inactivity (0-7200) Specifies the time (in seconds) to Timer wait for a command before initiating recovery action. This is used when the Link is secondary. The default is 30. This attribute is settable only when the Station is disabled. Pass Limit (1-254) Specifies the maximum number of BLUs that can be sent to the second- ary Station before starting data transmission to the next Station in the Link service order table. This is used when the Link is primary. The default is 1. This attribute is settable only when the Station is disabled. Not used at this time. Select (1-60000) Specifies the time (in milliseconds) Pause to pause before sending a response with the final bit set. This is used when the Link is secondary. The default is 50. Retry (0-255) Specifies the time (in seconds) to Sequence pause after completing a retry Pause sequence before beginning a new retry sequence. This is used when the Link is primary. The default is 0. Not used at this time. Retry (0-127) Specifies the maximum number of Sequence retry sequences allowed. This is used Limit when the Link is primary. The default is 0. This attribute is settable only when the Station is disabled. Not used at this time. Immediate no | yes Specifies whether a Station subentity Poll will be repolled when there is a Retry reply time-out before proceeding to the next Station on the Link's service order table. This attribute is settable only when the Station is disabled. The default is no. Not used at this time. 4 show show sdlc link station The show sdlc link station command displays the values of the attributes for the SDLC Link entity's Station subentity. The SDLC Station subentity contains the data link attributes that are configured for this connection. Ex, ncl> show sdlc link sdlc-0 station stn-0 address, protocol state 5 Identifier Name Displays the unique name assigned to the Station subentity by the network manager when the Station is created. 5 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. State Displays the operational state of the Station subentity. Setting the state is a result of execution of the enable/disable commands. The states are Off The Station is disabled and not available for use. On The Station is enabled and available for use. Protocol The protocol state for the SDLC connection on this State Station entity. The possible states are Inactive This Station is not enabled. You must issue an enable command before the SDLC entity can activate the Station. Normal The subentity can accept incoming connection Disconnect requests or initiate outgoing connection Mode requests. Normal An SDLC logical link connection has been Response established. Mode Pending This Station is enabled but other Peer Server Active resources, must be active before the Station can become active. Pending You have issued a disable command for this Inactive Station; no new sessions can use this Station. The state will change to Inactive as soon as all active sessions and non-SNA application links on this Station have terminated. 5 Characteristics Address 2 characters Displays the address of the hexadecimal secondary Station. The default is 40. Group 2 characters Displays the group poll address for Address hexadecimal Station. A value of 0 indicates the Station is not in a group. The default value is 0. Transfer twa | tws Displays the link level transmit/- Mode receive capability of the Station. The default is twa. TWA is Two Way Alternate; TWS is Two Way Simultaneous. Modulo normal | Displays whether the Station extended supports normal response mode (window size ranges from 1 to 7) or normal response mode extended (window size ranges from 1 to 127). This attribute is ignored for connections that perform XID3 negotiation. The default is normal. Window Size (1-127) Displays the maximum number of received I-frames that may be outstanding before this station requires an acknowledgment response. This value allows for the detection of erroneous sequence numbers in received frames. The default is 7. Send Frame (1-32764) Displays the maximum frame size Size (excluding the header) this Station can send. This value may be reduced during pre-connection XID negotiation or by the Station's client. The default is 265. Inactivity (0-7200) Displays the time (in seconds) to Timer wait for a command before initiating recovery action. This is used when the Link is secondary. The default is 30. Pass Limit (1-254) Displays the maximum number of BLUs that can be sent to the second- ary Station before starting data transmission to the next Station in the Link service order table. This is used when the Link is Primary. The default is 1. Select (1-60000) Displays time (in milliseconds) to Pause pause before sending a response with the final bit set. This is used when the LINK is secondary. The default is 50. Retry (0-255) Displays the time (in seconds) to Sequence pause after completing a retry sequ- Pause ence before beginning a new retry sequence. This is used when the Link is primary. The default is 0. Not used at this time. Retry (0-127) Displays the maximum number of Sequence retry sequences allowed. This is used Limit when the Link is primary. The default is 0. Not used at this time. Immediate no | yes Displays whether a Station Poll subentity will be repolled when there Retry is a reply time-out before proceeding to next Station on the Link's service order table. The default is no. 5 Counters Creation The time that the Station subentity was created. Time Connections The number of times a connection was established for Established this Station. Connections The number of times the SDLC connection was lost. Lost Connections The number of times an established connection was Reset lost and subsequently re-established for this Station by the snrm or snrme. Polls The number of Information and Supervisory frames sent by the primary or received by the secondary station with the P-bit set. Reply The number of times the local reply timer has Timeouts expired after the transmission of a frame with the P-bit set. Secondary The number of times a primary station encountered a Protocol protocol violation committed by an adjacent Errors secondary station. SNRM Frames The number of times a SNRM or SNRME frame was sent by the primary or received by the secondary station. DISC Frames The number of times a DISC frame was sent by the primary or received by the secondary station. DM Frames The number of times a DM frame was sent by the primary or received by the secondary station. Octets Sent The total of the number of octets in I-frames and UI-frames sent. Octets The total of the number of octets in I-frames and Received UI-frames received. BLUs Sent The total of the number of I-frames and UI-frames sent. BLUs The total of the number of I-frames and UI-frames Received received. BLUs Resent The total of the number of I-frames and UI-frames resent because of timeouts or rejects. FRMR Frames The total number of FRMR-frames sent. Sent FRMR Frames The total number of FRMR-frames received. Received REJ Frames The number of SDLC REJ-frames sent. Sent REJ Frames The number of SDLC REJ-frames received. Received RNR Frames The number of times RNR-frames have been sent. Sent RNR Frames The number of times RNR-frames have been received. Received TEST Frames The total number of TEST-frames sent. Sent TEST Frames The total number of TEST-frames received. Received TESTs Received The total number of TEST-frames received with a Invalid CRC bad CRC. XID Frames The total number of XID frames sent. Sent XID Frames The total number of XID frames received. Received 3 Port_Subentity For each Enabled Station that establishes a connection, SDLC creates a Port entity. 4 show show sdlc port The show sdlc port command displays the attributes for the SDLC Port subentity. A Port subentity is created dynamically for each connection to a remote station. Each Port is created when a connection is established and deleted when the connection is terminated. Use the command show sdlc port * to display a listing of the existing Ports. Ex, ncl> show sdlc port 1 all counters 5 Identifier Name A unique value assigned to the Port by the SDLC entity. The value is an unsigned integer. 5 Status UID Displays the entity's unique identifier, which is generated when the Peer Server creates the entity. Station Displays the name of the SDLC Link Station subentity that the client specified in the connection request. Client Displays the name of the client that connected to this Port's Station. Role Displays whether the station role is to be primary or secondary when it becomes active. Address Displays the address of the secondary station. Transfer Displays the link-level transmit/receive capability Mode for the connection, which is set to the transfer mode characteristic of the SDLC Station. Might be altered during XID negotiation. Modulo Displays the Response Mode supported by the Station. Normal Response Mode supports Send and Receive Window Sizes of 1 to 7. Normal Response Mode Extended supports Send and Receive Window Sizes of 1 to 127. Send Window Displays the negotiated maximum number of transmitted Size I-frames that may be outstanding before the adjacent station requires an acknowledgment response. The value is initialized as the SDLC Station window size and might be reduced during preconnection XID negotiation. Receive Displays the negotiated maximum number Window Size of received I-frames that may be outstanding before this station requires an acknowledgment response. The value is initialized as the SDLC Station Window Size and might be reduced during preconnection XID negotiation. Send Frame Displays the negotiated maximum size of frames Size (excluding header) sent by the connection. This value is initialized as the SDLC receive frame size. The value might be reduced during preconnection XID negotiation. Receive Displays the negotiated maximum size of frames Frame Size (excluding header) received by the connection. This value is initialized as the SDLC Station send frame size. The value might be reduced during preconnection XID negotiation. 5 Counters Creation Displays the time that the SDLC Port subentity Time was created. Polls Displays the number of frames sent by the primary or received by the secondary with the P-bit set. Octets Sent Displays the total number of octets sent in I-frames and UI-frames. Octets Displays the total number of octets received Received in I-frames and UI-frames. BLUs Sent Displays the total number of I-frames and UI-frames sent. BLUs Displays the total number of I-frames and UI-frames Received received. BLUs Resent Displays the total number of I-frames and UI-frames retransmitted due to timeouts or rejects.