 |
» |
|
|
|
Displays the status of the APPC subsystem. Syntax |  |
APPCCONTROL STAT[US] [;STYPE=Session Type Name] |
Parameters |  |
- Session Type Name
The name of a session type configured in the APPC subsystem
configuration file. Status information will be displayed for all
APPC sessions of the specified type. If a CNOS (Change-Number-Of-Sessions) request fails (at
subsystem startup or during run time when you issue the APPCCONTROL SESSIONS command), specify STYPE=SNASVCMG to check whether any CNOS sessions are active.
CNOS session information will be displayed only if you have independent
LUs configured to conduct parallel sessions. The session type names
displayed for CNOS sessions are internally defined and meaningless to
the user. The mode name for CNOS sessions is always SNASVCMG.
Examples |  |
In the following example, the APPCCONTROL STATUS command was issued with no parameters. The status display
includes all configured session types and all active TPs. :APPCCONTROL STATUS
Internal Trace File : NMTC0020.PUB.SYS
Performance Tracing : ON
--------------------------------------------------
Number of Active Sessions for APPC Subsystem : 5
--------------------------------------------------
Session Type Information :
---------------------------------------
Independent LU Session Type : STYPE1
---------------------------------------
Number of Active Sessions : 4
Number of Queued Session Requests : 3
Session Limits
Local LU SNA Node Remote LU Mode Maximum Current
-------- -------- ----------------- ------ ------- -------
INDLU1 SNANODE NET1.IBMLUA MODE1 50 50
Session ID LFSID State LU Type TP ID
---------- ----- ------ ------- -----
62 0103 1 ACTIVE PRI 1011
75 0104 1 ACTIVE PRI 6712
11 0106 1 ACTIVE SEC 1788
98 0105 1 ACTIVE SEC 1219 |
---------------------------------------
Independent LU Session Type : STYPE2
---------------------------------------
Number of Active Sessions : 0
Number of Queued Session Requests : 0
Session Limits
Local LU SNA Node Remote LU Mode Maximum Current
-------- -------- ----------------- ------ ------- -------
INDLU1 SNANODE NET1.IBMLUA MODE2 8 8
Session ID LFSID State LU Type TP ID
---------- ----- ------ ------- -----
* No active sessions
-------------------------------------
Dependent LU Session Type : STYPE3
-------------------------------------
Number of Active Sessions : 1
Number of Queued Session Requests : 1
Session Limits
SNA Node Remote LU Mode Maximum Current
-------- ----------------- ------ ------- -------
IBMNODE DISOSSC MODE3 8 8
Session ID LFSID Local LU State LU Type TP ID
---------- ----- -------- -------- ------- -----
28 0101 1 DEPLU8 ACTIVE SEC 2399
Transaction Program Information:
TP ID Program File Name TP NAME # Conv. User Name
----- -------------------- --------- ------- ------------
1011 TP1.PUB.SYS TP1 1 JOE.USER
6712 R TP3.PUB.SYS TP3 0 JOE.USER
1788 COPRTP.APPC.SYS COPRTP 1 MGR.APPC
1219 R CNOSTP.APPC.SYS CNOSTP 1 MGR.APPC
2399 TP2.PUB.SYS TP2 1 JOE.USER |
In the following example, the APPCCONTROL STATUS command was issued for one independent session type: STYPE1. The display includes information about the active
sessions of that session type and the transaction programs running
on those sessions. :APPCCONTROL STATUS;STYPE=SESS1
Internal Trace File : NMTC0020.PUB.SYS
Performance Tracing : ON
---------------------------------------------------
Number of Active Sessions for APPC Subsystem : 5
---------------------------------------------------
Session Type Information :
---------------------------------------
Independent LU Session Type : STYPE1
---------------------------------------
Number of Active Sessions : 2
Number of Queued Session Requests : 3
Session Limits
Local LU SNA Node Remote LU Mode Maximum Current
-------- -------- ----------------- ------ ------- -------
INDLU1 SNANODE NET1.IBMLUA MODE1 50 50
Session ID LFSID State LU Type TP ID
---------- ----- -------- ------- -----
62 0000 1 ACTIVE PRI 1011
74 0000 2 ACTIVE PRI 6712
Transaction Program Information:
TP ID Program File Name TP Name # Conv. User Name
----- -------------------- --------- ------- ------------
1011 TP1.PUB.SYS TP1 1 JOE.USER
6712 TP2.PUB.SYS TP2 1 JOE.USER |
If APPC subsystem internal tracing has been turned off, "TRACEOFF" is displayed instead of the trace file
name (NMTC0020.PUB.SYS, in the example). Reading the Display |  |
Each of the columns in the example status display is described
below: - Number of Active Sessions
The current number of active or pending sessions
for the session type. This number should be equal to the configured
Automatically Activated Sessions value at subsystem startup, or, if you have issued
the APPCCONTROL SESSIONS command to raise the session limit, it should be equal
to the number you specified in the command. However, for independent
LU session types running parallel sessions, the number of active sessions
might be negotiated down from the number you specified. - Number of Queued Session Requests
The number of outstanding session requests for the session
type. Session requests are queued when TPs call the MCAllocate or MCGetAllocate intrinsic and no sessions are immediately available. - Local LU
The name of a local LU associated with the session type. - SNA Node
The name of the SNA node configured for the session type. - Remote LU
The name of the destination LU on the remote system. - Mode
The mode configured for the session type. See Chapter 4 “APPC Subsystem Configuration” of this manual for more information on mode
configuration. - Session Limits
The maximum number of sessions for the session type. - Maximum
The configured maximum number
of sessions for the session type. - Current
The current maximum number of sessions. This number
will be equal to the number of active sessions, unless the remote
system has some sessions configured as contention winners (controlled
by the remote LU).
- Session ID
The unique identification number given to each session activated
for the session type. - LFSID
Local Form Session Identifier. This number identifies the
session to the SNA link product. The SNACONTROL STATUS command, which displays the status of the SNA link product,
identifies each LU-LU session by LFSID. For more information on
the SNACONTROL STATUS command, see the SNA Link/XL Node Manager's
Guide. - State
The state of a session. Each of the possible states
is described below: - NO SESS.
No APPC sessions are active or being activated for
this session type. The session type's session limit has
been set to 0. - WAITING
The APPC session is waiting for activation. No response
has been received from the remote system or from SNA Transport. - PENDING
Activation of the APPC session is pending. Activation
is proceeding but is not complete. - ACTIVE
The APPC session is ready for conversation. - TERM
The APPC session is in termination state. - ERROR
The APPC session is in an error state. You should
bring down the APPC subsystem.
- LU Type
Whether the local LU is the primary or secondary
LU for the session. LU Types are as follows: - PRI
Primary LU. The local LU sends the BIND to initiate
the session. - SEC
Secondary LU. The local LU receives the BIND from
the remote LU.
- TP ID
The unique identification number of an active transaction
program process. - R
When the TPID is followed by R, the transaction program was started up by the
remote system.
- Program File Name
The fully qualified file name for an active transaction program. - TP Name
The configured transaction program name. - # Conv.
The number of conversations being conducted by an active
TP process. If this number is 0, the TP is waiting for an APPC session
to be activated or freed, or it is waiting for an allocate request
to arrive from the remote TP. - User Name
The user name and group name associated with an active
TP process.
|