1XX_SH(Menus) 2XX_FB(x3270) has a menu bar with three pull-down menus (File, Options, and 3Connect) and a button to turn the keypad on and off. 4The pull-down menus are also available as pop-up menus by using the "Ctrl" 5key and the left, middle and right mouse buttons, respectively. 6XX_PP 7The menu bar can be turned off by setting the "x3270.menuBar" resource to 8XX_FB(false.) 9XX_PP 10Many sections of the File and Options menus are toggles, 11options that may be either on or off. 12The entries under the File menu are as follows: 13XX_TPS()dnl 14XX_TP(XX_FB(File Transfer)) 15Initiates transferring a file between the IBM host and the local workstation, 16using the XX_FB(IND$FILE) protocol. 17A pop-up menu allows specifying the file names and other attributes of the 18transfer. 19XX_BR() 20The IND$FILE program must be installed on the IBM host, and the 3270 cursor 21must be located in a field that will accept a TSO or VM/CMS command. 22XX_TP(XX_FB(Printer Session)) 23Starts or stops a printer session. 24XX_TP(XX_FB(Trace Data and Events)) 25If set, network traffic (both a hexadecimal representation and its 26interpretation) is logged to the file 27XX_FB(/tmp/x3trc.)`'XX_FI(pid), 28and a window is popped up to monitor the data. 29The file name is confirmed with a pop-up; the default directory name for the 30trace file can be changed with the "x3270.traceDir" resource. 31Keyboard and mouse events are also traced. 32This is useful for creating and debugging custom keymaps, macros 33and scripts. 34For example, it will tell you precisely what action was taken in response to 35pressing a particular key. 36If the key is not mapped, it will tell you the keysym name and keycode so you 37can add it to a custom keymap. 38XX_TP(XX_FB(Save Screen Contents)) 39Allows the contents of the screen to be saved. 40A dialog allows selection between continuous saving (a new image added each 41time the screen changes) or just a snapshot. 42It also allows switching beteen saving to a file and writing directly to the 43printer. 44If the screens are saved to a file, the dialog allows a choice between 45text, HTML or RichText output. 46By default, the file name is XX_FB(/tmp/x3scr.)`'XX_FI(pid)XX_FB(.)`'XX_FI(type) 47in /tmp. The default directory name can be changed with the "x3270.traceDir" 48resource. 49The dialog also allows the default print command (XX_FB(lpr)) to be changed. 50XX_TP(XX_FB(Print Window Bitmap)) 51Uses the XX_FB(xwd) and XX_FB(xpr) commands to print a copy of the graphical 52screen contents. 53XX_TP(XX_FB(Save Changed Options in File)) 54Saves into a file the values of all options that have been changed since 55XX_FB(x3270) was started. 56A pop-up allows the file name to be changed; the default file 57is XX_FB(.x3270pro) in the XX_POSESSIVE(user) home directory. 58If the file already exists, it is appended to. 59XX_FB(x3270) will read the contents of this file the next time it starts up. 60The options settings in the file override any resources defined 61with XX_FB(xrdb) or in the XX_POSESSIVE(user) XX_FB(.Xdefaults) 62file; command-line switches override the file. 63A different options file can be specified by the XX_FB(X3270PRO) 64environment variable. 65If the environment variable XX_FB(NOX3270PRO) 66is set, no options file will be read. 67XX_TP(XX_FB(x3270 Prompt)) 68Opens an interactive window for entering actions and viewing their output. 69This allows experimentation with actions without having to edit keymaps 70and repeatedly restart XX_FB(x3270). 71XX_TP(XX_FB(Toggles)) 72The toggles under the Options menu are as follows: 73XX_TPS()dnl 74XX_TP(XX_FB(Monocase)) 75If set, XX_FB(x3270) operates in uppercase-only mode. 76XX_TP(XX_FB(Blinking Cursor)) 77If set, the cursor blinks once per second. 78XX_TP(XX_FB(Blank Fill)) 79If set, XX_FB(x3270) behaves in some un-3270-like ways. 80First, when a character is typed into a field, all nulls in the field to the 81left of that character are changed to blanks. 82This eliminates a common 3270 data-entry surprise. 83Second, in insert mode, trailing blanks in a field are treated like nulls, 84eliminating the annoying XX_DQUOTED(lock-up) that often occurs when inserting into an 85field with (apparent) space at the end. 86XX_TP(XX_FB(Show Timing)) 87If set, the time taken by the host to process an XX_SM(AID) is displayed on 88the status line. 89XX_TP(XX_FB(Scrollbar)) 90If set, the scrollbar appears. 91XX_TP(XX_FB(Wraparound)) 92If set, the XX_SM(NVT) terminal emulator automatically assumes a XX_SM(NEWLINE) 93character when it reaches the end of a line. 94XX_TP(XX_FB(Paste with Left Margin)) 95If set, puts restrictions on how pasted text is placed on the screen. 96The position of the cursor at the time the `paste' operation is begun is 97used as a left margin. 98No pasted text will fill any area of the screen to the left of that 99position. 100This option is useful for pasting into certain XX_SM(IBM) editors that use the 101left side of the screen for control information. 102XX_TP(XX_FB(Overlay Paste)) 103If set, pasting over a protected field will simply increment the cursor 104position instead of locking the keyboard. 105This allows forms to be copied and pasted with the protected fields 106included. 107Setting this toggle also implicitly sets the XX_FB(Paste with Left Margin) 108toggle. 109XX_TP(XX_FB(Select by Rectangles)) 110If set, XX_FB(x3270) will always select rectangular areas of the screen. 111Otherwise, XX_FB(x3270) 112selects by rectangles when in 3270 mode, but in XX_SM(NVT) mode it selects 113continuous regions of the screen like XX_FI(xterm)(1). 114XX_TP(XX_FB(Crosshair Cursor)) 115If set, XX_FB(x3270) will display a crosshair over the cursor: lines extending 116the full width and height of the screen, centered over the cursor position. 117This makes locating the cursor on the screen much easier. 118XX_TP(XX_FB(Visible Control Chars)) 119If set, XX_FB(x3270) will display control characters as special underscored 120symbols instead of blanks. 121Field attribute characters are displayed in underscored yellow. 122Other control characters are displayed according to their field colors and 123attributes. 124XX_LP 125XX_TS(2,c l.) 126XX_TR(XX_TD(Symbol) XX_TD(Meaning)) 127XX_TR(XX_TD(Period) XX_TD(NUL (X'00'))) 128XX_TR(XX_TD(<) XX_TD(SO (Start of DBCS subfield))) 129XX_TR(XX_TD(>) XX_TD(SI (End of DBCS subfield))) 130XX_TR(XX_TD(0-9 A-V) XX_TD(Field attribute)) 131XX_TE() 132The mappings for field attribute characters are included in the XX_FB(x3270) 133Resource documentation for the XX_FB(visibleControl) resource. 134XX_TPE()dnl 135XX_TPE()dnl 136XX_LP 137The names of the toggles for use with the XX_FB(XX_DASHED(set)) 138and XX_FB(XX_DASHED(clear)) 139options are as follows: 140XX_LP 141XX_TS(2,center; 142l l .) 143XX_TR(XX_TD(Menu Option) XX_TD(Name)) 144XX_T_() 145XX_TR(XX_TD(Monocase) XX_TD(monoCase)) 146XX_TR(XX_TD(Blinking Cursor) XX_TD(cursorBlink)) 147XX_TR(XX_TD(Blank Fill) XX_TD(blankFill)) 148XX_TR(XX_TD(Show Timing) XX_TD(showTiming)) 149XX_TR(XX_TD(Trace Data and Events) XX_TD(trace)) 150XX_TR(XX_TD(Save Screen(s) in File) XX_TD(screenTrace)) 151XX_TR(XX_TD(Scrollbar) XX_TD(scrollBar)) 152XX_TR(XX_TD(Wraparound) XX_TD(lineWrap)) 153XX_TR(XX_TD(Paste with Left Margin) XX_TD(marginedPaste)) 154XX_TR(XX_TD(Select by Rectangles) XX_TD(rectangleSelect)) 155XX_TR(XX_TD(Crosshair Cursor) XX_TD(crosshair)) 156XX_TR(XX_TD(Visible Control Chars) XX_TD(visibleControl)) 157XX_TR(XX_TD(Typeahead) XX_TD(typeahead)) 158XX_TE() 159XX_LP 160In addition, the toggle XX_FB(altCursor) can be used to select the cursor type. 161If set, an underline cursor will be used. 162If clear, the normal block cursor will be used. 163The toggle XX_FB(aidWait) can also be used to change how actions that send an 164AID to the host behave: when clear, they no longer block until the host 165unlocks the keyboard. 166XX_LP 167These names also represent resources that can be set in your .Xdefaults 168or .x3270pro file. 169For example, if you always want to have the scrollbar off, you can add 170the following to your .Xdefaults or .x3270pro: 171XX_BR 172XX_RS(XX_PRODUCT.scrollBar: false) 173XX_BR 174XX_LP 175These names are also used as the first parameter to the XX_FB(Toggle) action. 176