[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

lshconp Command

Purpose

Lists all defined Host Connection Program (HCON) session profiles for an HCON user.

Syntax

lshconp-F OutputFormat ] [ -N LoginName ]

Description

The lshconp command (list HCON profiles) sends to standard output a list of the names and uses for all defined HCON session profiles of a given user.

The information is presented in one of two formats as specified by the -F OutputFormat flag. All data is for the user identified by the -N LoginName flag. If the -N flag is not used, the command uses the current login name.

You can use the System Management Interface Tool (SMIT) to run this command. To use SMIT, enter:

smit lshconp

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

Note: All HCON users can issue the lshconp command to list their own session profiles. Someone with root user authority can use the command to list any HCON user's profiles.

Flags

-F OutputFormat Specifies the format of the output. The value of the OutputFormat variable must be one of the following:
s List sessions format (default when flag is not entered)
l Command to list format (used by SMIT).
-N LoginName Specifies a valid login name. If the -N flag is not used, the lshconp command uses the current login name.
Note: Either the name specified by the LoginName variable or the current login name must have been previously defined as an HCON user with the smit hcon command or mkhconu command.

Return Values

The lshconp command returns a value of 0 if successful. If an error occurs, the command returns an errno variable value identifying the failure.

Error Codes

13 There are no session profiles defined for the user specified by the LoginName variable (or for the current user if the -N flag was not used).
14 Object Data Manager (ODM) Fatal Error: The database may be damaged. Use local problem reporting procedures.
19 The database is either damaged or deleted. Use local problem reporting procedures.
21 The user who issued the lshcons command does not have access to the profiles for the user specified by the LoginName variable (or for the current user if the -N flag was not used).
22 Either the user specified by the LoginName variable or the current user is not defined to HCON.
30 The lshconp command cannot obtain the current user name. This message can occur only when the -N flag is not specified.
32 The user issuing the command specified an option that is not valid.
50 Cannot initiate an ODM connection.
57 Specified output parameter (-F flag) is not valid.
61 You did not specify a parameter for one of the flags.

Examples

  1. To list session profiles for the current user, enter:
    lshconp
    This lists session profiles for the current user in the default output format (the List sessions format). The output is similar to the following:
                   SESSIONS
    Session Name            Session Use
           a                account on MA system
           e                vm8 printer session
  2. To list session profiles for user jeanne , enter:
    lshconp -F -N jeanne
    This lists session profiles for user jeanne in the SMIT command to list format (the -F flag). The output is similar to the following:
    a                        account on CA system
    c                        account on Boston VM
    d                        account on vm7
    Note: You must have root user authority to list session profiles belonging to another user.

Files

/usr/bin/lshconp Contains the lshconp command.
$HOME/usrdflts Contains session profile defaults.
$HOME/usrdflts.vc Contains session profile defaults.
$HOME/usrprofs Contains a user's session profiles.
$HOME/usrprofs.vc Contains a user's session profiles.

Related Information

To create an HCON user, use SMIT or the mkhconu command. To list HCON users, use SMIT or the lshconu command.

To list the parameters of an existing session profile, use SMIT or the lshcons command. To find out the session type of an existing profile, use the clhcons command.

To remove an HCON session profile, use SMIT or the rmhcons command.

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

To set up a session profile for HCON, use SMIT or the mkhcons command. To modify an existing profile, use SMIT or the chhcons command.

HCON Sessions and Session Profiles and Maintaining HCON.

System Management Interface Tool (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 ]