stathcon Command

3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

stathcon Command

Purpose

Lists the status of HCON session profiles and SNA logical unit (LU) pools.

Syntax

stathcon [ -h ] [ -u ] [ -s ] [ -w LUPrefix ]

Description

The stathcon command displays the status of either an HCON session profile, all SNA LU pools on the system, or only LUs within a specified pool.

The stathcon command provides the status of HCON session profiles. The list contains the number of defined profiles. The list also contains the number of active profiles that includes the session name and profile type. Session types are identified by either a D (display session) or a P (printer session). For a user with root authority, the list provides the statuses of all HCON session profiles.

The stathcon command provides SNA LU pool statistics. The list includes the number of LUs in each pool and the number of LUs that are active.

The stathcon command also provides the statuses of LUs within an SNA pool. The list includes LU addresses and LU states within the pool that is specified by the -w LUPrefix flag. The following descriptions pertain to LU states:

Active	The LU is active and in use.
Inactive	The LU is not in use, but can be activated upon request.
Disabled	The LU has failed eight consecutive activation attempts.
Disabled Pending	The LU has failed less than eight consecutive activation attempts.

Use the System Management Interface Tool (SMIT) to run this command. Enter:

smit stathcon

The stathcon command also can be issued from the command line.

Note: All HCON users can issue the stathcon command to list their session profile status. With root authority, a user can get a list of session profiles of all HCON users.

Flags

-h	Displays a help screen for the stathcon command; other options are ignored. The help screen provides a summary of each command option and its use. The -h flag is the default for this command.
-s	Displays the statuses of all SNA LU pools on the system.
-u	Displays the user's session profile status. A user with root authority can use this option to display a list of session profiles for all HCON users.
-w LUPrefix	Displays the status of each LU within the specified SNA LU pool. The LUPrefix variable specifies the prefix prepended to the LU address (02,03,04, ..., FE) that is part of the local LU profile name and the logical connection profile name. The LU prefix consists of an ASCII text string of 12 characters or less.

Examples

To list the session profile status for the current user, enter:
```
stathcon -u
```
The list provides session profile status for the current user. In the Display HCON User Status Screen, the session profile status for the current user, greg , is listed:

Note: Session types are identified by either a D (display session) or by a P (printer session).
As a root user, list the session profile status for all HCON users by entering:
```
stathcon -u
```
In the Display HCON User Status Screen, session profile status for all HCON users are listed:
To list all defined pools in the system, enter:
```
stathcon -s
```
In the Display SNA LU Pool Statistics Screen, the list provides LU status for all the defined pools in the system.
To list specific LU information of the Finance LU pool, enter:
```
stathcon -w Finance
```
In the Display SNA LU Pool Statistics Screen, the list provides the status for each LU in the Finance LU pool.

File

/usr/bin directory

Contains the stathcon command.

Related Information

To start SMIT for use with HCON, use the smit hcon command.

Understanding HCON Display Session Pooling discusses LU pooling.

Understanding HCON Sessions and Session Profiles introduces session profiles and their characteristics.

Maintaining HCON discusses interrupted file transfers and HCON sessions.

SMIT Overview in AIX Version 4.3 System Management Guide: Operating System and Devices discusses using the System Management Interface Tool.

[ Previous | Next | Contents | Search ]