+-------------+TM |d|i|g|i|t|a|l| +-------------+ AA-R63GA-TE --------------------------------------------------------------------------- DIGITAL SNA TN3270-C for DIGITAL UNIX Release Notes Version 1.0 January 1998 --------------------------------------------------------------------------- These release notes provide information on product installation, parameter tuning, features and functions, and known conditions and restrictions of the DIGITAL SNA TN3270-C for DIGITAL UNIX product. INSTALLATION ------------ To install this product and the online manual pages, perform the steps listed in the document Installing DIGITAL SNA TN3270-C for DIGITAL UNIX. This information is also available in the DIGITAL SNA TN3270-C for DIGITAL UNIX User's Guide, along with instructions for removing the software and online manual pages. CAUTION Installation of DIGITAL SNA TN3270-C may overwrite previously existing files, and the product may be incompatible with other related products such as the DEC SNA HLLAPI Tool Kit for OSF/1 and DEC SNA 3270 Terminal/Print Services for OSF/1. To avoid these potential problems, install DIGITAL SNA TN3270-C into a new directory. By default, DIGITAL SNA TN3270-C components are installed in directory /usr/tn3270c. If this directory already exists, a warning message is displayed with instructions on how to proceed. TUNING KERNEL PARAMETERS FOR MANY USERS --------------------------------------- Before running DIGITAL SNA TN3270-C with many users, you may have to tune the kernel parameters to meet the demand. To accomplish this, a series of formulas has been provided to help you adjust the pertinent kernel parameters to their proper values. In addition, following the formulas are instructions explaining which file to edit to adjust the kernel parameters, and the steps needed to build a new kernel and activate your changes. The variables used in the formulas are listed as follows. U = Maximum number of Session Managers that may execute (system wide) S = Maximum number of host sessions configured per Session Manager (SDF) H = Maximum number of HLLAPI user programs per Session Manager (SMCF) A = Maximum number of active host sessions per Session Manager C = Control Mode Configuration: 1=ControlMode configured 0=ControlMode disabled P = Local Print Configuration: 1=LocalPrint configured 0=LocalPrint disabled Note: It is highly recommended that, in conjunction with reading this material on how to tune the kernel parameters, the system administrator read the administrator's guide for the particular system in question. FORMULAS -------- For Semaphore Kernel Parameters SEMMAP = U Number of semaphore control maps SEMMNI = U Number of semaphore sets SEMMNS = U * (S + H + C + P + 3) Number of semaphores SEMMNU = U * (H + C + P + 1) Number of undo structures SEMMSL = S + H + C + P + 3 Number of semaphores per semaphore id SEMOPM = default Number of sem operations per semop call SEMUME = S + 2 Number of undo entries per undo structure SEMVMX = default Maximum semaphore value SEMAEM = default Maximum semadj value For Shared Memory Kernel Parameters SHMMAX = default Maximum segment size SHMMIN = default Minimum segment size SHMMNI = U * (A + 1) Maximum number of segments SHMSEG = A + 1 Maximum number of segs attached per process TUNING KERNEL PARAMETERS ON A DIGITAL UNIX SYSTEM ------------------------------------------------- All occurrences of below should be replaced by your system's name. l. Change your working directory to /usr/sys/conf. 2. Save the file /usr/sys/conf/ to /usr/sys/conf/.old 3. Edit the file /usr/sys/conf/ to change the kernel parameters. 4. Enter the following command: /usr/sbin/doconfig. This command creates a new kernel in the /usr/sys/ directory. 5. Save the existing kernel /vmunix to /vmunix.old. 6. Move /usr/sys//vmunix to /vmunix. 7. Reboot the machine. NEW HLLAPI FUNCTIONS (SCN 3799 and LATER) ----------------------------------------- There are several new High Level Language Application Program Interface (HLLAPI) functions and features that are supported: o Set Cursor function o Capture Presentation Space function o Capability to turn on and off the Session Manager Replay trace o Capability to define an EBCDIC-to-ASCII conversion table Set Cursor - Function 40 (FC_SCSR) Set Cursor allows your HLLAPI program to reposition the cursor within the current session's presentation space. The PS position parameter is used to specify the new presentation space position of the cursor. Presentation space positions are expressed as linear offsets from the upper left corner of the presentation space. For example, the upper left corner of the presentation space is 1 and the lower right corner is the size of the presentation space. Function Parameters Data String: N/A Length: N/A PS Position: New cursor position Session Parameters EXTSESOP Extended return codes are enabled. NOEXTSESOP Extended return codes are not enabled. (default) Return Codes ---------------------------------------------------------- Return Code Mnemonic Description ---------------------------------------------------------- 0 RC_OK Function successful 1 RC_NOCS No current session 4 RC_BUSY Session is busy (host is probably communicating with the session) 7 RC_INVP PS Position is out of range 9 RC_SERR System error (call Query System) 48 RC_UNINT Current session is in uninterpreted mode (returned only if EXTSESOP is in effect) ---------------------------------------------------------- Capture Presentation Space - Function 48 (FC_CPSP) Capture Presentation Space copies the entire contents of the presentation space of a specified session into a user program buffer. The size of the buffer depends on the model of the 3270 terminal that the specified session is configured to emulate and whether extended attribute bytes (EABs) are also being copied. The following table gives the assumed buffer sizes. Note: The lengths given are equal to the maximum presentation space size for each model. --------------------------------- 3270 Buffer Length Model Length with EAB --------------------------------- 1 960 1920 2 1920 3840 3 2560 5120 4 3440 6880 5 3564 7128 --------------------------------- Data characters in the presentation space that have Universal ASCII equivalents (see Appendix F in the HLLAPI programmer's guide) are translated from EBCDIC as they are copied. Handling of basic field attribute bytes during the copy operation is under user program control as described below. Data characters that have no Universal ASCII equivalents are copied as blanks. The presentation space being requested by this function is defined by a presentation space descriptor (PSCAPT_DESC). Its fields are defined as follows: ------------------------------------------------------------------ Field Description ------------------------------------------------------------------ ps_sname Session short name ps_buf Buffer pointer to receive copy of presentation space ------------------------------------------------------------------ Function Parameters Data String: Presentation space descriptor Length: N/A (Length assumed as above) PS Position: N/A Session Parameters ATTRB Attribute bytes are copied to the user's buffer unchanged (transferred directly in EBCDIC). The two high-order bits of attribute bytes are always on. NOATTRB Attribute bytes are replaced by blanks in the user's buffer. (default) EAB Extended attribute bytes are transferred to the user's buffer (if the host session is configured to support EABs). Each EAB follows its respective data or basic field attribute character in the user's buffer. NOEAB Extended attribute bytes are not transferred to the user's buffer. (default) EXTSESOP Extended return codes are enabled. NOEXTSESOP Extended return codes are not enabled. (default) Return Codes ----------------------------------------------------- Return Code Mnemonic Description ----------------------------------------------------- 0 RC_OK Function successful 1 RC_NOCS No current session 9 RC_SERR System error (call Query System) 48 RC_UNINT Current session is in uninterpreted mode (returned only if EXTSESOP is in effect) ----------------------------------------------------- Parameters for Turning On and Off the Session Manager Replay Trace There are two new session parameters that turn on and off the Session Manager Replay trace: RPTRON Turns on the Session Manager Replay trace. RPTROFF Turns off the Session Manager Replay trace. Parameters for Defining an EBCDIC-to-ASCII Conversion Table There are two new session parameters that give users the capability to define their own EBCDIC-to-ASCII conversion table. The HLLAPI functions that are affected by these parameters are: FC_CPS Copy Presentation Space FC_CPSP Capture Presentation Space FC_CFTS Copy Field To String FC_CPTS Copy Presentation Space To String FC_SFLD Search Field FC_SPSP Search Presentation Space The new session parameters are: EXTTABLE= Specifies the name of the file containing the conversion table. This table should consist of one line of 512 characters, with every two characters representing a single ASCII hexadecimal byte. Each set of two characters should be positioned in the line so that, when the table is indexed by an EBCDIC value, its corresponding ASCII equivalent is selected. The file is always assumed to be under the directory $COMMLINK/adm/natlang. A sample file etoa.sample is provided. In the event that the specified file is unable to be opened or read, then the function will return with the two new error1 codes 78 and 79, respectively. NOEXTTABLE Turns off translation via a user's conversion table. The translation is done via the neinit output file; all EBCDIC characters are translated into their Universal ASCII equivalents. (default) KNOWN CONDITIONS AND RESTRICTIONS --------------------------------- This release of DIGITAL SNA TN3270-C complies with RFC 1647, and has the following conditions and restrictions: 1. This release of the product requires DIGITAL SNA Peer Server Version 1.4 ECO-02 or higher or DIGITAL SNA Domain Gateway Version 2.1A ECO-01 or higher. 2. Do not configure the mainframe application to use an SNA CHAIN size greater than 1. This product is intended for use with applications that use only one SNA request unit (RU) per chain. Some mainframe applications have specific configuration parameters that control the use of SNA chaining. If no mainframe application configuration parameter is available, it may be possible to inhibit chaining by selecting a logmode entry that specifies no chaining. Select or create a logmode entry that has the high order bit of the PRIPROT= parameter set to zero. This corresponds to byte 4 of the SNA Bind request. For LU Type 3 (also known as Data Stream Compatibility) sessions only, an alternative approach is to increase the RU size to a value larger than the virtual printer buffer size. If the RU size is not explicitly controlled by the mainframe application program, select or create a logmode entry that has the first byte of the RUSIZES= parameter of 0xC9. This requests a mainframe-to-printer RU size of 6K. 3. The NOTN3270CR environment variable is used to suppress the copyright message from the tn3270c start script. Setting this variable to any value will cause the copyright message to be suppressed. 4. The NOTN3287CR environment variable is used to suppress the copyright message from the tn3287c start script. Setting this variable to any value will cause the copyright message to be suppressed. 5. The -dn DeviceName command line option is used to specify the tn3270E device name. The device name can also be specified by using the DeviceName keyword in the .sdf file for tn3270c or the .pc file for tn3287c. 6. The -oldTN command line option is used to specify the pre-RFC 1647 tn3270 protocol. The -oldTN option can be specified only on the command line. NOTE: RFC 1647 is new, and some parts of it are open to interpretation. There is a possibility that some clients and some servers will not work together. In case of trouble, specify this option and force tn3270c to use the pre-RFC 1647 tn3270 protocol. 7. The -DebugFileName FileName command line option redirects stderr to FileName if debug or replay is turned on, or as soon as it is turned on (by a new HLLAPI function or by KM_TELL). The -DebugFileName option can be specified only on the command line. (The TN32_DEBUG environment variable has the same effect.) If this option is not specified, and if debug or replay trace is turned on by either of these means, and if stderr was not already redirected, stderr will be sent to a file whose name is generated by tmpnam() (refer to your UNIX manual); it may take some work to find the file. 8. The LANG environment variable is used to generate output messages in French. Setting this variable to some value containing the string french will cause output messages to be printed in French. The default is to generate the output messages in English. 9. The KM_EXIT_ASK environment variable is used to prompt the user with a verification question before the user exits the Session Manager after pressing the KM_EXIT key. Setting this variable to some value will cause a question to be displayed to the user asking whether he or she is sure that they want to exit the Session Manager. Unless the user responds n, the exit operation will proceed. 10. The -nolock command line option is used to modify the behavior of the Session Manager when an illegal key is pressed. If this option is specified, the keyboard will not lock up; instead, an audible beep will be sounded and the keyboard will remain unlocked. © Digital Equipment Corporation 1998. All rights reserved. DEC, DIGITAL, and the DIGITAL logo are trademarks of Digital Equipment Corporation. OSF/1 is a registered trademark of Open Software Foundation, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. All other trademarks and registered trademarks are the property of their respective holders.