Removes an HCON session profile.
rmhcons -n SessionName [ -N LoginName ]
The rmhcons command (remove HCON sessions) removes the session profile specified by the -n SessionName flag and associated with the user identified by the -N LoginName flag. If the -N flag is not used, the command uses the current login name.
The login name specified with the -N LoginName flag, or the current login name if the -N flag is not used, must have been defined to HCON with the mkhconu command. The session profile specified by the -n SessionName flag must have been previously defined to HCON with the mkhcons command.
You can use the System Management Interface Tool (SMIT) to run this command. To use SMIT, enter:
smit rmhcons
The rmhcons command can also be issued from the command line.
Note: All HCON users can issue the rmhcons command to remove their own session profiles. Someone with root user authority can use the command to remove any HCON user's profiles.
| -n SessionName | Specifies the name of a previously defined session profile to be removed. The session profile name is a single character in the range of a to z. Capital letters are interpreted as lowercase letters.
Note: The specified session profile must have been previously defined using the smit hcon command or the mkhcons command. |
| -N LoginName | Specifies a valid login name. If the -N flag is not used, the rmhcons 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 to HCON using the smit hcon command or the mkhconu command. |
The rmhcons 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. |
| 14 | 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 rmhcons command does not have access to the profiles for the user specified by the LoginName variable (or 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 rmhcons command cannot obtain the current user name. This message can occur only when the -N flag is not specified. |
| 31 | The session specified by the SessionName variable does not exist for the user specified by the LoginName variable (or the current user if the -N flag was not used). |
| 34 | No session profile name was specified. |
| 47 | The -n flag was not specified. |
| 50 | The rmhcons command could not access the database. |
| 52 | The session name specified with the -n flag does not exist. |
| 61 | You did not specify a parameter for one of the flags. |
rmhcons -n rThis removes session profile r belonging to the current user.
rmhcons -n e -N lauraThis removes session profile e belonging to user laura and returns the following message:
Session e is deleted successfully for user laura.
Note: You must have root user authority to remove a session profile belonging to another user.
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 set up a session profile for HCON, use SMIT or the mkhcons command. To modify an existing profile, use SMIT or the chhcons command.
To list existing HCON session profiles, 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.
Maintaining HCON and HCON Sessions and Session Profiles.
System Management Interface Tool (SMIT) Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.