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

chhcons Command

Purpose

Changes an HCON session profile.

Syntax

To Change a Display Session Profile

chhcons -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 ] [-P LocalPrinterName ]

To Change a Printer Session Profile

chhcons -n SessionName-u 'SessionUse] [ -l Language ] [ -k KeyboardTable ] [ -c ColorTable ] [ -C PortAddress ] [ -P LocalPrinterName -v PrintFile ] [ -N LoginName ] [ -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 chhcons (change HCON session) command modifies an existing 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 chhcons command modifies the 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 default for each flag is determined by the setting made when the profile was created or last changed. If a flag is not specified with the chhcons command, the value associated with that flag is not changed.

The session type and session name cannot be changed. Use the clhcons command to determine the session type of a previously defined session profile.

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

smit chhcons

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

Note: All HCON users can use the chhcons command to modify their own sessions. Someone with root user authority can use the command to modify any HCON user's sessions.

Flags

-a AutologNodeID Specifies the AUTOLOG script to be used by the AUTOLOG facility. An AUTOLOG script must be created using the genprof or hconutil command before an automatic log in Login using AUTOLOG is attempted by the file transfer facility, an API program, or the HCON utility. The AutologNodeID cannot be longer than 18 characters.

The -a flag is valid only for display session profiles.

-b MaxBufferSize Specifies the maximum size of the I/O buffer used during file transfer, API/API, and API/API_T operations. The valid range for the buffer size is from 2048 to 32767 bytes. A value of 3456 bytes is the largest value that can be used when running a file transfer, API/API, or API/API_T operation through the pvm or passthru facility on the host system.

The -b flag is valid only for display session profiles.

-C PortAddress Specifies the two hexadecimal-character controller port address where the coaxial cable from the 3270 Connection Adapter is attached to one of the following:
  • 3174 or 3274 Control Unit
  • An integrated controller, which can be either:
    • 4361 Workstation Adapter
    • 9370 Workstation Subsystem Controller

The session address from the host configuration must match the controller port address in hexadecimal notation. The range of 3X74 port assignment addresses is 0x00 to 0x1F. The port assignment address is available from the System/390 access method definition from the 3X74 customization. The 3270 Connection Adapter printer address must also be configured accordingly to match this address with the same port assignment address. The adapter can be configured using the smit 3270con fast path.

The -C flag is valid only for non-SNA printer session profiles.

-c ColorTable Specifies the file containing the color definition table to be used for the session.
-d 'FxferDirection' Specifies the default direction for file transfers. The value of the FxferDirection variable can be:
up The default is to transfer files from local system to the host (upload).
down The default is to transfer files from the host to local system (download).

The default direction can be overridden when executing a file transfer.

The -d flag is valid only for display session profiles.

-f 'FxferProgram'
                          Specifies the host file transfer program name. The program name must be enclosed in single quotation marks and cannot be longer than 8 characters.

The -f flag is valid only for display session profiles.

-H HostType Specifies the host environment. This value is used by the file transfer program and the Application Programming Interface (API). The valid values for the HostType variable are:
TSO MVS/TSO host system
CMS VM/CMS host system
CICS CICS/VS (for MVS and VSE) host system
VSE VSE/SP or VSE/ESA host system

The -H flag is valid only for display session profiles.

-I HostName Specifies the host name to be used for the TCP/IP display session. The host name, which can be up to 255 characters in length, can be either the name of the host or a dotted-decimal Internet address. For example, if the host name, mikevm , has Internet address 123.45.678 , then either mikevm or 123.45.678 can be used as HostName. A fully qualified host name such as mikevm.ibm.com is also valid. There is no default for the HostName variable.

The -I flag is valid only for TCP/IP sessions.

-k KeyboardTable Specifies the host name to be used for the TCP/IP display session. The host name, which can be up to 255 characters, can be either the name of the host or an Internet address.
-l Language Specifies the code page for ASCII-EBCDIC translation. Valid abbreviations:
BEL Belgian
CAN Canadian-French
CHT Traditional Chinese
DEN Danish
FIN Finnish
FRA French
GER Austrian-German
GRE Greek
ICE Icelandic
ITA Italian
JPE Japanese-English
JPK Japanese Katakana
KOR Korean
NOR Norwegian
POR Portuguese
SPA Spanish
SWE Swedish
SWF Swiss-French
SWG Swiss-German
TUR Turkish
UK English (U.K.)
USA English (U.S.A.)
-m ModelNumber Specifies the 3270 display model to be emulated. Valid values include:
2 3278/79 model 2: screen size is 24 rows by 80 columns
3 3278/79 model 3: screen size is 32 rows by 80 columns
4 3278/79 model 4: screen size is 43 rows by 80 columns
5 3278/79 model 5: screen size is 27 rows by 132 columns
Notes:
  1. The -m flag is valid for DFT, HIA, and TCP/IP display sessions. The -m flag is not valid for non-SNA DFT printer sessions and SNA standalone sessions.
  2. For SNA DFT sessions, the exact model size is determined from the host definition. The model number indicated here is the maximum model size the display can support.
-N LoginName Specifies a valid HCON user name. If the -N flag is not used, the chhcons command uses the current login name.
Note: Either the name specified by the LoginName variable or the current login name must have been previously registered with HCON using the smit hcon command or the mkhconu command.
-n SessionName Specifies the name of the session profile to be changed. The session profile specified by the SessionName variable must have been previously defined using the smit hcon command or the mkhcons command. The session profile name is a single character in the range of a through z. Capital letters are interpreted as lowercase letters.

The -n flag is required for all session types.

Note: The name of a previously defined session profile cannot be changed.
-P LocalPrinterName Specifies the name of the local printer used by the emulator to service either print requests from the host or print-screen requests via the emulator PRINT key . The LocalPrinterName variable can be up to 32 characters and specifies the queue name of the printer. The default is lp0.

For printer sessions, the -P flag cannot be used with the -v flag.

-p DeviceName Specifies the communication device name. The DeviceName variable consists of up to 10 characters giving the device name. For DFT display and non-SNA DFT printer session profiles, the device name is the 3270 Connection Adapter device name (3270cX, where X is a numeral in the range of 0 to 7). For HIA display session profiles, the device name is hia0.

The -p flag is not valid for SNA standalone display and printer sessions or TCP/IP sessions.

-q FxferWait Specifies the amount of time the file transfer process waits for more file transfer requests before terminating.

The FxferWait variable must be a number of minutes up to 999. A value of 0 indicates that the file transfer process should end immediately after completing the last file transfer.

A value of 999 indicates that the file transfer process should never terminate. For implicit file transfers, a value of 999 causes the associated session to remain logged onto the host indefinitely.

The -q flag is valid only with display session profiles.

-R FxferRecoverTime Specifies the length of time in minutes that the file transfer process should attempt recovery during file transfer. The FxferRecoverTime variable must be a number of minutes up to 999. The recovery time is only in effect when the file transfer process has performed an implicit login to the host. A value of 0 indicates that no recovery should be performed.

The -R flag is valid only with display session profiles.

-r ReplaceFileName Specifies the file to be used by the emulator REPLS key.

The -r flag is valid only with display session profiles.

-s SaveFileName Specifies the file to be used by the emulator SAVES key.

The -s flag is valid only with display session profiles.

-T EnableAutologTrace Specifies whether a trace should be sent to standard output during an automatic host login using the AUTOLOG facility. The trace contains a listing of the AUTOLOG profile followed by the status of each step executed during the login process. The EnableAutologTrace variable must be either yes or no.

The -T flag is valid only for display session profiles.

-u 'SessionUse' Describes the session profile. The SessionUse variable must be a text string of up to 20 ASCII characters. The string must be enclosed in single quotation marks.

The SessionUse text is displayed in the Operator Information Area (OIA) during emulation sessions. The text is also shown in the list of session profiles displayed by the lshconp command.

Note: For SNA standalone sessions, to see both the SNA Logical Connection Profile name and Session Use characteristic in the Session Use field in the OIA, use only 10 characters for the Session Use characteristic and 5 characters for the SNA Logical Connection Profile or Prefix name.
-v PrintFile Specifies the name of the file in which to store printer output instead of spooling it to a physical printer.

The -v flag is valid only for printer session profiles and cannot be used with the -P flag.

-W AutologTimeout Specifies the amount of time, in seconds, that an AUTOLOG procedure should wait for the specified prompt to be sent from the host system. The valid range for the AutologTimeout variable is 0 to 99.

If the specified prompt is received before the time-out period is complete, the AUTOLOG facility immediately sends the specified input to the host and proceeds to the next event. If the time-out period is reached without receiving the prompt, the AUTOLOG facility proceeds to the next unsuccessful event number.

A value of 0 indicates that the next step should be performed immediately.

The -W flag is valid only for display session profiles.

-w 'SNAProfile' Specifies the SNA services logical connection profile to be used by SNA Services when establishing host communication. If LU pooling is desired, specify the logical connection prefix followed by an * (asterisk) instead of the actual logical connection profile name. The logical connection profile must be of type LU1 or LU3 for SNA standalone printer sessions, or type LU2 for SNA standalone display sessions. The profile does not have to have been previously configured; however, it must be configured before the emulator is invoked.
Note: For LU pooling, see Examples 4 and 5 to change display and printer session profiles.
-x HostLoginName Specifies the host login name, to be used by the file transfer program and API for automatic logins. The HostLoginName can be up to eight characters long.

The -x flag is valid only for display session profiles.

Error Codes

0 Successful.
14 ODM Fatal Error: The database may be damaged. Use local problem reporting procedures.
15 The user specified by the LoginName variable is not a valid user.
19 The database is either damaged or deleted. Use local problem reporting procedures.
21 The user who issued the command does not have access to the session 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.
28 The session type specified with the -t flag is not valid (mkhcons command only).
30 The command cannot obtain the current user name. This message can occur only when the -N flag is not specified.
31 The session name specified with the -n flag is not defined for the user in question (chhcons command only).
34 The -n flag was not specified or was specified without a SessionName variable.
36 Do not specify a session type when modifying a session profile (chhcons command only).
37 One of the flags specified is not valid with this session type.
38 The specified value of the HostType variable is not valid.
42 The specified value of the FxferDirection variable is not valid.
44 The specified value of the Language variable is not valid.
46 The specified value of the ModelNumber variable is not valid.
50 Cannot initiate an ODM connection.
52 The session name designated with the -n flag is not valid.
53 The session profile specified with the -n flag already exists.
54 Specified value of the FxferWait variable is not valid.
55 Specified value of the FxferRecoveryTime variable is not valid.
56 Specified value of the PortAddress variable is not valid (printer sessions only).
59 Specified value of the MaxBufferSize variable is not valid.
60 You cannot use both the -P flag and the -v flag (printer sessions only).
61 You did not specify a parameter for one of the flags.
63 The maximum length of the SessionUse variable is 20 characters.
64 The maximum length of the DeviceName variable is 11 characters.
65 The maximum length of the KeyboardTable variable is 1024 characters.
66 The maximum length of the ColorTable variable is 1024 characters.
67 The maximum length of the SaveFileName variable is 1022 characters.
68 The maximum length of the ReplaceFileName variable is 1022 characters.
69 The maximum length of the LoginName variable is 8 characters.
70 The maximum length of the FxferProgram variable is 8 characters.
71 The maximum length of the LocalPrinterName variable is 32 characters.
72 The maximum length of the PrintFile variable is 1024 characters.
73 The specified DeviceName value is not valid.
74 The specified KeyboardTable value is not valid.
75 The specified ColorTable value is not valid.
76 The specified SaveFileName value is not valid.
77 The specified ReplaceFileName value is not valid.
78 The specified FxferProgram value is not valid.
80 The maximum length of the AutologNodeID variable is 18 characters.
81 The specified AutologTimeOut value is not valid.
82 The specified EnableAutologTrace value is not valid.
85 You must specify either the -P flag or the -v flag for a printer session profile.
87 The maximum length of the SNAProfile variable is 14 characters.
92 The specified HostName value is not valid.
93 The maximum length of the HostName variable is 255 characters.

Examples

  1. To change the maximum buffer size, translation language, and file transfer direction for a display session profile belonging to the current user, enter:
    chhcons -n -l USA -d up -b 3712
    This changes the following parameters for session profile a : All other parameter values remain the same. If bob is the current user, the chhcons command returns the following message after changing the parameters:
    Session a for user bob is modified successfully.
    Note: You currently must be logged in with a valid HCON user name to use the chhcons command without the -N flag.
  2. To change the communication device name, model number, and host file transfer program for a DFT display session profile belonging to another user, enter:
    chhcons -n -p 3270c3 -m -f 'INDÅFILE' -N ruth
    This changes the following parameters for session profile w belonging to user ruth : All other parameter values remain the same. The chhcons command returns the following message after changing the parameters:
    Session w for user ruth is modified successfully.
    Note: You must have root user authority to modify a profile belonging to another user. The user specified with the -N flag must be defined as an HCON user.
  3. To change the local printer name for a printer session belonging to the current user:
    chhcons -n -P lp1
    This changes the local printer to lp1 for session profile b belonging to the current user.

    All other parameter values remain the same. If Yves is the current user, the chhcons command returns the following message after changing the parameters:

    Session b for user Yves is successfully modified.
    Note: You currently must be logged in with a valid HCON user name to use the chhcons command without the -N flag.
  4. To change the SNA logical connection prefix (LU pool) and the replace file name for an SNA standalone display session profile, enter:
    chhcons -w 'SNALU*' -r SNA_repls -N Bob -n j
    This changes the following parameters for session j , belonging to Bob : All other parameter values remain the same. The chhcons command returns the following message after changing the parameters:
    Session j for user Bob is successfully modified.
    Note: You must have root user authority to modify a profile belonging to another user. The user specified with the -N flag must be defined as an HCON user.
  5. To change the SNA logical connection profile and the local printer name for an SNA standalone printer session profile, enter:
    chhcons -w 'SNALU1' -P lp1 -n k
    This changes the following parameters for session profile k : All other parameters values remain the same. If Yves is the current user, the chhcons command returns the following message after changing the parameters:
    Session k for user Yves is successfully modified.
    Note: You currently must be logged in with a valid HCON user name to use the chhcons command without the -N flag.

Files

/usr/bin/chhcons Contains the chhcons command.
/usr/lib/hcon
                          Contains HCON files.
$HOME/usrprofs Contains the user's session profiles.
$HOME/usrprofs.vc Contains the user's session profiles.
$HOME/usrdflts Contains the defaults for the user's session profiles.
$HOME/usrdflts.vc Contains the defaults for the user's session profiles.

Related Information

The clhcons command, e789 command, fxfer command, lshconp command, lshcons command, lshconu command, mkhcons command, mkhconu command, rmhcons command, smit 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 discusses using the System Management Interface Tool.


[ Previous | Next | Contents | Search ]