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

mkhconu Command

Purpose

Registers an HCON user.

Syntax

mkhconu -N LoginName

Description

The mkhconu command (make HCON user) adds a user to HCON and sets the user's HCON option field defaults to match those of the system. The mkhconu command fails if the user is already defined to HCON or if the user is not defined.

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

smit mkhconu

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

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

Flags

-N LoginName Specifies the login name of the user to be added. The login name must be a valid login name.

Return Values

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

Error Codes

0 Successful.
11 The specified option is not valid.
12 No LoginName variable was specified.
14 ODM Fatal Error: The database may be damaged. Use local problem reporting procedures.
15 The user defined by the LoginName variable is not a valid user.
18 The user defined by the LoginName variable is already defined to HCON.
19 The database is either damaged or deleted. Use local problem reporting procedures.
21 You must have access permissions to the user's profiles.
50 Cannot initiate an ODM connection.
61 You did not specify a parameter for one of the flags.
62 Cannot access the HCON system database files. Use local problem-reporting procedures.

Examples

To add a user to HCON, enter:

mkhconu -N kaye

This command adds user kaye to the user database. After the user has been added, the mkhconu command returns a message similar to the following:

0789-523 User kaye is successfully added to the HCON system.

Files

/usr/bin/mkhconu Contains the mkhconu command.
/usr/lib/hcon/sysdflts Contains systemwide session profile defaults.
/usr/lib/hcon/sysdflts.vc Contains systemwide session profile defaults.
/usr/lib/hcon/users Contains information about HCON users.
$HOME/usrdflts Contains session profile defaults; created by the mkhconu command.
$HOME/usrdflts.vc Contains session profile defaults; created by the mkhconu command.
$HOME/usrprofs Contains a user's session profiles; created by the mkhconu command.
$HOME/usrprofs.vc Contains a user's session profiles; created by the mkhconu command.

Related Information

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

To list HCON users, use SMIT or the lshconu command. To remove an HCON user, use SMIT or the rmhconu command.

Understanding HCON Users.

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

[ Previous | Next | Contents | Search ]