mkhcons Command

Purpose

Creates an HCON session profile.

Syntax

To Create a Display Session Profile

mkhcons -n SessionName [-p DeviceName | -w 'SNAProfile' | -I HostName ] [ -u 'SessionUse' ] [ -m ModelNumber ] [ -l Language ] [ -k KeyboardTable ] [ -c ColorTable ] [ -r ReplaceFileName ] [ -s SaveFileName ] [ -H HostType ] [ -x HostLoginName ] [ -f 'FxferProgram' ] [ -d FxferDirection ] [ -q FxferWait ] [ -R FxferRecoverTime ] [ -b MaxBufferSize ] [ -T EnableAutologTrace ] [ -W AutologTimeOut ] [ -a AutologNodeID ] [ -N LoginName ] [ -t SessionType ] [-P LocalPrinterName ]

To Create a Printer Session Profile

mkhcons -n SessionName [ -u 'SessionUse' ] [ -l Language ] [ -k KeyboardTable ] [ -c ColorTable ] [ -C PortAddress ] [ -N LoginName ] [ -t SessionType ] [ -P LocalPrinterName | -v PrintFile ] [ -p DeviceName | -w 'SNAProfile' ]

Not all flags are valid for all session types. Valid flags for each session type are listed in "Valid Profile Fields and Associated Command Flags for Each HCON Session Type".

Description

The mkhcons command creates an Host Connection Program (HCON) session profile. The session profile is associated with the user identified by the -N LoginName flag. If the -N flag is not used, the mkhcons command creates a session profile associated with the user who is currently logged in. The user must have been previously defined to HCON using the smit hcon command or the mkhconu command.

The session type is determined by the -t SessionType flag when a session profile is created. If the -t flag is not specified, HCON attempts to create a DFT display session profile.

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

smit mkhcons

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

Note: HCON users can issue the mkhcons command to create their own session profiles. A user with root user authority can issue the command to create session profiles for any HCON user.

Flags

Error Codes

Examples

1. To add a DFT display session profile for user bob , with individualized color and keyboard support, connecting to a VM/CMS host, enter:

   mkhcons -n a -u 'VM in California'
   -p 3270c0 -m 2 -l USA -k /home/bob/keyboardCA
   -c /home/bob/colorVM -H CMS -x bob 
   -f 'IND$FILE' -d down -t dt

   This creates session profile a for the current user, with the following parameters.
   • The session use is VM in California .

     Note: The quotation marks around the session use string are always required.

   • The communication device is 3270c0 .
   • The 3270 screen model type is 2 (24 rows x 80 columns).
   • The language for ASCII-EBCDIC translation is English (U.S.A.) .
   • The keyboard table is the /home/bob/keyboardCA file.
   • The color table is the /home/bob/colorVM file.
   • The host type is CMS (VM/CMS).
   • The host login name is bob .
   • The file transfer program on the host is the IND$FILE program.

     Note: The quotation marks around the file transfer program name are always required.

   • The default file transfer direction is down (downloading).
   • The session type is dt (DFT display).

     Note: Because the default is to create a DFT display session, the -t flag is optional in this case.

   The mkhcons command creates the session profile with the default values for all other parameters. Notes:
   1. You currently must be logged in with a valid HCON user name to use the mkhcons command without the -N flag.
   2. If the text you enter for the mkhcons command extends beyond the limit of the screen, the text wraps automatically to the next line. Pressing the Enter key to wrap the text may cause an error.
2. To add an HIA display session profile for user tom , connecting to a TSO host, enter:

   mkhcons -n b -u 'HIA display'
   -p hia0 -H TSO -N tom -t ht

   This creates session profile b for user tom , with the default values for most parameters. The values of the following parameters are changed from the defaults by the flags used with the mkhcons command:
   • The session use is HIA display .
   • The communication device is hia0 .
   • The host type is TSO (MVS/TSO).
   • The session type is ht (HIA display).

     Note: You must have root user authority to create a session for another user. The user specified with the -N flag must be defined as an HCON user.

3. To add a non-SNA DFT printer session, enter:

   mkhcons -n g -u 'Printer' -p 3270c0
   -l USA -P lp0 -C 00 -t dp

   This creates session profile g for the current user, with the following values for the session parameters:
   • The session use is Printer .
   • The communication device is 3270c0 .
   • The language for ASCII-EBCDIC translation is English (U.S.A.) .
   • The local printer to use is lp0 .
   • The controller port address is 00 .
   • The session type is dp (non-SNA DFT printer).

     Note: You must be logged in to the operating system with a valid HCON user name to use the mkhcons command without the -N flag.

4. To add an SNA standalone display session profile, enter:

   mkhcons -n c -w 'SNALU*' -t st

   This creates session profile c for the current user, with the following values for the session parameters:
   • The SNA logical connection prefix name is SNALU .

     Note: The quotation marks surrounding the SNA logical connection prefix string are always required

   • The session type is st (SNA standalone display).
5. To add an SNA standalone printer session profile, enter:

   mkhcons -n e -w 'SNALU3' -t sp
   -v sna_prt_file

   This creates session profile e for the current user, with these session parameter values:
   • The SNA logical connection profile name is SNALU3 .
   • The session type is sp (SNA standalone printer).
   • The printer output file is sna_prt_file .
6. To add a TCP/IP display session profile, enter:

   mkhcons -n a -I MIKEVM -u 'TCP/IP Display' -t tt

   This creates session profile a for the current user, with the following session parameter values:
   • The host name is MIKEVM .
   • The session use is TCP/IP Display .
   • The session type is tt (TCP/IP display).

Files

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 modify an existing session profile, use SMIT or the chhcons command.

To list a user's 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.

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

The e789 command starts an HCON session. The fxfer command transfers files.

HCON Sessions and Session Profiles.

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