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

rmhconu Command

Purpose

Removes an HCON user.

Syntax

rmhconu -N LoginName

Description

The rmhconu command (remove HCON user) removes a specified HCON user and all associated HCON session profiles. The rmhconu command fails if the user is not defined to HCON.

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

smit rmhconu

Since the rmhconu command is usually called by SMIT, instead of being issued at the command line, no confirmation is requested before the user is deleted.

Note: The rmhconu command can be issued only by a user with root user authority.

Flags

-N LoginName Specifies the login name of the user to be deleted.

Error Codes

The rmhconu command returns a value of 0 if successful. If an error occurs, the command returns a value identifying the failure. The error codes are:

0 Successful.
12 The LoginName variable was not specified.
14 ODM Fatal Error: The database may be damaged. Use local problem reporting procedures.
22 The user specified by the LoginName variable is not defined to HCON.
25 The specified option is not valid.
50 Cannot initiate an ODM connection.
51 Cannot delete the user.
61 The -N flag was specified without a LoginName variable.

Examples

To remove a user from HCON, enter:

rmhconu -N maria

This command removes user maria from HCON and deletes all HCON session profiles associated with user maria . After the command finishes, it returns the following message:

0789-526 User maria is successfully deleted from the HCON system

Files

/usr/bin/rmhconu Contains the rmhconu command.
/usr/lib/hcon/users Contains information about HCON users.
$HOME/usrdflts Contains session profile defaults. This file is removed by the rmhconu command.
$HOME/usrdflts.vc Contains session profile defaults. This file is removed by the rmhconu command.
$HOME/usrprofs Contains a user's session profiles. This file is removed by the rmhconu command.
$HOME/usrprofs.vc Contains a user's session profiles. This file is removed by the rmhconu command.

Related Information

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

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

To list existing HCON session profiles for an HCON user, use SMIT or the lshconp 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 without removing the HCON user who owns it, use SMIT or the rmhcons command.

Understanding HCON Users and Maintaining HCON.

System Management Interface Tool (SMIT) Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.


[ Previous | Next | Contents | Search ]