Home

3 - Oracle Documentation

1. Component Parameters Meaning SDLCLINE NAME BLNO1 User defined name 8 char max Device dev zbxa UNIX device for this line port A CLOCK external Clocking by modems external source DUPLEX full Full duplex line point to point INE leased Point to point line NRZI no NRZ encoding PAUSE 1 Wait for input during poll cycle 100 ms SPEED 9600 Line Speed in bits sec PU2 NAME BPU011 User defined name 8 char max LINK_NAME BLNO1 Line name this station is on ADDR x cl Station address AXDATA 265 Max data size for frame on link OUTFRAME 7 Max outstanding frames allowed ODULO 8 SDLC is modulo 8 ACTIVITY TIMEOUT 0 Host activity timer none in sec units RETRIES 10 Max retransmissions Component Parameters Meaning LU NAME BLUO1101 User defined name 8 char max PU NAME BPUO11 PU2 this LU belongs to UUTYPE 2 LU type 2 3270 LOCADDR 2 Local address of LU PACING 1 Pacing window LU NAME BLU01102 PU NAME BPUO11 jUTYPE 2 LOCADDR 3 PACING 1 LU NAME BLU01103 PU NAME BPUO11 jUTYPE 2 LOCADDR 4 PACING 1 8 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 SNA Configuration for SUNWopc1 This chapter explains how to configure SUNWopcl and sun3287 in the SNA host network configuration Use the information in
2. d Keyboard Map Record sun and sun cmd d d sun sun cmd Aliases aliases R1 NE 208z R2 NE 209z R3 NE 210z R4 NE 211z R5 E 212z R6 E 213z R7 NE 214z R8 E A R9 NE 216z R10 NE D R11 E 218z R12 E C R13 E 220z R14 E B R15 E 222z L2 NE 193z F2 NE 225z F3 NE 226z F4 NE 227z F5 NE 228z F6 NE 229z ET NE 230z F8 NE 231z F9 NE 232z F10 NE 233z F11 E 234z F12 E 235z Enter E 250z Delete Del NE 249z Return m BackSp h Tab i Ins E 247z ESC a Ea ESC b Eb ESC c Ec ESC d Ed ESC e Ee ESC f Ef ESC g Eg ESC h Eh ESC i Ei ESC j Ej ESC k Ek ESC 1 EI ESC m Em ESC n En ESC o Eo ESC p Ep ESC q Eq ESC r Er ESC s Es ESC t Et ESC u Eu ESC v Ev ESC w Ew ESC X Ex ESC y Ey ESC z Ez ESC EI ESC E ESC R ESC S ES ESC E ESC EM ESC amp E amp BSC ER Mapping sun3270tty Keyboards B 13 Code Example B 1 Sample sun3270map File 8 of 8 ESC E ESC E ESC E_ ESC Et ESC E CTRL B re
3. ci o SNA WAN or LAN DLC F SUNWopcl Mainframe TCP IP LAN CJ E SUNWopcl sunpu2 1 Figure 1 1 SUNWopc1 and the sunpu2 1 SNA Server SunLink Client 3270 9 1 Configuration and User s Guide August 1997 A lll 1 1 SUNWopcl Client SUNWopcl has several different applications each application provides different emulation capabilities OpenWindows Motif 3270 emulation TTY 3270 emulation and 3287 printer emulation Each application however runs as an SNA client program on a Sun Workstation They attach to a sunpu2 1 SNA server to access the SNA network The relationship between the Sun SNA resources and their comparable IBM devices is illustrated in Figure 1 2 DLC E C H 3278 3274 B Real IBM devices DLC C B SUNWopcl To SNA host PU2 A A SDCLINE QLLCLINE sunpu2 1 SNA server TRLINE A Sun Workstation with sunpu2 1 and SUNWopcl C Sun resources Figure 1 2 SUNWopcl and SNA The SUNWopcl applications interpret the SNA 3270 data stream to provide presentation services The sunpu2 1 SNA server emulates the functions of an SNA control unit such as an IBM 3174 cluster controller The relationship of th
4. Spanish Translation Tables EBCDIC to ASCII 20 20 20 20 20 20 20 20 20 20 20 20 0a 0d 20 20 20 20 20 20 20 Oa 20 20 20 20 20 20 20 20 20 20 20 2020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 EO El 20 20 E7 20 5B 2E 3C 28 2B 7C 20 E9 20 20 E8 ED 20 EF 20 26 5D 24 2A 29 3B AC 2D 2F 20 20 CO C1 20 20 20 20 F1 2C 25 5F 3E 3F 20 C9 20 20 C8 CD 20 CE 20 60 3A BA D1 27 3D 22 20 61 62 63 64 65 66 67 68 69 20 20 20 20 20 20 20 6A 6B 6C 6D 6E 6F 70 71 72 AA 20 20 20 20 20 20 7E 73 74 75 76 77 78 79 7A Al BF 20 20 20 20 20 2020 B7 20 20 20 20 20 20 5E 21 20 20 B4 20 7B 41 42 43 44 45 46 47 48 49 20 20 20 F2 F3 20 7D 4A 4B 4C 4D 4E 4F 50 51 52 20 20 FC 20 FA 20 5C 20 53 54 55 56 57 58 59 5A 20 20 20 D2 D3 20 303132 33 34 35 36 37 38 39 20 20 DC 20 DA 20 ASCII to EBCDIC 00 01 02 03 04 05 06 07 08 09 1e Ob Oc Od 0e OF 00 01 02 03 04 05 06 07 08 09 Oa Ob Oc Od 0e OF 40 BB 7F 00 5B 6C 59 7D 4D 5D 5C 4E 6B 60 4B 61 FO Fl F2 F3 F4 F5 F6 F7 F8 F9 7A 5E 4C 7E 6E 6F 7C Cl C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5 D6 D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 4A EO 5A BA 6D 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99 A2 A3 A4 A5 A6 A7 A8 A9 CO 4F DO A1 00 Hh 00 00 9 00 Jo0U0 4 N nPn o AAO FP WNEF Cc 0 0f 0 1f 0 2f 0 3f 0 4f 0 5f 0 6f 0 7f 0 8f 0 9f 0 af 0 bf 0 cf 0 df 0 ef 0 ff 0 0f 0 1f 0 2f 0 3f 0 4f 0 5f 0 6f 0 7f SunLink
5. Element Description receive Receive file from IBM host application Required positional parameter local_file Pathname of file on local system Required positional parameter n n is LU session to use for transfer EHLLAPI session name A H Optional positional parameter Default is A host_file VM CMS file name on IBM host File name can be up to 8 characters Refer to the IBM Virtual Machine System Product CMS User s Guide manual for more information about VM CMS file names and properties Required positional parameter file type VM CMS file type Required positional parameter file mode VM CMS file mode Optional positional parameter Default is A1 options The character is mandatory when you specify options VM CMS supports the following send options append Appends the contents of the VM CMS file to the local file Optional parameter ascii crlf Indicates to VM CMS that the VM CMS file should be converted from EBCDIC to ASCII when transferred to the local file Use this option along with cr1 for readable files Do not use this option binary files Default VM CMS does not translate the file from EBCDIC to ASCII Indicates that carriage return linefeed characters CR LF act as record separators in the data transferred from the VM CMS application to the local file VM CMS adds the CR LF characters where its own internal end of record markers indicated end of records With this option pcft replaces the CR LF charac
6. ae oe sun4Geom oe Q oe T t c iM t m T OE ne il h This file contains an example keyboard geometry for the sun3270x emulation program This example geometry file was used to construct the default keyboard map file sunkeMap Sun keyboard mapper program sunke uses the sun4Geom fil o initially display the sun4 keyboard the NAEnglishCaps defines the IBM keys Once sunke produces a keyboard map file he ap ne ne sun4Geom file and the NAEnglishCaps file are no longer needed information from these files are coalesced in the output keyboard file sunkeMap sunke program graphically displays the keyboard layout The area within window containing the keyboard is defined as 1000x1000 units Each key in the keyboard window is defined by Position X coordinate Y coordinate Size Height Width A 20 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 2 Example Keyboard Geometry File 2 of 8 The geometry file specifies a key by defining on one line the following X coordinate Y coordinate Height Width If one of these parameters is not specified its value defaults to parameter value of the line above Positional values preceded by a are in absolute coordinates otherwise positional values are relativ to the previous position For example th ntr
7. After the sun3287 is started it waits for applications to acquire it through a BIND message and transmit print data to it sun3287 translates the print data from EBCDIC to ASCII before writing the print data to a disk file or stream SunLink Client 3270 9 1 Configuration and User s Guide August 1997 N lll 7 3 Print Stream File Manipulation Examples To move the print stream file to home new_file type o sun3287 c mv f home new_file You can also pass the print stream to your own handling function a Unix script or process by entering a command like o sun3287 c my print job script f rm f To attach to an LU named 8LU01104 on the local system and direct all print streams to a printer device named dev 1p type sun3287 1 BLU01104 s cat gt dev lp H 132 10 122 18 24 56 7 4 Starting suntn3287 To invoke suntn3287 type the following at the command line suntn3287 1 lu name h hostname n port number i d c command line s stream command path name H horizontal format V vertical format L line length ol i I ferm id d u a A translation name P t trace flag v Most of the suntn3287 command line keywords have the same meaning as their sun3287 counterparts with the following exceptions I terminal identifier suntn3287x negotiates terminal type sub options as the spec
8. 5 Press the left mouse button Customizing the sun3270x Keyboard AI lll aN A 32 Note If you double click on the left mouse button sunke picks up the next unmapped IBM key value from anywhere on the keyboard layout This option saves time because you do not have to move back and forth between the keyboard layout and the unmapped IBM key values Repeat this procedure for all unmapped IBM key values See Chapter 5 Using Keyboard Mapper for a complete description of mapping IBM key values SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Mapping sun3270tty Keyboards B Sun provides a keyboard map utility for sun3270tt y This utility helps you determine which keys affect IBM keyboard functions You can also use this utility to change the mapping between keystrokes and IBM keyboard functions To display the current keyboard map when you are using sun3270tty press the Help key sequence usually Escape The printout shows the IBM keyboard functions IBM key values and their corresponding input keystroke sequence You can modify the keyboard map You can change key mappings or you can create key mappings for new keyboards The name of the default keyboard map file is sun3270map The sun3270map file lists IBM key values by name and associates these keys with an input character sequence for your device keyboard The SUNMAP3270 environment variable defines an absolute path name
9. Customizing the sun3270x Keyboard A 7 lll aN Color of the shadowed side of a key Default is black xtsunBevelDarkColor color xtsunBevelDarkColor color A 2 4 Generic Arguments Pass resource strings directly to the X server xrm resource string Identify the instance of sunke to the X server The instance name is used to more specifically identify resource values in the sunke resources file that you want associated with this invocation sunke name instance name name instance name Inform the X server to display the sunke emulation window on a particular workstation console or X term display name has the following format on Unix systems host name 0 0 Format of display name follows XOpenDisplay display display name display display name General usage parameters for sunke u useageMode onloff A 3 Customizing sunke The sunke program has many attributes that you can change In X Window environments configurable attributes are called resources The sunke resources belong to the sunke class When the sunke program starts it searches for sunke resources in order of highest precedence sunke SXENVIRONMENT if it does not exist HOME Xdefaults hostname Resource Manager property xrdb If it does not exist SHOME Xdefaults A 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll SHOME sunke SXAPPLRESDIR sunke e usr lib X
10. Special Functions for more information on this parameter userButton3Command User Button Command string userButton3Command User Button Command string Specify the default title string for user button 4 See Section 3 11 Special Functions for more information on this parameter userButton4Title User Button Title string userButton4Title User Button Title string Specify the default command string for user button 4 See Section 3 11 Special Functions for more information on this parameter Using sun3270x 3 21 lll Qo userButton4Command User Button Command string userButton4Command User Button Command string Specify the default title string for user button 5 See Section 3 11 Special Functions for more information on this parameter userButton5Title User Button Title string userButton5Title User Button Title string Specify the default command string for user button 5 See Section 3 11 Special Functions for more information on this parameter userButton5Command User Button Command string userButton5Command User Button Command string You can set defaults for the user exits on LU activation and deactivation Specify the default command string for LU activation The format of the command is identical to the user button command string actCommand LU activation command string actCommand LU activation command string Specify the default command string for LU deactiva
11. ibmPurple color ibmPurple color ibmPaleGreen color ibmPaleGreen color SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll Table 3 1 IBM Color Keywords and Display Attributes Continued IBM Color The default X Index Color Keyword 13 pale turquoise ibmPaleTurq color ibmPaleTurq color 14 gray ibmGray color ibmGray color 15 white ibmWhiteFF color ibmWhiteFF color 16 black ibmBackground color ibmBackground color Replies to the host Read colorMode8 Partition Query Query colorMode8 on off List structured field to indicate that eight colors are supported Some host applications require this response to use color support 3 1 7 Displaying Window Color Functions This section lists the command line options that can be run to invoke sun3270x These options also explain the behavior of a displayed window You can change color functions of the display window matte menu options and pop up windows Start the emulator iconified iconic iconic on off Run sun3270x in monochrome mode For monochrome consoles sun3270x automatically runs in black and white For color consoles the defaults colors are green and black m monoMode on off When in monochrome mode use reverse video Using sun3270x 3 7 E reverseVideoMode on off When in monochrome mode use the color specified for the IBM color index as the foreground color F ibm co
12. printEhllapi Identify the file that contains the appropriate ASCII EBCDIC translation tables to use for EHLLAPI See Chapter 4 Customizing sun3270x or the file format y filename asciiEbcdicEhllapiFilename filename Identify the file that contains the appropriate ASCII EBCDIC translation tables for EHLLAPI and request that sun3270x print the tables during initialization See Chapter 4 Customizing sun3270x for the file format SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll Y filename asciiEbcdicTableEhllapinameAndDump filename Identity the base file name to write screen output to when the dump screen option is selected in series file name mode Each dump screen operation creates a new file with the base filename and a numeric suffix incremented for each new operation The default sun3270ScreenDump d base filename dumpScreenSeriesFilename base filename Identify the file name to write screen output to when the dump screen option is selected in fixed file name mode The default sun3270ScreenDump D filename dumpScreenFixedFilename filename Identify the default dump screen mode The default Fixed dumpScreenMode Fixed Pipe Interactive Series dumpScreenMode Fixed Pipe Interactive Series Identify the default dump screen pipe command dumpScreenPipe pipe command dumpScreenPipe pipe command Show sun3270x usage u
13. A 24 Code Example A 2 Example Keyboard Geometry File 5 of 8 n B Ov Oy ex DB DB DB DB BW WB WA Ba OWNRTY Key Row third row of a sun4 keyboard X X Height Width 15 480 80 40 7 L5 5 L6 120 0 80 60 Tab 5 0 80 40 Q 5 W 5 PB 5 PR 5 T 5 X 9 U 5 I 9 5 P 5 i 5 i 0 0 170 55 Return 815 0 80 40 SCORE 5 R8 5 R9 5 0 170 40 Num Pad SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 2 Example Keyboard Geometry File 6 of 8 n a BoB Ww am BB WA OB OB as Ba ASDFG Key Row fourth row of a sun4 keyboard X Y Height Width k 15 570 80 40 5 120 0 80 75 0 0 80 40 5 5 5 5 5 5 5 5 5 5 5 815 0 80 40 5 5 L7 Control bDoxwomngon ulocu m R10 R11 R12 Customizing the sun3270x Keyboard A 25 lll aN Code Example A 2 Example Keyboard Geometry File 7 of 8 ZXCVB Key Row fifth row of a sun4 keyboard X Y Height Width 15 660 80 40 L9 45 L10 120 0 80 90 Shift 95 0 80 40 Z 45 xX 45 C 45 v 45 B 45 N 45 M 45 Bos 45 a 45 Py 45 0 80 85 Shift 90 0 80 40 Line Feed 815 0 80 40 R13 45 R14 45 R15 45 0 170 40 Enter A 26 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 2 Example Keyboard Geo
14. Figure 3 3 shows the menu that controls the selection mode Figure 3 3 Light Pen Cut Copy Paste Menu Using sun3270x 3 41 3 42 The options are Light Pen Selection The left mouse button functions as a Selector Light Pen If the left mouse button is clicked within a Light Pen selectable field that field is selected When this option is selected all other options are excluded Two types of light pen selectable fields are defined selector fields and attention fields The selection type field is defined by a question mark designator character When selected the selector field designation character is automatically changed to a greater than sign gt and the Modified Data Tag bit is set that is this field is transmitted to the host on operator ENTER action or receipt of a Read Modified command An attention type field is defined by a space or NULL designator character When selected an I O pending attention is generated to the host The host may then issue a Read Modified command to retrieve the selected field A second type of attention type field is defined by an ampersand amp designator character When selected an operator ENTER action is simulated on the display Only Input Fields You can only Cut or Copy characters in data entry fields Each field is transferred as a single line Fields spanning multiple lines are transferred as multiple lines When this field is selected all other options are exclud
15. IBM key values are picked up from one key and placed on another Consequently the keyboard map utility provides a comprehensive help facility and the freedom to remap your Sun keyboard values whenever you want Sun also provides a keyboard map utility for sun3270tty This utility helps you quickly determine which keys affect the IBM keyboard functions You can also use this utility to change the mapping between keystrokes and IBM keyboard functions 1 4 Configuring SUNWopcl The SUNWopcl program connects to LU Type 2 ports on the sunpu2 1 SNA server The sun3287 printer emulator connects to LU Type 3 ports on the sunpu2 1 SNA server You can either direct these emulation programs to connect to a specific port or to any available one LU ports and PU2s represent SNA resources Therefore they must be configured in the NCP GEN file using the LU and PU macros Similar entries must be added to the sunpu2 1 SNA server configuration file for each LU port and PU2 device Introduction to SUN Wopcl 1 7 1 8 Note One sunpu2 1 SNA server can support up to 254 LU ports SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Getting Started with SUNWopc1 This chapter is designed to get you started with SUNWopc1 using a sample configuration that comprises a single link connection into the SNA network a single PU2 and a single SUNWopc1 program Chapter 8 SunLink PU2 1 SNA Server Configuration lists the
16. Name in the keyboard mapper title bar The default title is the name of the sunke invocation sunkeTitle title name sunkeTitle title name Path name of the icon file to use when the sunke window is closed sunkeIconFilename filename sunkeIconFilename filename 3 1 9 X Keywords Besides the geometry and title keywords listed above sun3270x also supports several generic X keywords that are passed to the X server Pass resource strings directly to the X server xrm resource string SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 Identify the instance of sun3270x to the X server The instance_name is used to more specifically identify resource values in the SUNWopc1 resources file that you want associated with this invocation sun3270x Use this construct to identify a group of resource values for connecting to the sunpu2 1 SNA server and identifying the EHLLAPI session name for example name instance name name instance name Inform the X server to display the sun3270x emulation window on a particular workstation console or X term display name has the following format host name 0 0 Display format is defined by XOpenDisplay display display name display display name 3 1 10 Miscellaneous Functions The following miscellaneous functions can be specified at the command line Use base color support green and white intensified b baseColorMode on off Use only uppe
17. Q oe This file contains example keyboard maps for the sun3270tty emulation programs This file is read during start up and used to initialize the IBM keys of a 3270 display station keyboard to the keys of your keyboard e g VT100 Wyse etc This keyboard map file contains the following entries ibmCaps record Associates names with the IBM key values of a 3270 display station keyboard You can change the names if you wish vt100 and vt200 keyboard map record Associates ASCII keystrokes with the IBM key values of a 3270 display station keyboard This record has two parts aliases record Associates names with ASCII keystroke expansions These aliases are especially useful for labeling keys which generate multi character sequences when depressed e g arrow keys and functions keys You can change the aliases if you wish ASCII keystrokes to IBM key value mappings Mapping sun3270tty Keyboards B 7 lll Se Code Example B 1 Sample sun3270map File 2 of 8 Actual keyboard map for vt100 and vt200 keyboards You can change IBM key value to ASCII keystroke mappings sun and sun cmd keyboard map record aliases record Associates names with ASCII keystroke expansions These aliases are especially useful for labeling keys which generate multi character sequences when depressed e g arrow keys and functions keys You can change the aliases if you
18. Since suntn3270x supports EHLLAPI session names A through Z 0 through 9 and a through z up to 62 EHLLAPI programs can run on one system To start suntn3270x as an EHLLAPI server use the e keyword To execute a file transfer you must start suntn3270x as an EHLLAPI server 11 2 suntn3270 Keywords 11 2 Keywords control the suntn3270x program These keywords are the same as sun3270x described in Chapter 3 Using sun3270x except as noted below All the suntn3270x keywords have parallel entries in the SUNWopc1 resources file suntn3270x reads the SUNWopc1 resources file during start up you can update this file to customize suntn3270x see Chapter 4 Customizing sun3270x for more information The resource name for each keyword is under the keyword and is prefixed with a period The following keywords describe the TN3270 server attachment suntn3270x requests connection to the TN3270 server located on the named host If the hn option is omitted the local host is called h host name hostName ost name SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Hi suntn3270x requests connection to the TN3270 server on the specified port If the n option is omitted the default Telnet port 23 is called n port_number portNumber port_number suntn3270x negotiates terminal type sub option as the specified terminal identifier with the TN3270 server If the 1 option is omitted t
19. WM CHS CICS wv Send Receive To Unix File i From Host File i Mode CRLF wv Binary w CRLF 4 Ascii No CRLF Comments File Transfer History Done l Transfer Figure 6 2 File Transfer lll O After setting the options described in the next section click the Transfer button to begin the file To stop a file transfer in progress click Done To exit from the File Transfer utility click Cancel 6 3 File Transfer Status The running status of a file transfer is displayed at the bottom of the File Transfer in the File Transfer History section of the screen This section indicates The start of the transfer Arunning tally of the bytes transferred The end of the transfer The status of the transfer 6 4 File Transfer Options Before executing a file transfer remember to move to the main READY prompt Table 6 1 includes the file transfer options Table 6 1 File Transfer Options Option Function IBM Host Application TSO Logged into Time Sharing Option TSO If the IBM host system is running TSO E you must disable interrupts and exit from the session manager before beginning a file transfer You can disable TSO interrupts with the term nobreak command You can exit from the TSO session manager by clearing the screen and typing ena VM CMS Logged into Conversational Monitoring System VM CMS CICS Logged into Customer Information Control System C
20. and Wyse The SUNWopc1 product has the following capabilities 3278 model 1 2 3 4 and 5 emulation 3279 model 2A 2B 3A and 3B emulation Extended High Level Language Application Program Interface EHLLAPI program services File transfer INDSFIL 3287 printer emulation E support LU Type 1 and LU Type 3 Graphical keyboard mapping keyboard layout display drag and drop keys to remap 1 1 1 2 In addition SUNWopc1 which includes the 3270 data stream Controls the local screen display Maps keyboard functions Converts ASCII to EBCDIC and vice versa The SUNWopc1 is responsible for presenting the 3270 data stream Therefore the controls on the local screen display maps keyboard functions and converts ASCII to EBCDIC and vice versa It uses the sunpu2 1 SNA server to establish and control LU Type 1 LU Type 2 and LU Type 3 SNA sessions with mainframe applications The physical connection to the SNA network is provided by the sunpu2 1 SNA server The sunpu2 1 SNA server location is independent from where the SUNWopc1 client emulation actually occurs The sunpu2 1 SNA gateway and the SUNWopc1 client can either execute on the same system or can be separated and communicate over a TCP IP network In Figure 1 1 the users of workstations on the TCP IP LAN can access the mainframe by invoking SUNWopc1 in an open window and then logging on to the mainframe applications
21. 1 SNA server Readiness The keyboard input capability is displayed Blank Keyboard input is enabled Wait Keyboard input is disabled Modes The terminal insert mode is displayed Blank The terminal emulator is not in insert mode Insert The terminal emulator is in insert mode LU The current Logical Unit name is displayed If sun3270x supports an EHLLAPI session the EHLLAPI session name is displayed in parenthesis after the Logical Unit name PU The current Physical Unit name is displayed PORT The current PU port number is displayed Cursor The current location of the cursor row column Using sun3270x 3 29 3 3 5 Data Entry Overview All SUNWopcl programs sun3270x sun3270tty suntn3270x and suntn3270tty share common data entry mechanisms Except where noted the following sections apply to each of these programs Since your keyboard probably differs from an IBM 3270 display station s keyboard SUNWopcl provides a configurable mapping capability to associate your keystrokes with IBM keystrokes For sun3270x and suntn3270x see Chapter 5 Using Keyboard Mapper for directions on mapping your keyboard to provide comparable 3270 keyboard input functions For sun3270tty and suntn3270tty see Appendix B Mapping sun3270tty Keyboards 3 5 1 SunLink 3270 Screen Formats A SunLink 3270 client display has two types of screens unformatted and formatted A formatted screen has fields defined by an IBM host appl
22. 3 SNA 3270 Display Configuration Example 8 4 IBM SNA 3287 Printer Configuration Example 8 4 Server Configuration Parameters 000000000 8 6 xiii xiv Table 9 1 Table 10 1 Table 11 1 Table A 1 Table B 1 Table C 1 Table C 2 Table C 3 Table C 4 Table C 5 Table C 6 Table C 7 Table E 1 NCP VTAM MacrOS seeee RI s 9 2 Common Problems and Solutions 08 10 5 Suntn32 70 Status Eine ecw Ree EEEE HERE 11 7 Keyboard Functions nres siasah pa eenia edee A 11 sun3270tty Keyboard Functions 08 B 4 pcft Command Options 0 0 0 6 cece C 2 Send TSO Syntax esas reb rb ete e aee eds C 4 Receive TSO Syntax sese C 6 Send CICS SYNTAX eiad kaa i ences C 8 Receive CICS Syntax Lesire tura ences C 9 Send VM CMS Syntax odek dx ok Oed e cp dcc at C 11 Receive VM CMS Syntax 0 ence eee C 13 Message String Components E 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Preface This manual describes the administration and use of the Sun SNA 3270 emulation product SUNWopc1 which is a client application of the SunLink SNA 9 1 PU2 1 server Who Should Use This Book The SunLink Client 3270 9 1 Configuration and User s Guide is the user s guide for the SUNWopc1 product It describes how to install and configure the SUNWopcl product It provides information on how to invoke SUNWopc1 capabil
23. 4 File Transfer Options sus ra sae es soe Rete ehh 7 USING SURI ET cana E oes eee ee banee ee eee eee er ee ewes FA Dependencies sitorri ELE PER HOO E ae oes 72 SOLUS eum QUO Y qaaa dn popa aca EE NON Ra a o or 7 3 Print Stream File Manipulation Examples 74 Starting Ss ntn32 8T resiti tht us e ER ERES 8 SunLink PU2 1 SNA Server Configuration coececberiuishws bcr 4a a dk eris us 8 1 SunLink PU2 1 SNA Server Configuration 8 4 LU DRIGCIIVO es cee ee eee eee a a eRe ec oo RR dd RRR CY 8 3 Example Display Terminal Configuration 8 4 Sample SNA Server Configuration SunLink Client 3270 9 1 Configuration and User s Guide August 1997 10 11 12 13 SNA Configuration for SUNWopCl ow cece eee ee eee eee 9 1 9 1 SNA Configuration o aoc Sant ae oae aca dci odd 9 1 92 HOGMODE Tables terere rennen i LAS Ed E EE VIEN 9 5 9 3 Application Tables a c6 eus LER De ER betes 9 7 SUNWopcl Troubleshooting ore nnn 10 1 10 1 Online FHlelpus caer bebRREFRERRRPC PREX E De Edd 10 2 10 2 Operator Status Information 005 10 2 10 3 Logical Data Scope and Tracing 0005 10 3 10 4 Recovery St ps serres dem xc nO RORORORK AERA ERROR 10 4 10 5 Common Problems 12 enar novato ORC ROR A RR ER E es 10 5 Using Sunn 270k so anes R9 CERWERRRREE A Gd EM K RH iR 11 1 11 1 suntn3270 Dependencies i522 e rr eene aa 11 2 11 2 suntn3270 KeyWo
24. 50 34 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 34 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY 07 26 96 10 50 35 read from terminal keyboard 76 V 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY 07 26 96 10 50 35 read from terminal keyboard 69 i 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY 07 26 96 10 50 35 read from terminal keyboard 65 e D 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example D 1 sun3270 Trace 4 of 9 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY 07 26 96 10 50 35 read from terminal keyboard 77 w 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event ll lt H _TERM_IN 07 26 96 10 50 35 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY Sun3270 receives input from terminal keyboard 07 26 96 10 50 38 read from terminal keyboard 1b Sun3270 recognizes input as terminal in
25. 9 amp 13 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Customizing the sun3270x Keyboard A The sun3270x keyboard mapper is a Unix program named sunke sun3270x starts sunke when you choose Keyboard Map from the Options menu Chapter 5 Using Keyboard Mapper discusses viewing and modifying the association between IBM key values and keys on your keyboard This chapter describes how to change the look of the keyboard mapper and choose different colors text and keyboard layouts Information in this appendix includes Invoking sunke Customizing sunke Customizing sunke for a new keyboard A Starting sunke You can start sunke program from a Unix command line If you are creating a new keyboard you will have to start and initialize sunke by specifying the g option A 1 1 Files The files used by sunke are as follows geometry defines the physical layout of the keyboard keyboard relates the keysyms generated by the X server to a graphical key key caps defines the logical keyboard functions mapping relates each logical keyboard function to one or more X keysyms The geomet ry file is used to draw a picture of the keyboard on the screen The picture along with the keysyms generated by the X server for each key is saved in the keyboard file The key caps file defines the 3270 logical keyboard functions and the EBCDIC code point corresponding to each function The 3270 keyboa
26. C 2 4 Receive CICS Examples To receive a host CICS data set data set name data as a text file name text file in readable format on your Unix system type pcft receive textfile data ascii crlf To receive a host CICS data set data set name data1 as binary file name binfile on your Unix system type 9 pcft receive binfile datal binary nocrlf C 3 VM CMS Options This section describes the options available for file transfers between Sun s pcft program and a VM CMS host application Remember to move to the VM CMS READY prompt before initiating a file transfer SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll C 3 1 Send VM CMS The syntax of the pc t command to transfer files from the SUNWopc1 session to a VM CMS host application is described in Table C 6 pcft send local file n host file host filetype hostfilemode options Options append ascii crlf lrecl m recfm f v Table C 6 Send VM CMS Syntax Element Description send Send file to IBM host application Required positional parameter local file Pathname of file on local system Required positional parameter n n is LU session to use for transfer EHLLAPI session name A H Optional positional parameter Default is A host file VM CMS file name on IBM host File name can be up to 8 characters Refer to the IBM Virtual Machine System Product CMS User s Guide for
27. CG3270 123 12 12 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using sun3270tty B This chapter describes how to start and run the Sun TTY based SNA 3270 emulator sun3270tty The sun3270tty application emulates IBM 3278 display terminals model 2 on terminals like VT100 VT200 and Wyse It supports EHLLAPI programs and file transfer between your local system and IBM host systems The sun3270tty program is a Unix application that can be invoked from the command line from a script or as a menu option Many sun3270tty programs can run in parallel each sun3270tty controls one terminal and one session with an IBM host application To view your current keyboard map press the Help key sequence Escape To Escape to shell press the Escape key sequence usually Control x To execute file transfers see Appendix C Using PCFT To attach to a sunpu2 1 SNA server running on a different system in your local area network use the h host name option 13 1 13 13 1 sun3270tty Dependencies 132 The sun3270tty program accesses the keyboard map file during start up The default keyboard map file name is sun3270map The sun3270tty searches the directories listed in your PATH environment variable to find sun3270map You can also use the SUNMAP3270 environment variable to specify the pathname of sun3270map or the k command line argument If the search fails sun3270tty announces that it
28. Chooses whether or not to enable GDDM support during this run of the suntn3270 If GDDM support is enabled query replies to the host indicate GDDM and the GDDM datastream will be fully supported If GDDM support is not enabled query replies to the host indicate NO GDDM support and any GDDM datastream data will be silently ignored The default if OFF gda m gddmMode on off This flag is similar to gddm gddmMode described above except it causes the suntn3270 to allocate a separate set of 3 planes in pixel memory for the Graphic Layer On some hardware this yields faster screen updates and refreshes in both the text layer and the graphics layer It yields smoother real time updates of the graphics layer as GDDM data stream arrives This mode of GDDM is required for GDDM mix modes OR and XOR for supporting 3 plane LPSs in graphics layer and for the GDDM crosshair graphics cursor If this mode is not enabled mix modes OR and XO will act the same as mix mode OVERPAINT Query responses to the host will indicate no support for 3 plane LPSs any Load PS structured field having a color field of other than 0 will be rejected and the GDDM crosshair graphics cursor will be unavailable only the cross graphics cursor will be available If both the gddm and gddmDirect are given gddmDirect takes precedence The default is OFF gddmDirect gddmDirectMode on off The type of X cursor to use for the cross style GDDM graphics cursor Th
29. Field Control csi ee RR ee ok ieee eee Ra 3 11 Special Functions vci eeu eet or oec aldea oe 4 Customizing sumni3 703 4 ex e eb E RRELEAEYXSTEMEKEK VEA 4 1 8un3270x MeSOUFC B 123 0 a E e edo qi 4 2 Example SUNWopcl Resource File 4 3 Settings Dynamic SUNWopc1 Resource Updates 4 4 Message Library Updates 00 0000 45 ASCII EBCDIC Translations 0 000005 4 5 1 Sample ASCII EBCDIC Translation Table 5 Using Keyboard Mapper ccccccccceccscees 5 1 Displaying the Keyboard Map iie 5 2 Keyboard Map Layout aiio y EERRIRIU RIDE Ee ue dod 941 Menu Data ee Xr RREPRPPPRPRPRPRPE eiti kind iures 5 22 Title Bat 2e eee EP eee EE eee Et 5 2 3 Unmapped IBM Keys coves i274 een oer m eem et 5 2 4 Mode DURO Co epos kie aeo RR UCH RR Contents 523 Single Key Layguboseswee su NO ODE DOE nena ws 5 2 6 Keyboard Layout sd aec eoe op pre ec 5 3 Updating the Keyboard Map iile sex sep ERR 5 3 1 Moving an IBM Key 22 20 4 0 4 Ta E XtA REX Rana 5 3 2 Duplicating an IBM Key cie Lied ee eee 5 3 3 Removing an IBM Key s cre Re e ens 5 4 Saving Keyboard Map Updates 5 5 Exiting Keyboard Map Display 6 Using Pile Transfet suae uu en ERR REEKRERRX 6 1 File Transfer Dependenolesu sues cecebs bebe ren Rr 6 2 Starting a File Taristet cs ciianns s dev ences EE E RR 6 3 File Transfer Status coi redobe Fee rerba eg v eee 6
30. HAH 8 3 3 4 3 345 daa 4333 zz 2 33 3 3 3 d zii zd 1 13 5 3 1 35 3 5 EEES daa aa 13 fe sf es es ess ee sg S445 es ga S18 SunLink Keyboard Happing Fncilitu PF20f Editing3Xz7i Figure 5 4 Previously Unmapped IBM Key Value F20 Being Mapped Similarly Figure 5 5 demonstrates a change to a previous mapped IBM key value In this case the Back Tab btab IBM key value has been picked up and now can be deposited on another key Using Keyboard Mapper Ser lll O1 Drag and Drop IBM Key File o dut SunLink Keyboard Mapping Fncilitu Edjtingdz2704 Pap pest markets Kaybsard out bbe eine Ed morb molar ies d 32 234 313 9 3 3 34 3 d dad 4335 zz se AYA A Ads dd aada zu eee fet 3 i 5 5 3 5 ee 9 dag sf fees fe ffs fs cs fe fs fs es a Ee gd JJJ dd ff Sd Figure 5 5 IBM Key Value Btab Being Re mapped If you drop an IBM key value onto a target key that has an IBM key value the keyboard mapper swaps the two IBM key values the incoming IBM key value is dropped off and the existing IBM key value is picked up 5 3 2 Duplicating an IBM Key To duplicate an IBM key value press the Shift key when you select the IBM key value 5 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 O1 lll 5 8 8 Removing an IBM Key To remove an IBM key value from the keyboard layout pick up the IBM key value and drop it off on the unmapped IBM key va
31. Sun Special Function Keys Name lt Value f r f Cut cut Copy copy Paste paste CIE ClearField DLeft DeleteLeft Print DumpScreen r r i i IBM Display Characters Name lt Value EBCDIC Customizing the sun3270x Keyboard lll aN Code Example A 1 Example Keycaps File 4 of 6 space c NX KX zZzd4goGo ctuHg oB8Sroersmur Surmxonnonp Wonuugafhtmuosctus f 40 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99 a2 a3 a4 a5 a6 a7 a8 a9 c1 c2 eS c4 eb5 c6 c7 c8 c9 di d2 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 1 Example Keycaps File 5 of 6 tuo m gs E NK SKM SS GCHN DDO 000 1001 C PN CO cent d3 d4 d5 d6 d7 d8 d9 e2 e3 e4 e5 e6 e7 e8 e9 0 l 2 3 4 5 6 7 8 9 4a 4b 4c 4d 4e 4f 50 5a 5b Customizing the sun3270x Keyboard lll aN Code Example A 1 Example Keycaps File 6 of 6 mr not brk oe v zw 1 60 61 6a 6b 6c 6d 6e 6f 79 7a Tb TO 7d 7e TE al cO do e0 5e 5d 5e 5f SunLink Client 3270 9 1 Configuration and User s Guide August 1997 A A 6 Defining a Keyboard Geometry File For new keyboards you may need to define a new keyboard layout or geometry The sunke accepts a simple text file to initializ
32. Sun Workstation The Sun Workstation attaches to the SNA network through a Point to point SDLC line BLNO1 Part of VTAM NCP GEN for this example is included in Code Example 9 1 Note This example does not include the configuration of a 3287 printer To configure a 3287 printer you must specify a 3287 1ogmode for an LU for example DLOGMOD DCS2K SNA Configuration for SUN Wopcl 9 3 Code Example 9 1 Partial VTAM NCP GEN Example 1 of 2 kCkckckckckckckckckckckckckckckckckckckckckckckckckckckockckckckckckckckokockockckockckckckckckockckockckckckockckockckockckckckck ck ck ck ck ck kk GROUP MACRO kk ck ck Ck ck ck Ck ck Ck Sk ck Ck Ck Ce Sk KKK KKK ck ck ck KK KKK KKK KKK ck kk ck kk ck ck ck KK KKK ck kk ko kk Sk kc KKK KKK KKK GRPSUNO GROUP DIAL NO INCTL SDLC YPE NCP ISTATUS ACTIVE KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK LINE OPERANDS MOVED UP TO GROUP MACRO KKEKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK kk kk kk CLOCKING EXT DISCNT NO SERVLIM 5 TRANSFER 9 SPDSEL NO KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK PU OPERANDS MOVED UP TO GROUP MACRO KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK IRETRY YES MAXDATA 265 MAXOUT 7 PAS
33. SunLink Client 3270 9 1 Configuration and User s Guide August 1997 11 The components of the status line are defined in Table 11 1 Table 11 1 suntn3270 Status Line Indication Display Status The current screen owner or active session is displayed as follows Connected The connection to the TN3270 server has been established Disconnected The connection to the TN3270 server has not been established Readiness The keyboard input capability is displayed as follows Blank Keyboard input is enabled Wait Keyboard input is disabled Modes The terminal insert mode is displayed as follows Blank The terminal emulator is not in insert mode Insert The terminal emulator is in insert mode Host Name Port The current TN3270 server host name and port number are displayed If suntn3270x supports an EHLLAPI session the EHLLAPI session name is displayed in parenthesis after the port number Cursor The current location of the cursor row column 11 5 suntn3270 Examples To connect to a t n3270 server running on remote system BigBlue and to specify terminal type sub option IBM 3278 2 E use the default Telnet port 23 serving as the EHLLAPI presentation space named A and enter the following command suntn3270x h BigBlue e A I IBM 3278 2 E or suntn3270x h BigBlue e A S 2 E Using suntn3270x 11 7 11 11 8 SunLink Client 3270 9 1 Configuration and User s Guide
34. The same keysym is used by these X servers for different keystrokes If the SUNWopcl is used in an environment using both of these Customizing the sun3270x Keyboard A 29 lll aN A 30 systems a common keymap will invert the functions print and sys req on these systems This situation can be avoided by using the Key Characterization to adjust the keysym interpretation from either of the X servers x un3270x OK V CancelV Key Characterization Shift F22 F22 F22 Print No Keysym Figure A 2 sun3270x Print Key Characterization SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll x eium 512 TO OK v Cancely Key Characterization Shift Print No Keysym Print Print Ctrl Print Print Figure A 3 IBM RS 6000 Print Key Characterization A 8 Mapping IBM Key Caps After training the keyboard you are ready to map IBM key values to keys on your keyboard 1 To map the keys start sunke by typing sunke c caps file I keyboard file 2 Pick up IBM key values from the unmapped IBM key value list and place them on keys in your keyboard layout 3 Toggle the Mode button initially labeled Move KeyCaps to the mapping mode Move KeyCaps 4 Move the X cursor over an IBM key value and press the left mouse button Move the picked up IBM key value over a key on the keyboard layout
35. and the instance name match Using an instance name makes it easy to specify different sun3270x program activities A resource specified with an instance name overrides any bindings using the asterisk paradigm sun3270x command line arguments override any settings established by SUNWopc1 resource bindings The following SUNWopcl resources exist Logical Unit LU attachment Keyboard map file path name EHLLAPI session name IBM color scheme Window color scheme Window attributes Font pools Generic X keywords Miscellaneous functions Most of the SUNWopc1 resources are described in Section 3 1 Starting sun3270x All sun3270x resources have parallel keyword definitions except for the font pools discussed below To list the fonts that sun3270x uses to display textual data in the 3270 emulation screen type fontPoolNormal font namel font name2 font nameN Note sun3270x chooses the font used for display on a best fit basis It selects the font whose width and height cover the most area within the sun3270x display window The fonts must be fixed width character cells If your application uses non North American English characters make sure that the fonts you choose contain all the ISO 8859 1 defined characters Similarly you need to verify the ASCII EBCDIC translations map appropriately SunLink Client 3270 9 1 Configuration and User s Guide August 1997 E You can list the fonts that sun3270x us
36. chapter provides troubleshooting procedures for SUNWopc1 Sun provides several tools with SUNWopcl to assist in troubleshooting Note Troubleshooting information for the SunLink 9 1 PU2 1 SNA Server and its SNA connections is documented in the SunLink 9 1 SNA PU2 1 Server Configuration and Administration Manual Use these utilities for troubleshooting problems Sun s Basic Message Database BMD This utility documents all errors describes the cause effect and recovery action Access the messages via the online database The Online database utility and SUNWopcl messages are documented in Appendix E Error Messages SunLink 9 1 PU2 1 Operator sunop This utility displays status and statistical information for SunLink 9 1 PU2 1 SNA server resources See the SunLink 9 1 SNA PU2 1 Server Configuration and Administration Manual for details on using sunop Logical data scope sunscope This utility is a data link level scope program that shows all transmitted and received frames on SNA data link connections See the SunLink 9 1 SNA PU2 1 Server Configuration and Administration Manual for a guide to using sunscope 10 1 10 10 1 Online Help Tracing SUNWopcl has extensive internal tracing facilities Appendix D SunLink 3270 Tracing lists a sample of the trace points captured by SUNWopcl The SunLink PU2 1 SNA server also has extensive tracing capabilities All error messages and display information are stored
37. display is rejected If the display device is not owned as indicated on the status line you can use the System Request function to control which session owns the device You can also use the System Request function key to transfer display ownership between sessions This transfer interrupts communications that take place for the session without waiting for completion of outbound transmissions transmissions from the host The inbound transmissions transmissions to the host normally are completed before this type of transfer takes place SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll Print Print enables you to capture information on a sun3270x screen in a file Press the Print key to start the copy You can change the actions of the Print key by updating the appropriate Settings under the main menu bar s Options button Selector Light Pen Selector Light Pen operation enables the mouse to function as a light pen Cursor Select Cursor Select enables the Selector Light Pen function to be performed from the keyboard The Cursor Select Key may be used on any field defined as a Selector Light Pen detectable field Cut Copy and Paste SUNWopc1 supports the Cut Copy and Paste functions Due to the formatted nature of 3270 display stations SUNWopc1 supports multiple modes for these functions To change the Cut Copy and Paste mode press the right mouse button while in the 3270 emulation screen
38. ev eus 3 4 3 1 5 EHELAPI Session Name 0 0 eese pee ebd 3 5 3 1 6 Color Display Attributes s cese 3 6 3 17 Displaying Window Color Functions 3 7 3 1 8 Main Display Window Attributes 3 9 3 1 9 AX KeyWords D cc usi eine wien ee Ra 3 10 3 1 10 Miscellaneous Functions c ceccer ee xe 3 11 3 1 11 File Transfer Menu Defaults eres 3 15 3 1 12 Light Pen Defaults 54454523300 ne nee ese pua 3 18 3 1 13 Host Graphics Keywords coser 3 19 3 1 14 User Button and Function Keywords 3 21 3 1 15 sun3270x Command Line Configuration Examples 3 22 3 2 sun3270x Window Layout exa a v ne Ja e 3 23 Oe BUS MEAG Orr 3 25 524 Edit Mente coru pine Rd ccce or ut 3 25 3 23 Action Menu s c S Re RARE ER RR ERE 3 27 3 2 4 Settings Men RRRRRRRRRO NOE ed dd 3 27 3 SOP PMNS SUNS 2 TOS soo eek E EREHRRYUAU E E d aedes 3 28 34 Status LINE nS 3 28 3 5 Data Entry Overview sees ioo bobo ese os 3 30 3 5 1 SunLink 3270 Screen Formats aate 3 30 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 5 2 3270 Keyboard Input Summary 3 5 3 Keyboard Functions xeu es ex x HERE Rn nnt 3 6 Data BHEESS oce ee ee LA ee i Rea SOR 3 7 Cursor Control Cis edad C H tortenni g OEE 3 7 1 Moving the Cursor from Character to Character 3 7 2 Moving the Cursor from Field to Field 3 8 Start Stop Data Entry eee v ew EU oe ol o RR OO Editing oi terar Eee eben b bU Ea FORCE TRI ee 3 10
39. exist in the etc services file Normally the installation of SUNWpu21 makes this entry If sun3287 is running on a remote system however this service name must have the same port value on both the local and remote systems 7 2 Starting sun3287 To invoke sun3287 type the following command line sun3287 1 lu name h host name p pu name n port number i d c command line s stream command f path name H horizontal format V vertical format a A translation name P t trace flag v SunLink Client 3270 9 1 Configuration and User s Guide August 1997 N lll The optional keywords on the command line are explained below 1 lu name sun3287 requests that the LU services manager connect to the named LU lu name The LU must be listed in the Sun PU2 1 SNA server configuration and the lut ype parameter for the LU must equal 3 If the lu name option is omitted the first available LU is selected active LUs are chosen first inactive LUs are chosen next only LUs with lutype 3 can be chosen h host name sun3287 requests that the LU services manager connect to the Sun PU2 1 SNA server located on the named host If the h option is omitted the local host is called p pu name sun3287 requests that the SNA server assign it to an LU belonging to the named Physical Unit PU The PU must be configured in the local configuration file If the pu name option is omitted
40. in bytes Default 80 bytes for new files existing logical record length for existing files Using PCFT Cll lll C Table C 6 Send VM CMS Syntax Continued Element Description lrecl n recfm f v Indicates the desired logical record length for the VM CMS file in bytes Default 80 bytes for new files existing logical record length for existing files Indicates the desired record format for the VM CMS file where Specifies fixed length records Specifies variable length records Default Fixed length records for new files without cr1f option specified variable length records for new files with cr1f option specified C 3 2 Send VM CMS Examples To send a text file name text file from the local Unix system to a host VM CMS file name data in readable format type o pcft send textfile data basic al ascii crlf To send a binary file name binfile from the local Unix system to a host VM CMS file name data1 type pcft send binfile datal basic al recfm v C 4 Receive VM CMS The syntax of the pcft command to transfer files from a VM CMS host application to a SUNWopcl session is described in Table C 7 below pcft receive local file lt n gt host_file host_filetype host filemode _ lt options gt Options append ascii crlf SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll Table C 7 Receive VM CMS Syntax
41. n is an integer specifying the number of requests allowed in a pacing window Default 1 Table 8 3 LU Types and Sun Client Programs LU Type Sun Client Program 0 SunLUO API Program 1 Sun3770 SunLUO API Program 2 SUNWopcl SunLUO API Program 3 sun3287 SunLUO API Program Always configured as LU Type 3 sun3287 emulates both LU Type 1 and LU Type 3 based on LU Type specified in received SNA BIND request SunLink PU2 1 SNA Server Configuration 8 3 8 8 8 Example Display Terminal Configuration An SNA 3270 display terminal configuration example is given in Table 8 4 Table 8 4 SNA 3270 Display Configuration Example LU AME LUO01 PU2_NAME PU01 UUTYPE 2 LOCADDR 2 PACING 1 User defined nam ame of PU2 this LU is on LU Type 2 port SUNWopcl port Local address of the LU Pacing window An IBM SNA 3287 printer configuration example is given in Table 8 5 Table 8 5 IBM SNA 3287 Printer Configuration Example LU AME LUO1 PU2_NAME PU01 UUTYPE 3 LOCADDR 2 PACING 1 User defined nam ame of PU2 this LU is on LU Type 3 port Sun3287 port Local address of the LU Pacing window 8 4 Sample SNA Server Configuration This section lists an example SunLink PU2 1 SNA server configuration file that can be used as a basis to configure LUs for SUNWopc1 SNA clients The sample configuration can be used with minimal changes Norma
42. name or RGB weights as per the XParserColor call Color of the text for a lifted IBM key value Default is black capCursorTextColor color capCursorTextColor color Color of the lifted IBM key value Default is red capCursorBackgroundColor color capCursorBackgroundColor color Color of the window background Default is Light blue background color background color A 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll Color of a button when selected Default is gray xtsunButtonSelectedColor color xtsunButtonSelectedColor color Color of a button s text Default is black xtsunButtonTextColor color xtsunButtonTextColor color Color of readout areas Default is red xtsunReadoutTextColor color xtsunReadoutTextColor color Color of the text for a lifted IBM key value Default is black capCursorTextColor color capCursorTextColor color Color of mapped IBM key values characters Default is black characterKeycapsColor color characterKeycapsColor color Color of mapped IBM key values AID keys Default is coral aidKeycapsColor color aidKeycapsColor color Color of mapped IBM key values functions Default is nagenta miscKeycapsColor color miscKeycapsColor color Color of the illuminated side of a key Default is white xtsunBevelLightColor color xtsunBevelLightColor color
43. of the sun3270map file B 1 Your 1ogin file specifies the SUNMAP3270 environment variable To specify the environment variable in the 10gin file type setenv SUNMAP3270 my dir my map file This format allows you to specify a particular keyboard mapping file instead of the default file named sun3270map To use the default mapping file format type the following default format No SUNMAP3270 defined This format uses the default mapping file sun3270map the mapping file is translated each time SUNWopc is started sun3270tty determines which keyboard map record to use by referencing your TERM environment variable If the terminal entry is not found or the mapping file is not found the default mapping is used Note The sun3270tty keyboard map utility can interpret previous versions of the sun3270map file An example sun3270map file is distributed with the SUNWopc1 emulator software It must be located along the search path for example in a directory specified by the PATH environment variable to be used B 1 Keyboard Map File Format B 2 The keyboard map file has three major record types ibmCaps record which defines the IBM key values available for mapping aliases record which gives ASCII keystroke sequences more meaningful names Terminal Map record which maps the IBM key values to ASCII keystroke sequences All records are grouped with and Y
44. online in the Sun Basic Messages Database BMD You can view the message files or display information for specific messages by entering bmsg COMPxxxx where COMP represents the first four characters of the message group identifier and xxxx is the message number For example bmsg B3270002 The information displayed about the message describes the meaning of the message and indicates the action you should take See Appendix E Error Messages for further information about the online help facility and a list of messages 10 2 Operator Status Information 10 2 To determine the status of the SUNWopc1 session and to start sunop 1 Type the sunop command You will see the Sun Controller message 2 Type the dis command SunLink Client 3270 9 1 Configuration and User s Guide August 1997 10 sunop Sun Controller dis 2 dis OP200025 2 Link BLNO1 2 Active OP200020 2 Physical Unit BPUO11 7 Active OP20002a 2 Logical Unit BLUO1101 2 Active Session OP20002a 2 Logical Unit BLUO01102 2 Active Attached OP20002a 2 Logical Unit BLU01103 2 Active In this example the first LU BLU01101 is active and a SUNWopc1 is in session with a host application The second LU BLU01102 is active and a SUNWopcl is attached to the LU but no session with a host application exists In this state SUNWopcl displays the logon banner The third LU BLU01103 is active but
45. owner GR SSCP LU State S1 Event EV SERV IN Sun3270 recognizes banner as FMD data 07 26 96 10 50 31 fsm automation Screen owner GR SSCP LU State S1 Event EV FMD Sun3270 sends positive response to banner 07 26 96 10 50 31 sun accept ru sun std type Sun3270 sees end of chain on message 07 26 96 10 50 31 fsm automation Screen owner GR SSCP LU State S4 Event EV EC Sun3270 receives input from terminal keyboard 07 26 96 10 50 33 read from terminal keyboard 6e n Sun3270 recognizes input as terminal input 07 26 96 10 50 33 fsm automation Screen owner GR SSCP LU State S1 Event EV TERM IN Sun3270 processes this input 07 26 96 10 50 33 fsm automation Screen owner GR SSCP LU State S1 Event EV FIRST KEY SunLink 3270 Tracing D 3 Code Example D 1 sun3270 Trace 3 of 9 07 26 96 10 5 65 07 26 96 10 5 Screen owner 0 34 read from terminal 0 34 fsm automation GR SSCP LU State S2 keyboard Event Sun3270 processes this input Sun3270 recognizes input as terminal input EV TERM IN Sun3270 receives input from terminal keyboard 07 26 96 10 50 34 fsm automation Screen owner GR SSCP LU State S2 Event EV FIRST KEY 07 26 96 10 50 34 read from terminal keyboard 74 is 07 26 96 10
46. sample configuration distributed with SUNWopc1 Once you are successfully connected to a remote application you can extend your configuration to meet your specific requirements This chapter describes the steps necessary for SNA connectivity It focuses on configuring and starting the sunpu2 1 SNA server and starting SUNWopcl Before SUNWopcl can communicate with IBM mainframe applications you must correctly install configure and activate the sunpu2 1 SNA server Sun delivers the sunpu2 1 SNA server with installation scripts and sample configurations to ensure that you can begin communicating with IBM mainframe applications immediately The following steps are required to run SUNWopcl and are covered in more detail in subsequent sections 1 Install the SunLink SNA PU2 1 9 1 server software Coordinate local and target network configurations Update the sunpu2 1 SNA server local configuration Start the sunpu2 1 SNA server sunpu2 1 and check the status Sr dg px og Start sun3270 2 1 Figure 2 1 illustrates one sample configuration that is distributed with SUNWopcl see Chapter 8 SunLink PU2 1 SNA Server Configuration The remaining sections use this sample configuration as an example Several other example configurations are included with the sunpu2 1 SNA server as well SNA server locaddr 2 LU BLNO1 BLUO1101 BLUO1102 locaddr 4 PU2 d locaddr 3
47. text is inserted moving the subsequent text over cpasteInsertMod cpasteInsertMode Toggles the insert key between text insertion and text overwrite G togglelInsertMode SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 1 11 File Transfer Menu Defaults The functions associated with File transfer menu and defaults are described below Find the host application used for file transfer The default TSO ftApplName TSO VMS CICS ftApplName TSO VMS CICS Identify the Unix system file name for file transfer operations to from the TSO host See Chapter 6 Using File Transfer for more information on this parameter ftTsUnixFilename Unix system file name ftTsUnixFilename Unix system file name Identify the host system file name for file transfer operations to from the TSO host See Chapter 6 Using File Transfer for more information on this parameter ftTsHostFilename Unix system file name ftTsHostFilename Unix system file name Identify the host system file name for file transfer operations to from the VMS host See Chapter 6 Using File Transfer for more information on this parameter ftVmHostFilename Host system file name ftVmHostFilename Host system file name Identify the host system file name for file transfer operations to from the CICS host See Chapter 6 Using File Transfer for more information on this parameter ftCicsHo
48. the PU associated with the named or selected LU is used n port number sun3287 requests that the LU Services Manager connect to the LU with the specified port number on the Sun PU2 1 SNA Server only if the lutype parameter for the LU is equal to 3 SunLink 9 1 port numbers begin at 2 and correspond to the LOCADDR of the LU directive in the SunLink 9 1 PU2 1 SNA Server configuration This option can only be specified if the p option is chosen If the n option is omitted and the p option is specified the first available LU on the specified PU is connected active LUs are chosen first Immediate mode of operation If the requested LU is not available sun3287 terminates Becomes a daemon process during initialization Detach from the controlling terminal and close stdin stdout and stderr Using sun3287 ra c command line Execute command line after receiving each print stream The name of the file in which the current print stream is stored can be represented in the command line as This symbol is expanded to the current path name of the print stream file and then the command line is executed The command line is executed under the Bourne shell sh This option cannot be used with the s option s stream command Execute the stream command as each print stream is received With the option no print stream file is used for storage Instead the print stream data is piped directly to the stream command as sta
49. the full content of the message Configurable message formats are used Users are free to modify the message content as they wish Consistent message handling for all SunLink IBM connectivity products The use of bmsg is described in the following section which also describes the structure of the BMD and the format of the message entries E 1 E 1 bmsg Sun Basic Message Display Utility bmsg is invoked as follows bmsg message number message number v where message number specifies the message to display v requests bmsg to print the current version number and exit It overrides all other options If no message number is given bmsg prompts the user and displays the requested message This continues until the user types Q to quit An example bmsg operation follows 9 bmsg Please enter message identifier Q to quit ABCD0001 MESSAGE ABCD0001 s This is an example message string which starts with a string parameter PARAMETERS 1 A string s CAUSE This field normally explains what condition s causes this message to be displayed EFFECT This field normally displays what effect the condition s may have had ACTION This field normally indicates what actions should be taken when this message is displayed Please enter message identifier Q to quit Q oe E 2 BMD Sun Basic Message Database BMD is a Unix directory The B
50. the window SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Customizing sun3270x 4 The sun3270x display can be customized in a number of ways This chapter discusses the sun3270x resources changing sun3270x text information and modifying the ASCII EBCDIC translations If you want to customize your sun3270x keyboard mapping display see Appendix A Customizing the sun3270x Keyboard 4 1 sun3270x Resources sun3270x has many attributes that you can change In X window environments configurable attributes are called resources The sun3270x program has many attributes that you can change The sun3270x resources belong to the SUNWopc1 class When the sun3270x program starts it searches for SUNWopcl resources in order of highest precedence SUNWopcl SXENVIRONMENT if it doesn t exist then SHOME Xdefaults hostname Resource Manager property xrdb if it does not exist then SHOME Xdefaults e SHOME SUNWopcl SXAPPLRESDIR SUNWopcl usr lib X11 app defaults SUNWopcl 4 1 4 2 If a SUNWopcl resource is found sun3270x initializes the defined resource with its specified value In the SUNWopc1 resources file a asterisk preceding a resource indicates that all sun3270x programs should use this resource definition for example hostname bruno Alternatively an instance name can be used to set a resource value only when the argument name to the sun3270x program
51. this chapter to help coordinate the updates to the local configuration and SNA host network configuration The sample configuration first described in Chapter 2 Getting Started with SUNWopcl describes how to install SUNWopcl This chapter does not discuss all the requirements for extending the SNA host network configuration Instead it explains the additions needed to correctly configure SUNWopcl in an SNA network See the SunLink 9 1 SNA PU2 1 Server Configuration and Administration Manual for more information on configuring the local line and Physical Unit resources including SDLC Token Ring and QLLC support Refer to the IBM VTAM Installation and Resource Definition for a complete description of SNA host network configuration 9 1 SNA Configuration An SNA network is a hierarchical network where many end point devices communicate with a few host systems To add a new device to the SNA network an SNA host system programmer must update the SNA host network configuration NCP VTAM GEN 9 1 lll Ko The NCP VTAM GEN lists all the SNA resources connected to an SNA communications controller Four macros define the resources associated with a PU2 device emulated by the SunLink 9 1 PU2 1 SNA server The LU macro defines the characteristics of the SUNWopc1 that is attached to the corresponding LU port on the SunLink 9 1 PU2 1 SNA Server see Table 9 1 Table 9 1 NCP VTAM Macros MACRO Description GROUP
52. to the local system the carriage return characters are removed Use this option along with ASCII text for readable files Do not use this option for binary files no crlf Indicates that carriage return linefeed characters CR LF do not act as record separators IBM Host File Attributes lrecl recfm space prim lt sec gt blksize Indicates the desired logical record length for the host data set in bytes Default 80 bytes for new files existing logical record length for existing files Indicates the desired record format for the host data set where f Specifies fixed length records v Specifies variable length records u Specifies undefined length records Default Fixed length records for new files without cr1f option specified variable length records for new files with cr1f option specified Indicates the space allocation requirements for a new host data set where prim is the primary and sec is the secondary allocation of blocks tracks and cylinders where blocks x is the smallest entity tracks is middle sized entity cylinders is largest entity Default default allocation value of blksize Indicates desired blocks size for the host data set in bytes Default 80 bytes for new files existing blocksize for existing files 6 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using sun3287 f sun3287 is a Sun IBM 3287 printer emulator process The sun3287 program
53. will use an internal default map The sun3270tty program attaches to the sunpu2 1 SNA server sunpu2 using the sun_pu2_espd service name This entry must exist in the etc services file Normally the Sun configuration makes this entry if sun3270tty is running on a remote system However this service name must have the same port value on both the local and remote systems If you want sun3270tty to support EHLLAPI programs you must make an entry in the etc services file that identifies the service name for the EHLLAPI session Normally the sun3270tty configuration makes this entry If sun3270tty is running on a remote system or a network name server NIS for example is used you may have to update the etc services file EHLLAPI service names begin with sunehllapi and end with the EHLLAPI session name Therefore the A EHLLAPI session service name is sunehllapiA Since sun3270tty supports EHLLAPI session names A through H up to eight EHLLAPI programs can run on one system To start sun3270tty as an EHLLAPI server use the e keyword or update the sunpu2 1 SNA server configuration See Chapter 8 SunLink PU2 1 SNA Server Configuration To execute a file transfer start sun3270tty as an EHLLAPI server 13 1 1 sun3270tty Status Line If the terminal display is less than 25 lines sun3270tty only displays the status line Operator Information Area OIA when the Status Line changes Any subsequent screen changes cause th
54. 01103 LU LOCADDR 4 DLOGMOD D4A32782 9 2 LOGMODE Tables The VTAM LOGON Mode LOGMODE table requires entries to describe the operating characteristics of logical units LUs The association between the LU and its LOGMODE entry is created in the LU Macro of the VTAM NCP GEN or in the definition of a superior resource GROUP LINE or PU A LOGMODE entry defines session and presentation values that are included in the session activation request BIND sent by the SNA host application to SUNWopcl or sun3287 The LOGMODE entry values specify the expected screen size display formatting characteristics maximum message sizes and session protocol definitions SUNWopcl emulates IBM 3278 Model 1 5 display terminals IBM 3279 Models 2A 2B 3A 3B display terminals and IBM 3287 printers LU Type 3 The LOGMODE entry IBM distributes for these type of display terminals e g D4A32782 can be used as a SUNWopcl LOGMODE entry Note To execute file transfers with SUNWopcl the first two bytes of the PSERVIC parameter must be PSERVIC X 0280 The 02 defines the LU as an LU Type 2 device the 80 indicates queries are supported SNA Configuration for SUN Wopcl 5 lll Ko Code Example 9 2 contains an example LOGMODE entry Code Example 9 2 Example LOGMODE Entry LOG32782 MODEENT LOGMODE LOG32782 FMPROF X 03 SPROF X 03 PRIPROT X BI1 ECPROT X 90 OMPROT X 3080 USI
55. 1 00 or greater pcft starts the Sun IBM 3270 PC file transfer INDSFILE process Note Pacific Rim users SUNWopc1 also supports the transfer of DBCS text files If dbcsMode is turned on the default for the File Transfer process is APVUFILE rather than INDSFILE Two options indicate the direction of the transfer send initiates a transfer from the local system to the IBM host system receive initiates a transfer from the IBM host system to the local system Before you initiate a file transfer you must be logged into one of the above mentioned IBM host applications and positioned at the main prompt for that IBM host application In TSO for example you should have the READY prompt displayed in your SUNWopcl window C 2 To execute a file transfer 1 2 7 Establish a communications link with the IBM host system Start SUNWopc1 as an EHLLAPI server use the e session name to identify the EHLLAPI session name Log into the IBM host application TSO CICS or VM CMS Ensure that the main prompt for the IBM host application is displayed Move to a Unix shell window For sun3270tt y use the Escape to shell key sequence to invoke a shell on your TTY display After executing the pcft command you can return to your 3270 emulation window by exiting from the shell Issue the pc t send or receive command pcft can also be used for exchanging several files with the IBM host
56. 1 Configuration and User s Guide August 1997 I IBM key moving 5 6 IBM key caps file sample A 13 ibmCaps record B 3 insert mode 3 38 installation scripts provided 2 1 installing SUNWopcl 2 2 K keyboard functions 3 31 keyboard geometry file A 19 sample A 20 keyboard input 3270 3 30 keyboard layout 5 6 definition files A 3 Keyboard map accessing 4 5 keyboard map displaying 5 1 layout 5 2 updating 5 6 keyboard map utility B 1 keyboard mapper file 5 4 menu bar 5 4 next 5 4 other info 5 4 quit 5 4 title information 5 4 keyboard mapping 1 7 keyclick 1 7 Keywords suntn3287 7 7 keywords 3 3 A 3 ehllapi name 13 4 host name 13 4 key map pathname 13 4 LU attachment 3 3 lu name 13 4 port number 13 4 pu name 13 5 trace flag 13 5 Keywords sun3270x DBCS F 1 host graphics 3 19 Keywords suntn3270x host graphics 11 4 miscellaneous 11 3 L light pen 3 18 logical data scope tracing 10 3 LOGMODE tables 9 5 LU directive 8 2 M main display window attributes 3 9 map attributes keyboard 3 4 mapping ASCII characters 1 5 mapping IBM key caps A 31 message files E 3 message library updates 4 8 mode button 5 5 Motif 11 1 Mouse dialog box 4 6 N NCP VTAM GEN 9 2 new keyboard layout creating A 9 new line key 3 36 Index 3 Index 4 O on line help 10 2 operator status information 10 2 Options sun32
57. 11 app defaults sunke If a sunke resource is found sunke initializes the defined resource with its specified value In the sunke resources file a asterisk preceding a resource indicates that all sunke programs should use that resource definition such as background green Alternatively an instance name can be used to set a resource value only when the name argument to the sunke program and the instance name match Using an instance name makes it easy to customize the sunke program A resource specified with an instance name overrides any bindings using the asterisk paradigm sunke command line arguments override any settings established by sunke resource bindings Several sunke resources exist and fall into these categories New keyboard files Keyboard map file path name Window color scheme Window attributes Generic X keywords The sunke resources are described in Section A 1 Starting sunke All the sunke resources have parallel keyword definitions A 4 Creating a New Keyboard Layout You will need to create a new keyboard layout if your keyboard is not a sun4 or sun5 type keyboard for North American English The procedure for creating a new keyboard is straightforward Use the example keyboard layout files NAEnglishCaps and sun4Geom as your starting point Most keyboards are similar to the layout described by the sun4Geon file Similarly most IBM key values are included in the NAEnglishCaps file C
58. 2 2 Send CICS Examples To send a text file name text file from the local Unix system to a host CICS data set data set name data in readable format type pcft send textfile data ascii crlf To send a binary file name binfile from the local Unix system to a host CICS data set data set name data1 type 9 pcft send binfile datal binary nocrlf C 2 3 Receive CICS The syntax of the pcft command to transfer files from a CICS host application to a SUNWopc1 session is described in Table C 5 pcft receive local file lt n gt host_file lt options gt lt comments gt Options ascii crlf Table C 5 Receive CICS Syntax Element Description receive Receive file from IBM host application Required positional parameter local_file Pathname of file on local system Required positional parameter n nis LU session to use for transfer EHLLAPI session name A H Optional positional parameter Default is A host_file CICS data set name on IBM host The data set name can be up to 8 characters Refer to the IBM Customer Information Control System CICS OS VS Version 1 Release 6 Installation and Operations Guide manual for more information about CICS data set names and properties Required positional parameter options The character is mandatory when you specify options CICS supports the following receive options ascii Indicates to CICS that the dataset should be converted from
59. 40404040404040 EE DEEEEEE G WW 40e6e64040e3d411 c85ce6e640404040 e640404040e6e611 WW TM H WW W WW c96de6e64040e6e6 e64040e6e6114a7 6e6e6e640e6e6e6 I WW WWW WW WWW e6114c4fe6e64040 40e6e6114f4e4dc3 5d40c39697a89989 W WW WW C Copyright IBM 8788a340c9c2d411 4f 60c39699974p40 f1f9f 8 7406040c1 Corp 1987 All lRights Reserved 9393114ff1d98987 88a3a240d985a285 99a585841150e5d3 amp VLicensed Material amp 8 89838595a2858440 d481a38599898193 1150 f 86040d79996 Property of IBM A 978599a3a8409686 40c9c2d411c14d40 4040 07 26 96 10 50 57 fsm automation Screen owner GR LU LU State S2 Event EV SERV IN Sun3270 recognizes Begin Bracket BB indication in this first message 07 26 96 10 50 57 fsm automation Screen owner GR LU LU State S2 Event EV BB 4 Sun3270 sends a positive SNA response for the first message 07 26 96 10 50 57 sun accept ru sun std type Sun3270 recognizes End Bracket EB indication in this first message 07 26 96 10 50 57 fsm automation Screen owner GR LU LU State S4 Event EV EB Sun3270 receives notification from sunpu2 1 SNA Server that LU LU session is between brackets 07 26 96 10 50 58 notification sun std type 0000000700000000 0000000701000001 0000000000000000 0000000000000000 Some trace points not shown Sun3270 receives an UNBIND 0x32 request from the application Again message with two trace points control and d
60. 6 1 keywords F 1 defaults light pen 3 18 defining IBM key caps file A 10 delete function 3 39 dependencies for file transfer 6 1 starting sun3287x 7 2 sunke A 2 Display dialog box 4 5 display interfaces 1 1 display terminals IBM 3278 1 4 display window color functions 3 7 double cursor movement 1 7 DSC printers emulation 7 1 duplicating IBM key 5 8 dynamic update SUNWopcl resource 4 4 E EBCDIC characters 1 5 Edit menu 3 25 editing functions 3 38 EHLLAPI server starting 6 2 EHLLAPI session name 3 5 emulation IBM 3278 3 1 emulation screen for 3270 status line 3 28 Enter key function 3 37 error message handling scheme E 1 error messages E 1 Escape key sequence 13 1 exiting keyboard map display 5 9 F field control 3 39 clear field 3 39 delete left 3 39 DUP 3 39 erase input 3 39 erase to end of field 3 40 file format keyboard map B 2 File menu 3 25 File transfer accessing 3 27 file transfer 6 1 menu defaults 3 15 starting 6 2 file transfer options 6 4 file transfer status 6 4 function keys PF1 to PF24 3 37 user defined 3 44 functions miscellaneous 3 11 G GDDM commands 12 1 graphical interfaces support 3 1 Graphics host sun3270x 3 19 suntn3270x 11 4 H help on line 10 2 Help key sequence 13 1 home key 3 36 horizontal_format 7 4 Host graphics keywords sun3270x 3 19 suntn3270x 11 4 host_name 7 3 SunLink Client 3270 9
61. 70x menu 3 25 3 27 organization manual xvi P path name 7 4 PC file transfer C 1 pcft utility C 1 port number 7 3 preface xv printer IBM 3287 1 4 program access keys 3 37 pu name 7 3 R READY prompt C 1 receive CICS C 9 receive CICS example C 10 receive TSO C 6 C 7 receive VM CMS C 12 examples C 13 recovery steps 10 4 removing IBM key 5 9 reset key 3 38 running sun3270x 3 1 running SUNWopcl 2 1 S sample configurations 2 1 saving keyboard map updates 5 9 Screen Color Mode updating 4 6 Screen Dump 4 7 screen format 1 5 screen formats 3270 3 30 SCS control codes 7 1 SCS emulation 7 1 send CICS C 8 examples C 9 send VM CMS C 11 examples C 12 send TSO C 3 send TSO examples C 5 send TSO syntax C 4 server configuration SunLink PU2 1 SNA 8 1 Settings menu 3 27 Settings brx3270 display 4 6 shell prompts xx shift key 3 34 single key layout 5 5 SNA BIND request 7 1 SNA configuration 9 1 SNA resources 1 3 special functions 3 40 copy 3 43 cursor select 3 41 cut 3 43 cut copy and paste 3 41 paste 3 43 print 3 41 selector light pen 3 41 system request 3 40 start stop data entry 3 36 starting sun3287 7 2 starting sunpu2 1 2 4 starting SUNWopcl 2 5 startingsun3270x 3 2 Status line sun3270x 3 28 status line components 3 29 Stopping sun3270x 3 28 stopping sunpu2 1 2 6 SunLink Client 3270 9 1 Configuration and User s Guide Aug
62. 8 color device SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 1 14 User Button and Function Keywords You can use the following defaults for the User buttons and User functions within the Options menu Specify the default title string for user button 1 See Section 3 11 Special Functions for more information on this parameter userButtonilTitle User Button Title string userButtonlTitle User Button Title string Specifies the default command string for user button 1 See Section 3 11 Special Functions for more information on this parameter userButtonlCommand User Button Command string userButtonlCommand User Button Command string Specify the default title string for user button 2 See Section 3 11 Special Functions for more information on this parameter userButton2Title User Button Title string userButton2Title User Button Title string Specify the default command string for user button 2 See Section 3 11 Special Functions for more information on this parameter userButton2Command User Button Command string userButton2Command User Button Command string Specify the default title string for user button 3 See Section 3 11 Special Functions for more information on this parameter userButton3Title User Button Title string userButton3Title User Button Title string Specify the default command string for user button 3 See Section 3 11
63. 9 02 725 88 50 Luxembourg 32 2 720 09 09 32 2 725 88 50 Germany 01 30 81 61 91 01 30 81 61 92 The Netherlands 06 022 34 45 06 022 34 46 Sweden 020 79 57 26 020 79 57 27 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Table P 2 SunExpress Contact Information Continued Switzerland 0800 55 19 26 0800 55 19 27 Holland 06 022 34 45 06 022 34 46 Japan 0120 33 9096 0120 33 9097 Sun Welcomes Your Comments Please use the Reader Comment Card that accompanies this document We are interested in improving our documentation and welcome your comments and suggestions If a card is not available you can email or fax your comments to us Please include the part number of your document in the subject line of your email or fax message Email smcc docs sun com Fax SMCC Document Feedback 1 415 786 6443 Preface xxi xxii SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Introduction to SUNWopcl A Ii The SUNWopcl software emulates IBM SNA 3270 display terminals on Sun computers enabling users to interactively access IBM mainframe applications such as CICS IMS TSO and NetView from a workstation using a graphical user interface or from a serial attached TTY terminal The SUNWopcl product supports two display interfaces OpenWindows for sun3270x on systems supporting the Sun OpenWindows interface TTY type terminals for sun3270tty on terminals like VT100s VT200s
64. August 1997 Using CG3270 ZS CG3270 adds the capability to support GDDM commands from the IBM host system This enables the client 3270 product to emulate the IBM 3179G terminal in addition to the terminals already emulated GDDM is only supported in the X versions of the 3270 and TN3270 emulators sun3270x and suntn3270x It is not supported by the TTY versions sun3270tty and suntn3270tty CG3270 support is added by Obtaining and installing the GDDM FlexLM licenses Adding the following command line option s to the script that activates the SunLink Client 3270 binary These are descriptions of the switches and resources added to the 3270 emulator for supporting GDDM functions You have the option to enable or not to enable the GDDM support during this run of the emulator If GDDM support is enabled Query replies to the host to indicate that GDDM and the GDDM datastream is fully supported If GDDM support is not enabled Query replies to the host indicate NO GDDM support and any GDDM datastream data is ignored gdam gddmMode on off Default off 12 1 Ey E This flag is similar to gddm gddmMode except that it causes the emulator to allocate a separate set of three planes in pixel memory for the graphic layer On some hardware platforms this yields faster screen updates and refreshes in both the text layer and the graphics layer It yields smoother realtime updates of the graphics layer as GDDM datast
65. CTRL D rag CTRL L CTRL N n CTRL U tay CTRL X x CTRL Z Ug t CTRL P1 pl CTRL P2 p2 CTRL P3 p3 NUM 1 E0q NUM 2 EOr NUM 3 EOs NUM 4 EOt NUM 5 EOu NUM 6 EOv NUM 7 NEOw NUM 8 NEOx NUM 9 EOy NUM 0 EOp vt100 and vt200 IBM Key lt ASCII key sequence Enter Enter Return Clear ESC c SysReq ESC s PA 1 CTRL P1 PA 2 CTRL P2 PA 3 CTRL P3 Left Left BackSp Right Right Up Up Down Down Home ESC h Reset ESC r Tab Tab Btab CTRL B Insert ESC i Delet CTRL D Newline CTRL N ErsInpt CTRL U ErsEof ESC e Attn CTRL Z Dup ESC d FldMark ESC f PF1 ESC 1 PF2 ESC 2 PF3 ESC 3 PF4 ESC 4 PF5 ESC 5 PF6 ESC 6 PF7 ESC 7 PF8 ESC 8 PF9 ESC 9 PF10 ESC 0 PF11 ESC PF12 ESC PF13 ESC PF14 ESC G PF15 ESC PF16 ESC PF17 ESC PF18 ESC PF19 ESC amp PF20 ESC PF21 ESC PF22 ESC PF23 ESC _ PF24 ESC Escape CTRL X ClrFld ESC SP Erase Delete Help ESC Status ESC o Reshow CTRL L DmpScrn ESC p cent ESC m not ESC n brk ESC v 0 0 NUMO 1 1 NUM 1 2 2 NUM_2 3 3 NUM 3 4 4 NUM_4 5 5 NUM 5 6 6 NUM_6 7 7 NUM 7 8 8 NUM_8 9 9 NUM 9 B 12 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example B 1 Sample sun3270map File 7 of 8
66. Clear field and move cursor to beginning of field t Delete Left deleteleft Delete character to left of cursor DUP dup Duplicate operation for field Erase Field eeof Erase to end of the current field Erase Input ein Erase all unprotected fields Field Mark fm Mark the end of a field or a subfield Customizing the sun3270x Keyboard A 11 o Em Table A 1 Keyboard Functions Continued Function Mnemonic Description Special function Systems Request sysreq Switch to another session such as LU LU to SSCP LU Cursor Select cursel Select field at cursor position Print dumpscreen Copy screen to file or program t Cut cut Cut selected portion of the screen t Copy copy Copy selected portion of the screen t Paste paste Paste selection to the cursor position t User defined function usr N Invoke user defined function N 1 2 3 4 5 Sun special keys A T2 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll A 5 Sample IBM Key Caps File Code Example A 1 Example Keycaps File 1 of 6 NAEnglishCaps oe oe oe G oe This file contains example IBM key definitions KeyCaps for the sun3270x emulation program This example file was used to construct the default keyboard map file sunkeMap The Sun keyboard mapper program sunke uses the NAEnglishCaps file to initially display the IBM key definitions the sun4Geom file defines the geometry of a sun4 keyboar
67. Client 3270 9 1 Configuration and User s Guide August 1997 Code Example 4 2 Example ASCII EBCDIC Translation Table Continued 00 00 AA 00 65 7C 45 6A Q w O 0 O0 O0 OG O O Ph O POO 0 0 00 00 00 00 00 00 00 00 00 00 ED 00 CD C ot 0 ti oOoooctuoocooco i eG 6 emo o o oo GOG 0 OOOO Qo OO od cd 00 00 00 00 00 00 00 00 00 00 00 B3 00 00 48 00 OUo 10000 O b O b OOOO C ncc lo oc oo Om ornmoocooco 00 00 9A 7B 00 F 0 D Ao 00 00 00 00 00 00 00 00 00 00 5F 00 00 FC 00 DC CO Ur Gc occ o D 0 O U O G GOG O 00 00 00 00 00 00 00 00 00 00 00 AB TT 00 57 00 th 00 00 Y wa 0 8f 0 9f 0 af O bf 0 cf 0 df O ef 0 ff Customizing sun3270x 4 11 4 12 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using Keyboard Mapper 5 Sun provides a graphical keyboard map utility with sun3270x to help you quickly determine how the corresponding IBM key values are associated with Sun keyboard functions This graphical utility displays a layout of your keyboard with keys labeled with their corresponding IBM key values It also allows you to dynamically update the current keyboard map while you are using the keyboard IBM key values are simply picked up from one key and placed on another Consequently the keyboard map uti
68. EBCDIC to ASCII when transferred to the local file Use this option along with cr1f for readable files Do not use this option for binary files Default CICS translates the file from EBCDIC to ASCII Using PCFT C 9 lll C Table C 5 Receive CICS Syntax Continued Element Description binary GELE no crlf comments Indicates that CICS should not attempt to convert the data set from EBCDIC to ASCII Default CICS translates the data set from EBCDIC to ASCII Pacific Rim Users If docsMode is set pcft translates the data set from DBCS to EUC Indicates that carriage return line feed characters CR LF act as record separators in the data transferred from the CICS application to the local file CICS adds the CR LF characters where its own internal end of record markers indicated end of records With this option pcft replaces the CR LF characters with a LF character before writing each text line to the local file Use this option along with ASCII for readable files Do not use this option for binary files Default CICS inserts CR LF characters to indicate end of record Indicates that carriage return line feed characters CR LF do not act as record separators Default CICS inserts end of record markers for CR LF characters Lets you add information regarding the file transfer The character is mandatory when you do not specify options indicate their absence by entering before your comments
69. ICS Transfer Direction Send Initiates a transfer from the local system to the IBM host system Receive Initiates a transfer from the IBM host system to the local system UNIX Pathname UNIX File Path name of file on the local system required parameter 6 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Table 6 1 File Transfer Options Continued Option IBM Host Filename Host File TSO Data set Names dataset name member name password CICS Data Set Names dataset name VM CMS File Names file name file type file mode Transfer Property create append Transfer Mode ascii Function File name on the IBM host required parameter A valid data set name contains 44 or fewer alphanumeric characters in the form user dataset name member Refer to the IBM OS VS2 Command Language Reference manual for more information about TSO data set names and properties Name of member in the TSO data set specified by lost file Optional positional parameter Follows tost file immediately no space separators Password used for TSO data set under password protection Optional positional parameter Follows tost file member name immediately no space separators TSO automatically prefixes the TSO data set name and member name with your TSO user ID Use single quotation marks to avoid having the User ID prefixed to the TSO data set name and member name you specify The CICS data se
70. INER PU LU Specifies certain common characteristics and functions for a group of links and devices Represents the physical line connecting to the PU2 device Represents the Physical Unit the PU2 device Represents a Logical Unit attached to the PU2 device An LU provides a port for SNA applications to gain access to an SNA network SUNWopcl is an SNA application sun3287 is an SNA application The LU type is determined by parameters that are transferred on the SNA BIND message which are received when the session is established LOGMODI BI definitions for SUNWopc1 and sun3287 are included later in this chapter The sample configuration shown in Figure 9 1 connects to the SNA network with one point to point link one Physical Unit Type 2 PU2 and three SUNWopcl client SNA programs LUs IBM host 37x5 Point to point SUNW 1 opc NAD line clients ADDR C1 Sun d 2 LU locaddr 2 ai 91101 BLNO1 po PU2 locaddr 3 LU BLUO1102 BPU011 locaddr 4 Sun Workstation Pee Modem DSU Figure 9 1 Sample SNA Configuration O22 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 9 The SunLink 9 1 PU2 1 SNA server emulates a 3274 Model C Series Cluster Controller BPUO11 Three SNA 3270 emulators BLU01101 BLU01102 and BLU01103 are also present on the
71. LU To SNA F BPUO 11 ADDR C1 Sun Workstation qos 3278 emulation from PC Figure 2 1 Sample Configuration 2 1 Installing SUNWopcl 2 2 Refer to the SunLink SNA 9 1 End Node Planning and Installation Manual for a complete description of the installation procedure A summary of the installation process is as follows 1 Install communications hardware and software as necessary 2 Remove and copy the SunLink sunpu2 1 and SUNWopc1 product files from the distribution media 3 Install the SunLink software You can also run SUNWopc1 on other systems in your network using the system running the sunpu2 1 SNA server as a gateway to the SNA network To install a remote SUNWopc1 move the SUNWopc1 files to the remote system The SunLink SNA 9 1 End Node Planning and Installation Manual discusses the SunLink Client 3270 9 1 Configuration and User s Guide August 1997 2 distribution of SUNWopcl programs in your network When you start a remote SUNWopcl you must specify the name of the system running the sunpu2 1 SNA server use the h hostname option 2 2 Coordinating Configurations The SNA resources described in the local sunpu2 1 SNA server configuration must mirror the values in the SNA host network configuration For specific details about coordinating configurations refer to the SunLink SNA PU2 1 9 1 Server Configuration and Administration Manual Consult your SNA host system program
72. MD directory contains several message files each representing one product component Each product component owns a range of message numbers and stores message information in its own message file The file is uniquely named xxxx msglib where xxxx is the product component identifier Bez SunLink Client 3270 9 1 Configuration and User s Guide August 1997 B E 3 Message Files The BMD directory may be located anywhere on the user s search path as specified by the environment variable PATH If you want to modify a message file copy it out of the BMD directory into the current working directory If SPATH includes the current directory the message file in the current working directory will be accessed rather than the version in the BMD directory A message library is a text file containing multiple message entries Each message has up to seven defining fields Message number Message string Message string parameters Message display options Cause Effect Action Message fields are delimited by blank lines Messages are separated by a full line of hyphens An example fictitious message entry follows MESSAGE ABCD0002 Line s has reached the retry limit d PARAMETERS 1 LINE name s 2 Retry limit CAUSE The specified LINE has attempted to retransmit a message retry limit times EFFECT INE moves into disconnected state ACTION 1 Check the configured MAXDATA size for the line If y
73. NWopc1 Resource File Continued Note many of th i by command line options fil can b overridden resources specified in th hostName bruno Dl luName BLUO1101 Dl ehllapiName A D2 luName BLU01102 D2 ehllapiName B D3 luName BLU01103 D3 ehllapiName C kbdMapFilename geometry 700x500 ibmBlue hot pink ibmRed orange ibmGreen Sky blue ibmWhite turquoise resourc usr local Sun SUNWopcl sunkeMap 4 3 Settings Dynamic SUNWopc1 Resource Updates You can dynamically change these sun3270x resources Keyboard map Uppercase only User keys Full IBM 16 color support Base color support Monochrome switches Dump screen output mechanism Use Settings under the Options button on the sun3270x Main menu SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Hx lll Figure 4 1 shows the available settings Figure 4 1 Options and Settings 1 Keyboard Displays a layout of your keyboard with the IBM key values located on the keys of your keyboard You can change your mapping simply by dragging an IBM key value to another key on your keyboard layout Chapter 5 Using Keyboard Mapper describes the keyboard mapper 2 Display Displays the Display dialog box in which you can customize the appearance of your screen display The options are described below Display Color The following options are available Customizin
74. ORdS i seks arr n eere da 11 2 11 2 1 Miscellaneous Keywords e 11 3 11 22 Host Graphics Keywords 22 cese n 11 4 11 3 Stopping sums 0z 4o tena bak x ex eye Xaadasax ee 11 6 T4 s ntn32Z70 Status LADO s o dk tno ee enu cn 11 6 115 muntu2270 Examples is susp Exec ER 11 7 Using C632 TU uua au kk R RAE Nac EE abi aboe a e do ca OR enh OR 12 1 12 1 Additional information 22222 rr rr t 12 3 Using suns 27 OCC eai E kr VER cacao CR MAC 13 1 13 1 sun3270tty Dependencies v vcre eor e e e En 13 2 13 1 1 sun3270ttyStatus Line 2 13 2 13 1 2 Intensified SUppOPE is scope obok lo RR EO 13 3 Contents vii 13 1 3 sun3270tty Bevwolds oees is ex o ex kxrutr n 13 3 13 1 4 sun3270tty Examples 25 2 rem mnn 13 6 A Customizing the sun3270x Keyboard LLL A 1 A l Starting SunSeros sche EIE E eneee eos A 1 AJ TMeSsziseee ke E EERERRRERLA RP DEN Rud A 2 A 1 2 Dependencies a cvrrerieti vender Ey CORE abad A 2 A KeyWords sisie eene pp UY vu E IET EUR OC Bt A 3 A 2 1 Keyboard Layout Definition Files A 3 A2 Window Attributes cc nn cciadaa rane se sand RR A 4 A 2 3 Window Golpe peer RE cane ee tee eee A 6 A244 Generic ATOUIMCIMNS yank sever Cece eee e viva A 8 Aud CUSTODIE BURKS c ESO o bre d e bee Ae bao A 8 A 4 Creating a New Keyboard Layout A 9 A 4 1 Defining an IBM Key Caps File A 10 Ab Sample IBM Key Caps File 5 2 4ceee ar vers vous A 13 A 6 Defining a Keyb
75. Receive VM CMS Examples C 13 D SunLink 3270 Traine ic sc hveeecaee eee siseedae eee acdas D 1 E Error Messages occas 250440240 Rr ER een b a dace eens E 1 E 1 bmsg Sun Basic Message Display Utility E 2 E 2 BMD Sun Basic Message Database E 2 Ha Message Bes aieo e rotor ede pci est ark ARR eee nee E 3 Contents ix SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Figures Figure 1 1 Figure 1 2 Figure 1 3 Figure 2 1 Figure 3 1 Figure 3 2 Figure 3 3 Figure 4 1 Figure 5 1 Figure 5 2 Figure 5 3 Figure 5 4 Figure 5 5 Figure 5 6 Figure 6 1 Figure 6 2 SUNWopcl and the sunpu2 1 SNA Server 1 2 SUNWopcl and SNA 660 errain irere be ewe re Rd es 1 3 SUNWOPE I Screen eb vex Lr te rt aee Ms 1 6 Sample Configuration sss 6 2 2 Thesun3270x Window 0 0 66 cece aia eee 3 24 Sample Status Line 1 eee een 3 28 Light Pen Cut Copy Paste Menu 006 3 41 Options and Settings llle 4 5 Options Keyboard Mapper 0 c cece eee e eee 5 1 sun3270x Keyboard Map Layout 006 5 3 Single Key Format esseri enina e E o 5 6 Previously Unmapped IBM Key Value F20 Being Mapped vise cnet a eieiei enda ied det galee ido E 5 7 IBM Key Value Btab Being Re mapped 5 8 File Menit eeepc p ata ater e Aa i ds 5 9 Action to File Transfer lsssse
76. SLIM 11 KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK LU OPERANDS MOVED UP TO GROUP MACRO KKEKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK Mk kk kx x xx MODETAB ISTINCLM SSCPFM USSSCS USSTAB HIS3270 PACING 1 VPACING 1 KK KKK KKK KK KKK KKK KEK KKK KKK KEK KKK KK KKK KKK KK KKK KKK KK ck ck ck KEK KKK KKK ck ck ko ko k Mk Sk ko kx A LINE MACRO KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK BLNO1 LINE ADDRESS 01 FULL SPEED 9600 NRZI NO SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Ko lll Code Example 9 1 Partial VTAM NCP GEN Example 2 of 2 DUPLEX FULL KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK PU MACRO kk ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck Ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck ck kk kk ck kk kk kckckck o kockockckockckckckckck BPUO11 PU ADDR C1 PUTYPE 2 kk ck Ck Sk ck Ck ck Ck Ck Ce kk Ck Sk ck Ck Sk ck Ck ck KK KKK KKK KKK KKK ck kk ck ck ck Ck ck ck kk ck kk KKK ck kk KKK KKK KKK KKK LU MACROS KKK KKK ck ck ck ck ck ck ck KKK KKK KKK ck kk ck ck KKK KKK KKK KKK KKK KK KKK KKK KKK ck kk ck kk KKK k kc kc KKK BLUO01101 LU LOCADDR 2 DLOGMOD D4A32782 BLU01102 LU LOCADDR 3 DLOGMOD D4A32782 BLU
77. SUNWopcl is not attached to the LU port 10 3 Logical Data Scope and Tracing SUNWopcl processes can trace all messages that are sent and received Messages are stored as trace points in the sunlib_pid file in tmp To trace start SUNWopcl with the trace option with t 1 where 1 specifies all trace points See Appendix D SunLink 3270 Tracing for an example SUNWopc1 trace run The SunLink 9 1 PU2 1 SNA server also has extensive tracing options Use sunscope to monitor traffic on an SDLC line or an IBM Token Ring network To monitor an SDLC line connected to the synchronous device zbx0 type sunscope e d dev zbx0 SUNWopcl Troubleshooting 10 3 10 10 4 Recovery Steps 10 4 To monitor an IBM Token Ring connection where the adapter device is tr0 type sunscope t e d dev tr See the SunLink 9 1 SNA PU2 1 Server Configuration and Administration Manual for information on using sunscope and interpreting its output Follow the steps listed below to recover from conditions that prevent you from entering data in the SUNWopc1 screen Follow each step until you recover from the problem The placement of the 3270 keys on your Unix keyboard is described in the keyboard mapping file sun3270map 1 Press the Reset key This 3270 key unlocks the keyboard so you can re enter data 2 Press the Attention key This 3270 key resets most SNA host applications returning you to the main ap
78. Sun3270 sends positive SNA response to BIND 07 26 96 10 50 52 sun accept ru sun std type Some trace points not shown Sun3270 receives the first chain of the main NetView logon screen Again two trace points control and data 07 26 96 10 50 57 rcv ru sun std type 0000000400000000 0000000700000000 8180300000010000 0000000000010000 07 26 96 10 50 57 rcv ru ru f54011c5c4d5d540 11c7e4d5d5d5d540 c4d5d54040d5d5d5 d540404040d5d511 c5c5c5c5114a4fc5 e3e3e3e3e311c77a e311c560e5e54040 4040404040e5e511 404040d5d511c6d4 40d5d511c8f4d5d5 d5114bd4d5d54040 e6btfcbcbo5oobob5cob c5114b5fc5c5c5c5 e3e311c94ae3e311 40404040404040e5 c8c2e5e540404040 404040e5e5114ae4 5e540e5e5114bf5 d5d5d5404040d5d5 40d5d540d5d5114a 40d5d5d5114ce4d5 11c76fc5c511c87 c5c511c6e7e3e3e3 4a5ae3e3114b6ae3 e511c6f1e5e54040 40e5e511c9d3e5e5 e5e5e5114dc6e511 NNN NN N NN Z0au C z NN F EEE G E EE EEEEEE FXTITT TTET ETAG PTEs LT E VV VV F1VV VV HBVV VV ILVV VV VV 5VVV FV D 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 J lll Code Example D 1 sun3270 Trace 8 of 9 c67fc9c911c84fc9 c911c95fc9c9114a 6fc9c9114p7fc9c9 EVILI ALL I I YIT 11c7c4c5c5c5c5c5 c511c8d4c5c511c9 e4c5c5c5c5114af4 GDEEEEEE HMEE IUEEEFE c5c5114cc4c5c5c5 c5c5c511c74ce6e6 40
79. SunLink Client 32709 1 Configuration and User s Manual Q Sun The Network Is the Computer Sun Microsystems Computer Company 2550 Garcia Avenue Mountain View CA 94043 USA 415960 1300 fax 415 969 9131 Part No 802 2667 12 Revision A August 1997 Copyright 1997 Sun Microsystems Inc 2550 Garcia Avenue Mountain View California 94043 1100 U S A All rights reserved This product or document is protected by copyright and distributed under licenses restricting its use copying distribution and decompilation No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors if any Third party software including font technology is copyrighted and licensed from Sun suppliers Parts of this product may be derived from Berkeley BSD systems licensed from the University of California UNIX is a registered trademark in the U S and other countries exclusively licensed through X Open Company Ltd RESTRICTED RIGHTS Use duplication or disclosure by the U S Government is subject to restrictions of FAR 52 227 14 g 2 6 87 and FAR 52 227 19 6 87 or DFAR 252 227 7015 b 6 95 and DFAR 227 7202 3 a Sun Sun Microsystems the Sun logo AnswerBook SunDocs SunLink OpenWindows and Solaris are trademarks registered trademarks or service marks of Sun Microsystems Inc in the U S and other countries All SPARC trademarks are used under license and are tradema
80. The Attention function key interrupts the IBM host application This function is invalid if you are using the SSCP LU session Clear If you use the Clear function key while using the SSCP LU session your screen is cleared immediately If you use the Clear key while in LU LU session your screen does not clear immediately the keyboard is locked and only the Reset key will unlock it Anything but the Reset key sounds the alarm When the host computer sends an appropriate code the WAIT state is extinguished and your terminal screen clears Enter Enter sends the currently displayed data to the host computer and locks the keyboard Until the keyboard is unlocked the alarm will sound if you press a data entry key Function Keys PF1 through PF24 Function keys terminate data entry and cause SUNWopcl to transmit the displayed data to the host computer There are twenty four IBM 3270 function keys that are designated PF1 through PF24 An application program defines what happens when you press a function key Each application program can assign a separate function to each function key For example an application program might indicate replacement of one display data entry form with another display data entry form whenever you press the PF5 function key Or if you press the PF2 function key the application program could be notified that all necessary data is entered If you press any of the function keys the keyboard is locked U
81. Use pcft in a shell script Several pcft commands can be executed sequentially by the shell script This batch file transfer is very useful for moving files between your local system and the IBM host see Table C 1 To invoke pcft type the following command line pcft send receive local file n 2host file lt options gt The different options are described separately for each IBM host application in subsequent sub sections Table C 1 pc t Command Options Option Function send Sends file to IBM host receive Receives file from IBM host local_file Path name of file on local system n The LU session to use for transfer EHLLAPI session name A H SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll C 1 TSO Options Table C 1 pcft Command Options Continued Option Function host_file File name on IBM host options Optional values controlling file transfer each application has its own option format see below lt gt Indicates optional parameter Note To prevent the Unix shell from interpreting the opt ions parameter for this program include all the options in double quotes The shell will not attempt to interpret single left parenthesis pcft will not include the double quotes in your request to the IBM host application Pacific Rim users see Appendix F DBCS for additional keywords that apply to pcft This section describes the options t
82. ZES X 85C7 PSNDPAC 0 SRCVPAC 0 SSNDPAC 0 PSERVIC X 0280000000001850000071 5 UWDAWN Fi e e Code Example 9 3 contains an example LU Type 1 LOGMODE entry Code Example 9 3 Example LU Type 1 LOGMODE Entry DSC2K MODEENT LOGMODE DSC2K FMPROF X 03 TSPROF X 03 PRIPROT X BI1 SECPROT X 90 COMPROT X 3080 R p USIZES X 8787 PSNDPAC 0 SRCVPAC 0 SSNDPAC 0 PSERVIC X 010000000000185018507F00 9 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 eo lll Code Example 9 4 contains an example LU Type 3 LOGMODE entry Code Example 9 4 Example LU Type 3 LOGMODE Entry DSC2K MODEENT LOGMODE DSC2K FMPROF X 03 SPROF X 03 RIPROT X B1 ECPROT X 90 OMPROT X 3080 USIZES X 8787 P SNDPAC 0 SRCVPAC 0 SSNDPAC 0 PSERVIC X 030000000000185018507F00 UWDQAWNUVH 9 3 Application Tables Some IBM applications for example CICS may require additional entries to application specific tables that define the terminals and printers allowed to access the application and the type of allowed operations See the appropriate application reference manual to prepare the host generation SNA Configuration for SUN Wopcl 9 7 9 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 SUNWopc1 Troubleshooting v This
83. a translation name Identifies the file containing the ASCII EBCDIC translation tables See Section 4 5 ASCII EBCDIC Translations for the file format A translation name Identifies the file containing the ASCII EBCDIC translation tables and requests that sun3287 print the tables during initialization See Section 4 5 ASCII EBCDIC Translations for the file format Requests that sun3287 print the ASCII EBCDIC translation tables during initialization See Section 4 5 ASCII EBCDIC Translations for the file format t trace flag ZW Trace mode of operation The supplied value for the trace_flag is used to determine which internal traces are captured in the sun3287 trace log for debugging The bits in the trace flag value indicate which trace to activate The value of the trace flag may be specified according to the syntax recognized by strtol 3 The defined traces and associated trace flag values are as follows 0x0001 Trace buffers to from SNA server API 0x0002 Trace buffers from the keyboard and to the screen 0x0004 Trace information on internal finite state transitions Trace files are created in tmp and named sunlib pid and sunlib pid 1 Traces accumulate in sunlib pid until 1000 trace points have been logged Then this file is renamed sunlib_pid 1 and tracing continues in sunlib pid Print the current release version number and terminate or dbcs These keywords enable Pacific Rim users to print dbcs
84. age Again two trace points control and data 0 39 rcv ru sun std type 000 0000000700000000 8180000000000000 000 0 39 rcv ru ru 0d9 c5d8e4c5e2e340d8 e4c5e4c5c440e3d6 LOGON REQUEST QUEUED TO 3cl e3c9d6d515 APPLICATION 0 39 fsm automation GR SSCP LU State S1 Event EV SERV IN 0 39 fsm automation GR SSCP LU State S1 Event EV FMD Sun3270 sends positive response to logon message 0 39 sun accept ru sun std type 0 39 fsm automation GR SSCP LU State S4 Event EV EC Sun3270 receives a BIND 0x31 request from SNA Host The first trace point shows the control RH indicators and the RU code 0x31 The second trace point shows the RU data everything after the RU code in SunLink 3270 Tracing D 7 Code Example D 1 sun3270 Trace 7 of 9 an SNA message 07 26 96 10 50 52 rcv ru sun std type 0000000400000000 0000000700000031 4180800000010000 0000000003490000 07 26 96 10 50 52 rcv ru ru 010303b190308000 0187c70100020000 000000185000007e 000005c3d5a4f0f1 00 07 26 96 10 5 Screen owner 0 52 fsm automation GR SSCP LU State S1 Event EV SERV IN Sun3270 recognizes the BIND request 07 26 96 10 50 52 fsm automation Screen owner GR SSCP LU State S1 Event EV BIND Scr Sun3270 changes th n owner 07 26 96 10 50 52 fsm automation Screen owner GR LU LU State S0 Event EV BIND
85. allels the normal Cut Copy functions in Windows Within a Rectangle Use a rectangle as the selection constraint This mode enables you to transfer rectangles of 3270 display data SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 2 3 Action Menu Pressing the Action button displays the following menu Each function is described below File Transfer Screen Dump File Transfer Transfers files between your local system and the IBM host Chapter 6 Using File Transfer discusses the various file transfer options Screen Dump Activates a Screen Dump request See Settings Dynamic SUNWopcl Resource Updates on page 4 for how to change the Screen Dump request Usri1 Usr2 etc User Keys When set these menu items do the same pressing a user defined function key See Settings Dynamic SUNWopcl Resource Updates on page 4 for how to change user defined keys 3 2 4 Settings Menu Pressing the Settings button displays the following menu that enables you to dynamically change certain attributes of the sun3270x display and dump screen options Chapter 4 Customizing sun3270x describes all the features that you can change Using sun3270x Suy 3 3 3 Stopping sun3270x You can terminate the sun3270x display in several ways Title Bar Menu Most window managers provide a Quit function in the menu associated with the window frame Stop th
86. and try again Keyboard map layout is not displayed sunke program cannot be found Ensure sunke is in your search paths Keyboard map layout is not updated sun3270 user does not have proper permissions Ensure that sun3270 user has write premissions for sunkeMap File Transfer option inactive No EHLLAPI session name Specify an EHLLAPI name when starting sun3270 e option File Transfer cannot be started pcft program cannot be found Ensure pcft is in your search paths pcft reports its failure to connect to the EHLLAPI server No EHLLAPI session name or EHLLAPI session in use Specify an EHLLAPI name when starting sun3270 e option Specify correct EHLLAPI session name for pcft prefix one character name to host file name File Transfer does not transfers data INDSFILE command sent no other activity Query bit not set in LOGMODE for LU Ensure PSERVIC parameter of LUs LOGMODE has first two bytes equal to X 0280 10 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using suntn3270x 11 This chapter describes how to start and run Sun s X based Telnet 3270 emulator suntn3270x The suntn3270x program provides Telnet 3270 emulation for any system supporting the X Window standard The suntn3270 product supports two graphical interfaces X Windows uses suntn3270x on systems supporting OpenWindows Motif or X Window Mana
87. ata SunLink 3270 Tracing D 9 lll v Code Example D 1 sun3270 Trace 9 of 9 07 26 96 10 51 02 rcv ru sun std type 0000000700000000 0000000700000032 4180800000010000 00000000034e0000 07 26 96 10 51 02 rcv ru ru 01 07 26 96 10 51 02 fsm automation Screen owner GR LU LU State S2 Event EV SERV IN Sun3270 recognizes event as an UNBIND 07 26 96 10 51 02 fsm automation Screen owner GR LU LU State S82 Event EV UNBIND D 10 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Error Messages E All SunLink 9 1 IBM connectivity products are distributed with a message database called BMD All informational and error messages output by Sun software are derived from the BMD Product components running in user space access the BMD during runtime Product components running in kernel space access message tables that are constructed at compilation time The Sun message handling scheme provides the following advantages All messages output by Sun software are documented When a message is output users have a reference that describes the reason the message was output and an explanation of its impact and how to respond Online message documentation BMD messages are standard Unix text files and may be browsed using normal system editors and utilities such as grep Sun also distributes an application bmsg that given a message number prints
88. ation and User s Guide August 1997 Code Example B 1 Sample sun3270map File 5 of 8 Keyboard Map Record vt100 and vt200 vt100 vt200 Aliases HeocHe cho HE Up E BackSp ESC a ESC e ESC i ESC m ESC q ESC u ESC y ral uv Q n ll sun Pam Delete Return A Down E B Right AHS Ea ESC b Eb ESC c Ee ESC f Ef ESC g Ei ESC j Ej ESC k Em ESC n En ESC o NEq ESC r Er ESC s NEu ESC v Ev ESC w Ey ESC z Ez E1 ESC 2 NE2 ESC 3 NES ESC 6 NE6 ESC 7 NE9 ESC 0 NEO ESC NEL ESC E ESC NES ESC XEN ESC amp NE 7 ESC E ESC _ NE ESC NE m Tab NE C Left Ec ESC d Eg ESC h NEk ESC 1 Eo ESC p NEs ESC t Ew ESC x TNES ESC 4 VET ESC 8 E ESC E ESC E amp ESC Er s ESC Mapping sun3270tty Keyboards B 11 Code Example B 1 Sample sun3270map File 6 of 8 CTRL B p
89. beginning and ending curly braces SunLink Client 3270 9 1 Configuration and User s Guide August 1997 B Comments start with a hash f and continue to the end of the current line Comments may appear anywhere in the file B 1 1 ibmCaps Record This record defines all the IBM key values that can be mapped to your keyboard IBM key values fall into four categories 3270 AID keys e 3270 function keys Special Sun function keys EBCDIC characters See Section 3 5 Data Entry Overview for a description of these different IBM key values The format of the IBM Key Caps file is Key Cap Name key value The Key Cap Name becomes the string associated the IBM Key Value Key Cap Names can be up to seven characters For displayable characters the key value is the character s EBCDIC code point for example A 0xC1 To support a UK English keyboard you need to add the EBCDIC value Pound 5B For the 3270 AID keys 3270 function keys and the special Sun function keys an associated string identifies the key value Table B 1 contains a list of these Key Value strings listed under mnemonics Mapping sun3270tty Keyboards B 3 Table B 1 sun3270tty Keyboard Functions Function Name Mnemonic Description Cursor Control Backtab backtab Move cursor to previous field Cursor Down down Move cursor down one line Cursor Left left Move cursor left one position Cursor Right right Move cursor r
90. color xtsunToggleSelectedColor color The color of pop up window background The default is X color Light blue xtsunPopupWindowBackground color xtsunPopupWindowBackground color 3 1 8 Main Display Window Attributes This section contains the command line options that can be run to invoke sun3270x These options also explain the attributes of a displayed window You can change attributes of the main display window and the pop windows The default geometry is 700x500 100 100 Geometry format is defined by XParseGeometry geometry widthxheight Xdisplacement Ydisplacement geometry widthxheight Xdisplacement Ydisplacement Name in the window s title bar The default title is the name of the sun3270x invocation T title name title title name title fitle name Display no main menu bar noMbar noMenuBarMode on off Using sun3270x 349 3 10 Display no Options button on the main menu bar noOptions noOptions on off Path name of the icon file to use when the sun3270x window is closed iconFilename filename iconFilename filename Type of X cursor in the main window The default cursor is top 1eft arrow cursor cursor nume cursor cursor name Type of X cursor in pop up windows The default cursor is top left arrow popupCursor cursor name popupCursor cursor name The function of the Caps Lock key affects only alphabetic keys or all keys capsLockAlphaOnly capsLockAlphaOnly onloff
91. cursor moves back to the first character position on line 1 of the screen Home The Home key moves the cursor to one of the following positions If a display is formatted the Home key moves the cursor to the first character position of the first data entry field on the screen If a display is unformatted the Home key moves the cursor to line 1 column 1 New Line New Line moves the cursor to the first character position of the next display line into which you can enter data Ifa display consists of either mixed non data entry and data entry fields or data only entry fields the cursor moves to the first position of the next data entry field Ifa display consists entirely of only non data entry fields the cursor moves to the first character position on line 1 of the screen If a display is formatted the cursor wraps to the first character position of the next line Tab Forward Tab moves the cursor forward to the first character position of the next data entry field If a display is either unformatted or consists only of non data entry fields the cursor moves forward to the first character position on line 1 of the screen 3 8 Start Stop Data Entry 3 326 The following function keys enable or terminate data entry from the terminal Some functions also cause SUNWopc1 to transmit data to the host computer SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll Attention
92. d Once sunke produces a keyboard map file the NAEnglishCaps file and the sun4Geom file are no longer needed the information from these files are coalesced in the output keyboard map file sunkeMap The structure of the NAEnglishCaps file is simple KeyCap Nam lt Key Valu For displayable characters the Key Value is the characters EBCDIC code point For special functions keys an associated string identifies the Key Value To invoke sunke c NAEnglishCaps g sun4Geom IBM Special Function Keys IBM KeyCap Name lt IBM Key Valu Customizing the sun3270x Keyboard A 13 lll aN Code Example A 1 Example Keycaps File 2 of 6 Enter Clear PA 1 PA 2 PA 3 PF1 PF2 PF3 PF4 PFS PF6 PF7 PF8 PF9 PF10 PF11 PF12 PF13 PF14 PF15 PF16 PF17 PF18 PF19 PF20 PF21 PF22 PF23 PF24 Left Right Up Down Home Reset Tab Btab enter clear pal pa2 pa3 pfl pf2 pf3 pf4 pf5 pf6 pf7 pf8 pf9 pfl pfl pfl pfl pfl pfl pfl pfl pfl pfl pf20 pf21 pf22 pf23 pf24 co 10 01 C0 F9 L5 CO o left right up down home reset tab backtab SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 1 Example Keycaps File 3 of 6 Ins insert Del delete Newln NewLine Ein ein Eeof eeof Attn attn SysRq SysReq dup dup fm fm CurSel fm 7
93. d on and INDSFILE when it is off pcftCommand pcftCommand pcft command F 1 F 2 To display SO SI characters and field characters on the sun3270x screen Default is off showBufferControls ShowBufferControlsMode on off Identifies a special dbcs euc table to use Default is the SunLink table dbecsEucTableFilename dbcs euc table Identifies a legacy dbcs euc table from SunLink 8 to use Default is none L legacyDbcsEucTableFilename legacy dbcs euc table Requests that sun3270x to display DBCS lt gt EUC translation table to dev stdout or to filename specified by O option during initialization Default is of f V printDbcsEucTable on loff Requests that sun3270x to display the widget tree to dev stdout or to filename specified by O option during initialization Default is off printWidgetTree printWidgetTree on off SunLink Client 3270 9 1 Configuration and User s Guide August 1997 F Sa a Requests that sun3270x to display the font names in the font pool to dev stdout or to filename specified by O option during initialization Default is of f printFontPools printFontPools onl off Specify a font set for the 3270x fontList lontList font list For example sun song medium r normal 16 140 75 75 c 140 9gb2312 1980 0 sun song me
94. d typing over the error Cursor movement keys are described later in this chapter After entering data you can instruct SUNWopc1 to send it to the host program by pressing the Enter key a function key or an Attention key The correct key to use depends on the requirements of the IBM host application See the IBM host application documentation for application input requirements While SUNWopcl is transmitting your data to the host program the keyboard is locked The keyboard will not accept keystrokes until Data transmission is complete Host system sends a message to SUNWopcl to be sent to your screen You enter the Reset function You enter the Log Off function You enter the System Request function 3 5 3 Keyboard Functions Keyboard functions are divided into six categories 1 Data entry functions for entering data 2 Start stop data entry for terminating or enabling data entry or transmitting data Cursor control functions for positioning the cursor on the screen Field control functions for formatting or structuring fields Editing mode functions for inserting and deleting characters Qv or dbe O99 Special functions Using sun3270x 3 31 lll Qo With the exception of the Data Entry functions these categories represent key functions that control the position of input and transmission of data to the IBM host application Table 3 3 lists these SUNWopc1 keys and includes a brief description of th
95. different X servers The key characterization menu enables you to modify the interpretation of a keysym received from the X server This is similar to performing an xmodmap function within the SUNWopcl window only This key characterization does not affect the actual keysyms generated by the X server and has no impact on any other X client application The key characterization menu is shown in Figure A 1 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Suns 2 Tx CancelV Key Characterization Figure A 1 Key Characterization Menu To change the keysym associated with a slot on the key cap Shift normal Control 1 Position the mouse on the slot and press the left mouse button The text in the slot will be displayed in red 2 Click a keysym generated by the X server one of the 4 slots on the right by pressing the right mouse button on the desired selection or type in any valid keysym name on the line labeled Other 3 Press the return key Once the selection is made the keysym associated with the slot on the keycap is updated 4 To apply the change click the Ok button Within the OpenWindows environment on Sun Workstations the key labeled print sys req produces the key characterization shown in Figure A 2 Within the Power DeskTop environment on IBM RS 6000 systems the key labeled print sys req produces the key characterization shown in Figure A 3
96. dium r normal 16 140 75 75 c 70 i1s08859 1 OR song must follow which ends the font list when only a single font is specified Specify the font to use as normal font fontPoolNormal fontPoolNormal normal font Specify the font to use as bold font fontPoolBold fontPoolBold bold font DBCS F 3 F 4 Specify the font to use in the OIA area fontPoolOIA fontPoolOIA SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Index A Action menu 3 27 aliases record B 5 alternate cursor 1 7 application tables 9 7 arguments generic A 8 ASCII character sequence B 6 ASCII EBCDIC translations 4 9 attention function 3 37 audience xv B backtab key 3 35 basic message database E 2 BMD E 1 bmsg display utility E 2 C caps lock key 3 34 case or test key 1 7 CG3270 usage 12 1 characterization key A 28 CICS 6 2 C 1 CICS options C 7 clear 3 37 CMS C 1 color display attributes 3 6 command line 7 4 configuration 1 7 display terminal example 8 4 SNA server example 8 4 configuration file SunLink PU2 1 8 1 configurations coordinating 2 3 configuring SUNWopcl 2 3 conversational monitoring system C 1 cursor control 3 34 cursor movement field to field 3 35 customizing keyboard A 1 D data entry assist 1 7 data entry keys 3 33 DBCS Index 1 Index 2 file transfer
97. ds describe the LU attachment sun3270x requests that the LU services manager connect to the sunpu2 1 SNA server located on the named host If the h option is omitted the local host is called h host name hostName ost name Using sun3270x au lll Qo sun3270x requests that the LU services manager connect to the named LU 1u name The LU must be listed in the sunpu2 1 SNA server s configuration and the lut ype parameter must be configured to equal 2 If the 1u name option is omitted the first available LU is selected active LUs are chosen first inactive LUs are chosen next only LUs with lutype 2 can be chosen 1 lu name luName lu name sun3270x requests that the SNA server assign it to an LU belonging to the named Physical Unit PU The PU must be configured in the local configuration file If the pu name option is omitted the PU associated with the named selected LU is used p pu name puName pu name sun3270x requests that the LU services manager connect to the LU with the specified port number on the sunpu2 1 SNA server only if the Lutype parameter for the LU is configured to equal 2 Port number begins at 2 and corresponds to the LOCADDR of the LU directive in the sunpu2 1 SNA server configuration This option can only be specified if the p option is chosen If the n option is omitted and the p option is specified the first available LU on the specified PU is connected active LUs are chosen f
98. e default is crosshair SunLink Client 3270 9 1 Configuration and User s Guide August 1997 11 graphicCursor cursor name graphicCursor cursor name Enables support for the Load Programmed Symbols structured field during this run of the suntn3270 or not If enabled query replies to the host indicate support for Load PS and such structured fields will be processed when seen If not enabled query replies to the host indicate NO support and any Load PS structured fields seen will be ignored This enables disables Load PS for both the text layer and the graphics layer The default is OFF loadps loadpsMode on off Pathname of the bitmap file to read and use for GDDM standard fill pattern number i Values for i are 1 14 The default is gddmPati Examples gddmPat1 gddmPat5 gddmPat12 etc gddmPati file name gddmPati file_name Causes the suntn3270 to consider GDDM datastream coordinate value 0 0 to be the upper leftmost pixel in the graphics layer rather than considering 0 0 to be the center of the graphics layer which is the normal interpretation A small number of hosts do consider datastream 0 0 to be the upper left pixel in the graphics layer hence this switch The default is OFF gddmUpperLeft gddmUpperLeftMode on off Enables support of the WCC Reset bit WCC bit 1 If enabled the suntn3270 performs reset actions described in the IBM 3270 Information Data Stream Programmer s Reference when
99. e 1 LU Type 3 Output print data to file printer or program To provide SNA 3270 emulation the SUNWopc1 application controls the screen format and the display of characters The 3270 data stream is converted to the appropriate screen commands and EBCDIC characters are mapped to corresponding ASCII characters Likewise the user input is displayed according to the 3270 display formats and data is sent to the host in 3270 data stream compliant format A sample SUNWopc1 screen is illustrated in Figure 1 3 Introduction to SUN Wopcl 15 sun3270x File Edit Action Settings ONLINE PPPPPPPPPP PPPPE P P P P P P PPP DDD P PPPPPPPPP P P P P P P PPP PPP P P P USERID and 1ll not RUNNING Figure 1 3 SUNWopcl Screen A lll SUNWopcl does not support the following IBM 3270 display terminal functions Case or test key Keyclick Alternate cursor GDDM support only Double cursor movement Programmed symbols Data entry assist 1 8 Keyboard Mapping Your keyboard and the IBM 3270 display station keyboard are different Sun provides a graphical keyboard map utility with sun3270x to help you quickly determine how the IBM key values are associated with your keyboard functions This graphical utility displays a layout of your keyboard with the keys labeled with their corresponding IBM key values It also enables you to dynamically update the current keyboard map while you are using sun3270x
100. e 3270 data stream Logon to NetView 07 26 96 10 50 38 sun send ru sun std type 0000000000000000 0000000700000000 8180000000000000 0000000100000000 07 26 96 10 50 38 sun send ru ru 9585a3a58985a6 netview Sun3270 receives reply from sunpu2 1 SNA Server stating message received OK 07 26 96 10 50 39 reply sun_std_type 0000000300000000 0000000700000000 0000000000000000 0000000000040000 Sun3270 recognizes the server reply and processes it 07 26 96 10 50 39 fsm automation Screen owner GR SSCP LU State S3 Event EV SERV IN D 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example D 1 sun3270 Trace 6 of 9 07 26 96 10 5 0000000500000 0000000000040 07 26 96 10 5 Screen owner 07 26 96 10 5 Screen owner 07 26 96 10 5 0000000400000 0000000000030 07 26 96 10 5 15d3d6c7d6d54 40cld7d7d3c9c 07 26 96 10 5 Screen owner 07 26 96 10 5 Screen owner 07 26 96 10 5 07 26 96 10 5 Screen owner Se SE SE OSE H Sun3270 receives a positive SNA respons from the SNA Host for logon message 0 39 rcv ru sun std type 000 0000000700000000 8180000000000000 000 Sun3270 recognizes event from server 0 39 fsm automation GR SSCP LU State S3 Event EV SERV IN Sun3270 process the positive SNA respons 0 39 fsm automation GR SSCP LU State 3 Event EV POS RSP Sun3270 receives logon mess
101. e Status Line to disappear You can check the Status Line by pressing the Status key sequence usually Escape o The Status key sequence acts as a toggle press it to display the Status Line and press it again to hide the Status Line SunLink Client 3270 9 1 Configuration and User s Guide August 1997 HE i 13 1 2 Intensified Support For many terminal types you can control the way the terminal displays intensified characters such as reverse video bold and so on Use the etc termcap file to control the type of intensity support for your terminal The so and se entries identify the character sequences to enter and exit standout mode intensified For a VT100 terminal you can set the standout to bold mode by setting so NE 1m andse E m 13 1 3 sun3270tty Keywords To invoke sun3270tty type the following command line sun3270tty e ehllapi name 1 lu name p pu name n port number h host name t trace flag v The following keywords describe the LU attachment a file name Identifies the file containing the ASCII EBCDIC translation tables to use See Section 4 5 ASCII EBCDIC Translations for the file format A file name Identifies the file containing the ASCII EBCDIC translation tables to use and requests that sun3270tt y print the tables during initialization See Section 4 5 ASCII EBCDIC Translations for the file format C Override the default selection of Row 24 as t
102. e Sun SNA resources and the IBM devices as illustrated in Figure 1 2 is as follows Part A of Figure 1 2 illustrates the sunpu2 1 SNA server running on a Sun Workstation a client SNA program SUNWopcl is also running on the Sun Workstation Introduction to SUN Wopcl T3 lll A 1 4 Part B of Figure 1 2 shows a parallel configuration of IBM devices Part C of Figure 1 2 relates the Sun SNA resources to the IBM devices where the sunpu2 1 SNA server represents the PU2 and attaches to the SNA network via an SDLCLINE serial attachment TRLINI attachment or QLLCLINI represents the LU 1 2 SUNWopcl Emulation E Token Ring E public data network attachment SUNWopcl SUNWopcl emulates IBM 3278 display terminals models 1 5 IBM 3279 display terminals models 2A 2B 3A 3B and IBM 3287 printers The SUNWopcl applications are described in Table 1 1 SunLink Client 3270 9 1 Configura tion and User s Guide August 1997 A lll Table 1 1 Applications and their Emulation Application Emulation sun3270x OpenWindows Motif 3270 emulation IBM 3278 models 1 5 IBM 3279 models 2A 2B 3A 3B EHLLAPI program services File transfer Resizable display window Keyboard mapping TN3270 RFC 1646 1647 support sun3270tty TTY 3270 emulation IBM 3278 models 1 5 EHLLAPI program services File transfer Keyboard mapping TN3270 RFC 1646 1647 support sun3287 3287 printer emulation LU Typ
103. e block size ftTsBlksize blocksize Specify the desired space allocation for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsSpace space prim lt sec gt ftTsSpace space prim lt sec gt Specify the desired record format for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsRecfm Fixed Variable Undefined ftTsRecfm Fixed Variable Undefined Specify the desired allocation unit for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsUnits Blocks Tracks Cylinders ftTsUnits Blocks Tracks Cylinders Specify the direction of the file transfer operation The default Send SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll ftVmSendReceive Send Receiv ftVmSendReceive Send Receiv Specify the transfer property for the receiving file See Chapter 6 Using File Transfer for more information on this parameter ftVmCreateAppend Create Append ftVmCreateAppend Create Append Specify the transfer mode for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftVmBinaryAscii Binary ASCII ftVmBinaryAscii Binary ASCII Specify the CRLF for the file transfer operation See Chapter 6 Using File Transfer for more informat
104. e bottom of the screen 3 2 1 File Menu Pressing the File button displays the following menu Each function is described below Save Ctri s Save As Exit Save Save changes to an open session at any time without closing the session Is the session does not have a name the screen displays the SaveAs dialog box SaveAs Saves the current session to a new or different name The screen displays the SaveAs dialog box Enter the new name and press OK Exit Exits the sun3270x session 3 2 2 Edit Menu Pressing the Edit button displays the following menu which enables you to cut copy and paste text as well as set up Edit Mode Cut Ctrlex Copy Ctrl C Paste Ctri Mode Using sun3270x 225 Mode Displays the Mode dialog box The options are described below Only Input Fields You can only cut or copy characters in data entry fields Each field is transferred as a single line Fields spanning multiple lines are transferred as multiple lines When this field is selected all other options are excluded Use this mode when transferring fields from one sun3270 display to another or to capture only the input field data Anything in Screen You can only cut or copy all characters in the selected area Field characters are converted into space characters Each screen line is terminated by a new line Across Entire Line Select characters across entire lines This mode par
105. e sun3270x process File Menu Press File Exit to terminate the session 3 4 Status Line The current status of the emulated 3270 display station is continuously displayed on the last line of the sun3270x 3270 emulation screen below the horizontal bar The Status Line in Figure 3 2 shows that the user is currently in an SSCP LU session System Operator the host is busy processing Wait the display is in Insert mode the LU is SLUO2 port 2 on PU SP63 and the EHLLAPI session name is A and the cursor is on row 4 column 56 Ae screen Insert mode EHLLAPI session Local address name tem Operator wait Insert LU SLU02 lt 4 PUZSPB3 PORT 2 Keyboard Logical Unit LU Physical Unit PU Cursor location readiness name name and local address Figure 3 2 Sample Status Line SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll The components of the Status Line are defined in Table 3 3 Table 3 2 Status Line Meaning Indicator State Status The current screen owner active session is displayed Inactive LU The SSCP LU session was not established by the host System Operator The SSCP LU session owns the display y Job The LU LU session owns the display and the terminal emulator is bound in session to a primary LU Unowned The LU LU session owns the display but the terminal is not bound in session to a primary LU Disconnected SUNWopcl cannot connect to the sunpu2
106. e the keyboard geometry You specify the new geometry file by using the g option when starting sunke sunke displays the keyboard layout in a window defined as 1000x1000 units As you resize the sunke window sunke readjusts the size and position of your keyboard geometry always maintaining a 1000x1000 units inside the window the units shrink or expand when you resize Each key in the geometry file is defined by Position in the window X coordinate in units Y coordinate in units Size of key Width in units Height in units Each line in the geometry file represents one key in the keyboard layout The syntax is X coordinate Y coordinate Height Width If one of these parameters is not specified its value defaults to the parameter value of the line above Positional values preceded by a hyphen are in absolute coordinates otherwise positional values are relative to the previous position For example the entry 19 300 80 40 specifies a key in absolute position 15 300 with a height of 80 units and a width of 40 units If the next entry is 45 then the next key is positioned 45 units greater in the X coordinate 60 300 and the size of the key is the same as the previous entry the Y coordinate height and width take the values of the previous entry Customizing the sun3270x Keyboard A 19 lll aN A 6 1 Sample Keyboard Geometry File Code Example A 2 Example Keyboard Geometry File 1 of 8
107. eadoutText text titleReadoutText text X cursor name when in move IBM key values mode Default is top left arrow moveCursor cursor nume moveCursor cursor nume X cursor name when in Learn the Keyboard Layout mode Default is hand2 codeCursor cursor nume CodeCursor cursor name X cursor name when in Forget the Keyboard Layout mode Default is pirate uncodeCursor cursor name uncodeCursor cursor name Text for mode button when in move mode Default is Move KeyCaps modeButtonMoveText text modeButtonMoveText text Text for mode button when in move mode Default is Learn Kbd Keys modeButtonCodeText text modeButtonCodeText text Text for mode button when in move mode Default is Unlearn Keys modeButtonUncodeText text modeButtonUncodeText text Customizing the sun3270x Keyboard A5 lll aN Fonts sunke can use for display sunke chooses fonts based on the window size fontPool font namel font name2 font nameN fontPool font namel font name2 font_nameN Text for the exit button Default is Quit exitButtonText text exitButtonText text Text for the file button Default is File fileButtonText text fileButtonText text Text for the information button Default is Other Info infoButtonText fext infoButtonText fext A 2 3 Window Colors The following text describes the window color attributes Colors are defined by their X color
108. ed Use this mode when transferring fields from one SUNWopc1 display to another or to capture just the input field data Anything In Screen Cut Copy all characters in the selected area Field characters are converted into space characters Each screen line is terminated by a new line Across Entire Line Select characters across entire lines This mode parallels the normal Cut Copy functions in X Windows Within a Rectangle Use a rectangle as the selection constraint This mode enables you to transfer squares of 3270 display data SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 To select data position the X cursor and press the left mouse button While holding the left mouse down drag the X cursor to the final character position you want to select You can also select a single word by positioning the cursor within the word and double clicking the left mouse button A word is defined as a set of contiguous letters underscores or digits You can readjust the area you selected by positioning the X cursor on the desired screen position and pressing the shift key and left mouse button simultaneously To de select a selected area press the left mouse button anywhere on the sun3270 screen Cut Cut moves data from the selected area to a logical clipboard The data is deleted from the sun3270x display Copy Copy copies data from the selected area to a logical clipboard Paste Paste m
109. ed to the TSO application TSO removes the CR LF characters and marks the end of each record with its own internal end of record marker With this option pcft reads each line of text from the local file and marks the end of each line with CR LF characters before transmitting the data to the TSO application Use this option along with ASCII for readable files Do not use this option for binary files Default TSO does not insert end of record markers for CR LF characters lrecl n Indicates the desired logical record length for the TSO data set in bytes Default 80 bytes for new files existing logical record length for existing files recfm flvlu Indicates the desired record format for the TSO data set where f Specifies fixed length records v Specifies variable length records C 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll Table C 2 Send TSO Syntax Continued Element Description u Specifies undefined length records Default Fixed length records for new files without cr1f option specified variable length records for new files with cr1f option specified space q lt i gt Indicates the space allocation requirements for a new TSO data set where q is the primary and i is secondary allocation of avblock tracks and cylinders and where lt avblock x gt Is the smallest entity lt tracks gt Is middle sized entity lt cylinders gt Is the largest entity Default d
110. eeeeeeeeeeeel 6 2 Pile Transfet eter vie ee e here aad pee eae eed 6 3 xi xii Figure 8 1 Figure 9 1 Figure 11 1 Figure A 1 Figure A 2 Figure A 3 Point to Point Line Configuration Workstation 8 5 Sample SNA Configuration 9 2 suntn3270 Status Line neei n E eee eee 11 6 Key Characterization Menu 0 eee eee A 29 sun3270x Print Key Characterization A 30 IBM RS 6000 Print Key Characterization A 31 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Tables Table 1 1 Table 2 1 Table 3 1 Table 3 2 Table 3 3 Table 5 1 Table 6 1 Table 7 1 Table 7 2 Table 7 3 Table 8 1 Table 8 2 Table 8 3 Table 8 4 Table 8 5 Table 8 6 Applications and their Emulation sssssue 1 5 Example Configuration Parameters 006 2 4 IBM Color Keywords and Display Attributes 3 6 Status Line Meaning ses t esk siek ena neces 3 29 Keyboard Functions sa iipasi scana c deia ia ee 3 32 Keyboard Mapper Modes issslele esses 5 5 File Transfer Options 0 trese sneke iwed rires ette 6 4 SCS Control Codes ccce ee dr tugri re n 7 1 Horizontal Format Specifiers 0 0 0 66 c eee eee ee 7 4 Vertical Format Specifiers 6 66 c cece eens 7 5 Configuration Syntax 6 666 cee eee 8 2 LU Port Attributes 2 0 tniii nne a 8 2 LU Types and Sun Client Programs 00065 8
111. efault allocation value of blksize C 1 2 Send TSO Examples To send a text file name text file from the local Unix system to a host TSO data set data set name data abc in readable format type 9 pcft send textfile data abc ascii crlf To send a binary file name binfile from the local Unix system to a host TSO data set data set name data def member name binfile type pcft send binfile data def binfile recfm v To send a binary file name binfile from the local Unix system to a host TSO data set data set name sys tables member name mystuff and indicate that your TSO User ID should not be prefixed to the indicated data set name type ae pcft send binfile sys tables mystuff recfm v Or pcft send binfile sys tables mystuff recfm v Using PCFT C 5 lll C The double quotes protect the data set and member name from being interpreted by the Unix shell Similarly the back slashes notify the Unix shell not to interpret the next characters C 1 3 Receive TSO The syntax of the pcft command to transfer files from a TSO host application to a SUNWopc1 session which is shown below is described in Table C 3 pcft receive local file lt n gt host_file lt member name password options Options append ascii crlf Table C 3 Receive TSO Syntax Element Description receive Receive file from IBM hos
112. eir actions Subsequent sections detail the actions of the Data Entry keys as well as the keys listed in Table 3 3 Table 3 3 Keyboard Functions Function Mnemonic Description Cursor Control Backtab backtab Move cursor to previous field Cursor Down down Move cursor down one line Cursor Left left Move cursor left one character position Cursor Right right Move cursor right one character position Cursor Up up Move cursor up one line Home home Move cursor to first field New Line newline Move cursor to first field on next line Tab Forward tab Move cursor to next field Start Stop Data Entry Attention attn Request turn to send data Clear clear Clear screen Enter enter Initiate transfer of data to host Function keys PF1 24 pfl pf24 Initiate transfer of data to host Program access PA1 3 pal pa3 Initiate transfer of data to host Reset reset Clear input inhibited status or insert mode Editing Mode Delete delete Delete character at current cursor position Insert mode insert Insert characters at current cursor position Field Control t Clear field clearfield Clear field and move cursor to beginning of field 32 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 6 Data Entry Table 3 3 Keyboard Functions Continued Function Mnemonic Description t Delete left deleteleft Delete character to the left of the cursor DUP dup Du
113. ember to move the CICS READY prompt before initiating a file transfer Note The pcft cannot create a partitioned data set under CICS However pcft can create new files when the data set is not partitioned Using PCFT C 7 lll C C 2 1 Send CICS The syntax of the pc t command to transfer files from the SUNWopc1 session to a CICS host application which is shown below is described in Table C 4 pcft send local_file lt n gt host_file lt options gt lt comments Options ascii crlf Table C 4 Send CICS Syntax Element Description send local file host file options ascii binary GELE no crlf comments Send file to IBM host application Required positional parameter Pathname of file on local system Required positional parameter Pacific Rim Users If dbcsMode is set pcft translates the data set from DBCS to EUC n is the LU session to use for transfer EHLLAPI session name A H Optional positional parameter Default is A CICS data set name on IBM host The data set name can be up to 8 characters long Refer to the IBM Customer Information Control System CICS OS VS Version 1 Release 6 Installation and Operations Guide manual for more information about CICS data set names and properties Required positional parameter The character is mandatory when you specify options CICS supports the following send options Indicates to CICS that the local file should be c
114. es to display textual information in the Status Line sun3270x chooses the display font on a best fit basis The semicolon character in the resources file indicates that the rest of the line is a comment fontPoolOIA font namel font name2 font nameN 4 2 Example SUNWopc1 Resource File Code Example 4 1 Example SUNWopc1 Resource File SUNWopcl i SWS G This file contains example resourc ntries for the sun3270x emulation program When the sun3270x program starts it searches for a SUNWopcl resource file in the X resource directories e g S XAPPLRESDIR If the SUNWopcl resources file is found sun3270x initializes the defined resources with their specified values A preceding a resource indicates all sun3270x programs should use this resource definition e g hostname bruno Alternatively an instance name can be used to set a resource to a a value depending on th name argument to the sun3270x program As illustrated below using an instance name makes it easy to specify different sun3270x program behavior In this example when sun3270x is invoked with name D2 sun3270x connects to the BLU01102 Logical Unit and becomes the B EHLLAPI session A resource specified with an instance name overrides any bindings using the paradigm Customizing sun3270x 4 3 lll HS Code Example 4 1 Example SU
115. example configuration 6 2 LU Directive The LU directive defines the attributes associated with an LU port operating on the specified PU Refer to Table 8 2 Absent parameters take default values Table 8 2 LU Port Attributes Attribute Function Syntax LU NAME 1lu name PU NAME associated pu2 LUTYPE 1lu type LOCADDR n PACING n Restrictions lu name must be unique associated pu2 must bea PU2 NAME argument 8 2 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Co lll Table 8 2 LU Port Attributes Continued Attribute Function Arguments NAME 1lu name PU NAME associated pu2 JUTYPE n LOCADDR n PACING n lu name can be any alphanumeric string up to 8 characters White space tabs spaces is not allowed NAME is used to identify this LU You can specify an EHLLAPI session name for SUNWopcl programs by beginning the 1u name with HLA and ending the name with the EHLLAPI session name e g HLAwxzyB specifies EHLLAPI session name B Only valid for EHLLAPI session names A through H associated pu2 can be any alphanumeric string up to 8 characters White space tabs spaces is not allowed PU NAME is used to identify the PU2 directive associated with this station n is an integer specifying the type of LU range 0 3 Default 2 See Table 8 3 n is an integer specifying the local address of this LU range 1 254
116. ey Format 5 2 6 Keyboard Layout The keyboard layout occupies the bottom portion of your keyboard map display window This area presents the mapping of IBM key values to keys on your keyboard You can change these mappings The keyboard map display can run as a player piano As you strike keys the keyboard mapper presses the associated key in the graphical keyboard representation Use the player piano feature to orient yourself with the association of keys on the keyboard and keys in the window 5 8 Updating the Keyboard Map Moving IBM key values to different keys on your keyboard is very simple pick it up and drop it off The following section explains this task in more detail 5 3 1 Moving an IBM Key To move an IBM key value 1 Place the mouse pointer above the IBM key value you want move and press the left mouse button The IBM key value becomes attached to the mouse pointer 2 Place the mouse pointer with the attached IBM key value above the target key and press the left mouse button to drop off the IBM key value 5 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 5 Figure 5 4 shows the PF10 IBM key value in the process of being mapped It has just been picked up from the unmapped IBM keys values This IBM key value can be mapped to any key on the keyboard layout Drag and Drop IBM Key fu _ Mer oj 7704 Pap pew greta Kargxwsarrd pent bbe wine ns molar LE d 85 dH
117. ey_map_pathname This is the pathname of the sun3270map keyboard map file If the k option is omitted sun3270map searches the directories listed in your PATH environment variable for a file named sunkeMap 1 lu name sun3270tty requests that the LU services manager connect to the named LU lu name lu name can be a specific LU name or a pool of LUs maintained by the TN3270 server This keyword is optional n port number sun3270tty requests that the LU services manager connect to the LU with the specified port number on the SunLink SNA PU2 1 SNA server only if the lutype parameter for the LU is configured to equal 2 The port number begins at 2 and correspond to the LOCADDR of the LU directive in the sunpu2 1 SNA server configuration 13 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 IE This option can only be specified if the option is chosen If the n option is omitted and the p option is specified the first available LU on the specified PU is connected active LUs are chosen first p pu name sun3270tty requests that the SNA server assign it to an LU belonging to the named Physical Unit PU The PU must be configured in the local configuration file If the pu name option is omitted the PU associated with the selected LU is used Special functions include S Use only uppercase characters in the 3270 emulation window u Shows sun3270tty usage t trace_flag Trace mode of operation T
118. f This flag is similar to gddm gddmMode described above except that it causes sun3270 to allocate a separate set of 3 planes in pixel memory for the Graphic Layer On some hardware this yields faster screen updates and refreshes in both the Text Layer and the Graphics Layer It yields smoother real time updates of the Graphics Layer as GDDM data stream arrives This mode of GDDM is required for GDDM mix modes OR and XOR for supporting 3 plane LPSs in Graphics Layer and for the GDDM crosshair graphics cursor If this mode is not enabled mix modes OR and XO will act the same as mix mode OVERPAINT Query responses to the host will indicate no support for 3 plane LPSs any Load PS structured field having a color field of other than 0 will be rejected and the GDDM crosshair graphics cursor will be unavailable only the cross graphics cursor will be available If both the gddm and gddmDirect are given gddmDirect takes precedence The default is OFF gddmDirect gddmDirectMode on off The type of X cursor to use for the cross style GDDM graphics cursor The default is crosshair graphicCursor cursor name graphicCursor cursor name Chooses whether or not to enable support for the Load Programmed Symbols structured field during this run of the sun3270 If enabled Query replies to the host indicates support for Load PS and such structured fields will be processed when seen If not enabled Query replies to the host Using sun3270
119. g sun3270x 4 5 lll HS Full Color Use full IBM 16 color mode 2 Color Use Base Color mode Monochrome Use black and white display Monochrome Reverse Video Use reverse video display invert foreground and background colors Case The following options are available Upper and Lower case Use mixed case Uppercase only Use only uppercase characters on the display 3 Mouse Displays the Mouse dialog box in which you can change the function of the mouse buttons The options are described below Left Mouse Position Cursor x Start Selection v Light Pen selection Options x Left Middle Mouse do Cut Paste OK Cancel zi Left Mouse The left mouse button can have the following functions Position Cursor Moves the cursor to the selected position Start Selection Start a new edit selection without moving the cursor Light Pen selection Enables the mouse to function as a Selector Light Pen See Section 3 11 Special Functions in Chapter 3 Using sun3270x for a detailed description of the Light Pen Options Enables you to use the left mouse button to cut copy and the middle mouse button to paste 4 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 E Screen Dump Displays the Screen Dump dialog box in which you can choose to where you want to write screen output The options are described bel
120. ger as on workstations PCs and X terminals TTY type terminals use suntn3270tty on terminals like VT100s VT200s and Wyse See Chapter 13 Using sun3270tty for more information about running suntn3270 on TTY type terminals You can invoke this application from the command line from a script or as a menu option Many suntn3270x programs can run in parallel each suntn3270x controls one display window and one session with an IBM host application Use the n host name option to attach to a Telnet server running on a different system in your local area network For more information on suntn3287 see Starting suntn3287 in Chapter 7 Using sun3287 11 1 11 11 1 suntn3270 Dependencies The suntn3270x program accesses the keyboard map file during start up The default keyboard map file name is sunkeMap suntn3270x searches the directories listed in your PATH environment variable to find sunkeMap If the search fails suntn3270x announces that will use an internal default map If you want suntn3270x to support EHLLAPI programs you must have an entry in the etc services file that identifies the service name for the EHLLAPI session If suntn3270x is running on a remote system or a network name server for example NIS is used you may have to update the etc services file EHLLAPI service names begin with sunehllapi and end with the EHLLAPI session name therefore the A EHLLAPI session service name is sunehllapiA
121. h that key Caps Lock The Caps Lock key capitalizes all alphanumeric keys until the Caps Lock key is pressed again The Caps Lock key does not affect any other keys The Cursor Control keys position the cursor without changing the contents of the screen These functions include Moving the cursor one character position at a time Positioning the cursor to the first character position in a data entry field Cursor Control is subject to limitations imposed by data field attributes defined by an application program For example you cannot use all the cursor control functions to move the cursor into a protected field 3 7 1 Moving the Cursor from Character to Character The following cursor control keys position the cursor one character position at a time Cursor Down Cursor Down moves the cursor down one line at a time in either non data or data entry fields If the cursor is on the last line in any column the cursor moves to line 1 in the same column Cursor Left Cursor Left moves the cursor one character position to the left in data entry fields SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 If the cursor is in the first character position of a line the cursor moves to the last character position of the previous line If the cursor is in line 1 column 1 the cursor moves to the last character position of line 24 Cursor Right Cursor Right moves the cursor one character positio
122. hapter 7 Using sun3287 lists all the startup options for sun3287 After starting SUNWopcl your IBM mainframe banner should be displayed in the SUNWopc1 window If no banner is displayed see Chapter 10 SUNWopcl Troubleshooting 2 6 Stopping sunpu2 1 Note The recommend method for stopping sunpu2 1 is to use the SunGMI To stop the sunpu2 1 SNA server 1 Load the sunop utility 2 Type the kill command at the prompt SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using sun3270x 3 This chapter describes how to start and run the X Motif based SNA 3270 emulator sun3270x The sun3270x provides SNA 3270 emulation for any system that supports the OpenWindows environment The SUNWopcl product supports several graphical interfaces The OpenWindows environment uses sun3270x on systems supporting OpenWindows Open Look Motif XWindow Manager workstations PCs and xterms TTY type terminals use sun3270tty on terminals like VT100s VT200s and Wyse See Chapter 13 Using sun3270tty for more information about running SUNWopcl on TTY type terminals The sun3270x program emulates IBM 3278 display terminals models 1 to 5 and IBM 3279 display terminals models 2A 2B 3A 3B It supports EHLLAPI programs and file transfer between your local system and IBM host systems This chapter includes information on sun3270x invocation sun3270x command line keywords sun3270x dis
123. hat are available for file transfers between the Sun pcft program and a TSO host application Remember to move to the TSO READY prompt before initiating a file transfer Note If the IBM host system is running TSO E you must disable interrupts and exit from the session manager before beginning a file transfer You can disable TSO interrupts with the term nobreak command You can exit from the TSO session manager by clearing the screen and entering end pcft cannot create a partitioned data set under TSO pcft however can create new members in an existing partitioned data set TSO automatically prefixes the TSO data set name and member name with your TSO User ID Use single quotation marks to avoid having the User ID prefixed to the TSO data set name and member name you specify C 1 1 Send TSO The following command describes the Send TSO command The syntax of the pcft command that transfers files from the SUNWopc1 session to a TSO host application is described in Table C 2 pcft send local file n host file member name password options Using PCFT C 3 lll C Options append ascii blksize n crlf lrecl n recfm f v u space q lt i gt avblock x tracks cylinders Table C 2 Send TSO Syntax Element Description send Send file to IBM host application Required positional parameter local file Pathname of file on local system Required positional parameter n n is the LU session t
124. he OIA if the terminal characteristics allow for it for example if the device supports more than 24 lines d base file name Identifies the base file name to write screen output to when the dump screen option is selected Each dump screen operation creates a new file with the base file name and a numeric suffix incremented for each new operation Default sun3270ScreenDump Using sun3270tty 133 j The EHLLAPI session name and attributes are specified as e ehllapi name sun3270tty takes ehllapi name as the name EHLLAPI programs use to reference this sun3270 display and keyboard buffers The ehllapi name must be one uppercase character between A and H You can also specify the EHLLAPI session name in the sunpu2 1 SNA server configuration See Chapter 8 SunLink PU2 1 SNA Server Configuration g sun3270tty runs as a daemon process with no display Use this mode when you are fronting the 3270 display with your own application h host name sun3270tty requests that the LU services manager connect to the sunpu2 1 SNA server located on the named host If the h option is omitted the local host is called j Enforce numeric editing on numeric fields The default is no numeric editing See the description of resources record in Appendix B Mapping sun3270tty Keyboards for a description of the numstr variable used to provide the user specified numeric edit string The keyboard map file can be specified k k
125. he default is IBM 3279 3 I terminal identifier termId ferminal identifier suntn3270x negotiates terminal type sub option as the specified model number with the TN3270 server Defined values are 2 3 4 and 5 If the I option is omitted the default is the Terminal Identifier option value S model number modelType model number suntn3270x negotiates terminal type sub option as the specified extended mode with the TN3270 server If the E option is specified the terminal type sub option value is suffixed with E ha extendedMode on off 11 2 1 Miscellaneous Keywords When suntn3270 settings are saved in a resource file selecting this option applies the changed settings to the current operation savelmpliesApplyMode SavelmpliesApplyMode Causes suntn3270 to preserve the current layout of any resource files and simply updates the changed resources This is helpful for commented resource files mergeResourcefil mergeResourcefile The left mouse button controls the cursor position leftMouseCurPostionMode leftMouseCurPostionMode Using suntn3270x 11 3 11 11 4 Allows you to cut and paste lines into the text at the current cursor position The pasted text is inserted moving the subsequent text over leftMouseCurPostionMode leftMouseCurPostionMode Toggles the insert key between text insertion and text overwrite G togglelInsertMOde 11 2 2 Host Graphics Keywords
126. he keyboard layout Click this button to view another page File Click the File button to apply your updates to the keyboard map The updates are stored in the file indicated in the Editing message near the top of the keyboard mapper window These files are always the ones currently used by the sun3270x these are its keyboard map and keyboard layout files See the k kbdMapFilename in Chapter 3 to specify a keyboard map file name the default file name is sunkeMap See the Z kbdFilename to specify a keyboard layout file name the default file name is sunkeKbd See the z kbdDirname to specify a keyboard layout directory the default is kbds Note You must have write permissions to the keyboard map file and the keyboard layout files to save your mapping updates The keyboard mapper will not report the failure of a File operation Quit Click the Quit button to exit the keyboard mapper Be sure to select File before quitting if you want to save any mapping updates 5 2 2 Title Bar The title bar displays the name and version number of the keyboard mapper SunLink Client 3270 9 1 Configuration and User s Guide August 1997 O1 lll 5 2 3 Unmapped IBM Keys All unmapped IBM keys are stored in a circular array of keys As you pick up IBM keys to map onto the keyboard layout other unmapped IBM keys become visible You can cycle through the array by moving the mouse over the unmapped IBM keys but not t
127. he rightmost key unmapped key and pressing the right mouse button 5 2 4 Mode Button The Mode button controls the overall functions of the keyboard mapper Click the Mode button to cycle through the three possible keyboard mapper modes see Table 5 1 Table 5 1 Keyboard Mapper Modes Mode Cursor Usage Move KeyCaps Top left arrow Basic mode Allows you to view and update the keyboard map Learn Kbd Keys Pointing finger Training mode Enables you to teach the keyboard mapper the keyboard keys See Appendix A Customizing the sun3270x Keyboard Unlearn Keys Skull and bones Deprogramming mode Enables you to tell the keyboard mapper to forget a keyboard key it previously taught See Appendix A Customizing the sun3270x Keyboard 5 2 5 Single Key Layout Each key in the keyboard layout is divided into three parts Top Shifted state of the key such as A and Middle Normal state of the key such as a and 4 Bottom Control state of key such as CTRL A and CTRL Z Figure 5 3 illustrates the different key states The key on the left has been learned by the keyboard mapper it is raised and can be mapped to IBM key values The key on the right has not learned it is pressed and cannot be mapped to IBM key values Using Keyboard Mapper 55 lll O1 Shift gt A No Shift gt a Control Ctrl a or Alt Graph Figure 5 3 Single K
128. he supplied value for the trace_flag is used to determine which internal traces are captured in the sun3270tty trace log used for debugging The bits in the trace_flag value indicate which trace to activate The value of the trace_flag may be specified according to the syntax recognized by strtol 3 The defined traces and associated trace_flag values are as follows 0x0001 Trace buffers to from SNA server API 0x0002 Trace buffers from the keyboard and to the screen e 0x0004 Trace information on internal Finite State transitions Trace files are created in tmp and named sunlib pid and sunlib pid 1 Traces accumulate in sunlib pid until 1000 trace points have been logged Then this file is renamed sunlib pid 1 and tracing continues in sunlib pid Prints the current release version number and terminate Using sun3270tty 135 Em 13 1 4 sun3270tty Examples To attach to a sunpu2 1 SNA server on a remote system named bruno type sun3270tty h bruno To attach to an LU named BLU01101 on the local system and serve as the EHLLAPI presentation space named A type sun3270tty 1 BLUO1101 e A To start sun3270tty in an OpenLook window use a shell script like the following bin sh shelltool Wt 9x15 WG 765x390 Wf 10 140 10 wb 0 0 0 Wl Sun3270 default term boldStyle Offset X and Y and XY default term inverseStyle Same as bold sun3270tty 1 2 3 4 5 6 7 8
129. ication The basic field types are Protected A protected field contains information from the host which you cannot overwrite It is protected from user input If you enter data in a protected field the keyboard will lock and you have to press the IBM reset key to restore the keyboard for input Unprotected An unprotected field enables you to insert information Non display A non display field does not echo input as it is entered for example password fields Autoskip An autoskip field is skipped over by the cursor 3 5 2 3270 Keyboard Input Summary As you enter each character SUNWopc1 validates it against field attributes to ensure that the character belongs where you are entering it If the data character is valid it is displayed on the screen if the data character is invalid an alarm sounds and the cursor does not move An example of an invalid character is a character entered in a protected field To recover press the IBM Reset key and enter a valid character SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 The cursor indicates where the next entered character will appear on the screen The cursor advances automatically unless you enter an invalid character as you enter data If a field is not completed use the Return Tab or cursor key to move the cursor to the next data entry field Also you can correct mistakes by positioning the cursor at the text to be changed an
130. ified terminal identifier If I is omitted the default is IBM 3287 1 This option is not normally used with an RFC 1647 compliant server but is left in for backward compatibility RFC 1647 servers only allow IBM 3287 1 for a printer terminal identifier Using sun3287 7 7 7 8 1 lu name suntn3270x requests that the Logical Unit LU services manager connect to the named LU lu name lu name may either be a specific LU name or it may be a pool of LUs maintained by the TN3270 Server This keyword is optional p pu name This keyword is eliminated Associate this printer instance with the display LU named with the 1 lu name option w or dbcs These keywords enable Pacific Rim users to print dbcs For more information on Telnet see Chapter 11 Using suntn3270x SunLink Client 3270 9 1 Configuration and User s Guide August 1997 SunLink PU2 1 SNA Server Configuration 8 The SUNWopc1 attaches to LU Type 2 ports display terminals on the SunLink 9 1 PU2 1 SNA Server The Sun3287 emulator attaches to LU Type 3 ports printers on the SunLink PU2 1 SNA server Each port represents one LU Ports for these SNA client applications must be configured in the local SunLink PU2 1 SNA server file Since LUs are SNA resources you will need your LU ports defined in the SNA configuration Chapter 8 SunLink PU2 1 SNA Server Configuration discusses how to configure the Sun emulators in an SNA network 8 1 SunL
131. ight one position Cursor Up up Move cursor up one line Home home Move cursor to first field New Line newline Move cursor to first field on next line Tab Forward tab Move cursor to next field Start Stop Data Entry Attention attn Request turn to send data Clear clear Clear screen Enter enter Initiate transfer of data to host Function Keys PF1 24 pf1 pf24 Initiate transfer of data to host Program Access PA1 3 pal pa3 Initiate transfer of data to host Reset reset Clear input inhibited status or insert mode Editing Mode Delete delete Delete character at cursor position Insert Mode insert Insert characters at cursor position Field Control TClear Field clearfield Clear field and move cursor to start of field tDelete Left deleteleft Delete character to left of cursor DUP dup Duplicate operation for field Erase Field eeof Erase to end of the current field Erase Input ein Erase all unprotected fields Field Mark fm Mark the end of a field or a subfield SunLink Client 3270 9 1 Configuration and User s Guide August 1997 b lll Table B 1 sun3270tty Keyboard Functions Continued Function Name Mnemonic Description Special Function Systems Request sysreq Switch to other session i e LU LU to SSCP LU Print dumpscreen Copy screen to file or program t Special Sun keys B 1 2 aliases Record Use this record to name ASCII character sequences so that their meaning is easily discernible when a SUNWo
132. in resolving SNA connectivity problems SunLink Client 3270 9 1 Configuration and User s Guide August 1997 2 sunpu2 1 reads the local configuration file to learn about its SNA resources during initialization To display the status of the sunpu2 1 SNA server use the sunop application including LU status The sunop application prompts you for management requests is the sunop prompt To view the PU2 status type dis display status dis 2 dis gt OP200025 2 Link BLNO1 2 Active OP200020 2 Physical Unit BPUO11 7 Active OP20002a 2 Logical Unit BLUO1101 2 Active OP20002a 2 Logical Unit BLUO01102 2 Active OP20002a 2 Logical Unit BLU01103 2 Active If the SNA host has successfully connected to the PU2 the Physical Unit status is Active If the SNA host has successfully connected to the LU the Logical Unit status is Active 2 5 Starting SUNWopcl After you successfully connect to the SNA network you can start SUNWopcl To invoke SUNWopc1 in the OpenWindows environment type 5 sun3270x To invoke SUNWopc1 in TTY type terminal display type sun3270tty To start the SUNWopc1 printer emulator type 5 sun3287 Getting Started with SUNWopcl 2 5 lll No 2 6 Chapter 3 Using sun3270x lists all the startup options for sun3270x Appendix B lists all the startup options for sun3270tty C
133. ing and Installation Guide 802 2665 12 Administration SunLink SNA X 25 9 1 Configuration and Administration Guide 802 3166 12 Configuration and user SunLink 3270 OpenClient 9 1 Configuration and User s Guide 802 2667 12 information Configuration and user SunLink RJE 3770 9 1 Configuration and User s Guide 802 2672 12 information Configuration information SunLink SNA PU 2 1 9 1 Server Configuration Guide 802 2673 12 Programming information SunLink Client IBM 3270 9 1 Programmer s Guide 802 2668 12 Programming information SunLink LUO 9 1 API Programmer s Guide 802 2676 12 Programming information SunLink SNA Peer to Peer LU 6 2 9 1 Programmer s Guide 802 2680 12 Programming information SunLink SNA Peer to Peer CPI C 9 1 Programmer s Guide 802 2681 12 Reference information SunLink SNA SNM 9 1 Reference Manual 802 2674 12 Late breaking news SunLink SNA 9 1 for Solaris Release Notes 802 3165 12 xviii SunLink Client 3270 9 1 Configuration and User s Guide August 1997 IBM Documentation The following IBM documents provide reference information Typographic Conventions IBM Systems Network Architecture Concepts and Products GC30 3072 IBM VTAM Installation and Resource Definition SC23 0111 IBM Network Control Program Resource Definition Guide SC30 3349 IBM VTAM Operation SC23 0113 IBM NetView Operation C30 3364 The following table describes the typographic changes used in this book Typeface or replace wi
134. ink PU2 1 SNA Server Configuration The SunLink PU2 1 SNA server configuration file specifies the SNA resources associated with a Unix system This configuration file is read during the SunLink PU2 1 SNA server sunpu2 1 initialization This chapter discusses the LU directive in the SunLink PU2 1 SNA server the LU directive specifies SNA parameters for SUNWopcl Refer to the SunLink SNA PU2 1 9 1 SNA Server Configuration and Administration Manual for more information on the SunLink PU2 1 SNA server configuration The configuration file is ASCII text Each directive begins with a directive keyword and ends with a semicolon The following conventions shown in Table 8 1 are followed when describing each directive s syntax 8 1 lll Co Table 8 1 Configuration Syntax Mnemonic Symbol Description Brackets Optional argument Or sign Separates the options in a list Uppercase A Must be entered as shown can be either uppercase or lowercase Lowercase a Variable argument indicates the type of information Commas j Must be entered as shown Equal Must be entered as shown Single quote Must be entered as shown Slash slash Indicates a comment the rest of the line is ignored There is no restriction on the use of blank lines tabs or spaces to separate directives and their arguments Comments may appear anywhere and are preceded by Refer to Section 8 4 Sample SNA Server Configuration for an
135. ion on this parameter ftVmCrlfNocrlf Crlf WNocrlf ftVmCrlfNocrlf Crlf Nocrlf Specify the desired logical record length for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftVmLrecl logical record length ftVmLrecl logical record length Specify the desired record format for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftVmRecfm Fixed Variable Undefined ftVmRecfm Fixed Variable Undefined Specify the direction of the file transfer operation The default Send ftCicsSendReceive Send Receiv ftCicsSendReceive Send Receiv Specify the transfer property for the receiving file See Chapter 6 Using File Transfer for more information on this parameter ftCicsCreateAppend Create Append ftCicsCreateAppend Create Append Using sun3270x 3 17 lll Qo Specify the transfer mode for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftCicsBinaryAscii Binary ASCII ftCicsBinaryAscii Binary ASCII Specify the CRLF for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftCicsCrlfNocrlf Crlf Nocrlf ftCicsCrlfNocrlf Crlf Nocrlf Specifies the desired comment string for the file transfer operation See Chapter 6 Using File Transfer for more information on th
136. irst n port number portNumber port number 3 1 4 Keyboard Map Attributes The keyboard map file can be specified as The path name of the sun3270x keyboard map file If the k option is omitted sun3270x searches the directories listed in your PATH environment variable for a file named sunkeMap k key map pathname kbdMapFilename key map pathname 3 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 3 The path name of the sun3270x keyboard file If the Z option is omitted sun3270x searches the directories listed in your PATH environment variable for a file named sunkeKbd Z keyboard pathname kbdFilename keyboard pathname The directory name of the sun3270x keyboard file The default is kbds The sun3270x examines all files in this directory for a keyboard file that matches the X server description of the display system keyboard z keyboard directory name kbdDirname keyboard directory name Override sun3270x keyboard file definition with current keysym values When this option is in effect you should specify a keyboard file name z or kbdFilename or the default keyboard sunkeKbd should see your current keyboard Use this option if you use xmodmap or if you alter the Xserver environment after mapping your keyboard sniffKbd sniffKbd on off Note Pacific Rim users see Appendix F DBCS for additional keywords 3 1 5 EHLLAPI Session Name The EHLLAPI se
137. is a Unix application that you can invoke from the command line a script or as a menu option Many sun3287 and SUNWopc1 programs run in parallel each sun3287 controls one session with an IBM host application sun3287 emulates both LU Type 1 SCS and LU Type 3 DSC printers The sun3287 program dynamically switches between LU Type 1 and LU Type 3 emulation on receipt of the SNA BIND request The SNA BIND request specifies the LU Type requested by the connecting application While operating as an LU Type 1 the sun3287 program supports the SCS control codes described in Table 7 1 Table 7 1 SCS Control Codes Code EBCDIC Hex Name BS 16 Backspace BEL 2F Bell function CR 0D Carriage return ENP 14 Enable presentation FF 0C Form feed GE 08 Graphic escape HT 05 Horizontal tab INP 24 Inhibit presentation IRS 1E Interchange record separator LF 25 Line feed 7 1 lll N Table 7 1 SCS Control Codes Continued Code EBCDIC Hex Name NL 15 New line SA 28 Set attribute SHF 2BC1 Set horizontal format SLD 2BC6 Set line density SVF 2BC2 Set vertical format TRN 35 Transparent VCS 04XX Vertical channel select VT Ob Vertical tab Use the h host name option to be attached to a Sun PU2 1 SNA server running on a different system in your local area network 7 1 Dependencies The sun3287x program attaches to the SunLink SNA 9 1 PU2 1 Server sunpu2 1 using the sun pu2 espd service name This entry must
138. is parameter ftCicsComment comment string ftCicsComment comment string 3 1 12 Light Pen Defaults You can use the following defaults for the Light Pen Cut Copy Paste pop window Specify if the Light Pen Cut Copy Paste pop window will be displayed when the right mouse button is pressed noCPP noCPP on off Specify the default mode for all mouse operations See Section 3 11 Special Functions for more information on this parameter cpPenFieldAll Pen Field All cpPenFieldAll Pen Field Al11l Specify the default mode for cut operations See Section 3 11 Special Functions for more information on this parameter cpLineRect Line Rectangle cpLineRect Line Rectangle Specify using the mouse for copy and paste functions The left mouse button is used to select the copy text The middle mouse button is used to paste cpasteMouse cpasteMouse on off 3 18 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 1 13 Host Graphics Keywords You can change the defaults for host graphics Chooses whether or not to enable GDDM support during this run of the sun3270 If GDDM support is enabled Query replies to the host indicate that GDDM and the GDDM datastream will be fully supported If GDDM support is not enabled Query replies to the host indicate NO GDDM support and any GDDM datastream data will be silently ignored The default if OFF gda m gddmMode on of
139. isplay this message NO MESSAGE NUMBER Do not prefix the message with its number PROGRAM_NAME Prefix the message by the program name PROCESS_ID Prefix the message by the user process id TIME Prefix the message by the date and time CAUSE The CAUSE field describes why the message is displayed This field can be up to 1024 characters and cannot contain any blank lines EFFECT The EFFECT field describes the effect on the product component due to the condition described by the associated messages This field can be up to 1024 characters and cannot contain any blank lines ACTION The ACTION field describes the actions the user or administrator should take when the associated message is displayed This field can be up to 1024 characters and cannot contain any blank lines SunLink Client 3270 9 1 Configuration and User s Guide August 1997 DBCS F This appendix is for Pacific Rim users with double byte character string DBCS functionality F1 DBCS Keywords The following keywords apply to sun3270x and pcft Enables sun3270x to process and display DBCS Default is off w or dbcs dbcsMode on off Selects the desired input method Default is onspot if dbcsMode is turned on desiredImStyle desiredImStyle onspot offspot root Identifies the command to use for file transfer Default is APVUFILE when dbcsMode is turne
140. ities as well as to map the behavior of real 3270 devices to the same functions that are provided by the SUNWopc1 product Extended High Level Language Application Program Interface EHLLAPI programmers need to refer to this manual to correctly invoke SUNWopcl as an EHLLAPI server application System programmers define the SUNWopc1 devices in the SNA configuration add these new devices to the SunLink sunpu2 1 SNA server configuration and customize the SUNWopc1 client software Usually one system programmer is responsible for the SNA network updates another installs the sunpu2 1 server and builds the local configuration file and possibly a third installs the SUNWopcl client software These system programmers must coordinate the parameters chosen for the SNA configuration the sunpu2 1 server and the SUNWopcl configurations As a system programmer responsible for the SNA network configuration you should be familiar with adding new devices to a Virtual Terminal Access Method Network Control Point Generation VTAM NCP GEN XV As a system programmer responsible for installing and configuring the SunLink sunpu2 1 SNA server you should be familiar with the Solaris operating system and the configuration of SNA devices As a system programmer or administrator responsible for the SUNWopc1 client installation and configuration you should be familiar with the Solaris operating system and its configuration As a user you should under
141. l System programmers should provide their users with a generic mapping Operators should refer to this section if they want to change their keyboard mappings for SUNWopcl Chapter 6 Using File Transfer describes how to exchange files between the local system and the IBM host using the SUNWopcl menu driven file transfer mechanism Chapter 7 Using sun3287 specifies the startup requirements and printer output functions for the sun3287 printer emulation program Chapter 8 SunLink PU2 1 SNA Server Configuration specifies the syntax and descriptions of the SUNWopc1 configuration directives in the sunpu2 1 SNA server configuration Chapter 9 SNA Configuration for SUNWopcl describes the updates required for the SNA host network configuration Chapter 10 SUNWopcl Troubleshooting provides troubleshooting procedures for SUNWopcl Chapter 11 Using suntn3270x describes how to start and run the Sun X based Telnet 3270 emulator suntn3270x The suntn3270x program provides Telnet 3270 emulation for any system supporting the X Window standard Chapter 12 Using CG3270 explains how to use CG3270 emulation which adds the capability to support GDDM commands from the IBM host system Chapter 13 Using sun3270tty describes how to start and run Sun s TTY based SNA 3270 emulator sun3270tt y The sunw3270tty program is a Unix application Many sun3270tty programs can run in parallel Each sun3270tty controls one termina
142. l and one session with an IBM host application Appendix A Customizing the sun3270x Keyboard describes how to customize your keyboard using the sunke Unix mapper program Appendix B Mapping sun3270tty Keyboards describes how to map the sun3270tty keyboards Preface xvii Appendix C Using PCFT describes how to use the PCFT program SUNWopcl supports the transfer of binary ASCII and EBCDIC text files between the local Unix system and IBM host systems that support the IBM 3270 PC file transfer option Appendix D SunLink 3270 Tracing explains how to turn on the trace utility and start the appropriate emulator with the t option Trace points record all information received and sent to the sunpu2 1 SNA server and all information received and sent to the terminal It explains how to turn on the trace utility and start the appropriate emulator with the t option Appendix E Error Messages describes the error messages generated by the system All informational and error messages generated by Sun software are derived from the BMD It describes how to use the bmsg utility Appendix E DBCS describes the double byte character string for Pacific Rim users Related Documents The following Sun documents contain topics that relate to the information in SunLink Client 3270 9 1 Configuration and User s Guide Purpose Document Title Part Number Installation SunLink SNA 9 1 End Node Plann
143. licence s il y en a Des parties de ce produit pourront tre deriv es du syst me UNIX licenci par Novell Inc et du syst me Berkeley 4 3 BSD licenci par l Universit de Californie UNIX est une marque enregistr e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Le logiciel d tenu par des tiers et qui comprend la technologie relative aux polices de caract res est prot g par un copyright et licenci par des fournisseurs de Sun Sun Sun Microsystems le logo Sun AnswerBook SunDocs SunLink OpenWindows et Solaris sont des marques d pos es ou enregistr es de Sun Microsystems Inc aux Etats Unis et dans d autres pays Toutes les marques SPARC utilis es sous licence sont des marques d pos es ou enregistr es de SPARC International Inc aux Etats Unis et dans d autres pays Les produits portant les marques SPARC sont bas s sur une architecture d velopp e par Sun Microsystems Inc Les utilisateurs d interfaces graphiques OPEN LOOK et Sun ont t d velopp s de Sun Microsystems Inc pour ses utilisateurs et licenci s Sun reconna t les efforts de pionniers de Xerox Corporation pour la recherche et le d veloppement du concept des interfaces d utilisation visuelle ou graphique pour l industrie de l informatique Sun d tient une licence non exclusive de Xerox sur l interface d utilisation graphique cette licence couvrant aussi les licenci s de Sun qui mettent en place les utili
144. lity provides a comprehensive help facility and the freedom to remap your IBM key values whenever you want 5 1 Displaying the Keyboard Map To invoke the keyboard mapper select Settings gt Keyboard Keyboard Display Mouse Screen Dump User Keys Figure 5 1 Options Keyboard Mapper 5 1 3 5 2 Keyboard Map Layout Figure 5 2 illustrates an example sun3270x keyboard map layout The keyboard map layout is made of five major components Menu bar Title information Unmapped IBM keys Keyboard layout Mode Button Many characteristics of the keyboard mapper can be customized including color title and keyboard layout for new keyboards See Appendix A Customizing the sun3270x Keyboard for more information ed SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Title Bar Unmapped IBM Keys Menu Bar Mode Button N EELT Aham J T ee A SunLink Keyboard Happing Fncilitu wil markets Kaukxsard pent khd aleunkekEd mi ele ie d 2 de gen cep cieve keucap a 555 3444 3544 44 43 85 33 8 3 3 8 8 3 3 34 3 23 ded 3555 LEEEEBEEEEPEBEEESDCEEEEE Pier P PEPE EEE aus 5 4 5 2 1 Menu Bar The keyboard mapper provides a menu bar with three buttons Other Info not supported Click the Other Info button to display a user defined commentary about the keyboard map Next The Next button is displayed if there is another display page for t
145. lly you only need to update the EOS directive and the PU2 ADDR argument Refer to the SunLink PU2 1 server configuration documentation for details on the configuration parameters The sample configuration defines the following SNA connection shown in Figure 8 1 8 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Co lll Point to point line BLNO1 SUNWopcl PU2 lt gt BLUO1101 BPUO 11 BLUO1101 Modem DSU sunpu21 BLUO1101 Sun Workstation Figure 8 1 Point to Point Line Configuration Workstation Code Example 8 1 SNA Server Sample Configuration Sun SunLink PU2 1 SNA Server Sample Configuration This sample configuration configures one point to point Line BLNO1 one Physical Unit BPU011 and three Logical Units BLU01101 BLU01103 Lf The physical connection is realized via a 9600 bits sec synchronous modem The UNIX system is connected to the modem using serial port A running the Sun synchronous driver zbxdrv You will need to configure the following parameters PU2 ADDR Remember SDLCLINE lt gt VTAM LINE macro PU2 VTAM PU macro where PUTYPE 2 LU VTAM LU macro a SunLink PU2 1 SNA Server Configuration 8 5 lll Co Table 8 6 Server Configuration Parameters
146. log box 4 7 using sun3287 7 1 V vertical format 7 5 VM CMS 6 2 VM CMS options C 10 Ww window attributes A 4 window colors A 6 Index 5 X X keywords 3 3 3 10 X Window Manager 11 1 X Window standard 11 1 Xserver 3 12 X terminals 11 1 Index 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997
147. lor index monoModeForeground ibm color index When in monochrome mode use the color specified for the IBM color index as the background color B ibm color index monoModeBackground ibm color index Use the color specified for the IBM color index as the matte color The default index is 1 blue M ibm color index matteForeground ibm color index The color of the main menu bar The default is X color light blue menuBarBackground color menuBarBackground color The color of the pop up window menu bars The default is X color dark green popupMenuBarBackground color popupMenuBarBackground color The color marking top of button The default is X color white xtsunBevelLightColor color xtsunBevelLightColor color The color marking bottom of button The default is X color black xtsunBevelDarkColor color xtsunBevelDarkColor color The color of button when selected The default is X color gray xtsunButtonSelectedColor color xtsunButtonSelectedColor color SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll The color of text in buttons The default is X color black xtsunButtonTextColor color xtsunButtonTextColor color The color of text read out areas The default is X color black xtsunReadoutTextColor color xtsunReadoutTextColor color The color of toggle selection box when chosen The default is X color red xtsunToggleSelectedColor
148. lues 5 4 Saving Keyboard Map Updates To save keyboard map updates 1 Click the File button The File Confirmation menu is displayed 2 Click the Ok button to save the files The updates are stored in the files indicated in the Output Map File and Output Keyboard File fields of the File Confirmation menu These fields are initialized from the Editing message near the top of the keyboard mapper window Figure 5 6 File Menu 5 5 Exiting Keyboard Map Display To exit the keyboard mapper click the Quit button Using Keyboard Mapper 59 lll O1 S10 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using File Transfer 6 SUNWopc1 supports the exchange of binary ASCII and EBCDIC text files between the local Unix system and IBM host systems that support the IBM 3270 PC File Transfer INDSFILE option The sun3270x program provides an easy to use menu to facilitate file transfers Pacific Rim users SUNWopc1 also supports the transfer of DBCS text files If dbcsMode is turned on the default for the File Transfer process is APVUFILE rather than INDSFILE See Appendix C Using PCFT for a description of the sun3270tty file transfer mechanism and for procedures for executing batch file transfers 6 1 File Transfer Dependencies You can transfer files to and from IBM host systems that support the INDSFILE program within the following programs CICS Customer Informatio
149. mer to determine the specific values for the parameters outlined below After coordinating the updates to these two configurations you are ready to establish a connection to the SNA network Here are the parameters Line attributes SDLCLINE TRLINE or QLLCLINE parameters Line station address PU2 directive parameters Port number of the logical unit LOCADDR parameter of the LU directive LU type LUTYPE parameter for LU directive indicates display terminal or printer implied by LOGMODE parameters for the LU configured on the SNA host system Chapter 9 5NA Configuration for SUNWopcl contains example SNA configuration information This chapter contains parts of a VTAM NCP GEN which illustrates the configuration of the SUNWopc1 SNA resources LINE PU and LU This chapter also contains sample LOGMODE tables one for SUNWopc1 and one for sun3287 printer emulation 2 3 Configuring SUNWopc1 To configure SUNWopc1 SNA connections use the configurations located in the Sun installation directory and the ones listed in Chapter 8 or another sample configuration included in the SunLink SNA PU2 1 9 1 Server Configuration and Administration Manual Using the information in Section 2 2 Coordinating Configurations update your configuration to reflect your local parameter values Getting Started with SUNWopcl 23 Note A SUNWopc1 display terminal emulator can only attach to LUs configured as lut
150. metry File 8 of 8 Space Bar sixth row of a Row sun4 keyboard X Y Height Width 15 750 80 85 120 0 80 40 45 45 45 0 80 405 410 0 80 40 45 45 815 0 80 85 90 0 80 40 Help Caps Lock Alt Diamond Space Bar Diamond Compose Alt Graph Ins Del Customizing the sun3270x Keyboard A 27 m A 7 Teaching sunke Keyboard Functions After you update the keyboard geometry and IBM key caps file you are ready to train sunke about your keyboard keystrokes To train the keyboard start sunke by typing sunke g geometry file sunke will start in teaching mode indicated by the hand cursor To train the keyboard move the hand cursor above a pressed unlearned key and strike the similarly positioned key on your keyboard sunke will beep and raise the key indicating the association between the keystroke and that the keyboard layout has been learned Repeat the process for all the keys in your keyboard layout To retrain a key move the hand cursor above the key and strike a different key After training all of the keyboard keys click the File option to save the keyboard file A 7 1 Key Characterization The key characterization defines the association between the keysym and the virtual keycode the SUNWopc1 interprets keysym is the code sent by the X server when a key is pressed Discrepancies are known to exist within the keysyms generated by
151. more information about VM CMS file names and properties Required positional parameter file type VM CMS file type Required positional parameter file mode VM CMS file mode Optional positional parameter Default is A1 options The character is mandatory when you specify options VM CMS supports the following send options append ascii crlf lrecl n Appends the contents of the local file to the VM CMS file The logical record length and record format values are the same as the original VM CMS file Optional parameter Indicates to VM CMS that the local file should be converted from ASCII to EBCDIC when stored in the VM CMS file Use this option along with cr1f for readable files Do not use this option for binary files Default VM CMS does not translate the file from ASCII to EBCDIC Indicates that carriage return line feed characters CR LF act as record separators in the data transferred to the VM CMS application VM CMS removes the CR LF characters and marks the end of each record with its own internal end of record marker With this option pcft reads each line of text from the local file and marks the end of each line with CR LF characters before transmitting the data to the TSO application Use this option along with ascii for readable files Do not use this option for binary files Default VM CMS does not insert end of record markers for CR LF characters Indicates the desired logical record length for the VM CMS file
152. n Control System CICS VS 5798 DOH Version 1 00 or greater TSO Time Sharing Option MVS 5665 311 Version 1 00 or greater CMS Conversational Monitoring System VM SP 5664 281 Version 1 00 or greater 6 1 6 2 Before you initiate a file transfer you must be logged into one of the above mentioned IBM host applications and positioned at the main prompt for that IBM host application In TSO for example you should have the READY prompt displayed in your sun3270x window To execute a file transfer 1 Establish a communications link with the IBM host system 2 Start sun3270x as an EHLLAPI server by specifying the e session name argument 3 Log into the IBM host application TSO CICS or VM CMS 4 Ensure that the main prompt for the IBM host application is displayed 6 2 Starting a File Transfer To start a file transfer choose Action gt File Transfer from the sun3270x Main menu bar Figure 6 1 File Transfer Screen Dump Figure 6 1 Action to File Transfer Figure 6 2 contains the sample selections for the file transfer options In this example the readable file usr abc will be sent to the IBM host via the TSO application The file will be stored in the test1 abc data set Remember before executing the file transfer you must have the TSO READY prompt displayed on the sun3270x emulation screen SunLink Client 3270 9 1 Configuration and User s Guide August 1997 File Transfer
153. n of the first possible data entry field If the display consists entirely of non data entry fields the cursor moves to line 1 column 1 If a display is unformatted all character locations are cleared to null characters The cursor moves to line 1 column 1 Using sun3270x 3 39 Erase to End of Field Erase to End of Field erases the current data entry field from the cursor position to the end of the field The cursor does not move from its current location If a display consists of non data entry fields or if the cursor is located in an attributed character position an alarm sounds and the keyboard locks Field Mark Field Mark displays a semicolon as a field delimiter If a display consists of data entry fields subfields within a data entry field are delimited with semicolons If a display is unformatted the semicolon indicates the end of a field If the cursor is located either in an attribute character position or in a non data entry field an alarm sounds and the cursor does not move 3 11 Special Functions 3 40 The following special functions keys provide extended capabilities System Request The System Request function key transfers ownership of the screen display Display ownership is indicated by the status line and only one session can be the display device owner at a time During the session or the ownership period only the device owner can display data Any attempt by a non owner to use the
154. n to the right If the cursor is in the last character position of a line the cursor moves from the end of the line to the first character position of the next line If the cursor is in the last character position of line 24 the cursor moves to the first character position of the screen Cursor Up Cursor Up moves the cursor up one line at a time in either non data entry or data entry fields If the cursor is on line 1 in any column the cursor moves to line 24 in the same column 3 7 2 Moving the Cursor from Field to Field These following cursor control keys position the cursor to the first character position in a data field Backtab Backtab moves the cursor to the start of the previous non protected non skipped field Ifa display consists of mixed non data entry and data entry fields and the cursor is located either in the attribute character position of one of the mixed fields or in the first character position of a data entry field or in any character position of a non data entry field the cursor moves back to the first alphanumeric character position of the preceding data entry field If the cursor is located in an alphanumeric character position other than the first position of a data entry field the cursor moves back to the first alphanumeric character position in the same data entry field Using sun3270x 3 35 Ifa display is either unformatted or consists only of non data entry fields the
155. ndard input stdin The popen 3 function is used f path name Absolute or relative path name of the base level file name used to store the print stream Each new print stream is stored in a file whose name is the base level file name with a unique number appended For example a base level file name of abc would have associated print stream file named abc 0 abc 1 and so on H horizontal format Defines the default horizontal format for the presentation space This parameter is only valid while operating as an LU Type 1 The horizontal format is specified as follows MPP LM RM TAB1 TAB2 TABn See Table 7 2 Table 7 2 Horizontal Format Specifiers Specifier Function MPP The maximum presentation position specifies the horizontal extent of the presentation surface The default value is 132 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 N lll Table 7 2 Horizontal Format Specifiers Specifier LM Function The left margin specifies the column value of the left most presentation position LM also serves as the first tab stop This value must be less than or equal to the MPP The default value is A RM The right margin specifies the column value of the right most presentation position RM must be greater than or equal to LM and less than or equal to MPP The default value is MPP TAB Horizontal tab stops specifies the column values for the horizontal tab HT func
156. ntifies the service name for the EHLLAPI session Normally the installation procedure makes this entry If sun3270x is running on a remote system or a network name server for example NIS is used you may have to update the etc services file EHLLAPI service names begin with sunehllapi and end with the EHLLAPI session name therefore the A EHLLAPI session service name is sunehllapiA Since sun3270x supports EHLLAPI session names A through Z 0 through 9 and a through z up to 62 EHLLAPI programs can run on one system To start sun3270x as an EHLLAPI server use the e keyword SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll Note The installation procedure only adds service names A though H to the etc services file 3 1 2 Keywords Different keywords control the operation of sun3270x Logical Unit LU attachment Keyboard map file path name EHLLAPI session name IBM color scheme Window color scheme Window attributes Generic X keywords Miscellaneous functions All the sun3270x keywords have parallel entries in the SUNWopc1 resources file sun3270x reads the SUNWopc1 resources file during startup you can update this file to customize your sun3270x behavior see Chapter 4 Customizing sun3270x for more information The resource name for each keyword is under the keyword and is prefixed with a period 3 1 3 LU Attachment Keywords The following keywor
157. ntil the keyboard is unlocked the alarm sounds if you press a data entry key Program Access Keys Program access keys terminate data entry and cause SUNWopc1 to transmit a message to the IBM host application Using sun3270x 9 97 lll Qo 3 9 Editing 3 38 PA1 Through PA3 An application program defines what happens when you press a program access key Each application program can assign separate actions to each program access key If you press any program access keys the keyboard is locked Until the keyboard is unlocked the alarm will sound if you press a data entry key Reset Reset unlocks your keyboard so you can enter more data The following editing function keys insert and delete characters in data entry fields Insert Mode Use Insert mode to enter consecutive characters into a data entry field without altering characters already there Press the Reset key to terminate the insert mode When you insert text all characters within a field from the cursor to the first NULL character are shifted right If the cursor is located at a null non character position in a data entry field and you insert a character the character is inserted in the null position and no character shifting occurs The insert function does not span lines A separate insert action must be performed on each line If you try to insert characters in a filled field an alarm sounds In an unformatted screen the Insert mode treats
158. o use for transfer EHLLAPI session name A H Optional positional parameter Default is A host file TSO data set name on IBM host Refer to the IBM OS VS2 Command Language Reference manual for more information about TSO data set names and properties Required positional parameter member name Name of member in the TSO data set specified by host file This is an optional positional parameter Follows host file immediately with no space separators password Password used for TSO data set under password protection This is an optional positional parameter Follows lost file member name immediately with no space separators options TSO supports the following send options append Appends the contents of the local file to the TSO data set append cannot be used for members of a partitioned data set The logical record length and record format values are the same as the original TSO data set Optional parameter ascii Indicates to TSO that the local file should be converted from ASCII to EBCDIC when stored in the TSO data set Use this option along with cr1f for readable files Do not use this option for binary files Default TSO does not translate the file from ASCII to EBCDIC blksize n Indicates desired blocks size for the host data set in bytes Default 80 bytes for new files existing blocksize for existing files crlf Indicates that carriage return line feed characters CR LF act as record separators in the data transferr
159. oard Geometry File A 19 A 6 1 Sample Keyboard Geometry File A 20 A 7 Teaching sunke Keyboard Functions A 28 A 7 1 Key Characterization unaa evE ETE es A 28 AS Mapping IBM Key Caps xexxckrerirrus e OI ER es A 31 B Mapping sun3270tty Keyboards eee B 1 B 1 Keyboard Map Pile Porat vies eis er rr e nears B 2 B 1 1 ibmCaps Record 00 eee eee B 3 D slrssesBecomnl om eere dciaace oed Re Rcx B 5 viii SunLink Client 3270 9 1 Configuration and User s Guide August 1997 B 1 3 Terminal Map Record ius eeu n D nent ww B 5 B 1 4 ASCII Character Sequence aiu cea eaaet B 6 BAS Sample sun3270map We eese ERE es B 7 Ce Using POF Ti aaa kk YOOX RAE RE EEEE REO COCA OR E o C 1 C TSO OU C c irere eenei PIOS EE EQ du dd ad C 3 C11 Send TSO P C m C 3 C 1 2 Send TSO Examples vid pod eR hU En C 5 L3 Rec ive lOO ciecoterbrb bbb ROO ds currence et C 6 C 1 4 Receive TSO Pxamiples oiiciinaaines eee ne C 7 Eus CICS OPHONS e oi ioo EE eiie ot oncle arose ee C 7 SEE EIE P cdc dati Tr C 8 C 2 2 Send CICS Examples mee aeeckases C 9 3 Receive CWS cos xx te ceret ed Cer GADS EEE C 9 C24 Receive CICS Examples e cevees C 10 C 3 VM CMS Options s vi wi ERR nasaan ERE Ew V rs C 10 CoL Send VM CMS ss smi ed Ew a aca adt os C 11 C 3 20 Send VM CMS Examples esee ess C 12 CA Receive VM CMS oerRERRERRERA CO EDEORE X OX OR C 12 C 41
160. on off Default off 1242 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 ner Pathname of the bitmap file to read and use for GDDM standard fill pattern number i where i ranges from 1 through 14 gddmPati file name gddmPati file name Default gddmPati Examples gddmPat1 gddmPat5 gddmPat12 etc It causes the emulator to consider GDDM datastream coordinate value 0 0 to be the upper leftmost pixel in the graphics layer and so forth rather than considering 0 0 to be the center of the graphics layer which is the normal interpretation A small number of hosts do consider datastream 0 0 to be the upper left pixel in the graphics layer hence this switch gddmUpperLeft gddmUpperLeftModeon off Default off Enable support of the WCC Reset bit WCC bit 1 If enabled the emulator will perform reset actions When the WCC Reset bit is on in the WCC of an Erase_Write or Erase_Write_Alternate command This bit is ignored on Write and Erase_all_Unprotected commands If not enabled WCC Reset bit is always ignored R wccReset onl off Default off This will be enabled if gddm support is enabled 12 1 Additional information Note When running the emulator with GDDM support CG3270 functions as an 8 color device To set the window size to 750 x 550 you need to specify the geometry geometry parameter Example geometry 750x550 100 100 Using
161. onverted from ASCII to EBCDIC when stored in the CICS data set Use this option along with cr1f for readable files Do not use this option for binary files Default CICS translates the file from ASCII to EBCDIC Indicates that CICS should not attempt to convert the local file data from ASCII to EBCDIC Default CICS translates the file from ASCII to EBCDIC NOTE Pacific Rim Users if dbcsMode is set pcft translates the data set from DBCS to EUC Indicates that carriage return linefeed characters CR LF act as record separators in the data transferred to the CICS application CICS removes the CR LF characters and marks the end of each record with its own internal end of record marker With this option pcft reads each line of text from the local file and marks the end of each line with CR LF characters before transmitting the data to the CICS application Use this option along with ASCII for readable files Do not use this option for binary files Default CICS inserts end of record markers for CR LF characters Indicates that carriage return line feed characters CR LF do not act as record separators Default CICS inserts end of record markers for CR LF characters Lets you add information regarding the file transfer The character is mandatory when you do not specify options indicate their absence by entering before your comments C 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll C
162. ou are transmitting oversize frames they will be rejected 2 Use the Operator to examine the line statistics If the line condition is poor it may be necessary to increase the retry limit Otherwise you may need to increase the retry timeout value Table E 1 describes the message string components Error Messages E 3 lll m Table E 1 Message String Components Field Function MESSAGE The MESSAGE field contains the message number and its associated string The message number such as ABCD0001 is fixed The message string is similar to a printf formatted string The order of the parameters in the string is fixed The message string can be up to 1016 characters long and cannot contain any blank lines The following parameter insertion values are defined oo n Inserts a string printf s o Q Inserts a decimal integer printf d oo bd Inserts a hexadecimal integer printf 0x 08x oe oe Escapes the so this character can be included in string printf PARAMETERS The parameters in the message string are described in the PARAMETERS field Each parameter is defined on one line This field can be up to 1024 characters and cannot contain any blank lines OPTIONS The OPTIONS field describes how the messages should be displayed Options may include NO_PRINT Do not d
163. oves data to the SUNWopc1 display from the logical clipboard of the same or some other sun3270x display or from the selection highlighted in some non sun3270x window like xterm or cmd tool If the incoming data is a non rectangular cut copy from a SUNWopc1 display or is from a non SUNWopc1 window each line in the data fills in one data entry field in the SUNWopc1 display starting at the position of the 3270 cursor If the screen is unformatted each line in the data fills one screen line If the incoming data is a rectangular cut copy from a SUNWopc1 display the upper left corner of the rectangle of data is placed at the 3270 cursor and the rectangle is dropped as is into the SUNWopc1 display subject only to the restriction that field characters and characters within protected fields are not altered Rectangular cut copy paste is useful for moving or copying data in mainframe text editors such as the TSO editor Using sun3270x 3 43 3 44 User Defined Function Keys User defined function keys enable you to specify a command pipeline to be executed when the key is pressed The user functions may invoke EHLLAPI programs to perform user specific tasks The sun3270 will not wait for the specified command pipeline to complete before continuing Any error status returned by the specified command pipe line is reported through the Child Process Abnormal Termination status pop up window The child process exit status is displayed within
164. ow To activate a Screen Dump request press Action gt Screen Dump To Fixed File Name Write to specified file name To Filename Series Write to specified base file name with numeric index suffix Piped to Script Process Write output to the specified command To Interactive Filename Prompt for action each time dump screen function executed User Keys Displays the User Keys dialog box in which you define the function of menu items User keys appear on the Action menu when the Key Button Title and Command fields are riot NULL The button title appears on the Action menu and the command is executed when the menu item is selected Selecting these buttons is the same as pressing the Customizing sun3270x 4 7 appropriate user defined function keys The command may be any Unix command or pipeline The EHLLAPI session short name is substituted into the command string wherever the special characters are found User Keys M Key Definitions Key Button Title Command Usr2 Usr2 ce Usr3 Usr3 m Usr4 IN Fo Usr5 re EEG Dactu Unit Deactiva a DK l Cancel 4 4 Message Library Updates The text in the sun3270x resources such as buttons and labels can be changed to meet your requirements Sun distributes the Sun Message Database BMD utility with sun3270x The sun3270x resource text strings are stored as messages in the BMD To change the sun3270x resou
165. p sun_open_type 0000000100000000 0000000700000000 0000000000000000 e ke srr eee eee ee rea ee eee 0000000000000000 534c553331000000 5350363300000000 SLU31 SP63 00020000 Sun3270 begins processing event from server 07 26 96 10 50 21 fsm automation Screen owner GR_SSCP_LU State S0 Event EV_SERV_IN Sun3270 recognizes event as open connection 07 26 96 10 50 21 fsm automation Screen owner GR_SSCP_LU State S0 Event EV_OPEN_LU Sun3270 sees that the SSCP LU session is active 07 26 96 10 50 21 fsm automation Screen owner GR_SSCP_LU State S0 Event EV_SSCP_LU_ACT D 2 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example D 1 sun3270 Trace 2 of 9 Sun3270 receives a logon banner from the SNA Host Next two messages are for the banner message the first shows the control and RH indicators and the second shows the 3270 data stream Only part of the banner message is shown 07 26 96 10 50 31 rcv ru sun std type 0000000400000000 0000000700000000 8180000000000000 0000000000020000 07 26 96 10 50 31 rcv ru ru e6c5d3c3d6d4c540 e3d640e3c8c540c9 c2d440e3c5e2e340 WELCOME TO THE IBM TEST 4o 40cld7d7d3c9c44d e75d40d3d6c7d4d6 c4c54de85d40c4c1 APPLID X LOGMODE Y DA 3cl4de95d157e7e 7e6e40 TA Z gt Sun3270 begins processing event from server 07 26 96 10 50 31 fsm automation Screen
166. pc1 user requests help One aliases record can exist for each terminal map defined in the sun3270map file The form of an aliases record entry is alias ASCII character sequence where alias is up to seven characters and ASCII character sequence represents an keyboard input data as defined below B 1 3 Terminal Map Record This record contains the keyboard map and possibly one aliases record for one or more terminal types Multiple terminal types can use the same Terminal Map record list each terminal type placing a between terminal type names The format of a keyboard map entry is Key Cap Name ASCII character sequence oralias where Key Cap Name is an IBM key value name ASCII character sequence represents an keyboard input data as defined below and alias is an alias name defined in the terminal type s aliases record Mapping sun3270tty Keyboards B 5 B 6 B 1 4 ASCII Character Sequence The ASCII input characters sequences are set off by single quotation marks single quotation Multi character sequences can only begin with an escape or control character Special mnemonics exist for these characters use to escape the and characters uu Escape NE Tab Nt Newline Mn Carriage Return Nr Control SunLink Client 3270 9 1 Configuration and User s Guide August 1997 B 1 5 Sample sun3270map File Code Example B 1 Sample sun3270map File 1 of 8 sun3270map oe oe oe
167. play window layout sun3270x menu selections sun3270x status line sun3270x data entry Example login to an IBM host application 3 1 lll Qo Subsequent chapters describe customizing your sun3270x display mapping your keyboard transferring files to and from an IBM host and printing IBM host files 3 1 Starting sun3270x sun3270x is an OpenWindows application You can invoke this application from the command line from a script or as a menu option Many sun3270x programs can run in parallel each sun3270x controls one display window and one session with an IBM host application Use the h host name option to attach a sunpu2 1 SNA server running on a different system in your local area network 3 1 1 Dependencies sun3270x accesses the keyboard map file during startup The default keyboard map file name is sunkeMap sun3270x searches the directories listed in your PATH environment variable to find sunkeMap If the search fails sun3270x announces that it will use an internal default map sun3270x attaches to the sunpu2 1 SNA server sunpu2 1 using the sun pu2 espd service name This entry must exist in the etc services file Normally the installation procedure makes this entry If sun3270x is running on a remote system this service name must have the same port value on both the local and remote systems If you want sun3270x to support EHLLAPI programs an entry must exist in the etc services file that ide
168. plicate operation for field Erase field eeof Erase to end of the current field Erase input ein Erase all unprotected fields Field mark fm Mark the end of a field or a subfield Special Function Systems request sysreq Switch to other session i e LU LU to SSCP LU Cursor select cursel Select the current field if selectable Print dumpscreen Copy screen to file or program Cut cut Cut selected portion of the screen Copy copy Copy selected portion of the screen Daste paste Paste selection to the current cursor position User N user Invoke user defined command defined pipeline N t Sun special function keys Keys valid for sun3270x only The data entry keys are the same on all 3270 terminals The data entry functions include Using sun3270x All alphabetic characters upper and lowercase A through Z Numeric characters characters 0 9 located above the alphabetic keys on the main keypad or on the numeric keypad Non alphabetic characters such as the asterisk punctuation and special symbols located above the alphabetic keys at the bottom and to the right of the alphabetic keys and the numeric keypad 2 33 lll Qo 3 7 Cursor Control The spacebar do not use the spacebar to position the cursor unless text is to be replaced by spaces Shift Shift capitalizes all the alphabetic characters It also causes the top legend of any other key to be entered when pressed in combination wit
169. plication menu 3 Press the System Request key This 3270 key switches you to the SSCP LU session and back again Switch to the SSCP LU session and log off from the application 4 Press Control C SUNWopcl will terminate SunLink Client 3270 9 1 Configuration and User s Guide August 1997 10z 10 5 Common Problems Table 10 1 summarizes the types of problems you may encounter running SUNWopcl along with probable causes and corrective actions Table 10 1 Common Problems and Solutions Symptoms Probable Cause Corrective Action Unable to find keyboard map file message sunkeMap file not found Check if sunkeMap is in your search paths PATH environment variable sun3270 status line Readiness state is disconnected Unable to connect to SunLink 9 1 PU2 1 SunLink 9 1 PU2 1 not up Start SunLink 9 1 PU2 1 sun3270 status line Readiness state is disconnected SunLink 9 1 PU2 1 runs on remote system Unable to ping SunLink 9 1 PU2 1 system Unable to connect to SunLink 9 1 PU2 1 network not up Unable to connect to SunLink 9 1 PU2 1 incorrect hostname specified Unable to connect to SunLink 9 1 PU2 1 services for brxadmin pu2 and brx pu2 espd do not match on both systems Establish network connectivity Invoke sun3270 with hostname of the remote SunLink 9 1 PU2 1 system Use h hostname Ensure etc services files match on both systems Ensure NIS has updated services s
170. pr CTRL D gd CTRL L CTRL U u CTRL X x CTRL Z z CTRL P1 pl CTRL P2 p2 CTRL P3 p3 sun and sun cmd IBM Key ASCII key sequence Enter Enter Clear ESC c SysReq ESC s PA 1 CTRL P1 PA 2 CTRL P2 PA 3 CTRL P3 Left R10 BackSp Right R12 Up R8 Down R14 Home R7 Reset R11 Tab Tab Btab CTRL B Insert Ins Delete Del Newline Return ErsInpt CTRL U ErsEof R1 Attn R3 Dup ESC d FldMark ESC f PF1 L2 PF2 F2 PF3 F3 PF4 F4 PF5 F5 PF6 F6 PF7 F7 PF8 F8 PF9 F9 PF10 F10 PF11 F11 PF12 F12 PF13 ESC PF14 ESC PF15 ESC PF16 ESC S PF17 ESC PF18 ESC PF19 ESC amp PF20 ESC PF21 ESC PF22 ESC PF23 ESC _ PF24 ESC Escape CTRL X ClrFld ESC e Erase R13 Delete Help ESC Status ESC o Reshow CTRL L DmpScrn R2 cent ESC m not ESC n brk ESC v B 14 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Using PCFT C SUNWopc1 supports the transfer of binary ASCII and EBCDIC text files between the local Unix system and IBM host systems that support the IBM 3270 PC file transfer option You can transfer files to and from IBM host systems that support CICS Customer Information Control System CICS VS 5798 DOH Version 1 00 or greater TSO Time Sharing Option MVS 5665 311 Version 1 00 or greater CMS Conversational Monitoring System VM SP 5664 281 Version
171. put 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN Sun3270 receives input from terminal keyboard 07 26 96 10 50 38 read from terminal keyboard 5b Sun3270 recognizes continuing input from terminal input 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 38 read from terminal keyboard 32 2 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 38 read from terminal keyboard 35 5 07 26 96 10 50 38 fsm automation SunLink 3270 Tracing lll v Code Example D 1 sun3270 Trace 5 of 9 Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 38 read from terminal keyboard 30 0 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN 07 26 96 10 50 38 read from terminal keyboard 7a Z 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV TERM IN Sun3270 recognizes input data from terminal as the mapped ENTER key 07 26 96 10 50 38 fsm automation Screen owner GR SSCP LU State S2 Event EV ENTER KEY Sun3270 sends input data to SNA Host Data traced as two messages the first message represents control and RH indicators and the second is th
172. racters with a LF character before writing each text line to the local file Use this option along with ASCII for readable files Do not use this option for binary files Default TSO does not insert CRLF characters to indicate end of record C 6 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 C lll C 1 4 Receive TSO Examples C 2 CICS Options To receive a host TSO data set data set name data abc as a text file name text file in readable format on your Unix system type pcft receive textfile data abc ascii crlf To receive a host TSO data set data set name data def member name binfile as binary file name binfile on your Unix system type 9 pcft receive binfile data def binfile To receive a host TSO data set data set name data def member name binfile as a binary file name binfile on your Unix system and indicate that your TSO User ID should not be prefixed to the indicated data set name type oe pcft receive binfile sys tables mystuff Or oe pcft receive sys tables mystuff The double quotes protect the data set and member name from being interpreted by the Unix shell Back slashes notify the Unix shell that the characters that follow should not be interpreted This section describes the options available for file transfers between Sun s pcft program and a CICS host application Rem
173. rcase characters in the 3270 emulation window s monoCaseMode on off If the requested LU or an LU Type 2 is not immediately available from the sunpu2 1 SNA server the emulator terminates Use the following command to specify this function i immediateMode on off Disable the audible bell function noBell noBell on off Using sun3270x oll 3 12 Disable automatic keyboard grab on mouse entry into the emulation window noGrab noGrab on off nitiate a heartbeat with the Xserver If this value of consecutive heartbeats is missed from the Xserver terminate the Xserver connection and terminate heartbeat heartbeat value Request SUNWopc1 to print the ASCII EBCDIC translation tables during initialization See Chapter 4 Customizing sun3270x for the file format P printTrans Identify the file that contains the appropriate ASCII EBCDIC translation tables See Chapter 4 Customizing sun3270x for the file format a filename asciiEbcdicTableFilename filename Identify the file that contains the appropriate ASCII EBCDIC translation tables and request that sun3270x print the tables during initialization See Chapter 4 Customizing sun3270x for the file format A filename asciiEbcdicTableFilenameAndDump filename Request sun3270 to print the ASCII EBCDIC translation tables used by EHLLAPI during initialization See Chapter 4 Customizing sun3270x for the file format U
174. rce text string update the appropriate message entry in the B327_msglib file See Appendix E Error Messages for more information about displaying and modifying Sun error messages Hx lll 45 ASCII EBCDIC Translations To change the SUNWopcl ASCII EBCDIC translations use the a file name command line argument or the asciiEbcdicTableFilename resource The format of this file is 512 white space separated hexadecimal numbers The character indicates that the remaining part of the line is a comment The first 256 characters are used for the EBCDIC ASCII translation SUNWopcl programs determine the translation of an EBCDIC character by using the EBCDIC code point of the character as an index from the start of the first set of 256 characters The second 256 characters are used for the ASCII EBCDIC translation SUNWopcl programs determine the translation of an ASCII character by using the character s ASCII numeric code as an index from the start of the second set of 256 characters Non mapped characters in the ASCII EBCDIC translation table should be mapped to the NULL character 0x00 An example ASCII EBCDIC translation file for Spanish follows in Code Example 4 2 Customizing sun3270x 4 9 4 10 4 5 1 Sample ASCII EBCDIC Translation Table Code Example 4 2 Example ASCII EBCDIC Translation Table
175. rd functions assigned to one or more X keysyms are saved in the mapping file The combination of geometry and X server keysyms uniquely identifies the keyboard This enables the SunLink 3270 emulation software to search a directory of keyboard files and select the correct one It also enables a single mapping file to be projected on to any keyboard When you modify your keyboard mapping the modification is projected onto any keyboard you use because of the independence of the mapping file It is assumed that a system administrator has created the keyboard files for each keyboard and X server pair employed These files should be maintained in a central directory and restricted from update by everyone except the administrator The administrator should also create an initial mapping file that should also be protected from update Sun ships a mapping file and keyboard files for standard platforms with the SUNWopc1 product A 1 2 Dependencies The sunke program accesses the keyboard map file and keyboard layout file during startup The default keyboard map file name is sunkeMap The default keyboard layout file name is sunkeKbd sunke searches the directories listed in your PATH environment variable to find sunkeMap and sunkeKbd Unless you specify the g and c options sunke will exit if the keyboard map and keyboard layout files are not found SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll A 2 Keywords Ke
176. ream arrives This mode of GDDM is required for GDDM mix modes of OR and XOR for supporting 3 three plane LPS s in graphics layer and for the GDDM crosshair graphics cursor If this mode is not enabled mix modes of OR and XOR are rendered the same as mix mode of OVERPAINT Query responses to the host indicate no support for three plane LPSs Any Load PS structured field with a color field other than 0 is rejected and the GDDM crosshair graphics cursor are unavailable only the cross graphics cursor are available If both the gddm and gddmDirect are given the gddmDirect takes precedence gddmDirect gddmDirectMode on off Default of f The attributes of the main display are changed with the geometry keyword described in Chapter 3 Using sun3270x When using the gddm option the geometry defaults to geometry 750x550 100 100 The type of X cursor to use for the cross style GDDM graphics cursor graphicCursor cursor name graphicCursor cursor nume Default crosshair Enable support for the Load Programmed Symbols structured field during this run of the emulator or not If enabled any query replies from the host indicate support for Load PS and such structured fields is processed when it is seen If not enabled Query replies to the host will indicate no support and any Load PS structured fields seen will be ignored This enables or disables Load PS for both the text layer and the graphics layer loadps loadpsMode
177. ribe the appropriate resource values The SUNWopcl resources file is detailed in Chapter 4 Customizing sun3270x Figure 3 1 illustrates the basic components of the sun3270x window Using sun3270x 3 23 Ui ue eG ZG LAAL L 1iQiqQq iS Q1 o LLQELLCSLLLULLZLLLLLLL 11dS ULL sun3270x File Edit Action Settings P P P PP P P P P P PPPPF PPP P P P PPP PPP ee P P P PPP PPP chitecture COMMAND RUNNING Figure 3 1 The sun3270x Window The sun3270x window is composed of four major parts Window Frame Contains the generic title bar and window border provided by the system window manager Main Menu The main menu enables you to choose sun3270x options like displaying the keyboard mapping executing file transfers and changing sun3270x settings dynamically A quit button also enables for simple exit 3 Matte Matte is the textured background surrounding the 3270 emulation screen display A matte varies in size depending on the dimensions of the window and the available font sizes sun3270x operates in a best fit mode as you expand or shrink the window sun3270x fills the interior of the window with the 3270 emulation screen display 3270 Emulation Screen The 3270 emulation screen displays data transmitted by IBM host applications and accepts your keyboard input The 3270 emulation screen also contains an Operator Information Area OIA or Status Line at th
178. rk fm PF1 pfl PF2 pf2 PF3 pf3 PF4 pf4 PF5 pf5 PF6 pf6 PF7 pf7 PF8 pf8 PF9 pf9 PF10 pf10 PF11 pf11 PF12 pf12 PF13 pf13 PF14 pf14 PF15 pf15 PF16 pfl16 PF17 pf17 PF18 pf18 PF19 pf19 PF20 pf20 PF21 pf21 PF22 pf22 PF23 pf23 PF24 pf24 Special Sun function keys Escape escape ClrFld clrfld Erase erase Help help Status status Reshow reshow DmpScrn dmpscr Mapping sun3270tty Keyboards B 9 Code Example B 1 Sample sun3270map File 4 of 8 Non display and non ASCII characters space 40 cent 4a not 5f brk 6a Characters which need names because they are also interpretable sun3270map special characters SemiCln 5e LBrace c0 RBrace d0 SQuote 7d The rest a 81 b 82 c 83 d 84 e 85 f 86 g h 88 i 89 j 91 k 92 l1 93 m 94 n o 96 p 97 q 98 r 99 s a2 t a3 u Vv a5 w a6 x a7 y a8 z a9 A C1 B C2 C C3 D C4 E C5 F c6 G H c8 I c9 J d1 K d2 L d3 M d4 N O d6 P d7 Q d8 R dg S e2 T e3 U V e5 W e6 X e7 Y e8 Z e9 0 0 1 f1 2 2 3 3 4 f4 5 5 6 7 7 8 8 9 9 4b lt 4c 4d 4e 4f amp 50 5b 5c 5d 60 61 6b _ 6d gt 6e 6f 79 7a 7b 7e 7f al e0 87 95 a4 c7 d5 e4 f6 5a 6c 7c B 10 SunLink Client 3270 9 1 Configur
179. rks or registered trademarks of SPARC International Inc in the U S and other countries Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems Inc The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems Inc for its users and licensees Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry Sun holds a non exclusive license from Xerox to the Xerox Graphical User Interface which license also covers Sun s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun s written license agreements DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS REPRESENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID Copyright 1997 Sun Microsystems Inc 2550 Garcia Avenue Mountain View Californie 94043 1100 U S A Tous droits r serv s Ce produit ou document est prot g par un copyright et distribu avec des licences qui en restreignent l utilisation la copie et la d compilation Aucune partie de ce produit ou de sa documentation associ e ne peut tre reproduite sous aucune forme par quelque moyen que ce soit sans l autorisation pr alable et crite de Sun et de ses bailleurs de
180. roke For displayable characters the Key value is the character s EBCDIC code point e g A OxC1 To support a UK English keyboard for example you need to add the EBCDIC value Pound 5B SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Az For the 3270 AID keys 3270 function keys and the Sun special function keys an associated string identifies the Key Value Table A 1 contains a list of these key value strings listed under mnemonics Table A 1 Keyboard Functions Function Mnemonic Description Cursor control Backtab backtab Move cursor to previous field Cursor Down down Move cursor down one line Cursor Left left Move cursor left one character Cursor Right right Move cursor right one character Cursor Up up Move cursor up one line Home home Move cursor to first field New Line newline Move cursor to first field on next line Tab Forward tab Move cursor to next field Start stop data entry Attention attn Request for sending data Clear clear Clear screen Enter enter Initiate transfer of data to host Function Keys PF1 24 pfl pf24 Initiate transfer of data to host Program Access PA1 3 pal pa3 Initiate transfer of data to host Reset reset Clear input inhibited status or insert mode Editing mode Delete delete Delete character at cursor position Insert Mode insert Insert character at cursor position Field control t Clear Field clearfield
181. sateurs d interfaces graphiques OPEN LOOK et qui en outre se conforment aux licences crites de Sun CETTE PUBLICATION EST FOURNIE EN L ETAT SANS GARANTIE D AUCUNE SORTE NI EXPRESSE NI IMPLICITE Y COMPRIS ET SANS QUE CETTE LISTE NE SOIT LIMITATIVE DES GARANTIES CONCERNANT LA VALEUR MARCHANDE L APTITUDE DES PRODUITS A REPONDRE A UNE UTILISATION PARTICULIERE OU LE FAIT QU ILS NE SOIENT PAS CONTREFAISANTS DE PRODUITS DE TIERS Recycle Contents go MP xv 1 Introduction to SUNWopcl eee nnn 1 1 1 1 SUNWopcl Client 0 0 1 3 1 2 SUNWopcl Emulation llle lees 1 4 1 3 Keyboard Mapping 222uiast eines ee C4 serrr SEEN UA 1 7 1 4 Configuring SUNWODOl 2234344 ev yk ed eed ex dad 1 7 2 Getting Started with SUNWopcl cece eee eee ee eee 2 1 2 1 Installing SUNWOBOL lt iv vecurwecedccouee ee eer es ews 2 2 2 2 Coordinating Configurations lt cceei esse ever en 2 3 2 3 Confheunne BUNWNGDOT quax qued ae edi od 2 3 24 Staring SUDnpUeloseepe a p baduEs Wes ue gba a 2 4 20 Starting SUNWODET sack Re RR beeen UR beri 2 5 26 Stopping sunpuA l ask RRERIUUA Axe EU Rr e 2 6 3S Using suni 70 cscs cei bens dese Posse osnan ssas RR RARE 3 1 3 1 Starting und POR o RPPERRERE EE RE Eie ird 3 2 iii DET DOBOOBCIeS eoe wet tie ube Wer pe n 3 2 SNSeMEdI a m 3 3 3 1 3 LU Attachment Keywords 2442 4 oce ote 3 3 3 1 4 Keyboard Map Attributes 014 46 estos
182. ssion name is specified as e ehllapi name ehllapiName ehllapi name sun3270x takes ehllapi_name as the name EHLLAPI programs use to reference sun3270 display and keyboard buffers The ehllapi name must be one character in the range A through Z 0 through 9 or a through z You can also specify the EHLLAPI session name in the sunpu2 1 SNA server configuration see the SunLink SNA 9 1 PU 2 1 Server Configuration Guide Using sun3270x 35 3 6 3 1 6 Color Display Attributes You can define what colors to use when representing the IBM color scheme for 3270 displays Use the X color names or define the color with red green blue RGB weights following the XParseColor conventions Note that you can choose the color of the 3270 display background The IBM color keywords are listed in Table 3 1 Table 3 1 IBM Color Keywords and Display Attributes IBM Color Index The default X Color Keyword 1 10 11 12 medium slate blue red magenta green cyan yellow white black dark slate blue orange violet pale green ibmBlue color ibmBlue color ibmRed color ibmRed color ibmPink color ibmPink color ibmGreen color ibmGreen color ibmTurq color Turq color ibm ibmYellow color ibmYellow color ibmWhite color ibmWhite color ibmBlack color ibmBlack color ibmDeepBlue color ibmDeepBlue color ibmOrange color ibmOrange color
183. stFilename Host system file name ftCicsHostFilename Host system file name Specify the password used for TSO data set password protection See Chapter 6 Using File Transfer for more information on this parameter ftTsPassword Password ftTsPassword Password Specify the direction of the file transfer operation The default Send ftTsSendReceive Send Receiv ftTsSendReceive Send Receiv Using sun3270x 3 15 3 16 Specify the transfer property for the receiving file See Chapter 6 Using File Transfer for more information on this parameter ftTsCreateAppend Create Append ftTsCreateAppend Create Append Specify the transfer mode for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsBinaryAscii Binary ASCII ftTsBinaryAscii Binary ASCII Specify the CRLF for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsCrlfNocrlf Crlf Nocrlf ftTsCrlfNocrlf Crlf Nocrlf Specifies the desired logical record length for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsLrecl logical record length ftTsLrecl logical record length Specify the desired block size for the file transfer operation See Chapter 6 Using File Transfer for more information on this parameter ftTsBlksiz
184. stand the 3270 data entry and display characteristics As a system operator you will learn how to invoke the sun3270x emulation capabilities as well as how to map the behavior of real 3270 devices to the same functions provided by sun3270x You should understand how SUNWopcl interacts with the SNA network as described in Chapter 1 If you are an EHLLAPPI programmer this manual will show you how to invoke SUNWopcl as an EHLLAPI server application For Pacific Rim customers this manual includes information on DBCS functionality Appendix D SunLink 3270 Tracing contains additional keywords How This Book Is Organized This book is organized as follows Chapter 1 Introduction to SUNWopcl provides a conceptual overview of SUNWopcl and serves as background for subsequent chapters Chapter 2 Getting Started with SUNWopcl describes the steps you take to install configure and start SUNWopcl Chapter 3 Using sun3270x specifies how to use the SUNWopc1 data entry and display characteristics in the Solaris environment Chapter 4 Customizing sun3270x defines how to change the various attributes of the SUNWopc1 display via the SUNWopc1 pull down menus xvi SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Chapter 5 Using Keyboard Mapper describes the SUNWopc1 graphical keyboard map which displays the mapping of SUNWopc1 keyboard functions to keys available on the local Sun workstation termina
185. t application Required positional parameter local_file Pathname of file on local system Required positional parameter n n is LU session to use for transfer EHLLAPI session name A H Optional positional parameter Default is A host file TSO data set name on IBM host Refer to the IBM OS VS2 Command Language Reference manual for more information about TSO data set names and properties Required positional parameter member name Name of member in the TSO data set specified by lost file Optional positional parameter Follows host file immediately no space separators password Password used for TSO data set under password protection Optional positional parameter Follows host fileimember name immediately no space separators options TSO supports the following receive options append Appends the contents of the TSO data set to the local file Optional parameter ascii Indicates to TSO that the TSO dataset should be converted from EBCDIC to ASCII when transferred to the local file Use this option along with cr1f for readable files Do not use this option for binary files Default TSO does not translate the file from EBCDIC to ASCII Grlf Indicates that carriage return line feed characters CR LF act as record separators in the data transferred from the TSO application to the local file TSO adds the CR LF characters where its own internal end of record markers indicated end of records With this option pcft replaces the CR LF cha
186. t name can be up to 8 characters long Refer to the IBM Customer Information Control System CICS OS VS Version 1 Release 6 Installation and Operations Guide manual for more information about CICS data set names and properties Required parameter The VM CMS file name can be up to 8 characters Refer to the IBM Virtual Machine System Product CMS User s Guide for more information about VM CMS file names and properties The format of the type in field is file name file type file mode VM CMS file type Required positional parameter VM CMS file mode Optional positional parameter Default is A1 Create the target file File transfer cannot create a partitioned data set under TSO or CICS It can create new members in an existing partitioned data set Append the contents of the transferred file to the target file append cannot be used for members of a partitioned data set The logical record length and record format values are the same as the original data set Indicates that the transferred data is ASCII Use this option along with cr1f for readable files Do not use this option for binary files Using File Transfer 6 5 lll O Table 6 1 File Transfer Options Continued Option Function binary Indicates that the transferred data is BINARY CRLF Option crlf Indicates that carriage return linefeed characters CR LF act as record separators in the data transferred to the IBM host On data transferred from the IBM host
187. ters with a LF character before writing each text line to the local file Use this option along with ASCII for readable files Do not use this option for binary files Default VM CMS does not insert CRLF characters to indicate end of record C 4 1 Receive VM CMS Examples To receive a host VM CMS file name data as a text file name textfile in readable format on your Unix system type pcft receive textfile data basic al ascii crlf To receive a host VM CMS file name data1 as binary file name binfile on your Unix system type 9 pcft receive binfile datal basic al Using PCFT C 13 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 SunLink 3270 Tracing D To aid you in troubleshooting sun3270 has internal tracing capabilities To turn on the trace utility start the appropriate emulator with the t option For example to start sun3270x with tracing enabled use the following command sun3270x t 1 The sun3270tty suntn3270x and suntn3270tty emulators can all be started in this way The t option with the 1 argument requests sun3270 to dump all encountered internal trace points Chapter 3 Using sun3270x describes sun3270 start options sun3270 records all trace points in the sunlib pid file in the current working directory This file is reused after recording 1000 trace points the older trace information is saved in sunlib_pid 1 The trace poin
188. th a real name or value Book titles new words or terms words to be emphasized Symbol Meaning Example AaBbCc123 The names of commands Edit your login file files and directories Use 1s a to list all files on screen computer output You have mail AaBbCc123 What you type when su contrasted with on screen Password computer output AaBbCc123 Command line variable To delete a file type rm filename Read Chapter 6 in the User s Guide These are called class options You must be root to do this Preface xix Shell Prompts in Command Examples The following table shows the default system prompt and superuser prompt for the C shell Bourne shell and Korn shell Table P 1 Shell Prompts Shell Prompt C shell machine name C shell superuser machine namef Bourne shell and Korn shell Bourne shell and Korn shell superuser Ordering Sun Documents XX SunDocs is a distribution program for Sun Microsystems technical documentation Easy convenient ordering and quick delivery is available from SunExpress You can find a full listing of available documentation on the World Wide Web http www sun com sunexpress Table P 2 SunExpress Contact Information Country Telephone Fax United States United Kingdom 1 800 873 7869 0800 89 88 88 1 800 944 0661 0800 89 88 87 Canada 1 800 873 7869 1 800 944 0661 France 0800 90 61 57 0800 90 61 58 Belgium 02 720 09 0
189. the WCC Reset bit is on in the WCC of an Erase Write or Erase Write Alternate command This bit is ignored on Write and Erase all Unprotected commands If not enabled WCC Reset bit is always ignored The default is OFF R WccReset on off Note This will be enabled if gddm support is enabled When running the suntn3270 with GDDM support it functions as an 8 color device Using suntn3270x 11 5 Em 11 38 Stopping suntn3270x You can terminate the suntn3270x display in the following ways Click the Quit button Use the Title Bar Menu Most window managers provide a quit function in the menu associated with the window frame Kill the suntn3270x process When killed suntn3270x is terminated 11 4 suntn3270 Status Line The current status of the emulated 3270 display station is continuously displayed on the last line of the suntn3270x emulation screen below the horizontal bar Figure 11 1 illustrates a status line that shows that the user is currently connected to the TN3270 server connected the host is busy processing Wait the display is in insert mode the TN3270 server is located on host BigBlue with port number 23 the EHLLAPI session name is A and the cursor is on row 10 column 4 TN3270 server Insert mode Port EHLLAPI session name connection status Wait Insert BigBlue 23 Keyboard readiness TN3270 server hostname Cursor location Figure 11 1 suntn3270 Status Line 11 6
190. the entire screen as one field and additionally insert will span lines and the end of screen SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll 3 10 Field Control Delete Delete helps delete the character at the cursor in a data entry field The cursor does not move from its current location and any characters to the right shifts one position to the left Vacated character positions at the end of the fields are filled with null characters A separate delete action must be performed for each character that is to be deleted The following field control keys affect the format or structure of fields Clear Field Clear Field is a Sun special function key that erases the current field and positions the cursor to the field s first character location Delete Left Delete Left is a Sun special function key that positions the cursor one character to the left and deletes the character in that position DUP DUP duplicates the information from the previous record in a data entry field When you use this function SUNWopc1 displays an asterisk and a tab function is performed SUNWopcl transmits a code represented by the displayed asterisk to the host application program Upon receipt of the code the host application program initiates a duplication operation where the asterisk code is located Erase Input Erase Input erases all data entry fields The cursor is repositioned to the first locatio
191. ths I file name inKbdFilename file name Path name of the keyboard file to create when changes are recorded for the current keyboard map Default is to overwrite the current keyboard map file o file name outMapFilename file name Path name of the keyboard file to create when changes are recorded for the current keyboard layout Default is to overwrite the current keyboard layout file O file name outKbdFilename file name A 2 2 Window Attributes The following text describes the window attributes related to this program Width of the surrounding sides of a displayed key sunke attempts to create keys with the approximate width specified Default is 6 pixels maxBevelWidth pixel number maxBevelWidth pixel number Size and position of the sunke display window The values are in pixel units The form obeys the X geometry construct as defined by XParseGeometry Default is 900X750 100 100 geometry widthxheight Xposition Yposition geometry widthxheight Xposition Yposition Path name of the file containing an icon for sunke Default is Sun icon iconFilename file name iconFilename file name A 4 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 pee lll Title string for the X window Title Bar Default is the name of the sunke program title title name title title name String describing the keyboard mapper product and version of the keyboard map file titleR
192. tion TABs must be greater than or equal to LM and less than or equal to RM The maximum number of TABs that may be specified is 255 The default values are 1 4 8 16 20 24 128 132 V vertical format Defines the default vertical format for the presentation space This parameter is only valid while operating as an LU Type 1 The vertical format is specified as follows MPL TM BM TAB1 TAB2 TABn See Table 7 3 Table 7 3 Vertical Format Specifiers Specifier Function MPL The maximum presentation line specifies the vertical extent of the presentation surface The default value is 66 TM The top margin specifies the line value of the top presentation line on the page TM also serves as the first vertical tab stop This value must be less than or equal to the MPL The default value is 1 BM The bottom margin specifies the line value of the bottom presentation line on the page BM must be greater than or equal to TM and less than or equal to MPL The default value is MPL TAB Vertical tab stops specifies the line values for the vertical tab VT function TABs must be greater than or equal to TM and less than or equal to BM TAB stop parameters 1 through 11 are also used to the line values for corresponding control channels 2 through 12 channel 1 is set by the TM The maximum number of TABs that may be specified is 255 The default values are 1 8 16 24 64 Using sun3287 75 7 6
193. tion The format of the command is identical to the user button command string dactCommand LU deactivation command string dactCommand LU deactivation command string 3 1 15 sun3270x Command Line Configuration Examples To attach a sunpu2 1 SNA server on a remote system named bruno type 9 5 sun3270x h bruno To attach to an LU named BLU01101 on the local system and serve as the EHLLAPI presentation space named A type 5 sun3270x 1 BLUO1101 e A dud SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Qo lll To change IBM color blue to the X color light blue and display the sun3270x window on the remote system named bruno type sun3270x ibmBlue light blue display bruno 0 0 If you have set up your SUNWopcl resources file and you want to identify resource values associated with instance name D1 type sun3270x name D1 3 2 sun3270x Window Layout The sun3270x window can be displayed on all systems that support an X server It inter operates with OpenWindows and X Window Manager window managers The sun3270x window can be moved and resized it can be closed iconified and then re opened On color consoles sun3270x uses all sixteen IBM colors on monochrome consoles sun3270x runs in black and white You can choose the colors and operational characteristics of the sun3270x window by using the SUNWopcl resources file to desc
194. ts record all information received and sent to the sunpu2 1 SNA server and all information received and sent to the terminal Trace points have this format 07 26 96 10 50 21 fsm automation Screen owner GR_SSCP_LU State SO Event EV_OPEN_LU Each trace point contains the following information Date and time time trace point recorded in seconds Component the device recording this trace point Information string general description of type of trace point Hexadecimal message dump or information string optional lll J The most common types of trace points are fsm automation Process events captured by sun3270 rcv ru Receives message from SNA host through sunpu2 1 SNA server send ru Sends message to SNA host through the sunpu2 1 SNA server read from terminal Inputs data read from the terminal An example of trace points is listed and described in Code Example D 1 Code Example D 1 sun3270 Trace 1 of 9 07 26 96 10 50 21 start screen LI LI 25 07 26 96 10 50 21 start screen CO CO 81 Sun3270 requests connection to sunpu2 1 SNA Server 07 26 96 10 50 21 sun open port open request 0002000000000000 0000000000000000 0000000000000000 ee BR 0000000000000000 0000000000000000 0000000000000000 eee MAR 0000000000000000 0000000000000000 0000000000000000 eR Sun3270 receives open connection response from sunpu2 1 SNA Server 07 26 96 10 50 21 open_lu_rs
195. un3270 status line Readiness state is disconnected sunop shows LU active Another application is using port or lutype 2 Check lutype 2 use another LU sun3287 reports LU unavailable sunop shows LU active Another application is using port or lutype 3 Check lutype 3 use another LU sun3270 status line Readiness state is disconnected sunop dis shows LU Inactive SNA Host has not activated the LU Request SNA system programmer to activate the LU sun3270 reports opening of EHLLAPI server Unable to find EHLLAPI service name Ensure that etc services contains sunehllapiA through sunehllapiH services Inverse video for highlighting TTY inverse mode not set properly Update etc termcap file entries for mode not set appropriately Ensure so and se standout Using default map message sun3270map file not found Check search paths for sun3270map Ensure TERM environment variable is defined in sun3270map SUN Wopcl Troubleshooting 10 5 i Table 10 1 Common Problems and Solutions Continued Symptoms Probable Cause Corrective Action Logon failed 0821 sense code received Bad session parameters Use LOGMODE D4A32782 or similar sun3270 status line Mode state is Wait Improper operation executed See previous section for recovery steps Error from move x y Screen window sized too small Resize screen
196. usageMode on off Using sun3270x 3 13 3 14 Trace mode of operation The supplied value for the trace flag is used to determine which internal traces are captured in the sun3270x trace log for debugging The bits in the trace flag value indicate which trace to activate The value of the trace flag may be specified according to the syntax recognized by strtol 3 The defined traces and associated trace flag values are as follows t trace flag traceFlag trace flag Trace files are created in tmp and named sunlib pid and sunlib pid 1 Traces accumulate in sunlib_pid until 1000 trace points have been logged Then this file is renamed sunlib_pid 1 and tracing continues in sunlib pid 0x0001 trace buffers to from SNA Server API 0x0002 trace buffers from the keyboard and to the screen 0x0004 trace information on internal Finite State transitions When sun3270 settings are saved in a resource file selecting this option applies the changed settings into the current operation savelmpliesApplyMode SavelmpliesApplyMode Causes sun3270 to preserve the current layout of any resource files and simply updates the changed resources This is helpful for commented resource files mergeResourcefile mergeResourcefil The left mouse button controls the cursor position leftMouseCurPostionMode leftMouseCurPostionMode Enables you to cut and paste lines into the text at the current cursor position The pasted
197. ust 1997 stopping suntn3270x 11 6 stream command 7 4 sun3270 sample map file B 7 sun3270 trace D 2 sun3270 tracing capabilities D 1 sun3270tty keyboard map utility B 1 sun3270tty dependencies 13 2 sun3270tty examples 13 6 sun3270tty intensified support 13 3 sun3270tty keywords 13 3 sun3270tty status line 13 2 sun3270x status line 3 28 stopping 3 28 sun3270x resources 4 1 sun3270x window 3 23 sun3270x window layout 3 23 sun3270x window parts 3 24 sunke keyboard functions teaching A 28 starting A 1 sunke customizing A 8 sunke files A 2 sunop 2 6 suntn3270 dependencies 11 2 suntn3270 examples 11 7 suntn3270 keywords 11 2 suntn3270x 11 1 status line 11 6 suntn3287 keywords 7 7 starting 7 7 SUNWopcl applications 1 3 SUNWopcl capabilities 1 1 SUNWopcl client 1 3 SUNWopcl emulation 1 1 1 4 SUNWopcl resource example 4 3 SUNWopcl screen 1 5 X tab forward 3 36 Telnet 3270 emulation 11 1 terminal map record B 5 Time Sharing Option C 1 trace points D 1 format D 1 trace flag 7 6 transferring files 6 2 translation table sample ASCII EBCDIC 4 10 translation name 7 6 troubleshooting common problems 10 5 troubleshooting sun3270 10 1 troubleshooting utilities BMD 10 1 logical data scope 10 1 SunLink PU2 1 operator 10 1 TSO 6 2 TSO options C 3 TSO READY 6 2 U unmapped IBM keys 5 5 unsupported terminal functions 1 7 User Keys dia
198. ustomizing the sun3270x Keyboard A 9 To support a new keyboard follow these steps 1 Define an IBM key caps file 2 Define a keyboard geometry file 3 Teach sunke keyboard functions 4 Map the IBM key caps to your new keyboard The following sections outline these steps After defining the keyboard layout you no longer need to specify the keyboard geometry or IBM key caps file sunke stores away their information when you click the File button on the sunke display A 4 1 Defining an IBM Key Caps File The IBM key caps file contains all the IBM key values that can be mapped to your keyboard Start with the example file NAEnglishCaps You can add values or delete values from this file When sunke is started with the c option to specify the new IBM key caps file sunke displays the entries in this file in the un mapped IBM key values section of the display see Chapter 5 Using Keyboard Mapper for an illustration of sunke display IBM key values fall into four categories 3270 AID keys 3270 function keys Sun special function keys EBCDIC characters The format of the IBM key caps file is simple Some entries of the form include Key Cap Name Key Value The Key Cap Name becomes the string associated with the IBM key value Key Cap Names can be up to 5 characters sunke displays the Key Cap Name you move the Key Cap Name to keys in the keyboard layout to map the Key Cap Name s associated IBM key value to a keyst
199. wish ASCII keystrokes to IBM key value mappings Actual keyboard map for sun and sun cmd keyboards You can change IBM key value to ASCII keystroke mappings When sun3270tty starts it references your local environment variable TERM to determine the terminal type These programs then search the sun3270map to find matching the TERM type entry These programs locate the sun3270map file by looking through your search paths as specified in your PATH environment variable You can change and add to these entries to customize the keyboard map to your liking For example if you have a different terminal type you will need to make another keyboard map entry for you new terminal type Also you can associate IBM key values to different keys on your keyboard maybe you prefer the IBM key Erase to end of field eeof to be mapped to Escape Q ESC Q B 8 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 4d Code Example B 1 Sample sun3270map File 3 of 8 ibmCaps record ibmCaps Non display IBM keys special functions and AID keys Enter enter Clear clear SysReq sysreq PA 1 pal PA 2 pa2 PA 3 pa3 Left left Right right Up up Down down Home home Reset reset Tab tab Btab btab Insert insert Delete delet Newline nl ErsInpt einp ErsEof eeof Attn attn Dup dup FldMa
200. x 3 19 indicates NO support and any Load PS structured fields seen will be ignored This enables disables Load PS for both the Text Layer and the Graphics Layer The default is OFF loadps loadpsMode on off Path name of the bitmap file to read and use for GDDM standard fill pattern number i Values for i are 1 14 The default is gddmPat i Examples gdamPati1 gddmPat5 gddmPat 12 etc gddmPati filename gddmPati filename Causes the sun3270 to consider GDDM datastream coordinate value 0 0 to be the upper leftmost pixel in the Graphics Layer and so forth rather than considering 0 0 to be the center of the Graphics Layer which is the normal interpretation A small number of hosts do consider datastream 0 0 to be the upper left pixel in the Graphics Layer hence this switch The default is OFF gddmUpperLeft gddmUpperLeftMode on off Enables support of the WCC Reset bit WCC bit 1 If enabled the sun3270 performs reset actions described in the IBM 3270 Information Display Station Data Stream Programmer s Reference when the WCC Reset bit is on in the WCC of an Erase Write orErase Write Alternate command This bit is ignored on Write and Erase all Unprotected commands If not enabled the WCC Reset bit is always ignored The default is OFF R wccReset on off Note This bit will be enabled if gddm support is enabled When running sun3270 with GDDM support it functions as an
201. y 15 300 80 40 specifies a key in absolute position 15 300 with a height of 80 units and a width of 40 units If the next entry is 45 then the next key is positioned 45 units greater in the X coordinate 60 300 and the size of the key is the same as the previous entry the Y coordinate height and width take the values of the previous entry Note the function buttons the un mapped IBM KeyCaps row and the display banner also are in the keyboard display window To invoke sunke c NAEnglishCaps g sun4Geom Customizing the sun3270x Keyboard A 21 lll aN Code Example A 2 Example Keyboard Geometry File 3 of 8 i Function Key Row top row of a sun4 keyboard r r nd ai X Y Height Width i i 15 300 80 40 Ll 45 i L2 120 Fl 45 F2 45 F3 45 F4 45 F5 45 F6 45 F7 45 F8 45 F9 45 F10 45 Fil 45 F12 45 RON 45 0 80 90 Delete 815 0 80 40 7 RL 45 R2 45 R3 45 Num Lock A22 SunLink Client 3270 9 1 Configuration and User s Guide August 1997 Code Example A 2 Example Keyboard Geometry File 4 of 8 Numbers Key Row second row of a sun4 keyboard Height Width k 0 80 40 s R3 80 90 80 40 E E u e Q QOO MAI HOB WY bP EL Back Space R4 R5 R6 Num Pad Customizing the sun3270x Keyboard A 23 lll aN
202. ype 2 the default A sun3287 printer emulator can only attach to LUs configured as lutype 3 The sun3278 printer emulator will function as either a SNA LU Type 1 or LU Type 3 depending on the SNA BIND command received For the sample configuration the particularly relevant parameters and their values in the sunpu2 1 SNA configuration are listed in Table 2 1 Note that a 3287 printer is not configured Table 2 1 Example Configuration Parameters sunpu2 1 sunpu2 1 Parameter Directive Parameter Value Comment SDLCLINE DUPLEX FULL Point to point line LINE LEASED Line is non switched NRZI NO Non return to zero encoding SPEED 9600 Line speed in bits per second PU2 ADDR eq Line station address LU LOCADDR 2 Logical port for LU LUTYPE 2 3270 display default value LU LOCADDR 3 Logical port for LU LUTYPE 2 3270 display default value LU LOCADDR 4 Logical port for LU LUTYPE 2 3270 display default value 2 4 Starting sunpu2 1 2 4 Note The recommend method for starting sunpu2 1 is to use the SunGMI After coordinating the SNA host network configuration and the local sunpu2 1 SNA server configuration you are ready to start the sunpu2 1 SNA server The SunLink SNA PU2 1 9 1 Server Configuration and Administration Manual lists the options for invoking the sunpu2 1 process This manual has a troubleshooting chapter Chapter 10 SUNWopcl Troubleshooting to aid
203. ywords control the sunke program and define New keyboard files Keyboard map file path name Keyboard layout file path name Window color scheme Window attributes Generic X keywords All the sunke keywords have parallel entries in the sunke resources file sunke reads the sunke resources file during startup You can update this file to customize your sunke program The resource name for each keyword is under the keyword and is prefixed with a period A 2 1 Keyboard Layout Definition Files The following text explains different definition files and keyboard layout definitions Path name of the file containing a keyboard layout definition Default is none g file name inGeometryFilename file name Path name of the file containing the IBM key values and their associated reference names The format of this file is described in Section A 4 Creating a New Keyboard Layout Default is none c file name inKeycapsFilename file name The following arguments control which keyboard map file and keyboard layout file to read on startup and which files to update when the keyboard map or keyboard layout is changed Path name of the file containing the keyboard map file Default is sunkeMap in your current search paths i file name inMapFilename file name Customizing the sun3270x Keyboard A3 lll aN Path name of the file containing the keyboard layout file Default is sunkeKbd in your current search pa

3 - Oracle Documentation

Contents

Download Pdf Manuals

Related Search

Related Contents