VS Multi-Station Release 7.10.03 Customer Software Release Notice December, 1999 Copyright GetronicsWang Co., 1999 Disclaimer of Warranties and Limitation of Liabilities The staff of GetronicsWang Co., has taken due care in preparing this manual. However, nothing contained herein modifies or alters in any way the standard terms and conditions of the GetronicsWang purchase, lease, or license agreement by which the product was acquired, nor increases in any way GetronicsWang's liability to the customer. In no event shall GetronicsWang or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the product, the accompanying manual, or any related materials. Software Notice All GetronicsWang Program Products (software) are licensed to customers in accordance with the terms and conditions of the GetronicsWang Standard Software License. No title or ownership of GetronicsWang software is transferred, and any use of the software beyond the terms of the aforesaid license, without the written authorization of GetronicsWang, is prohibited. Alliance is a registered trademark of GetronicsWang Co. CONTENTS PREFACE Chapter 1 SUMMARY OF FEATURES Overview ................................................... 1-1 Windowing .................................................. 1-2 Personal Keyboard Definition ............................... 1-3 Editing MWS Windows Sizes and Location ..................... 1-3 The VS Glossary Language ................................... 1-4 Enhanced Control of Workstation Features ................... 1-5 International Options ...................................... 1-6 Multi-Station Window Status Symbols ........................ 1-6 CHAPTER 2 HARDWARE AND SOFTWARE REQUIREMENTS Overview ................................................... 2-1 Hardware Requirements ...................................... 2-1 Software Requirements ...................................... 2-2 CHAPTER 3 ENHANCEMENTS Overview ................................................... 3-1 Enhancements to Release 7.10.00 ............................ 3-1 CHAPTER 4 CORRECTED PROBLEMS Overview ................................................... 4-1 Problems Corrected in Release 7.10.00 ...................... 4-1 Problems Corrected in Release 7.10.01 ...................... 4-1 Problems Corrected in Release 7.10.02 ...................... 4-1 Problems Corrected in Release 7.10.03 ...................... 4-1 CHAPTER 5 RESTRICTIONS AND SPECIAL CONSIDERATIONS Overview ................................................... 5-1 Restrictions and Special Considerations .................... 5-1 iii CONTENTS (continued) CHAPTER 6 MEDIA CONTENTS Overview ................................................... 6-1 Media Contents of Release 7.10.03 .......................... 6-1 CHAPTER 7 INSTALLATION INSTRUCTIONS Overview ................................................... 7-1 Installation Instructions .................................. 7-1 Using a VS Multi-Station ................................... 7-1 Loading Workstation Personalities ....................... 7-2 Managing Windows ........................................ 7-3 Using the Default Glossary .............................. 7-4 Changes in VS Menu Operation ............................ 7-5 Managing Glossaries ..................................... 7-5 Word Wrap .................................................. 7-8 APPENDIX A SYSTEM ADMINISTRATION APPENDIX B SAMPLE MULTI-STATION APPLICATION TABLES Table 6-1 VS Multi-Station Media Contents ............... 6-1 iv PREFACE This customer software release notice (CSRN) describes VS Multi-Station Release, 7.10.03, a package that lets you customize the keyboard and to display simultaneously up to four interactive tasks in four windows on the workstation screen. VS Multi-Station also includes a Glossary language, which lets you write programs to assign to Glossary key combinations. This CSRN provides information for programmers, operators, and system administrators. It assumes familiarity with the VS environment and with VS Procedure Language. System administrators should already be familiar with the GENEDIT utility. Users who want to write Glossary language programs should be familiar with the VS programming environment and with one of the VS languages. This CSRN provides the following information: . Chapter 1 summarizes the VS Multi-Station features. . Chapter 2 summarizes the hardware and software requirements. . Chapter 3 describes the enhancements of this software release. . Chapter 4 lists problems corrected in this release. . Chapter 5 specifies restrictions and special considerations that apply to the software. . Chapter 6 lists the VS Multi-Station media contents. . Chapter 7 provides instructions for installing the software. . Appendix A provides system administration information. . Appendix B describes a sample VS Multi-Station application. v The following manuals are referenced in this document: . VS WSPERSON Customer Software Release Notice (INT-0811) . VS Media, Transfer, and Device Utilities Reference (715-1716A) . VS Procedure Language Reference (800-1205-06) . VS GENEDIT Utility Reference (715-1511A) . VS Program Development Tools Reference (715-0348A) vi CHAPTER 1 SUMMARY OF FEATURES OVERVIEW The VS Multi-Station package transforms the 2256, 4230, 4245, and PC workstations into personalized, multi-windowed workstations. The VS Multi-Station enhances productivity by allowing you to customize the keyboard and to process multiple interactive tasks simultaneously. The VS Multi-Station supports the following features: Windowing -- Lets you run and display up to four interactive programs concurrently. Personal keyboard definition -- Lets you define the meaning and function of each key. An expanded set of key functions -- Provides you with added feature options when assigning functions to workstation keys. A Glossary language -- Lets you define new, expanded key functions that operate under program control. Glossary programs can automate repetitive keyboard operations and can perform conditional and text-manipulating operations. After you define a Glossary program, any user can invoke the program. Enhanced control of workstation features -- Lets you control the workstation alarm, the keyboard clicker, blinking fields, tab operation, cursor-wrap, and type-ahead capability on all multi-station types. This feature also lets you control the color options and workstation mode on color workstations. International options -- Lets you alter the character set, define key combinations for accented characters, and modify the default capitalization rules. The number of windows a particular multi-station has is determined when the system is configured. You define all other Multi-Station features through an interactive and easy-to-use utility known as WSPERSON. The collection of features you select using WSPERSON is called your workstation personality. Your workstation personality can be loaded whenever you log on to any multi-station and can be changed at any time. Thus, the Multi-Station features are part of your workstation personality file and are not a fixed part of the workstation. WINDOWING A VS Multi-Station can have up to four windows. Each window is an independent VS task, from which you can run any VS data processing program. For example, you can simultaneously run the EDITOR, the DISPLAY utility, a compiler, and the Symbolic Debugger from separate windows of a multi-station. To alternate between windows, press shift/Execute (this is the default key sequence; other keys can be configured to move between windows through the WSPERSON utility). This will activate the next higher-numbered window (or window one if the current window is the highest-numbered window). You can dynamically adjust the number and the size of the displayed windows. Each window can occupy an entire screen, or portions of several windows can be displayed simultaneously. Portions of a program screen outside the boundaries of a window scroll into view as the cursor moves into them. You can set the default window configuration using WSPERSON, and you can change it at any time by pressing special window function keys defined in WSPERSON. The WP/WP PLUS, or Alliance applications can also run from a multi-station window. However, you cannot access the other windows while these applications are in use. Any tasks running in the other windows continue processing until the screen must be modified (the task is then suspended until exiting WP/WP PLUS, or Alliance). PERSONAL KEYBOARD DEFINITION The WSPERSON utility offers you total control of the meaning and the function of each key on the keyboard. You can relocate standard workstation keys. For example, you can reverse the locations of the Enter and New Line keys to be consistent with the corresponding word processing key locations or you can modify the QWERTY key sequence to AZERTY. You can also incorporate key functions supported only in the multi-station environment. Some of these functions support other Multi-Station features; others are improved versions of existing key functions. A summary of the key functions follows: Window operation keys -- You can define keys that display the next or the previous workstation window and move a window up, down, left, or right. Data transfer keys -- You can define keys that can copy information from one location to another on the same or a different window. Glossary keys -- You can dedicate a workstation key to a specific Glossary function, rather than having to press the Glossary key and another key. Enhanced key operations -- The Multi-Station environment supports new key functions such as an Insert Mode key that inserts characters by moving the existing characters to the right and then adding the new characters, and a Back Line key that is the inverse of the standard New Line key. For more information on creating a personality file using WSPERSON, refer to the VS WSPERSON CSRN. EDITING MULTI-STATION WINDOWS, SIZES, AND LOCATIONS You can capture window size modifications and location changes from the WSPERSON Edit MWS Windows Sizes and Location menu. The following options appear on this menu: Load and Retrieve Data -- Lets you load the window sizes and location values from the current personality record, or retrieve the current window sizes and locations from the workstation. You can select this option for an individual window, or for all active windows simultaneously. Presized Windows Selections -- Lists presized window styles and location options. You can select a window style option, load it into the window, and/or save it within the current personality record. There are three methods of manipulating window sizes: remapping the keyboard with window sizing manipulation keys, using the default window sizing glossary feature, and using the WSPERSON utility described above. For more information about remapping the keyboard, refer to the VS WSPERSON CSRN. For more information about the default window sizing glossary feature, refer to Chapter 8. THE VS GLOSSARY LANGUAGE The VS Multi-Station Glossary language combines the decision processing and the text manipulation of a programming language with the capability to issue and accept keystrokes. The Glossary language allows users to define single key functions that easily perform complex or repetitive operations. In many ways, Multi-Station glossaries are similar to word processing glossaries; however, Multi-Station glossaries are substantially more powerful. VS Multi-Station also incorporates a Glossary-By-Example facility, which lets you record and reissue a series of keystrokes. You invoke Glossary-By-Example by pressing the GL key followed by PF7; a "|" symbol is displayed on the status line to indicate that your keystrokes are being saved. You can also append a Glossary-By-Example to a Glossary program for subsequent editing through the WSPERSON utility. WSPERSON automatically translates the Glossary-By-Example keystrokes into the appropriate syntax for the Glossary language. Thus, you can specify keystrokes in a Glossary program by typing them on the workstation. Note: When all windows on a MWS device are logged off, you cannot invoke Glossary-By-Example from a logon screen. The structure and form of the Glossary language resemble a simplified PL/I. The Glossary language, however, is much easier to learn because Glossary programs have only the character and integer data types and do not use file I/O. The Glossary language includes standard PL/I built-in functions for text string manipulation. It also includes functions and procedures (subroutines) that are designed specifically for workstation applications. A program can control the keyboard, check the current window, manipulate the cursor, and highlight screen locations through Glossary language features. A Glossary program is composed of a collection of procedures. Each Glossary key function is defined as a single procedure. The Glossary program is edited and compiled through the VS EDITOR or WSPERSON and attached to your workstation personality. You invoke Glossary programs by pressing the GL key and the defined key (just as in VS Word Processing) or by pressing a single key dedicated to the Glossary key combination using WSPERSON. Since a Glossary program is part of a workstation personality, it can be invoked from any window. Multi-Station also supports global glossaries, which run in all windows at once, and auto-start glossaries, which automatically run when the personality is loaded. Global glossaries can perform such operations as logging off all windows. ENHANCED CONTROL OF WORKSTATION FEATURES Multi-Station controls such workstation features as the alarm, the keyboard click, and the blinking of error fields through your workstation personality. Multi-Station also lets you control the operation of the tab keys and to specify whether or not the cursor wraps at the screen edges. Multi-Station supports workstation features such as type-ahead capability, window status, and color control. The type-ahead option stores all keystrokes in a buffer, allowing you to continue typing while waiting for system response. The window status feature optionally displays the status and the number of the active window. The color control features available for the 4245 color workstation are supported in the multi-station environment, allowing you to set the colors for the different field types, the cursor, and the screen background on each window of a color multi-station (this feature lets you set different screen colors for the four multi-station windows). Because these features are part of your workstation personality, they can be set automatically whenever you log on to any multi-station or return from WP/WP PLUS, or Alliance. Multi-Station places traditionally hardware-oriented features under user-modifiable software control. For more information about using WSPERSON to control workstation features, refer to the VS Media, Transfer, and Device Utilities Reference. INTERNATIONAL OPTIONS Multi-Station lets you tailor the workstation to your native language. By modifying the character set, you can customize the keyboard for your language. Multi-Station also lets you define accented characters as combinations of an accent key and the key to be accented. Thus, Multi-Station does not have to dedicate a key to each accented character. In addition, Multi-Station allows International users to control the automatic conversion of characters entered into uppercase-only fields. The International features are interactively selected through the WSPERSON utility and are part of your workstation personality. Multi-Station reduces the effect of native language on a system. Users can define their individual multi-station to operate within the desired language. Multilingual users can define a personality for each language to run on the same workstation. By modifying the character set, users can change VS display characters to include the characters that are frequently used in the C programming language (i.e., curly left and right braces, vertical bar, and tilda). For detailed information on using WSPERSON to modify the character set, define accent keys, and control characters in uppercase-only fields, refer to the VS Media, Transfer, and Device Utilities Reference. MULTI-STATION WINDOW STATUS SYMBOLS Multi-Station supports window status symbols that keep you informed of the status of the workstation. The symbols that appear on 4230/4245 workstations differ from those on other workstation types. For more information about window status symbols, refer to the VS Media, Transfer, and Device Utilities Reference. CHAPTER 2 HARDWARE AND SOFTWARE REQUIREMENTS OVERVIEW This chapter summarizes the hardware and software needed to support VS Multi-Station. The components specified in this chapter are required, in addition to the VS Multi-Station software, and are sold separately. HARDWARE REQUIREMENTS Depending on the microcode, the VS Multi-Station, Release 7.10.00 requires one of the following workstations. . The 2256MWS microcode requires a VS 2256C workstation. . The 4230MWS microcode requires a VS 4230, 4230A, 4230B, or 4430 workstation with a Universal Low Profile keyboard. . The 4245MWS microcode requires a VS 4245 color bitmapped workstation and a Universal Low Profile keyboard. . The 4250IMG microcode requires a Wang PC, APC, PC200/300/400, Wang or MicroChannel IBM PS/2, with a minimum of 256K memory equipped with a Data Link Option card, a Wang 4450/4451, or VS WIIS workstation. SOFTWARE REQUIREMENTS VS Multi-Station requires the following software: . VS Operating System, Release 7.20 or later . VS Device Support Package, Release 3.60 or later . VS WSPERSON, Release 7.10.03 or later The minimum releases of optional VS software are: . Integrated Information System WP/WP PLUS VS Emulation Software, Release 4.60.15 or later . VS Virtual Machine, Release 2.01.00 or later . VS WIIS Workstation Software, Release 2.10.06 or later (refer to the appropriate VS WIIS Customer Software Release Notice for more information about WIIS software requirements). The Wang PC, APC, PC200/300/400, IBM PS/2, and Wang 4450/4451 requires one of the following emulation software releases: . Wang PC Terminal Emulation Software, Release 2.19i or later (EM928ALL.EXE) . Wang Local Office Connection (WLOC), Release 02.50.00 or later . MCLOC, Release 1.00 or later . WINLOC, Release 2.10 or later Note: When executing applications such as WP/WP PLUS, or Alliance, VS Operating System, Release 7.40 or later, lets you access these applications from any window. Earlier VS Operating Systems require executing these applications from Window 1. CHAPTER 3 ENHANCEMENTS OVERVIEW The VS Multi-Station software lets a single workstation run multiple tasks, each in a separate window. This package includes 2256MWS, 4230MWS, 4245MWS, and 4250IMG microcode. WSPERSON, the personality utility included in the VS Device Support Package, lets each user redefine the functional characteristics of the multi-station. ENHANCEMENTS IN RELEASE 7.10.00 Release 7.10.00 of VS Multi-Station includes the following enhancements: . A new workstation personality record format. This record format is used in conjunction with the new I/O command support, which is used by WSPERSON and related utilities (7.10.00 or later). . The 4250IMG microcode now supports the PC 723, 724, 310, and the corresponding extended keyboards, provided there is PC emulation software that also supports these keyboards. . The WSPERSON Freeform Edit feature, enabling users to map key functions that are not supported by the WSPERSON keyboard layout screens. . A Field Word Wrap feature, enabling users to continue typing without regard to the end of a line, in such applications as Wang Office. . The Fill/Erase character, used when the Space, Delete, Erase, and Insert key functions are activated, is now user definable. . Users can now control the TAB key function to either wrap the cursor from the last to the first tab location on the screen, or to beep and keep the cursor in the last tab location. . Key functions are now supported that switch directly from one window task to another window task. . The WSPERSON functionality of generating predefined window configurations is now supported, by saving the number of active windows in the workstation personality record. . A global Reset (RESET) key function to cancel glossaries executing in all windows is now supported. . A glossary in the default personality record now enables users to size windows with the arrow keys without adding window key functions to the keyboard personality. . During device IPL, a message is now displayed on the screen that contains diagnostic information and a copyright notice. . On PC devices, the MWS status can now be displayed on line 25 instead at the right top corner of the screen. . When executing code loading applications such as WP/WP PLUS, or Alliance, Release 7.10.00, eliminates having to execute these applications in Window 1. . There are new status line symbols for the Word Wrap feature, and Auto Start Glossary In-Progress. CHAPTER 4 CORRECTED PROBLEMS OVERVIEW This chapter describes the problems corrected in VS Multi-Station PROBLEMS CORRECTED IN RELEASE 7.10.03 The NEXT WINDOW function no longer exits an executing glossary. PROBLEMS CORRECTED IN RELEASE 7.10.02 A hard error is no longer reported when switching between windows while another window is attempting to update the screen. The "put down" buffer default has been changed from "00" to "20" to ensure that the buffer has valid key data incase a user performs a "put down" function before performing a "pick up" function. PROBLEMS CORRECTED IN RELEASE 7.10.01 P410009080: Image windows no longer hang when user enters and leaves WPPLUS. Fix pertains primarily to @4250IMG microcode. PROBLEMS CORRECTED IN RELEASE 7.10.00 The following problems are corrected in the @2256MWS, @4230MWS, @4245MWS, and @4250IMG microcodes. PTR Number Problem Description/Resolution C500008522 @2256MWS glossaries with typing rate statements now function on Megacell, WLOC cards, and 4450 workstations. Additionally, @4230MWS glossaries with typing rate statements now function on all 4230/4230A/4430 workstations. P500011028 Disabling the Type-ahead function in MWS personality now locks the keyboard on the first keystroke. P500010533 The PC250 workstation, using 2256MWS microcode with WLOC hardware (210-9754-A), no longer freezes when executing Mentor CBT software. P400007028 WSPERSON no longer generates a message, that the workstation is running the wrong level of microcode, when it replaces the personality record to the workstation. P200014070 Users can use the Glossary Delay function on 4230A workstations with E4 Rev 210-8467A. This feature no longer freezes the workstation. P200007571 The Freeze Screen key now functions correctly. CHAPTER 5 RESTRICTIONS AND SPECIAL CONSIDERATIONS OVERVIEW This chapter lists the restrictions and special considerations that apply to Release 7.10.03 of VS Multi-Station. RESTRICTIONS AND SPECIAL CONSIDERATIONS Be aware of the following restrictions and special considerations that apply to Release 7.10.03: Workstation personality records created prior to WSPERSON, Release 07.10.00, are not supported. Users must convert old consecutive format personality files to the new indexed format personality files using WSPERCNV, Release 7.10.07, or use WSPERSON, Release 7.10.00, to create a new personality file. On an industry standard PC, users cannot control the Clicker on/off setting or the clicker volume from the WSPERSON Optional Workstations Features screen. The right and left curly brace, grave, tilde, vertical bar, and backslash are not supported in the VS workstation character set. When users press these keys on some of the keyboards used with 4230/4230A/4230B/4430, PC, APC, PC200/300/400 workstations, the graphic display is not correct even though the data sent to the VS CPU is correct. Users can use WSPERSON, Release 7.10.03, to modify the workstation character set. On PC, APC, PC200/300/400 workstations, the emulation software may also require changes. The @4250IMG microcode used in a PC workstation with WLOC, Release 2.50 or later, causes the star (*) key to function as a Tab. Users can remap the key by running WSPERSON. The following MWS features differ from the single workstation microcode: The VS Multi-Station software accepts spaces in numeric fields where the Single-Window Workstation microcode does not. The cursor is not positioned correctly with Multi-Station on a Write IOCW error. The BackSpace key function deletes the data to the left of the cursor, and the cursor moves to the immediate left of the initial cursor position. The Hex 0B character, in the VS default character set, is displayed as a DEC TAB instead of a pseudoblank character. The default personality record now reflects the following changes from previous releases: Keyboard layout and capitalization fold-over tables are now consistent with the VS principles of operation and single workstation microcodes included in the VS Device Support Package, Release 3.60, with the exception of the shifted EXEC key being mapped to the Next window key function. The VS character set is now consistent with the VS principles of operation and single workstation microcodes, except for the pseudoblank character (Hex 0B), which is displayed as a DEC TAB. The default window size is full-screen for all configured windows. The @4230MWS microcode does not support the PC workstation hardware. If the user indicates that a Mini PC device is used when executing the emulation software, the Multi-Station status information is displayed on the 25th line. This is accomplished by specifying the f-switch to EM928ALL, WLOC, WINLOC, and MCLOC. The Word Wrap feature does not function on the last line of a Wang Office memo. Users must press PF5 to continue the memo on the next screen. On a PC using an application in Gemini mode, (i.e., the Windows Multi-Station), when a user executes a Highlight glossary, the text is not highlighted. For keyboard restrictions and special considerations on a PC workstation, refer to the documentation for the emulation software. On a PC workstation with a 723 keyboard, the grey keys and numeric keypad arrow keys may both be changed when the key functions on either the grey or numeric keypad arrows are changed. The MWS has been enhanced to retain information concerning the window from which you entered a microcode loading application, such as WP/WP PLUS, or Alliance. This change eliminates the previous user restriction requiring a user to run these applications from Window 1. The MWS enhancement requires VS Operating System, Release 7.40 or later, and if using VM, VS/VM, Release 2.01.00. New key functions have not been added to the Glossary Language compiler (i.e, Go To Window 1, 2, 3, 4, or Word Wrap toggle); therefore, any Glossary-By-Example or Global Glossary-By-Example that includes these key functions will cause unpredictable results if the Glossary-By-Example is compiled. Keyboard anomalies may occur on Classic PCs, if the Local Communications Option Terminal Emulation software, Release 2.19i is not installed. The @4245MWS microcode, with the Type Ahead feature enabled, may miss characters in an 8-character program name. CHAPTER 6 MEDIA CONTENTS OVERVIEW This chapter summarizes the contents of the VS Multi-Station software. MEDIA CONTENTS OF RELEASE 7.10.03 Table 6-1 lists the media contents of the VS Multi-Station, Release 7.10.03, software. Table 6-1. VS Multi-Station Media Contents Library @SYSTEM@ @4230MWS 07.10.03 $ 31 4230MWS Multi-Station microcode @4245MWS 07.10.03 $ 32 4245MWS Multi-Station microcode @2256MWS 07.10.03 $ 25 2256MWS Multi-Station microcode @4250IMG 07.10.03 $ 25 4250IMG/PCMWS Multi-Station microcode Library CSRNLIB MWS71003 07.10.03 $ 33 VS Multi-Station Customer Software Release Notice CHAPTER 7 INSTALLATION INSTRUCTIONS OVERVIEW This chapter describes how to install and use the VS Multi-Station software. INSTALLATION INSTRUCTIONS To install VS Multi-Station, run the BACKUP utility and use the RESTORE function to copy modules @2256MWS, @4230MWS, @4245MWS, and @4250IMG into the @SYSTEM@ library on your IPL volume. Re-IPL your system to load the microcode to the appropriate devices. Note: When using PC workstation hardware, it is recommended that you configure the device as PCMWS (where available in GENEDIT) or 4250IMG, instead of 2256MWS. The VS Operating System loads the @4250IMG microcode file for both the 4250IMG and the PCMWS devices. When installing the VS Multi-Station software on a VS/VM system, the microcode file must be copied into the @VMDSK library using the VM operator COPY command. For more information about installing the software on a VS/VM system, refer to the VS VS/VM Customer Software Release Notice. USING A VS MULTI-STATION While a personalized multi-station is more convenient to use than a standard workstation, its use involves several different procedures. The VS Multi-Station package consists of workstation microcode, and several support utilities. This section describes the coordinated use of the Multi-Station facilities to produce an effective workstation environment. Assuming that your workstation is configured as a multi-station with a set number of windows (refer to Appendix A for configuration information), you need the following items to use a multi-station: A workstation personality A multiple logon capability specified for your user ID Your system administrator can give you multiple logon capability through the VSSECURE utility; refer to the VS System Administrator's Reference for details on the VSSECURE utility. You define a workstation personality through the WSPERSON utility, described in the VS Media, Transfer, and Device Utilities Reference. Loading Workstation Personalities When a multi-station is initialized at IPL-time, it is given a default personality that is practically identical to that of a single-task workstation of the same type. The multi-station does not acquire the characteristics defined in your workstation personality until you load a personality record into the workstation. A personality record remains loaded until you replace it with another personality or power off the workstation, or until the system is initialized. Thus, an unused multi-station may or may not have the default personality loaded when you log on. WSPERSON includes three utilities that allow you to load or save your personality file under different conditions. While you can always load your personality by running the WSPERSON utility, you can also load your personality through the WSRSTR utility or through the WSLOAD utility. The WSSAVE utility allows you to save the personality currently loaded in the workstation (including the current window configuration) in a separate file. The WSRSTR utility allows you to specify and load a workstation personality. When WSRSTR processing begins, it prompts you to enter the file, library, and volume names of the personality file you want to load. When you have identified the file, WSRSTR loads the specified personality into the workstation. The WSLOAD utility loads your default personality file without any user interaction. WSLOAD assumes that your default personality file resides in a file identified by your User ID located in the WSPER library on your System Volume. WSRSTR is useful when you want to load a personality that is different from your default personality. WSLOAD is appropriate when you want to easily load your default personality. For example, WSLOAD is typically run as part of a Logon procedure. The WSSAVE utility allows you to save the personality that is currently loaded into the workstation in a separate file. When WSSAVE processing begins, it requests you to enter the file, library, and volume names of the output personality file. When you have identified the file, WSSAVE saves the personality in the specified file. Managing Windows Each multi-station has a fixed number of windows that is determined by the system configuration. You can display the windows simultaneously or separately. In either case, each window is a full-powered VS task, regardless of how much of the screen is displayed. If less than the full screen is displayed, Multi-Station ensures that you can always see the cursor (unless you indicate otherwise). Using the window function keys defined through WSPERSON or your glossary program, you can move the physical window on the screen or move the contents of the window within the boundaries of the window. Using the Default Personality To move from one window to the next higher-numbered window, press SHIFT-EXEC; if the active window is the highest-numbered window, the next window displayed is window one. You can also use WSPERSON to define window keys that move you directly from window to window. For more information about window function keys, refer to the VS Media, Transfer, and Device Utilities Reference. Window function keys allow you to move a window about the physical screen or move the contents of the window relative to the window. Other window function keys enable you to change the size of the displayed window. For a complete list of window function keys, refer to the VS Media, Transfer, and Device Utilities Reference. The Next Window key makes the next higher-numbered window the active window, complete with its window boundaries. The Get Next Window key also makes the next higher-numbered window the active window, but moves the window into the window size and the location of the current window. Many window functions are available for window manipulation. While dedicating each function to a key through the WSPERSON utility would reserve a large portion of the keyboard for window management, you can use a Glossary program to issue the window function keys without reserving keyboard locations. You can write a separate Glossary procedure for each window function key you want to use or write a Glossary procedure that performs one of several functions, depending on an additional keystroke that you enter. For details on the Glossary language, refer to the VS Media, Transfer, and Device Utilities Reference. Using the Default Glossary The particular window configuration for a multi-station is a matter of personal choice. If you define a window configuration in your workstation personality file, the windows are displayed in that configuration when you load the personality. Otherwise, each window is displayed as a full screen. You can always dynamically adjust the window sizes and locations through window key functions defined on the keyboard or issued through a user glossary, or the default window sizing glossary. The default is what exists without a user defined personality record. In Release 7.10.00, a default glossary lets users manipulate windows without mapping window key functions or writing a new glossary. The default window sizing glossary is activated by pressing the GL key followed by PF2 (PAGE). The user can now delete, add, or move each side of a window using the following key sequence. Press the Delete, Insert, or PF12 (Move) key followed by one of the arrow keys (i.e., to delete 3 rows from the bottom of the window, press GL, then PF2, followed by the delete key and the down arrow three times). Use the Look up, Look down, Look right, and Look left key functions to move the window in increments of 10 rows/columns. You can also use the following key functions after activating the glossary: Insert Mode -- Performs a full-screen operation and cancels the glossary. Recall -- Cancels the operation, restores the window to the previously saved window size, and cancels the glossary. Erase -- Performs an invisible window operation and cancels the glossary. To exit the glossary, press the Reset or Help key function. Notes: The Look up, Look down, Look right, Look left, Insert, and Recall key functions, used in the default glossary, are not included in the default keyboard mapping and must be added if desired. The VS Operating System clears the glossary section of the MWS workstations after logging off the system. When this occurs, the standard window sizing glossary is lost. You can reload the workstation microcode to regain the glossary, or run WSPERSON and load the standard glossary into the workstation, or incorporate the window sizing glossary into your personality file. Changes in VS Menu Operation VS menus that allow you to select an option by positioning the cursor to a non-modifiable numeric field containing a hexadecimal 04 ( ), 05 (f), or 0B (A) operate differently on a multi-station. Such menus include, for example, the Manage Files and Libraries screens, WSPERSON screens, and some Wang OFFICE screens. On a standard workstation, you select options on such screens by using the Tab, Back Tab, cursor control, and Home keys to position the cursor to the entry and pressing ENTER. On a multi-station, however, you can also use the space bar and Back Space key to move the cursor among the entries. In addition, you can type the first letter of any corresponding option to move the cursor to the entry, provided that the first letter is located two positions to the right of the menu pick. Thus, a multi-station automatically converts many VS menus to word processing style menus. Managing Glossaries The Multi-Station includes two types of glossary facilities: compiled glossaries and Glossary-By-Example. Compiled glossaries are a permanent part of the workstation personality and perform many glossary functions. Glossary-By-Example allows you to create a temporary glossary that performs one function. A multi-station can have one permanent and one temporary glossary. Multi-Station glossaries are managed through the WSPERSON utility. To initiate the glossary program, run the WSPERSON utility. When the Glossary Management screen appears, there are three options available to you. These options are described in the following sections. The Glossary Management screen displays the percentage of glossary space that is used and the number of characters remaining for glossary definition. Glossary object programs cannot exceed 2048 bytes. Edit/Compile the Source File When you select this option, WSPERSON links to the VS EDITOR. If the specified source file exists, the EDITOR main menu appears. If the specified source file does not exist, WSPERSON displays the EDITOR Input screen, allowing you to respecify the file parameters. You create and modify the Glossary source code in the same manner that you would create and modify other source code files (BASIC, COBOL, etc.). If your glossary file does not exist, you get a "File not found" message. For more information on using the VS EDITOR, refer to the VS Program Development Tools Reference. Once the file is edited, press PF9 from the EDITOR special menu to compile and, if compilation is successful, load the object code into the personality file you are editing. The object file is placed in library GLOBJ on the system volume; the filename is your user ID. The compiled glossary program is not a permanent part of your workstation personality until you save the personality file. The glossary program will not operate until you load your personality file into the workstation by pressing PF10 (REPLACE into WS) from any screen where this function is available. Compile the Source File This option allows you to directly compile the source file from the Glossary Management screen. You cannot specify any compilation options; no source listing is produced. The object code is placed in a file with the same name as the source file; the object file is placed in library GLOBJ on the system volume. If any errors occur during compilation, an error listing is stored in a error file; the file name for the error file consists of the first four characters of the source file name followed by "ERRS" and is placed in your default print file library. If the compilation completes without errors, you can press PF10 to load the glossary file into the workstation, or you can save it as you exit WSPERSON. If errors occur during compilation, the compilation return code is displayed on the Glossary Management screen and WSPERSON does not update the Glossary area of the current workstation personality. Invoking Compiled Glossaries When a compiled glossary program is attached to a workstation personality, all of the individual glossary functions are available to the Multi-Station user. You can run any glossary in the active window or in all windows simultaneously. You run a glossary in the active window by pressing the Glossary key (GL) followed by the key that identifies the function; you run a glossary in all the multi-station's windows by pressing the Global Glossary key (SHIFT-GL) followed by the key that identifies the function. You can also use WSPERSON to assign glossaries to individual keyboard keys, allowing you to invoke a glossary routine with one keystroke. You can cancel an executing glossary by pressing the Cancel key. If the glossary is running in each window, you must press Cancel in each window or use the RESET key function. When a glossary executes a STOP statement, you can continue the glossary's execution by pressing the Glossary key followed by PF16. For more information about a STOP statement, refer to the VS Media, Transfer, and Device Utilities Reference. Glossary-By-Example A Glossary-By-Example allows you to store a sequence of keystrokes in the workstation and to reissue the sequence at any time. To activate Glossary-By-Example recording, press the GL key, followed by PF7. To end a Glossary-By-Example recording, press the Reset key function. To invoke a Glossary-By-Example, press GL twice. Note: When all windows of a MWS device are logged off, you cannot invoke Glossary-By-Example A multi-station can store one Glossary-By-Example at a time, and it is available until you log off all windows on your workstation. Thus, a Glossary-By-Example is particularly useful for automating repetitive keyboard operations in a single workstation session. Multi-Station reserves 2048 bytes for the compiled glossary and the Glossary-By-Example. Because the two types of glossaries share the same space, the maximum size of either type of glossary depends on the present size of the other type. For example, if your compiled glossary occupies 2000 bytes, your Glossary-By-Example cannot exceed 48 bytes. If you want to permanently store the Glossary-By-Example, you can attach it to your Glossary source program (see the next section, Appending the Glossary-By-Example). Appending the Glossary-By-Example When you select this option, WSPERSON takes the Glossary-By-Example keystrokes that are stored in the workstation and translates them into the appropriate Glossary language syntax. The resulting glossary procedure is then placed at the end of the source file listing that is currently loaded into the workstation. The appended procedure is labelled Glossary-By-Example, with an options clause that specifies the glossary key that invokes the procedure. Notes: You cannot append a Glossary-By-Example if you are running WSPERSON from a workstation that is not configured as a multi-station. There are new key functions in Release 7.10.00 that are not defined in the Glossary language. If the Append function is used for a Glossary-By-Example that contains any of the new key functions, unpredictable results my occur. Word Wrap The Word Wrap feature lets you continue typing without regard to the end of a row, and the word wraps onto the next row. This feature can be activated or deactivated from the WSPERSON Optional Workstation Features screen. To activate the feature, set the Word Wrap option to Y; to deactivate the feature, set the option to N. The MWS window must be a full screen to use the word wrap feature. If the Word Wrap feature is activated, a non blank or alphanumeric character in Column 80 will begin Word Wrap processing. Characters from the previous space to Column 80 of that row are moved to Column 1 of the next row. This action occurs only if the character in Column 80 is entered into a field that is 80 columns and the next row contains a field of 80 columns. Caution: Be aware that if you are typing over data in column 80, of a modifiable field that starts in column 1, data in the beginning of the next row may be lost when a word wraps to that row. Note: The Insert and Insert Mode key functions will continue to operate as described in the VS Principle of Operation, and the VS Media, Transfer, and Device Utilities Reference. You can also activate/deactivate the Word Wrap operation by mapping the Word Wrap Toggle key function to the keyboard using the WSPERSON Keyboard Layout screen. For more information about WSPERSON, refer to the VS Media, Transfer, and Device Utilities Reference. To use the Word Wrap Toggle key function, the Word Wrap option on the WSPERSON Optional Workstation Features screen, must be set to N. APPENDIX A SYSTEM ADMINISTRATION INTRODUCTION The system configuration determines which workstations can support the VS Multi-Station software and how many windows a particular multi-station has. This appendix describes the procedure for configuring multi-stations, and the impact of multi-stations on the number of available tasks. CONFIGURING A VS WORKSTATION AS A MULTI-STATION You define a workstation as a multi-station through the GENEDIT utility. The VS GENEDIT Utility Reference describes the general use of the GENEDIT utility; this section describes the steps you must follow to configure the system with multi-stations and assumes familiarity with GENEDIT. You can consider a multi-station to be one physical device that is connected to up to four logical tasks. Through GENEDIT, you assign a port and a device type to a device number (task). A multi-station with four windows is defined as four separate device numbers. However, because the multi-station is only one physical device, each device number is assigned to the same port. The device type of the multi-station depends upon the model number of the workstation you are configuring as a multi-station. Valid multi-station device types are 2256MWS, 4230MWS, 4250IMG, 4245MWS, and PCMWS. You do not have to assign the multi-station windows to consecutive device numbers. For example, the first window can be configured as device number 7, and the second window can be configured as device number 12. You should realize that IOPs typically have only twice as many device numbers as ports, which may leave you with unused ports on an IOP that supports a large number of multi-stations with three or four windows. Note: You should not define the main Operator's Console (device number 0 and port number 0) as a multi-station. To activate a modified configuration file, you must initialize the system. When the system initialization is complete, each configured multi-station contains a default personality that readily identifies it as a multi-station. The following steps are used to configure a multi-station: 1. From the VS command processor, press PF1 (RUN Program or Procedure). The Program Parameters screen appears. 2. Enter GENEDIT in the Program field and press ENTER. The Select Configuration File screen appears. 3. Enter the name of the configuration file you want to edit in the File field. Press ENTER. The GENEDIT main menu appears. 4. From the GENEDIT main menu, press PF3 to modify the configuration file. The Device Adapters menu appears. 5. Position the cursor next to the device adapter that you want to configure the multi-station on. Press ENTER. The GENEDIT Device screen appears, showing the devices configured on the selected IOP. 6. Position the cursor under the Type column, next to a device number that is not being used, and press PF13 (Modify). 7. Under the Port# column, enter the port number that the multi-station is physically cabled to. Under the Type column, enter the model number of the Multi-Station (2256MWS, 4230MWS, 4245MWS, 4250IMG, and PCMWS are valid multi-station model numbers). Press ENTER. The first window is configured. 8. With the cursor positioned at the model number you just entered, press ENTER to reserve cluster devices (multi-station is a cluster device). The GENEDIT Available Device Numbers screen appears. 9. The device numbers that have a pseudoblank (A) or DEC TAB (f) symbol displayed to the left of the number are the device numbers that have not yet been used. To select the device numbers for your additional multi-station windows, simply position the cursor next to an available device number and enter a nonblank character in the space provided. When all device numbers have been selected (you can select up to three additional device numbers for each multi-station), press ENTER. You return to the GENEDIT Device screen. 10. Press PF17 (PF1 shifted) to return to the GENEDIT main menu. Press PF4 to save the configuration changes in your configuration file. The multi-station configuration will take effect the next time the system is initialized. TASK RESTRICTIONS Although a multi-station only occupies one port on an IOP, it reserves as many tasks as it has windows. The maximum number of tasks on the system is unchanged, but the number of physical workstations that can be supported is directly reduced by each additional window on a multi-station. For example, if a system could previously support 32 workstations and the system administrator configures 3 multi-stations, each with 4 windows, the newly configured system can support only 23 workstations. The effect on system performance of 4 programs running on a multi-station with 4 windows is roughly comparable to that of those programs running on 4 individual workstations. APPENDIX B SAMPLE MULTI-STATION APPLICATION OVERVIEW Multi-Station offers a large set of features, which are best understood when seen in practice. To demonstrate the coordinated use of the Multi-Station package, this section considers the case where you are a user who programs in VS BASIC and uses VS Word Processing. This section demonstrates how you can change the keyboard layout to accommodate personal typing habits, as well as how you can write and install glossaries that log off all the windows and that run the EDITOR with BASIC supplied as the default language. Changing the Keyboard Layout Note: The example in this section applies only to 2256C keyboards. Other keyboards may have different key labels. Users of VS Word Processing have certain typing habits. When they return to the VS data processing environment, they must adapt their habits. The data processing equivalent of the Execute key is the Enter key, but the Enter key is located in the position of the word processing Return key. The Return key in word processing performs a function similar to the New Line key. VS utilities and the Command Processor tend to use PF4 to display a previous screen and PF5 to display the next screen of information. To provide consistency with the word processing environment, you can change the keyboard in the following way: Reverse the positions of the Enter and New Line keys Convert the P Scrn/Back Tab key to PF4 and the Erase key to PF5 Convert the infrequently-used + and - keys on the numeric keypad to Back Tab and Erase, respectively A multi-station can have up to four windows, so you also need keys to display the next window and the previous window. To form a parallel to the word processing keys, you can place the Next window key on the shifted Erase key (next screen) and the Prev window key on the shifted Back Tab key. You also need a few keys to change the size of the windows, and place these on the shifted values of the numeric keypad. Thus, you also want to make the following keyboard changes: Convert the shifted P Scrn/Back Tab key to the Prev window key Convert the shifted Erase key to the Next window key Convert the 5, 6, 2, and 3 keys on the numeric keypad to window function keys. In the following example, the shifted Erase key is changed to function as a Next window key. You change the keyboard layout using the WSPERSON utility. A brief overview of the process of keyboard definition is provided here. For more information about WSPERSON, refer to the VS WSPERSON CSRN. When you run the WSPERSON utility, your personality file can be loaded into your workstation. You can then select the Keyboard Layout function to edit the keyboard layout and change each key to the desired new value. From the first keyboard layout screen, press PF5 (Next keyboard section) until the shifted extended/universal section is displayed. Locate the cursor at the key to be changed (in this example, the Erase key) and press PF9. The shifted Erase key is highlighted (or underscored, depending on your workstation type), and the first alphabetical list of screen functions is displayed on the bottom half of the screen. Additional lists of screen functions can be displayed by pressing PF5. Position the cursor in the pseudoblank to the left of the Next window option and press Enter. The selected function (n-wnd) is now displayed in the shifted Erase key position. Press PF10 (Replace into WS) to load the change into your workstation. The shifted Erase key on the numeric keypad now functions as a Next window key. Follow the same procedure to change the other keys on the keyboard layout. As you exit WSPERSON, you can save the changes in your permanent personality file by selecting the Keep the Changes option, or you can cancel the changes you made by selecting the Discard the Changes option. Creating Glossary Programs This section describes how to create a glossary that contains two procedures: the first procedure logs you off all windows automatically, and the second procedure runs the VS EDITOR with BASIC as the language. To create a glossary, you select the Glossaries option from the WSPERSON main menu (refer to the VS Media, Transfer, and Device Utilities Reference for more information on running WSPERSON). WSPERSON links to the VS EDITOR, and you can then enter the following source text. For more information about the Glossary language, refer to the VS Media, Transfer, and Device Utilities Reference. /* The following procedure logs off the current window or all the */ /* windows when invoked globally. It first exits any program by */ /* issuing a series of PF16 keys until the Command Processor is */ /* displayed (identified by the value 'Workstation' on Row 4). */ /* The procedure then issues a PF16 and an Enter, logging off the */ /* window. */ auto logoff: procedure options ('k'); _ do while (substr(screen(4), 2, 11) = 'Workstation'); call playout ("(-pf-16-)"); call waitforunlock; end; call playout ("(-pf-16-)(-enter-)"); end auto logoff; _ /* The following procedure runs the EDITOR from the Command */ /* Processor. It then enters BASIC as the language and erases */ /* any text remaining in the field from a default value. */ edit in BASIC: procedure options('B'); _ _ call playout("(-pf-1-)EDITOR(-enter-) BASIC(-erase-)"); end edit in BASIC; _ _ After entering the source file, you can compile the source file and load it into the workstation by pressing PF9 from the EDITOR special menu. When you exit the EDITOR, you return to the WSPERSON utility. When exiting the WSPERSON utility, any changes you have made to the workstation personality can be saved in your permanent personality file. If you like, you can modify your Logon procedure to load the new personality each time you log on. Your personality file name consists of your 3-character logon ID, and is stored in library WSPER on the system volume. If you wish to make further keyboard modifications or add new Glossary programs, you can edit the existing personality at any time through the WSPERSON utility.