Customer Software Release Notice for VS Operating System Release 07.53.00 July, 1997 Int 1042 Copyright Wang Laboratories, Inc., 1997 DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES The staff of Wang Laboratories, Inc., 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 Wang purchase, lease, or license agreement by which this software package was acquired, nor shall Wang Laboratories, Inc., or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the software package, the accompanying manual, or any related manuals. NOTICE All Wang Program Products are licensed to customers in accordance with the terms and conditions of the Wang Laboratories, Inc., Standard Program Products License; no ownership of Wang Software is transferred and any use beyond the terms of the aforesaid License, without the written authorization of Wang Laboratories, Inc., is prohibited. PREFACE This Customer Software Release Notice (CSRN) provides important information for using the files in Release 07.53.00 of the VS Operating System. It describes the enhancements included in the release, and the procedures for installation. This notice also contains system requirements, a list of problems corrected since the previous release, and a list of restrictions and special considerations that apply to the release. The CSRN is organized as follows: Chapter 1 describes enhancements to the VS Operating System including new device support and enhancements to utilities, device controller microcode and printer microcode. Chapter 2 details minimum hardware and software requirements. Chapter 3 lists problems corrected since the last general release. Chapter 4 describes restrictions and special considerations that apply to this release. Chapter 5 lists the files included in this package. Chapter 6 provides installation instructions. Addemdum A provides information concerning the VS Operating System License Agreement. CHAPTER 1 ENHANCEMENTS 1.1 VS OPERATING SYSTEM The VS Operating System has several enhancements and additions that should be noted. The enhancements and additions include: - OS Customer License Support - Increased printer classes - Background task priority support - Enhanced DMS file access - New device support - Improved logon and logoff performance WITH THE RELEASE OF OPERATING SYSTEM 07.53, IPL'ING THE SYSTEM WILL INCLUDE VALIDATION OF SYSTEM LICENSING INFORMATION. Please refer to the VSOS Software Licensing Section (Appendix A) for information on licensing support. Also refer to the Installation Instructions for information concerning the effect of this addition on the installation process. This Operating System supports 52 different print classes (increased from 26). All Operating System screens (Operator and Command Processor) which support print functions, now display and allow input of print classes in both UPPER and LOWER case alpha characters ('a' - 'z' as well as the standard format 'A' - 'Z'). These new lowercase classes are also supported in the most recent release of the PRINT Usersub and the Procedure Interpreter. No new parameters are needed in support of these subroutine calls. This also applies to REMOTE (RSF) print classes as well. - 2 - Under 07.53, background job SUBMITs via the Command Processor and the SUBMIT SVC (including usage of the SUBMIT usersub and procedure interpreter), can now be designated with a specific 'priority' at invocation. This single digit priority (allowed values from '1' - '9') informs the OS at which priority the background initiator (used to 'run the job') should execute. If not supplied, a default priority of '7' will be used as was the case prior to 07.53. This default priority as well as the actual keyword parameter - PRIORITY - can be observed on the screen shown by pressing 'PF12 - SUBMIT procedure' from the Command Processor screen. A new parameter 'PRIORITY' has been added to the SUBMIT usersub as well as the @MACLIB@ assembler macro. Modifications have also been made to the Procedure Interpreter in support of the new parameter to SUBMIT function calls. DMS has been improved to allow more than 250 users to simultaneously access a DMSTX data file. Support has been added to the 07.53 Operating System for the following: - VS16000: The VS 16000 is a new generation VS processors that provides increased CPU processing power while retaining backward compatibility with other VS processors. It uses the same I/O subsystem and controllers as Wang's high-end VS families. The VS 16000 is available as a complete new system and as an in-system upgrade for VS 7000/8000/9000 and VS 12650 class machines. - 2279V7 9.0 GB disk drive: Basic GENEDIT support and Operating System addressing was added for a new 9.0 GB SCSI disk drive. Microcode to support this drive is ordered separately in the High Capacity Volume Support Package. - 2288V3 1.3 GB disk drive: The Operating System has been enhanced to handle an ISO standard 2.6 GB (1.3 GB per side) removable optical disk drive. - FO-RSF for CP9/11 systems: Support has been added to the Operating System to allow Fiber Optic RSF functionality for CP9/CP11 VS systems. Microcode to support the fiberoptic RSF controllers must be ordered separately in the FO-RSF-6K. - 2238V4 5 GB tape drive: IOC microcode files have been updated to support a 5 GB QIC tape drive. (Wang VS BACKUP does not support APPEND to this drive. If the APPEND function is required, users should run USI's BACKBURNER utility.) - 3 - 1.2 UTILITIES AND RELATED FILES PROCEDURE INTERPRETER Enhancement for SUBMIT The Procedure Language supports the PRIORITY keyword for the SUBMIT statement. Below is the general format and an example of the SUBMIT statement syntax using the PRIORITY keyword. General Rules: Valid integer values are 1 through 9 7 is the default if not included in the syntax. General Format: [label:]...SUBMIT JOB IN LIBRARY ON VOLUME, PRIORITY = 1 through 9 PRIORITY = (integer variable) Example: PROCEDURE DECLARE PRIOR INTEGER INITIAL 1 SUBMIT JOB1 IN LIBRARY ON VOLUME, CLASS = "Z", DUMP = "YES", CPULIMIT = 99, STATUS = "RUN", ACTION = "CANCEL", PERM = "YES", PRIORITY = 4 SUBMIT JOB2 IN LIBRARY ON VOLUME, CLASS = "Z", DUMP = "YES", CPULIMIT = 99, STATUS = "RUN", ACTION = "CANCEL", PERM = "YES", PRIORITY = PRIOR - 4 - PROCEDURE INTERPRETER (continued) Enhancement for SET The Procedure Language supports lowerclass (a-z) setting for PRTCLASS of the SET statement. Below is the general format and an example of the SET statement syntax using a lowerclass PRTCLASS. General Rules: For the SET statement either a string constant or a string variable may be used for the value of PRTCLASS. General Formats: [label:]...SET PRTCLASS = [string constant] [string variable] Examples: Procedure Declare &prtclass string (1) initial "a" Set PRTCLASS = a Set PRTCLASS = &prtclass - 5 - 1.3 PRINTER MICROCODE N/A 1.4 CP9/CP11 SYSTEM BOOT FILES @MCRCU@ Support has been added for the 2238V4 5GB tape drive and the 2288V3 removable cartridge drive. @SB50861 Support has been added for the 50V14 RSF IOC. 1.5 WORKSTATION MICROCODE N/A 1.6 TAPE MICROCODE N/A 1.7 DEVICE CONTROLLER MICROCODE @50V68 Support has been added for the 2238V4 5 GB tape drive and the 2288V3 removable cartridge drive. @50V68E Support has been added for the 2238V4 5GB tape drive and the 2288V3 removable cartridge drive. @70V68 Support has been added for the 2238V4 5GB tape drive and the 2288V3 removable cartridge drive. - 6 - CHAPTER 2 HARDWARE AND SOFTWARE REQUIREMENTS 2.1 HARDWARE REQUIREMENTS Release 07.53.00 is supported on CP8, CP9, CP10, CP11 (genned as a CP9), CP12, CP14 and CP16 systems and requires a minimum of 2 MB of physical memory. 2.2 SOFTWARE REQUIREMENTS This section summarizes the minimum software revision levels required to run this release. For information regarding the recommended software levels of Wang applications, please refer to your Wang Support Center or Wang VS Data Bits. Software Release Level System Console Unit (CP10 and CP14) A2.20.00 System Console Unit (CP8 and CP12 with B3.20.00 PC280 System Console Unit (CP8 and CP12 with 03.20.00 PC Classic) Small VS RCU Class Diagnostic Package 02.09.00 Central Processing Unit (CPU) Microcode CP8 Microcode 08.80.65 08.81.65 (FPU) CP9 Microcode 09.80.20 CP10 Microcode 10.80.12 10.81.05 (VS12000 Model 550) CP11 Microcode 09.81.11 CP12 Microcode 12.80.13 CP14 Microcode 14.80.05 CP16 Microcode 16.80.00 Systems running VS Extended Data Management System (XDMS) need to upgrade to version 1.53.00 for VS Operating System 07.53.00 compatibility. - 7 - CHAPTER 3 PROBLEMS CORRECTED 3.1 VS OPERATING SYSTEM CTS Number Problem Description E066243 When a disk paging I/O error occurs on a remote paging volume, the pager will crash with a PCNT errhalt. This problem has been corrected so that the I/O error is properly reported by the OS. E021981 Users trying to logon with too large a UMDA size will get the message "Invalid data size for current system.", rather than being logged on with a smaller UMDA size. E052198 The system appears hung because @SYSTSK@ is looping. E052260 Work/Page/Spool options are not always saved across an IPL for volumes in a multi-volume set. E026925 Intermittent @SESMGR@ timer crash on CP9. E027781 There is an occasional problem dismounting MVF volumes. E071234 @SYSTSK@ crashed with a PCDS error halt while processing a second Clear Disconnect message for a workstation. PTR Number Problem Description M100012278 Pace Query with DISPLAY U gives Error C001 reported by EZSORT when run from a procedure with the output directed to WP or WP+ merge. The error does not occur with all queries that use the unique operator. M100022065 TAPECOPY cannot read IBM labelled tapes with variable record lengths. M200023072 System may PCDU after pressing PF5 in the SSL program, or using SSLs. M200023656 Correct a typo in a SYSTSK operator message; "Rebuil ding Queue" now reads "Rebuilding Queue". M200023667 Accessing files on a multi-volume set is causing the system to PCDU. - 8 - M200023677 Diskette sizes are displayed incorrectly in the "Control Disks" screen. M200023685 Assemblies are failing when using the "TASKUINT" option of the LOADCODE macro. M410012379 The FIND function in operator mode for interactive tasks is not working properly. The fields are not lined up properly on the Size and Scheduling screen. M410012484 Add a 256 byte Alignment option to GETMEM. M800027168 Non-SSA operators can now mount dual-port disks with SECURE=NO. M800027199 @SYSTSK@ crashes with Error 0039 - port not active. M800027256 PGPT, IOMQ and PCNT non-continuable error halts in Pager. M800027279 If WIIS is shut down completely, @DEVMGR@ in non- interactive tasks, shows as "Crashed", when in fact it did not crash. M800027365 Errant data appears (including workstation number) when using PF14 or PF15 (print program screen/print command screen) from the Help screen. M800027437 Fragmented GETMEM - GETMEM pages are almost exhausted but significant GETMEM bytes are actually available. 3.2 UTILITIES AND RELATED FILES CIP M410012597 CIP does not work on 2GB drives or larger. LISTVTOC M800027368 LISTVTOC does not display correct "Total Space on Volume" on 2GB disks or larger. PROCEDURE INTERPRETER The DATE4 feature was not working as documented. In previous supporting versions, the date was incorrectly retrieved in YYYYMMDD format. The Procedure Interpreter now retrieves the date in the documented format of MMDDYYYY. - 9 - 3.3 PRINTER MICROCODE N/A 3.4 CP9/CP11 SYSTEM BOOT FILES N/A 3.5 WORKSTATION MICROCODE N/A 3.6 TAPE MICROCODE N/A 3.7 DEVICE CONTROLLER MICROCODE N/A - 10 - CHAPTER 4 RESTRICTIONS AND SPECIAL CONSIDERATIONS 4.1 VS OPERATING SYSTEM VS Operating System 07.53 has system license support. The IPL process will be affected by this addition. Please refer to the Installation Instructions for more information concerning the installation and IPL process. If upgrading from an Operating System release prior to 07.52.00, the QUEUE file (in @SYSWORK on the system volume) MUST be scratched. Using an old QUEUE file may cause the system to appear "hung". Users are unable to run WP if they are running from a workstation that is CLOG'd back on to a local system via a multi-hop. The workstation stays in the WPEMU screen. If an attempt is made to cancel via HELP-PF16, and then CLOGOFF, the cluster will drop. (M200023633) Running a program across the RSF cluster can hang the system if the remote program resides on a multi-volume set. (M200023694) Wang VS BACKUP does not support APPEND to the 2238V4 5 GB tape drive. If the APPEND function is required, users should run USI's BACKBURNER utility. Below is a list of the patches and specials which are not sourced into Release 07.53.00. Replacement patches are available and are included with this Operating System in library "@PATCHS@". Original Replacement Description Patch Patch RSDP1001 RSDP1076 FILSRVs are inhibited when logons are inhibited even if 'Inhibit Logons and Logoff user at Program Completion" has been specified. RSDP1004 RSDP1077 "Excessive Errors" messages in Operator hang the system, the user cannot be forced off because the screen is updating so quickly. RSDP1005 RSDP1078 @TSKMGR@ cancels with the timer not set. RSDP1009 RSDP1075 PGFX when trying to halt a presentation services protocol 2 IO. RSDP1069 RSDP1079 The debugger hangs on entry when run from a remote workstation (or via Lightspeed). - 11 - 4.2 UTILITIES AND RELATED FILES PROCEDURE INTERPRETER The Procedure Interpreter must be named @PROC@. An attempt to use the interpreter by any other name will fail. 4.3 PRINTER MICROCODE N/A 4.4 CP9/CP11 SYSTEM BOOT FILES @MCRCU@ Workstation 0: The location of workstation 0 is determined by switch settings on the RCU board. If workstation 0 is an asynchronous workstation, the terminal must be configured to operate at a baud rate of 19200 bps, 1 stop bit, ODD Parity, and 8 data bits. SCSI devices should not be powered off and on during or after IPL. 4.5 WORKSTATION MICROCODE N/A 4.6 TAPE MICROCODE N/A 4.7 DEVICE CONTROLLER MICROCODE @50V68 / @50V68E SCSI devices should not be powered off and on during and after IPL. @70V68 Each device attached to the 70V68 IOC must have a valid WANG copyright. The SCSI IOC must occupy position (ID) 7 on the SCSI bus. - 12 - If a disk device on the IOC is used as the system (IPL) volume, that disk device must be configured according to the default configuration. Users of 2259V1 streamers should be aware that while we guarantee default (high) density recording mode for tapes written from BOT, tapes appended to will be written at the tape's previously recorded density, be it low or high. This is due to the unit's upward compatibility with the manufacturer's earlier streamer, which we do not support. Although system IPL is functional from either of the supported RAID units (2277V1 and 2277V2), we do not recommend doing so. In the unlikely event that a reconstruct would be necessary, the system would have to be IPLed from a volume other than the volume requiring reconstruction. The RAIDSTAT utility will not function otherwise. The following restrictions exist if either of the supported RAID units' (2277V1 and 2277V2) location on the SCSI bus is Target x, Lun y, where y is greater than 0. 1) The volume's use as an IPL disk is not possible based on the description on page A-1 for the default configuration, as it applies to system IPL. 2) SYSCON's Easy IPL display (PF8) will never show the volume name. 3) VS/VM virtual SCSI support will be non-existant for volumes physically connected in this manner. In order to IPL off of a disk on the SCSI IOC, the disk must be configured in a way that is consistent with the default configuration for the SCSI IOC. The following is the default configuration for the IOC: LDN Port Target LUN 00 0 0 0 01 0 1 0 02 0 2 0 03 0 3 0 04 0 4 0 05 0 5 0 06 0 6 0 07 0/1 7 0 (reserved for IOC itself) 08 1 0 0 09 1 1 0 0A 1 2 0 0B 1 3 0 0C 1 4 0 0D 1 5 0 0E 1 6 0 - 13 - NOTE: The default configuration supports only Logical Unit Number (LUN) 0. Therefore, the system (IPL) volume must occupy LUN 0. Example 1 Suppose that the system (IPL) volume is target 1 on port 0 of the SCSI IOC. In our default configuration, the Logical Device Number (LDN) for this device is '1'. Therefore, in the GENEDIT configuration file for this IOC, the system volume must be configured as unit '1' on the IOC, the second entry in the device configuration screen. Example 2 Suppose that the system (IPL) volume is target 5 on port 1 of the SCSI IOC. In our default configuration, the Logical Device Number (LDN) for this device is 'D'. Therefore, in the GENEDIT configuration file for this IOC, the system volume must be configured as unit 'D' on the IOC, the 14th entry in the device configuration screen. IF THE SYSTEM VOLUME IS NOT CONFIGURED ACCORDING TO THE ABOVE RULES, THE IPL WILL FAIL. - 14 - CHAPTER 5 MEDIA CONTENTS OVERVIEW This chapter describes the files that make up Release 07.53.00 of the VS Operating System. The information in this chapter will help to determine which files to maintain on the system volume. To conserve space on the system volume, delete all unnecessary files after completing the installation of this release. The CODE column indicates whether or not a file should be installed on a customer system. The code consists of at most three characters: the first is an alphabetic character which indicates the installation option; the second is a digit which restricts the code to a certain CP type only; the third is used to indicate a footnote, which may describe additional information or documentation about the file. The installation option codes are as follows: M MANDATORY: This file must always be installed. This installation option code applies primarily to the operating system files, files required during IPL, and certain utilities such as SECURITY. C HARDWARE CONFIGURATION DEPENDENT: This file should be deleted if the corresponding device is not part of the system configuration. U USER-DEFINED: This file must reside on the system volume, but the contents are user defined. This installation option code applies to data files used by system programs (for example, the USERLIST file, which is maintained by the SECURITY utility). O OPTIONAL: This file should be included only if it will be used. Most utilities are assigned this code. - 15 - 5.1 VS OPERATING SYSTEM KERNAL LIBRARY = @SYSTEM@ Code Module Version Description M @CPYDMP@ 07.53.00 Procedure to copy dumps M @FFM 07.53.00 File Manager Task M @GENMSG@ 07.53.00 Displays "System Generation in Progress" message M @IOCDRT@ 07.53.00 IOC Routing Table M @IOCLOD@ 07.53.00 IOC Load M @IOSLOAD 07.53.00 Loads Microcode to devices M @LOGGER@ 07.53.00 Security Logging Task M @OPER@ 07.53.00 Operator Console M @PAGE 07.53.00 Paging server to open paging to remote volumes M @PRTTSK@ 07.53.00 Printer Task M @QUEVER@ 07.53.00 Queue Verification M @RSFSYNC 07.53.00 @RSF Synchronization task M @SHARER@ 07.53.00 Sharer Task M8 @SYS008@ 07.53.00 VS CP8 Operating System Nucleus M9 @SYS009@ 07.53.00 VS CP9/11 Operating System Nucleus M10 @SYS010@ 07.53.00 VS CP10 Operating System Nucleus M12 @SYS012@ 07.53.00 VS CP12 Operating System Nucleus M14 @SYS014@ 07.53.00 VS CP14 Operating System Nucleus M16 @SYS016@ 07.53.00 VS CP16 Operating System Nucleus M @SYSCPR@ 07.53.00 Command Processor M @SYSDBG@ 07.53.00 System Debug M @SYSDMS2 07.53.00 Data Mgmt. System 16 MB Virtual Addressing - 16 - M @SYSGEN@ 07.53.00 Dynamic System Generation M @SYSINIT 07.53.00 System Initialization M @SYSSERV 07.53.00 System Services M @SYSTSK@ 07.53.00 System Task M @TSKMGR@ 07.53.00 User Task Manager M @WSLOAD@ 07.53.00 Loads workstation devices during IPL. M BUILDALT 07.53.00 Builds DMS Alternate Index Structure Library = @ERRMSG@ M WLREMSG Runtime error messages for all system programs written in PL/I. 5.2 PACKAGED UTILITIES AND RELATED FILES Library = @SYSTEM@ M @GENSSL 07.53.00 Genedit SSL Subroutines M @PROC@ 07.53.01 Procedure Interpreter. M PROC 07.53.01 Procedure interface for @PROC@. O ACLEXTR 07.53.00 EXTRACLs default output or print ACL. O ACLREAD 07.53.00 Reads a file's ACL. O ACLREPL 07.53.00 Replaces a file's ACL. O ACLSET 07.53.00 SETs specified default ACL. O ASSEMBLE 01.09.05 VS Assembler O AUTOPAT 07.53.00 Autopatch utility O AUXPRINT 04.00.00 Auxiliary Print Utility O BACKUP 07.24.73 Backup Utility O -WTEFORM 000277 BACKUP form file - 17 - O CIP 07.53.00 Compress in Place Utility O CLOGON 07.53.00 Cluster Logon Utility O CONVTLOG 07.53.00 Security Log Conversion Utility O COPY 07.53.00 Copy disk files, libraries and volumes O COPY2200 07.53.00 VS Intersystem copy program O -WTCDEAT 07.53.00 COPY2200 - external file O COPYOIS 02.04.03 Program to copy OIS files M DEVLIST 07.53.00 System Device List O DISK643 06.43.20 OS 6.43 to 7.20 upgrade utility O DISK713 07.20.35 OS 7.13 to 7.20 upgrade utility O DISK714 07.20.35 OS 7.14 to 7.20 upgrade utility O DISK720 03.75.01 OS 7.2X to 7.50 upgrade utility O DISK730 04.25.01 OS 7.3X to 7.50 upgrade utility O DISK740 04.33.02 OS 7.4X to 7.50 upgrade utility O DISKINIT 07.53.00 Disk initialization utility O DISPLAY 07.53.00 File display utility O DMSTX 07.53.00 DMS/TX Utility O -FRMRLBAK 000077 DMS/TX forms file O -WXRDMS 07.53.00 DMS/TX program file O DMSTXCVT 07.24.73 DMS/TX recovery blocks O FASTLINK 07.53.00 Permanently open files utility O FILSRV 07.53.00 File Server O FLOPYDUP 07.53.00 Utility to duplicate diskettes O FONTCNTL 07.06.08 Font Control Utility O -FONTFORM 000074 Form file for FONTCNTL - 18 - O FORMCNTL 07.18.43 Forms Definition Utility M GENEDIT 07.53.00 Configuration Utility M -GENEDITF 000224 GENEDIT form file O GETMON 07.53.00 GETMEM Monitor O GLOSSARY 02.01.11 Multistation glossary compiler O IBMCOPY 07.53.00 Copy Wang diskettes to IBM format and IBM diskettes to Wang format O INFO 02.03.15 INFO Program file O INITMANY 07.53.00 Utility to initialize multiple diskettes O IOELOG 07.53.00 I/O Error Log utility O IOTRACE 07.53.00 I/O Tracer M* LICENSE 07.53.01 Utility to create License Print Fax Form O LISTVTOC 07.53.00 VTOC Analysis Utility O LOGPRINT 07.53.00 Utility to display the security logging file. O PATCH 07.53.00 Utility to patch programs and files O POOLSTAT 07.53.00 Displays paging pool status O PSPRINT 07.00.08 PostScript source file to VS print file utility O PSPRT 07.00.08 PostScript source file to VS print file subroutine O RAIDSTAT 07.53.00 RAID status utility O RSFMON 07.53.00 Utility to monitor RSF activity O RSAFXFER 02.11.00 RSAF transfer file O RSFUTIL 07.53.00 Utility Task to set RSF synchronization O SCSISTAT 07.53.00 SCSI status utility M SECURITY 07.53.00 Security Utility U -@SECFILE None Default System Security Options file O SHRSTAT 07.53.00 Sharer Statistics O SORT 07.20.07 Sort Utility O SSL 07.53.00 Shared Subroutine Library - 19 - O SSLCONVT None SSL Catalog System Services Procedure O SWP5300 07.53.00 Sweeper File O TAPECOPY 07.53.00 Tape to disk/disk to tape copy utility O TAPEDUMP 07.53.00 TAPEDUMP utility O TAPEINIT 07.53.00 Tape initialization utility O UNHANG 07.53.00 UNHANG utility U USERLIST None System User List (NOTE: Contains one userid CSG, with no password) O VERIFY 07.53.00 Indexed File Verification Utility O VOLCOPY 07.53.00 Backup - track to track backup program O WSLOAD 07.10.05 Restore default personality file O WSPERCNV 07.10.07 Personality file conversion utility O WSPERSON 07.10.06 Personality editor O WSRSTR 07.10.05 Restore personality program O WSSAVE 07.10.05 Save personality program Library = COLORLIB O 4245SRC None Sample source file O COLORCNV 01.00.06 Program file O COLORDEF 01.00.08 Program file O COLORIO 01.00.06 Program file O COLORMSG 01.00.00 Screen and error messages O COLOROPT 01.00.08 Program file O IMAGES None Sample image file O PALETTES None Sample palette file O SCREENS None Sample screen file - 20 - Library = GL O SAMPLE None Personality program Library = GLOBJ O SAMPLE None Personality program Library = WSPER O @STDFILE 07.10.03 Default personality records for supported 07.10.00 devices 5.3 Info Documents and Help Text Library = @DOCLIB@ O BUPHELP 07.10.00 On-line Help Text for the BACKUP utility O INFOHELP 02.03.09 On-line Help Text for the INFO utility O IOEHELP 01.00.01 On-line Help Text for the I/O Error Log Utility O MTDUTIL None On-line Help Text for WSPERSON O SECURITY 07.20 On-line Help Text for the SECURITY utility 5.4 Form Files Library = @SYSFRM@ O INFOFRM 000053 INFO Form file - 21 - 5.5 User Macros Library = @MACLIB@ (all are Optional) $BCTGEN $RDFGEN $VERS13 $VERSION @BCMSG@ ACLEMPTY ACLIST ACTEST ALEX AXD1 AXDGEN BCE BCTBL BCTGEN BEGTRANS BIJFIRST BIJLOG CALL CANCEL CEXIT CHARGEN CHARVAR CHECK CHPASSWD CLOGON CLOSE CNTROLOG COMMAND COMMIT COPYFDR CREALIAS CREATE CXT DELACL DELALIAS DELETE DESTROY DEXIT DFB DISMOUNT DISPTAB DMSDEFS DMSPROCS ENDLOCAL EXTOPID EXTRACL EXTRACT EXTRACT# EXTRD EXTRD# FDR1 FDR2 FDR3 FIB FILEI FILLTAB FMTLIST FREEALL FREEBUF FREEHEAP FREESHR FREEXRTS GETACL GETALIAS GETBUF GETHEAP GETLOGON GETMAP GETNUDEF GETOPEN GETPARM GETSECUR GETXRTS HALTIO HALTIO# IACCEPT ICANALS ICHECK ICLREXIT ICONNECT ICREATE IDECLINE IDESTROY IDISCMAP IDISCONN IFORWARD ILKUPALS IPCB IPCCLOLN IPCLOSE IPCOPNLN IPCSETV IPCXTRCT IPM IPOPEN IPREVIEW IQUIESCE IREACTVT IREGALS IRETRIEV ISEND ISETEXIT IWAIT KEYLIST LINK LINKPARM LISTEN LNKB LOADCOD# LOADCODE LOADFONT LOCAL LOCALS LOGOFF LOGR LSB MFIB MOUNT MOUNT# MSGLIST MSMAP MSUNMAP OPEN OPEN# OPSMGOPR OPTPARMS PATCH PCEXIT PCONTROL PROCINFO PROTECT PUTLOG PUTPARM RANDGEN READ READACL READFDR READVTOC RECEIVE REGS RENAME REPACL RESETIME RETURN REWRITE RFB RLBKFDCL ROLLBACK SBREAK SCGLOBLS SCRATCH SCREATE SDELETE SENTER SET SET# SETACL SETIME SETNUDEF SETRECOV SETSECUR SEXIT SORTACL SSLALS SSLINFO START STATINIT SUBMIT SYSERPLI SYSERROR SYSMSGID TABLERA TASKCTL TCOMPLET TCOPTION TEMADD TEMDELET TEMLIST TEMQUERY TEMUPDAT TIMDAYCV TIME TINVOKE TKILL TPLAB TPLB2 TRACE TRANSMIT UCBMSG UFB UFB# UFBDISK UFBGEN UFBGEN# UNITRES UNITRES# UPDATFDR USERSEMA VALIDATE VFYUSRPW VOL1 VOLINFO VOLINFO# VSETINFO WPCALL WRITE WV46MAP XIO XMIT - 22 - 5.6 LOADABLE PRINTER MICROCODE AND RELATED FILES 5.6.1 Loadable Printer Microcode Library = @SYSTEM@ C @5535S 05.01.08 5533, 5535 printer microcode C @MC2273S 06.00.04 5573, 5574 printer microcode C @MC2281S 07.00.03 6581W, 6581WC printer microcode C @MC32EM 07.00.07 3211 emulation microcode C @MC55741 06.01.04 5574-1 printer microcode C @MC5575 05.01.07 5575 printer microcode C @MC5575X 07.01.09 5575X printer microcode C @MC5577 07.00.12 5577 printer microcode C @MC5578 07.01.00 5578 printer microcode C @MCAPTRE 07.00.04 EADC/WACS Printer microcode C @MCBNPIB 07.00.00 BANDPIB VSDP microcode C @MCDM50E 07.00.18 DM50/300 printer microcode C @MCDW55 07.00.04 DWOS55 printer microcode C @MCDW60 07.00.03 DWOS60 printer microcode C @MCEPLQ 07.01.00 Epson LQ/HQ 300 printer microcode C @MCLCS15 07.02.08 LCS15-2 printer microcode C @MCLDP8 07.00.24 LDP8 printer microcode C @MCLDP8E 07.00.24 LDP8E printer microcode C @MCLIS12 07.00.29 LIS-12/24 microcode C @MCLM900 07.00.29 LM-400/700/900 printer microcode C @MCLNPIB 07.00.00 LINEPIB microcode C @MCLPS8 07.01.42 LPS-8 printer microcode C @MCLQE 07.00.02 Epson LQ emulation printer microcode C @MCPCL5 07.00.20 HPPCL5 printer microcode - 23 - C @MCPM15E 07.01.07 PM015 DP printer support C @MCPM17E 07.01.05 PM017/18 DP printer support C @MCPM19E 07.01.02 PM019 DP printer support C @MCPS30 08.00.12 Print System 30 Microcode C @MCPSPIB 07.00.09 PSPIB printer microcode 5.6.2 Printer Font Files LIBRARY = @30710PN (5577) 10 pitch fonts C COURIER Courier C DRAFT Draft LIBRARY = @30F06LA (LCS15) 20 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F06PA (LCS15) 20 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F07LA (LCS15) 17 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F07PA (LCS15) 17 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique - 24 - LIBRARY = @30F08LA (LCS15) 15 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F08PA (LCS15) 15 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F10LA (LCS15) 12 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique - 25 - LIBRARY = @30F10PA (LCS15) 12 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F12LA (LCS15) 10 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @30F12PA (LCS15) 10 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @31010LN (LDP8) 10 pitch landscape fonts C COURBOLD Courier Bold (internal) C COURIER Courier C LTRGOTAS Letter Gothic ASCII C LTRGOTLG Letter Gothic LEGAL LIBRARY = @31010PN (LDP8) 10 pitch portrait fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C LTRGOTAS Letter Gothic ASCII C LTRGOTLG Letter Gothic LEGAL LIBRARY = @31012LN (LDP8) 12 pitch landscape fonts C LTRGOTBD Letter Gothic Bold C LTRGOTHC Letter Gothic C LTRGOTIT Letter Gothic Italic C PRESBD Prestige Elite Bold C PRESELTE Prestige Elite C PRESIT Prestige Elite Italic - 26 - LIBRARY = @31012PN (LDP8) 12 pitch portrait fonts C LTRGOTBD Letter Gothic Bold C LTRGOTHC Letter Gothic C LTRGOTIT Letter Gothic Italic C PRESAS Prestige Elite ASCII C PRESBDAS Prestige Elite Bold ASCII C PRESBDLG Prestige Elite Bold LEGAL C PRESELTE Prestige Elite C PRESFS Prestige Elite Full Science C PRESIT Prestige Elite Italic C PRESITAS Prestige Elite Italic ASCII C PRESITLG Prestige Elite Italic LEGAL C PRESLG Prestige Elite LEGAL C PRESSC Prestige Elite Science LIBRARY = @31015LN (LDP8) 15 pitch landscape fonts C DRAFT Draft (Internal) C PRESAS Prestige Elite ASCII C PRESLG Prestige Elite LEGAL LIBRARY = @31015PN (LDP8) 15 pitch portrait fonts C DRAFT Draft (Internal) C PRESAS Prestige Elite ASCII C PRESELTE Prestige Elite C PRESFS Prestige Elite Full Science C PRESLG Prestige Elite LEGAL LIBRARY = @31310LN (LIS12/24) 10 pitch landscape font C COURIER Courier LIBRARY = @31310PN (LIS12/24) 10 pitch portrait font C COURIER Courier LIBRARY = @31610LN (LPS8) 10 pitch landscape font C COURIER 10 pitch landscape font LIBRARY = @31610PN (LPS8) 10 pitch portrait font C COURIER 10 pitch portrait font - 27 - LIBRARY = @31810PN (LM900) 10 pitch fonts C DRAFT BL173010 Draft regular C DRAFTAS SM300010 Draft ASCII C DRAFTLIT BL173010 Draft light C DRAFTMED BL173010 Draft regular C GOTHIC BL173010 Gothic regular C MEMO BL173010 Memo regular LIBRARY = @31812PN (LM900) 12 pitch fonts C DRAFT Draft regular C DRAFTAS SM300010 Draft ASCII font C DRAFTLIT Draft light C DRAFTMED Draft medium C GOTHIC Gothic regular C MEMO Memo regular LIBRARY = @31815PN (LM900) 15 pitch fonts C GOTHIC CM100066 Gothic regular LIBRARY = @31910PN C COURIER JM111010 10 Pitch Courier regular (5578) C DRAFT JM076010 10 Pitch Draft regular (5574) LIBRARY = @31B10LN (PS30) 10 pitch landscape fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) LIBRARY = @31B10PN (PS30) 10 pitch portrait fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) LIBRARY = @31B12LN (PS30) 12 pitch landscape fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) - 28 - LIBRARY = @31B12PN (PS30) 12 pitch portrait fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) LIBRARY = @31B15LN (PS30) C DRAFT 15 pitch landscape Draft (internal) LIBRARY = @31B15PN (PS30) C DRAFT 15 pitch portrait Draft (internal) LIBRARY = @31C10LN (PCL5) 10 pitch landscape fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) C LTRGOTAS Letter Gothic ASCII C LTRGOTLG Letter Gothic LEGAL 10 pitch landscape fonts LIBRARY = @31C10PN (PCL5) 10 pitch portrait fonts C COURIER Courier (internal) C COURBOLD Courier Bold (internal) C COURITAL Courier Italic (internal) C LTRGOTAS Letter Gothic ASCII C LTRGOTLG Letter Gothic LEGAL LIBRARY = @31C12LN (PCL5) 12 pitch landscape fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) C LTRGOTBD Letter Gothic Bold C LTRGOTHC Letter Gothic C LTRGOTIT Letter Gothic Italic C PRESBD Prestige Elite Bold C PRESELTE Prestige Elite C PRESIT Prestige Elite Italic - 29 - LIBRARY = @31C12PN (PCL5) 12 pitch portrait fonts C COURBOLD Courier Bold (internal) C COURIER Courier (internal) C COURITAL Courier Italic (internal) C LTRGOTBD Letter Gothic Bold C LTRGOTHC Letter Gothic C LTRGOTIT Letter Gothic Italic C PRESAS Prestige Elite ASCII C PRESBD Prestige Elite Bold C PRESBDAS Prestige Elite Bold ASCII C PRESBDLG Prestige Elite Bold LEGAL C PRESELTE Prestige Elite C PRESFS Prestige Elite Full Science C PRESIT Prestige Elite Italic C PRESITAS Prestige Elite Italic ASCII C PRESITLG Prestige Elite Italic LEGAL C PRESLG Prestige Elite LEGAL C PRESSC Prestige Elite Science LIBRARY = @31C15LN (PCL5) 15 pitch landscape fonts C DRAFT Draft (Internal) C PRESAS Prestige Elite ASCII C PRESLG Prestige Elite LEGAL LIBRARY = @31C15PN (PCL5) 15 pitch portrait fonts C DRAFT Draft (Internal) C PRESAS Prestige Elite ASCII C PRESELTE Prestige Elite C PRESFS Prestige Elite Full Science C PRESLG Prestige Elite LEGAL LIBRARY = @31E10PN (LINPIB) 10 pitch fonts C DRAFT LN800010 Draft (DP) C HSDRAFT LN800010 Hi Speed Draft C HSDRAFTB LN800010 Hi Speed Draft B C HSDRAFTC LN800010 Hi Speed Draft C C OCRA LN800010 OCR-A C OCRB LN800010 OCR-B C ROMN LN800010 Roman (NLQ) LIBRARY = @31E12PN (LINPIB) 12 pitch fonts C DRAFT LN800010 Draft (DP) C HSDRAFT LN800010 Hi Speed Draft C HSDRAFTB LN800010 Hi Speed Draft B C HSDRAFTC LN800010 Hi Speed Draft C C ROMN LN800010 Roman (NLQ) - 30 - LIBRARY = @31E15PN (LINPIB) 15 pitch fonts C DRAFT LN800010 Draft (DP) C HSDRAFT LN800010 Hi Speed Draft C HSDRAFTB LN800010 Hi Speed Draft B C HSDRAFTC LN800010 Hi Speed Draft C C ROMN LN800010 Roman (NLQ) LIBRARY = @32706LA (PSPIB) 20 pitch landscape font C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32706PA (PSPIB) 20 pitch portrait font C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32708LA (PSPIB) 15 pitch landscape font C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32708PA (PSPIB) 15 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32710LA (PSPIB) 12 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique - 31 - LIBRARY = @32710PA (PSPIB) 12 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32712LA (PSPIB) 10 pitch landscape fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32712PA (PSPIB) 10 pitch portrait fonts C COURBDOB Courier Bold Oblique C COURBOLD Courier Bold C COURIER Courier C COUROB Courier Oblique LIBRARY = @32910PN (EPLQ) 10 pitch portrait fonts C COURIER LQ800010 Courier font C COURITAL LQ800010 Courier Italic font C DRAFT LQ800010 Draft font C OCRA LQ800010 OCR-A font C OCRB LQ800010 OCR-B font C ORATOR LQ800010 Orator-S font C ORATORN LQ800010 Orator font C PRES LQ800010 Prestige Elite font C PRESIT LQ800010 Prestige Elite Italic font C QUIC LQ800010 Quick Gothic (HQ) font C ROMN LQ800010 Roman font C ROMNIT LQ800010 Roman Italic font C SANS LQ800010 San Serif font C SANSIT LQ800010 San Serif Italic font C SCRIIT LQ800010 Script Italic font C SCRIPT LQ800010 Script font C SOUV LQ800010 ITC Souvenir (HQ) font C SOUVIT LQ800010 ITC Souvenir Italic (HQ) - 32 - LIBRARY = @32912PN (EPLQ) 12 pitch portrait fonts C COURIER LQ800010 Courier font C COURITAL LQ800010 Courier Italic font C DRAFT LQ800010 Draft font C HSDRAFT LQ800010 HS Draft Gothic (HQ) font C OCRA LQ800010 OCR-A font C OCRB LQ800010 OCR-A font C PRES LQ800010 Prestige Elite font C PRESIT LQ800010 Prestige Elite Italic font C QUIC LQ800010 Quick Gothic (HQ) font C ROMN LQ800010 Roman font C ROMNIT LQ800010 Roman Italic font C SANS LQ800010 San Serif font C SANSIT LQ800010 San Serif Italic font C SCRIIT LQ800010 Script Italic font C SCRIPT LQ800010 Script font C SOUV LQ800010 ITC Souvenir (HQ) font C SOUVIT LQ800010 ITC Souvenir Italic (HQ) LIBRARY = @32915PN (EPLQ) 15 pitch portrait fonts C COURIER LQ800010 Courier font C COURITAL LQ800010 Courier Italic font C DRAFT LQ800010 Draft font C PRES LQ800010 Prestige Elite font C PRESIT LQ800010 Prestige Elite Italic font C ROMN LQ800010 Roman font C ROMNIT LQ800010 Roman Italic font C SANS LQ800010 San Serif font C SANSIT LQ800010 San Serif Italic font C SCRIIT LQ800010 Script Italic font C SCRIPT LQ800010 Script font C SOUV LQ800010 ITC Souvenir (HQ) font C SOUVIT LQ800010 ITC Souvenir Italic (HQ) LIBRARY = @IPLOVLY C @0013000 LCS15-2 front panel messages C @0013001 7.02.02 LCS15-2 image overlay and error handler C @0013002 PV80032001 LCS15-2 prologue file C @0098000 1.1 User print engine tables C @0223000 .11 LIS-12/24 firmware LIBRARY = GP1FONT (LIS12/24) C COURIER Graphic Stroke C MARKER Graphic Stroke - 33 - 5.7 CP9/CP11 System Boot Files Library = @SYSTEM@ M9 @MCCP9@ 09.80.20 CP9 CPU microcode M11 @MCCP11@ 09.81.11 CP11 CPU microcode M9 @MCRCU@ 01.08.00 RCU microcode M9 @SB50801 00.00.03 VS5000 Series TC-1 soft-boot loader microcode M9 @SB50861 01.03.00 CP9 CPU microcode file M9 @SB50862 01.00.00 CP9 CPU microcode file M9 @SB50863 01.00.00 Softboot loader microcode M9 @SB50864 01.00.00 Softboot loader microcode 5.8 Loadable Workstation Microcode Library = @SYSTEM@ C @2246S1 05.01.03 029 with standard keypad C @2246S2 05.01.03 2246S with reverse numeric keypad C @2246S2B 05.01.05 Microcode for 32K serial DP-only workstation C @2246S3 05.01.03 029 w/reverse keypad C @4210WM 07.00.00 Microcode for 4210 workstation C @4250GH 07.00.00 4250GH workstation microcode C @4250GM 07.00.00 4250GM workstation microcode C @6300GM 07.00.00 Microcode for graphics workstation C @MC2246C 07.00.04 Microcode for serial DP/WP workstation (2246C) C @MC2246R 04.03.13 2246 Remote workstation microcode M @MC2246S 07.00.01 Microcode for 16K serial DP-only workstation C @MC2256A 07.03.00 Microcode for DP support for workstations C @MC2256C 07.10.00 Microcode for serial DP/WP workstation (2256C) - 34 - C @MC2266C 05.01.05 Microcode for 48K-RAM DP/WP archiving workstation C @MC2266S 05.01.03 Microcode for 32K-RAM DP-only archiving workstation C @MC4205 07.00.02 Microcode for the 4205 32K RAM DP workstation C @MC4220R 06.01.10 4220 Remote workstation microcode C @MC4230 07.10.00 4230 workstation microcode C @MC4245 07.10.00 Microcode for the color graphic workstation C @MC4250 07.03.04 4250 workstation microcode C @MCPCIWS 07.00.00 Microcode for 11X type workstations C @MCPCSWS 07.10.00 PCSWS workstation microcode 5.9 LOADABLE TAPE MICROCODE C @MC2238V 07.00.00 Streamer tape microcode C @MC2509V 06.00.05 Serial 9-Track Tape microcode C @MC2529V 05.00.07 Cartridge tape microcode 5.10 DEVICE CONTROLLER MICROCODE CH @22V68 01.01.01 22V68 IOC microcode C8 @23V14 03.02.02 RSF wire cable microcode C8 @23V24 03.02.02 Microcode for ITC for WIIS C8 @23V95KN 02.05.03 Microcode for Kennedy Tape C8 @23V95TX 02.10.11 Telex Tape IOC microcode C8 @23V96DE 02.06.01 DE controller microcode for the 2110 workstation C8 @23V96RW 01.07.03 Multiline IOC microcode for remote workstation C8 @23V97W 05.07.30 928W serial IOC microcode C8 @23V98 03.05.02 Microcode for SMD Disk IOC C9 @50V68 01.04.00 VS5000/6000 single-port SCSI IOC microcode - 35 - C9 @50V68E 01.01.00 VS5000/6000 single-port Caching SCSI IOC microcode C9 @50V96DE 01.06.01 2110 microcode for DCC-8 board C9 @50V97W 02.00.05 50V97 IOC microcode C9 @50V98 01.02.04 VS5000 SMD IOC microcode CH @70V67 01.00.10 Serial IOC microcode C8 @70V68 03.03.00 VS300/7000/8000/10000/12000 IOC microcode C8 @70V98E 03.04.44 Caching Disk IOC Microcode C8 @MC23V46 01.05.01 2110 microcode for LADC boards C9 @MC50V67 02.00.05 928 serial I/O microcode CH @MCWACS 02.06.07 WACS IOC microcode 5.11 @ASCII@ MICROCODE (Federal Information Processing Standards - FIPS) Library = @ASCII@ C @4250GM B7.00.00 FIPS microcode for 4250 graphics workstation C @5535S A5.01.08 FIPS microcode for Low Cost matrix printer C @MC2256A B7.03.00 Workstation DP support C @MC2266C A5.01.05 FIPS microcode for 8-inch archiving workstation C @MC4205 A7.00.02 FIPS microcode for 4205 workstation C @MC4220R A6.01.10 FIPS microcode for 4220R/2233R devices C @MC4230 A7.10.00 FIPS microcode for 4230 workstation C @MC4245 A7.10.00 FIPS microcode for 4245 workstation C @MC5575 A5.01.07 FIPS microcode for 5575 printer C @MCDW55 A6.01.03 FIPS microcode for DW55 printer C @MCDW60 A6.00.07 FIPS microcode for DW60 printer - 36 - Library = @SYSAS@ CH @23V96DE RAS 2.06.01 DE controller microcode for the 2110 workstation C @50V96DE RAS 1.06.01 FIPS microcode for 50V96DE DCC-8 board for the 2110 workstation C @MC23V46 RAS 1.05.01 LADC 2110 microcode M9 @MCRCU@ RAS 1.08.00 Resource Control Unit microcode C @MCWACS RAS 2.06.07 WACS IOC microcode 5.12 USER DOCUMENTATION O LIBRARY = CSRNLIB OS75300 07.53.00 Software Release Notice (this document) - 37 - CHAPTER 6 INSTALLATION 6.1 OVERVIEW This chapter describes the installation of the VS Operating System Release 07.53.00. Please be sure to carefully read the section entitled "VSOS Software Licensing" (Appendix A) for information concerning changes in the installation and system IPL due to the 07.53 System Licensing Support. Additional software packages required for installation include: o Small VS RCU-class Diagnostic Package (CP9/11 systems). o CP8, CP10, CP12, CP14 and CP16 systems, refer to the appropriate System Console Unit (SCU) Customer Software Release Notice for your system. 6.2 PRELIMINARY STEPS FOR UPGRADES 1. Inhibit logons and ensure that all users are logged off the system. 2. Logon to the system as a System Administrator. 3. If installing Release 07.53.00 on a CP8, CP10, CP12, CP14 or CP16 system, be sure to verify that the System Control Unit has been loaded with the current version of CPU microcode. If installing Release 07.53.00 on a CP9 or CP11 system, be sure to verify that you have loaded the current version of CPU microcode, as follows: CP9/11: in @SYSTEM@ on the IPL disk From the SYSCON screen, press PF12 to display system options. 4. If a current backup of the entire system volume is not available, use the BACKUP utility to perform this backup now. 5. When the Operating System is installed, all information in the system QUEUE file will be lost. To ensure your new system is set up exactly as it was prior to the installation, perform the following: - 38 - a. Using Operator's Console functions, note the outstanding jobs and transmissions listed in the Print, Procedure, Transmit, and Receive Queues so that they may be reconstituted after the installation. Alternately, wait for all outstanding jobs and transmissions to finish processing before proceeding. b. Note the defaults for dual-mode workstations (additional Operator's Consoles), background job classes, printer class assignments, system parameter settings, page pool commitment ratio, and SPOOL/WORK/PAGE volumes. 6. When satisfied that your old system is satisfactorily backed up, proceed to the next section and begin the installation. 6.3 SOFTWARE INSTALLATION USING VS BACKUP (All CP Types) Refer to the "VS Media, Transfer, and Device Utilities Reference" for instructions on using the BACKUP and DISKINIT utilities. 6.3.1 Running BACKUP 1. Create a new system volume (for installing the operating system) using the INITIALIZE function of DISKINIT, with IPL VOLUME = YES. Refer to the "VS Media, Transfer, and Device Utilities Reference" for information on setting other options in DISKINIT. 2. Mount the newly initialized volume and the tape containing the Release 07.53.00 Operating System. 3. Using BACKUP, RESTORE Release 07.53.00 from the distribution media to the newly initialized disk. Use the following specifications: INPUT screen: VOLUME = (name of distribution media) DEVICE = TAPE FUNCTION = RESTORE ERRDISP = YES FILESEQ = MOREFILE = NO SELECT = NO OUTPUT screen: VOLUME = (name of new system volume) DEVICE = DISK CLEAR = NO - 39 - OPTIONS screen: DUPFILES = SCRATCH LOGFILES screen: Press ENTER to obtain a log file. EOJ screen: Press PF16 or ENTER to terminate BACKUP. 4. Dismount the release media from the tape drive. 5. Verify the existence of file WANGVS in library LICENSE on your new system volume. If this file is not present, please contact the Wang Software Distribution Center or your Wang Representative. The Wang VS Software Distribution Center can be contacted by the following methods. Mail: Wang Laboratories, Inc. 836 North St. Tewksbury, Ma. 01876 M/S 027-G1B Attn: SDC Customer Service Phone: (508) 858-8600 FAX: (508) 858-7043 E-Mail: SDC.CUSTOMERSERVICE@office.wang.com 6. CP9 and CP11 systems must load the Small VS RCU-Class Diagnostic Package. Refer to the appropriate Customer Software Release Notice for installation instructions. 7. Using the DISKINIT utility, RELABEL the newly created system volume. The system will not IPL unless it is RELABELed. 8. On completion of the installation, run SSL to provide an ALIAS name of GENSSL for GENEDIT. a. Run SSL. b. The System Administrator must verify whether the alias GENSSL already exists, and what steps must be taken to continue: If a GENSSL alias name was created for GENEDIT from a previous installation, exit the utility. - 40 - If a GENSSL alias name was created for non-GENEDIT purposes, a substitute alias name must be provided for that function. Once the substitution is complete, go to step 6C to create a new GENSSL alias name for the GENEDIT utility. If a GENSSL alias does not exist, go to step 6C. c. Press PF11 on the MAIN screen of the SSL utility to create the alias name, GENSSL. Type in the GENSSL alias name. The SYSVOL (Y/N) parameter should remain blank. The GENSSL alias name is required in the following location: Volume = System Volume Library = @SYSTEM@ File = @GENSSL d. Press PF-16 to exit the utility. If these steps are not performed, the following error message will be displayed on the screen when the GENEDIT utility is run: "Error creating static from MAP - SSL possibly not mapped". 6.3.2 CONFIGURING THE SYSTEM NEW SYSTEM CONFIGURATION 1. If you are not IPL'd from the new system volume, do so now, using the PF1 option to specify a minimum configuration. If you are already IPLed, go to step 2. 2. Run GENEDIT and create a new configuration file for the system. 3. IPL, specifying the new configuration file. 4. Proceed to section 6.4. - 41 - CONFIGURING UPGRADED SYSTEMS First restore the system configuration files backed up earlier. Use the BACKUP or COPY utility to copy these files from the old system volume to the corresponding library on the new volume. Also, restore at this time certain other files that will be needed at later stages of the installation. These are: SSL files (e.g., @ALIAS@), print-form definitions (FORMDFFN), and the following security files: @SECFILE, USERLIST, GROUPLIST. Use the BACKUP or COPY utility to copy these files from the library @SYSTEM@ on the old system volume to @SYSTEM@ on the new system volume. To do this, perform the following steps: 1. IPL from the new system volume, pressing PF1 for a minimum configuration. 2. Run the GENEDIT utility, and configure the drive you will be using to restore your backed-up files. From the main GENEDIT screen, press PF4 to save the new configuration file and exit. 3. IPL, specifying the new configuration file. 4. Run BACKUP or COPY and restore the files mentioned above. 5. Now convert the files just restored to the new format. Run GENEDIT, specifying, one by one, each of the configuration files that you wish to convert. If you wish, you may make changes to the file(s). When you save the file(s), GENEDIT will automatically perform the conversion. 6. If you wish to create new configuration files, do so now and save them. 7. IPL from the new system volume, specifying either a converted or new configuration file, and verify that the system operates correctly. 6.3.3 RENAMING THE OLD SYSTEM VOLUME (UPGRADES ONLY) To ensure that procedures and programs that reference the system volume do not have to be changed, you should rename the new system volume with the name of the old system volume. To do this: 1. While still IPLed from the new system volume, rename the old system volume. 2. IPL from the old system volume, and rename the new system volume with the original name of the old system volume. - 42 - 6.4 FINAL STEPS 1. If you are not IPLed, do so. Specify the normal configuration file. Inhibit logons. 2. If you have font-loading printers, install the fonts for them as follows: a. Ensure that all font-loading printers are turned off. LIS-12/24 printers may remain powered on to allow them to warm up, but the printer control box must be turned off. b. Run the FONTCNTL utility and install at least one font for each device. (For information on FONTCNTL, refer to the VS System Administration and Analysis Utilities Reference.) c. Turn on the printers. Allow approximately one half minute per printer for initialization to complete. The printer microcode will select the printer after the microcode is loaded and running. Printers with an audible hardware alarm will signal the completion of initialization. The following instructions apply only to systems that are being upgraded: 3. Verify that the file @TOPLIB@ in library @SYSTEM@ exists on the new system volume. If @TOPLIB@ is not in library @SYSTEM@, it may be in library @DOCLIB@. If it is, copy the file to @SYSTEM@ and delete the file in @DOCLIB@. If @TOPLIB@ is not in either @SYSTEM@ or @DOCLIB@, do nothing. The INFO utility will create the file when it is first run on the new system. 4. Also restore any print and data files you may have stored on the old system volume, using the NOCOPY option of BACKUP. 5. Restore the system queues to their pre-installation state, and reassign all system defaults for dual-mode workstations, background jobs and print classes, etc. - 43 - 6.5 INSTALLING TRANSLATED LCS15 FRONT PANEL MESSAGE FILES The LCS15 printer has the ability to download front panel message text that has been translated to languages other than English (English is supplied as the default language). The DP microcode downloads the message file at IPL time and, if required, loads it to the printer when the first job is printed. Standard translation utilities translate the file used by the WP print driver to create the default message file. To install a translated downloadable message file for DP use, you need to copy the WP message file PRINT.T30FMSG (file T30FMSG in WPSPRINT on the system volume) to @0013000 in @IPLOVLY on the system volume. Then perform the following steps: 1. Run COPYOIS. 2. Press PF4 (Copy/Convert OIS File) when the MENU screen appears. 3. On the INPUT screen, enter the system volume name as VOLUME and the string WPSPRINT.T30FMSG as the FILE. Specify DEVICE = VS, and CONVERT = NO. Press ENTER. 4. On the OUTPUT screen, enter the system volume name as VOLUME. Specify OUTPUT FILE = @0013000 and LIBRARY = @IPLOVLY. Press ENTER. 5. Press ENTER again when the MENU screen reappears. The newly installed messages are downloaded and take effect after the next time the printer is IPLed. 6.6 INSTALLING ASCII MICROCODE When you want to use the ASCII microcode, copy the @ASCII@ Library into the @SYSTEM@ library. Library @ASCII@ may be scratched after copying. Re-IPL your system and the @ASCII@ file replaces the standard microcode file. CAUTION: Adding the ASCII microcode replaces the standard microcode. Both the ASCII microcode and the standard microcode cannot reside in @SYSTEM@ and be used at the same time. - 44 - 6.7 COMPLETING THE INSTALLATION OF WSPERSON To use the on-line help facility for WSPERSON, the document file MTDUTIL must be in the library @DOCLIB@ on the system volume. In addition, @DOCLIB@ must be installed in INFO as a topic library with the internal title Wang Documents. Similarly, the file MTDUTIL must be installed as an INFO topic with an appropriate title, e.g., "Media, Transfer, and Device Utilities". To ensure that this is the case, carry out the following steps: 1. From the Command Processor screen, press PF5 to enter the Manage Files and Libraries screen. Verify that the library @DOCLIB@ exists on the system volume, and that it contains the file MTDUTIL. 2. Next, run the INFO utility. 3. If @DOCLIB@ is the only topic library INFO recognizes, you will be placed directly in the Topic Selection screen. Verify that "Wang Documents" is listed at the top of the screen as the topic library. If this is the case, go on to step 4. If not, go to step 5. If INFO contains more than one topic library, the Topic Library Selection screen will appear. TAB to the "Wang Documents" entry, and press ENTER. The Topic Selection screen will appear. If "Wang Documents" is not listed, go to step 5 for instructions on how to create this entry. Otherwise, continue with step 4. 4. At the Topic Selection screen, verify that there is an entry for Media, Transfer, and Device Utilities either by tabbing through the list of topics, or by using the PF9 (Find) key. If this entry exists, the verification is complete. Press PF16 twice to exit INFO. Otherwise, go to step 5. 5. If either the topic library "Wang Documents" or the topic "Media, Transfer, and Device Utilities" is missing, refer to the "VS INFO User's Guide" for instructions on how to install libraries and topics. When you have completed the installation, repeat the verification above. - 45 - 6.8 MISCELLANEOUS NOTES When you have completed all phases of the installation of Release 07.53.00 and are satisfied that every feature is set correctly, use the BACKUP utility to back up your new system volume. When you are using VSGF graphics printing on LIS-12 or LIS-24 printers, run FONTCNTL and install the graphic stroke fonts. You must install COURIER in GP1FONT font number 999, and MARKER in GP1FONT font number 998. Do not install either of these fonts as the default font. When you send a job to the queue before the printer completes the power-on sequence, the printer may not post the "Change Form" message that precedes the first job. At this time you may wish to install any additional software, such as compilers or word processing (WP) software on the new system volume. Refer to the specific installation guide or Customer Software Release Notice for each software package. The VS system does not IPL the printer if a file is queued to the printer prior to turning on the printer. - 46 - APPENDIX A SOFTWARE LICENSING With Operating System version 7.53.00, a License File will be required for full functionality. This document describes the new VS Operating System License requirements. The License File is a 2048 byte file to be installed in library "LICENSE" as file "WANGVS" on the target IPL volume. It contains the Customer name, NODEID, CPU Serial number, and Wang VSOS License number. This file is interrogated by the Operating System at each IPL and should never be modified or deleted. The License File is supplied by the Wang Software Distribution Center. Prior to ordering/installing System 7.53.00 you will need to gather the following information for each VS system to be licensed: CUSTOMER NAME The customer name is the name that the Wang VSOS software license is granted under. This name will be displayed on each Logon screen. NODEID The node ID is specified in the active VS Configuration file. It is recommended that this field be unique for each machine. CPU SERIAL NUMBER Each Wang VS machine has a unique serial number usually located on the rear of the cabinet or inside the door. CPU TYPE Each Wang VS CPU type is displayed within the GENEDIT utility when displaying the appropriate model name. WANG SALES ORDER NUMBER The Wang Sales Order Number is your license order number. If you have provided this information at the time of order, your copy of the VS Operating System will contain the appropriate License File. The License File and License Verification Codes will be generated by The Wang Software Distribution Center upon receipt of an order and the information describe above. A License File shipped on the VS Operating System installation tape will be named "WANGVS" and be located in library "LICENSE". You will also find a License Print File, "POxxxxx" where "xxxxx" is your License number in the "LICENSE" library. This print file contains the License Verification Codes which are necessary to reinstall the License File should the License File be inadvertently damaged or deleted. - 47 - It is recommended that you create a BACKUP copy of the License and License Print Files and store it in a secure location. You should also create a hard copy printout of the License Print File (which contains the License Verification Codes) and store it in a secure location. Should the need arise to replace the License File simply restore the BACKUP copy to file name "WANGVS" in library "LICENSE" on the appropriate IPL volume or use the License Verification Codes from the hard copy printout of the License Print File to reinstall the License File. If you do not have a License File on the VS Operating System installation tape you will need to obtain a License File or License Verification Codes from Wang's Software Distribution Center. You can do so by: 1. Running program LICENSE in @SYSTEM@ on your 7.53.00 IPL volume. 2. Enter the requested information and select the PRINT option. 3. Send the PRINT output to Wang's Software Distribution Center by FAX, mail, or telephone: Mail: Wang Laboratories, Inc. 836 North St. Tewksbury, Ma. 01876 M/S 027-G1B Attn: SDC Customer Service Phone: (01) 508 858-8600 FAX: (01) 508 858-7043 E-Mail: SDC.CUSTOMERSERVICE@office.wang.com - 48 - Customers in Europe, Africa and the Middle East should contact the European Software Manufacturing and Distribution Centre (ESMDC): Mail: Wang Ireland B.V. Unit 2B Annacotty Industrial Estate Annacotty Limerick Ireland Phone: 353 61 335 244 X2111 FAX: 353 61 335 601 Wang's Software Distribution Center will return to you the License Print File that contains the License Verification Codes. During the system IPL process you will need these codes to complete System Generation. The IPL of the 7.53.00 Operating System requires the existence of the License File on the IPL volume. If your installation tape includes the file, the installation and IPL of the Operating System will occur with no change to the process. If the License File is not on the installation tape, the IPL of the 7.53 Operating System will be interrupted with error screens. - 49 - The following screens are displayed during the IPL process when errors are encountered. Descriptions of possible causes and recommended actions are listed. During System Generation: ************************************************************* The Wang VS Operating System License is either Invalid or Non-existent. Press enter to continue with minimal Operating System support Or press (PF5) to install a valid License. ************************************************************* The Operating System may have encountered an invalid License File. The data (NODEID and CPUTYPE) in the License File may not match the data in the VS Configuration File. Pressing ENTER allows the system to continue the IPL process. This will give you the capability to investigate and correct the problem. The system functionality will be restricted to usage of Workstation Zero and all disks, printers and tape units defined in the specified VS Configuration File. To investigate Run the DISPLAY utility to display file WANGVS in library LICENSE to verify that the correct License File has been installed for this machine. Run the GENEDIT utility to verify that the correct NODEID has been defined. - 50 - The Operating System may have not found a License File on the IPL volume. Pressing PF5 allows you to enter the License Verification Codes to install a License File. The following screen will then be displayed. ************************************************************* Enter the name this license is being granted under. NAME = --------------------------------------- Enter the WSN Networking name used by this license. NODEID = -------- Enter the Serial Number of the CPU SERIAL = ------ Enter the CP type for this license. CPU = -- (Enter) Continue - (16/32) Exit. ************************************************************* Enter the data from the appropriate License Print File. The License Print File is supplied by Wang's Software Distribution Center as a file in the library LICENSE on the VSOS Installation tape or as a FAX printout. Data is case sensitive and must be entered exactly as displayed on the printout. Pressing ENTER will display the screen below. Pressing PF16/32 will return you to the "Invalid or Non-existent License File" screen. - 51 - ************************************************************** Enter the LICENSE number from your application response. LICENSE = ---------- Enter the License verification codes. CODE1 = -------- CODE2 = ------- CODE3 = -------- CODE4 = ------- (Enter) Continue - (16/32) Exit. ************************************************************* Enter the data from the License Print File exactly. Pressing ENTER will install the License File. If all the data is correct, the Operating System Generation will continue normally. If the data in the License File does not match the VS Configuration file, the "Invalid or Non-existent License File" screen will be presented again. Pressing PF16/32 will return you to the "Invalid or Non-existent License File" screen allowing you to bring the system up with minimal support or restarting the installation of a valid license. - 52 - ************************************************************* There has been a Unrecoverable Error during the creation of your LICENSE file. This error is probably the result of Disk Space exhaustion, or a corrupted VTOC. Press Enter to continue. Your WANG VS License can be installed after the problem has been corrected. ************************************************************* This screen is displayed whenever an error has occurred that prevented the License File from being successfully installed. Pressing ENTER will return you to the "Invalid or Non-existent License File" screen allowing you to bring the system up with minimal support or restarting the installation of a valid license. Continuing System Generation will give you access to the standard VS utilities to determine the cause of the error. - 53 -