DECserver 250 Server for Printers V2.0 VMS Release Notes May 1991 The DECserver 250 V2.0 Release Notes contain updated information on all known problems affecting DECserver 250 operation in a VAX/VMS environment. This document also contains information and examples specific to the V2.0 release of the software. The Re- lease Notes should be distributed to the server manager(s), load host system manager(s) and any other individuals responsible for server maintenance. Digital Equipment Corporation DECserver 250 V2.0 Release note The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subpara- graph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. Copyright 1991 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. The following are trademarks of Digital Equipment Corporation: DEC DECstation VAX DECnet DECsystem VAXcluster DECserver MicroVAX VMS This document was prepared using VAX DOCUMENT, Version 1.2 ii CONTENTS 1 INTRODUCTION......................................... 1 1.1 Installation of DECserver 250 on Load Host........ 1 2 SUMMARY OF CHANGES................................... 2 2.1 UNSUPPORTED DECserver 250 Commands................ 2 2.2 DECserver 250 Undocumented Status and Error Messages.......................................... 3 2.3 Limited TSM Support............................... 4 3 MISCELLANEOUS SOFTWARE NOTES......................... 4 3.1 Server Name....................................... 4 3.2 AUTOBAUD INFORMATION Valid for Port 1 ONLY........ 5 3.3 SET/DEFINE PORT ACCESS NONE Is Not Supported...... 6 3.4 TSM V1.3-01 Required For Use With DS250 V2.0...... 6 4 Problems Fixed In This Release....................... 6 4.1 Stalled Queue Problem............................. 6 4.2 110% CPU Usage and Server Hang Problem............ 7 4.3 Double printed, and dropped lines................. 7 5 SETTING UP VMS LTAxx DEVICES AND PRINT QUEUES........ 7 5.1 Setting up PRINT QUEUES for the LCG01 Color Printer........................................... 8 5.2 Setting Up PRINT QUEUES for the LN03R Printer..... 8 5.3 Setting Up PRINT QUEUES For Serial and Parallel Printers.......................................... 8 iii DECserver 250 V2.0 VAX/VMS Release notes 1 INTRODUCTION The DECserver 250 Server for Printers is a six-line, Ethernet based server for printers which provides all the functions re- quired to support four serial printers and two Digital Parallel Printers. The DECserver 250 has modem support on port 1 (dial- in/dial- out). Modem support is also available (DIAL OUT ONLY), for ports 2-4. The DECserver 250 also supports remote access ports to host systems. There is one version of the DECserver 250 hardware as follows: o DECserver 250 has (4) RS-232-C connections; full modem con- trol on port 1 only o DECserver 250 has (2) Digital parallel printer ports ([TM]Dataproducts interface) The following installation notes emphasize some of the new elements of the DECserver software installation. Full details of the installation process may be found in the DECserver 250 Software Installation Guide. The V2.0 software release supports installation of the DECserver 250 software on VMS V4.7 through V5.4 load hosts. 1.1 Installation of DECserver 250 on Load Host NOTE The loadable image DP0601ENG.SYS within Release V2.0 is different than that of Release V1.0, and must be installed on "ALL" network nodes which are being used as potential load hosts for the DS250. If this is not done, the possi- bility will exist that an earlier version of DP0601ENG.SYS will be loaded whenever the DS250 transmits a load re- quest, since the host that responds to the load request is somewhat arbitrary. 1 DECserver 250 V2.0 VAX/VMS Release notes Enhancements have been made to the DSVCONFIG.COM procedure (Release 1.8), that should facilitate the management of the DSVCONFIG.DAT database and server image files in a VAXcluster environment. Please read the DECserver 250 Software Installation Guide that you received with your software documentation package for a complete description of these changes. Note that the Installation Guide shows examples with DSVCONFIG, version 1.6. 2 SUMMARY OF CHANGES Release V2.0 is a maintenance release of the DECserver 250 software running under the VMS operating system software. See the section on problem fixes for more information. 2.1 UNSUPPORTED DECserver 250 Commands The Local prompt on the DECserver 250 cannot be modified. The Terminal Server Commands and Messages Manual is provided with the DECserver 250 documentation as a reference for the customer. It must be noted that certain commands described in the manual are NOT supported in V1.0 or V2.0 of the DECserver 250 software. The specific commands that are NOT supported are: INACTIVITY [LOGOUT] AND INACTIVITY [TIMER] LIMITED [VIEW] LOCK ON-DEMAND [LOADING] PROMPT REMOTE [MODIFICATION] SHOW/MONITOR/LIST NODES SIGNAL [CHECK] 2 DECserver 250 V2.0 VAX/VMS Release notes 2.2 DECserver 250 Undocumented Status and Error Messages Certain commands function differently on the DECserver 250 than described in the manuals. o PORT port-list - You can specify only one port on the DS250. Certain Informational and Error Messages are different: o LOCAL -020- Logged out on port n This command is present in the DS250 but not in the manual. The message follows a LOGOUT command or port logout caused by other conditions. o LOCAL -032- Session Management for session terminated In the DS250, the message will read "Session management for session canceled". o LOCAL -199- WARNING - Terminal server shutdown in n minutes In the DS250, the message will read "System shutdown in n minutes". The message is issued at regular intervals after a privileged user issues an INITIALIZE command. o LOCAL -210- Connection not established, queued access timeout In the DS250, this message will occur because the service node does not support queuing. o LOCAL -720- Loopback invalid option on parallel port (Er- ror message 720 occurs when TEST PORT command is used with loopback option) o LOCAL -723- Parallel port not ready for TEST (This error occurs when the printer attached to the parallel port is off-line.) o LOCAL -903- Loading from host address This command is present in the DECserver 250, but not in the manual. A load host with the Ethernet address specified by address has volunteered to down-line load the server. This message normally occurs once for each initialization. 3 DECserver 250 V2.0 VAX/VMS Release notes 2.3 Limited TSM Support TSM (Terminal Server Manager) up-line dump of DECserver 250 characteristics is not supported. The DECserver 250 does not have multiple TSM setup command files, for special server port configurations. At this time the user would have to manually create their own special config- uration command files to use with TSM for their DECserver 250 configuration management. 3 MISCELLANEOUS SOFTWARE NOTES The following section supplies additional information regarding some of the DECserver 250 features. This information will help in using and understanding some of the features provided with the DECserver 250. 3.1 Server Name Since the DECserver 250 has the capability to become a full LAT service node on the network, it is necessary that the server name be unique on the network. You should set up the server name to be the same as the DECnet node name you define when configuring the DECserver using the DSVCONFIG.COM procedure. By default, the server name is 'LAT_xxxxxx', where the 'xxx...' is the Ethernet address of the server, and hence is unique on the network. It is extremely important that a unique DECnet node name be SET/DEFINED on the DECserver 250 as well as on the VAX host under the LAT Control Program. Failure to SET/DEFINE a unique SERVER NAME on the DECserver 250 will result in print jobs submitted to the server being lost. 4 DECserver 250 V2.0 VAX/VMS Release notes 3.2 AUTOBAUD INFORMATION Valid for Port 1 ONLY AUTOBAUD supports terminal set to either 7-bit even parity or 8-bit no parity. If you are experiencing incorrect character echoing on your terminal, check the parity and character size settings. The parity and character size settings for a terminal or printer can be changed in one of the following ways: o Change the physical terminal or printer settings. o Use the privileged terminal or printer on the terminal server, and issue a SET PORT command to reset the parity, character size, and speed for the terminal experiencing character echoing problems. When this is done, set AUTOBAUD DISABLED for the terminal. Autobaud has been designed to function upon receiving TWO car- riage returns at speeds of 1200-19200 bps, and THREE carriage returns at speeds below 1200 bps. When pressing the carriage returns, you should allow a short (half second) delay between each one. Rapid-fire carriage returns may result in your having to type more carriage returns for autobaud to be successful. CAUTION AUTOBAUD should generally be disabled on all REMOTE AC- CESS ports, and should definitely be DISABLED on ports connected to printers, dial-out modems and non-LAT host systems. When disabling AUTOBAUD, be sure to set the ap- propriate speed, character size and parity. 5 DECserver 250 V2.0 VAX/VMS Release notes 3.3 SET/DEFINE PORT ACCESS NONE Is Not Supported The DECserver 250 does not support the SET/DEFINE PORT ACCESS NONE feature. Attempts to SET/DEFINE this feature will cause an error message to appear on the users screen. 3.4 TSM V1.3-01 Required For Use With DS250 V2.0 DECserver 250 is supported by TSM V1.3. TSM 1.3-01 is the patch level which must be used with the DECserver 250. Please contact your Customer Support Center for a copy of this patch level of TSM. (NOTE: TSM software is a separate software layered product from the DECserver 250, and requires a separate license.) 4 Problems Fixed In This Release The following problems were fixed in this release of the DEC- server 250 Software. At this time, there are no unresolved problems in this kit. 4.1 Stalled Queue Problem This problem occurred on a number of our high speed parallel band printers. The queue would stall intermittently and could only be restarted by stopping, resetting and restarting the queue. It was caused by the processing procedure used for in- terrupts that were generated in response to noise on the cable. This routine has been corrected. 6 DECserver 250 V2.0 VAX/VMS Release notes 4.2 110% CPU Usage and Server Hang Problem This problem would occur on any parallel printer that was con- nected to the server. When either of the printers received a large number of remote broadcast messages from the LAT, some of the messages were printed garbled. Soon after that occurred the server's CPU usage would go to 100% and the server would hang. This was corrected by suppressing local messages that contained unprintable characters. 4.3 Double printed, and dropped lines This problem would occur when print data was sent to an LP27(connected to a DS250), from a VAX 4000 6000 or VAX 9000 system. The printer would occasionally double print a line, and drop the following line. This was corrected by improving the double buffer management routine that handles incoming data from the network. 5 SETTING UP VMS LTAxx DEVICES AND PRINT QUEUES Please be advised that the information given below is subject to change without notice and should not be construed as a com- mitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. 7 DECserver 250 V2.0 VAX/VMS Release notes 5.1 Setting up PRINT QUEUES for the LCG01 Color Printer When installing an LCG01 Color Printer on the DECserver 250, be sure to follow the DECserver 250 VMS Software Installation Guide in order to create and SET/DEFINE the DECserver 250 server ports and the LTAxxx devices on the host system. When creating the print queues for an LCG01 it is required that the command files provided with the LCG01 color printer be used to cre- ate the LCG01 print queues and to send output to the LCG01 printer. The two files provided with the LCG01 Color printer are LCG01INS.COM, which is used to create an LCG01 print queue and PRINTLCG.COM, which is used to send output file to the LCG01 print queue. Failure to use the LCG01 command files will result in files not being output to the LCG01. 5.2 Setting Up PRINT QUEUES for the LN03R Printer When installing an LN03R printer on the DECserver 250, be sure to follow the DECserver 250 Software Installation Guide in order to create and setup the DECserver 250 server ports and the LTAxxx devices on the host system. When creating the print queues for the LN03R, it is EXTREMELY important that the software and command files that are distributed with the LN03R printers be used to setup the print queues for this device, otherwise the LN03R will not print. Be sure that LATSYM is not specified as the processor in the queue initialization. 5.3 Setting Up PRINT QUEUES For Serial and Parallel Printers Please be advised that the information given below is subject to change without notice and should not be construed as a com- mitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. 8 DECserver 250 V2.0 VAX/VMS Release notes Below is an example of all the settings on the DECserver 250 as well as the VMS host, that were used in a site-specific configuration. The sample DECserver 250 setup listed below is given to show the user all of the actions that must be performed before a VAX host can output a file to a printer attached to the DECserver 250. Additional references for configuring servers and server print queues can be found in the following manuals; o DECserver 250 Software Installation Guide. o DECserver 250 Management Guide. o VMSLAT Control Program (LATCP) Manual (VAX/VMS V5.0 or later Documentation) The sample DECserver 250 setup procedure listed below can serve a couple of functions for the system manager; The procedure can be extracted, modified and used to setup DECserver 250 LTAxxx ports and print queues on VMS host systems; The procedure listed below can also serve as a checklist for the system manager when verifying proper setup of the DECserver 250 Server and the VMS host system. It is strongly recommended that the user follow the instructions in the DECserver 250 Software Installation Guide (VMS) and the DECserver 250 Management Guide when setting up the DECserver 250, and VMS host system LTAxxx devices and print queues. The sample setup listed below is only provided as an example; your site-specific requirements may be different. 9 DECserver 250 V2.0 VAX/VMS Release notes $! $!* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * $! NOTICE: To System Manager or DECserver 250 Installer. $! If this file is extracted for use as a command file $! then this command file MUST be modified to replace the $! the ***server_name*** and the ***node_name*** with the $! actual DECserver 250 server name and the host VMS node name. $! Invoke This Modified Command File ONLY after installing the Latest $! Version of DECserver 250 Software. DO NOT USE THE INITIALIZE $! QUEUE command given below to setup the LCG01 or the LN03R printers, $! use the queue setup command files, provided with the LCG01 and LN03R $! software. $!* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * $! DECserver 250 SETUP FOR A SINGLE NODE AND DS250 PORT 1 $! THIS COMMAND FILE CONTAINS SETUP INSTRUCTIONS FOR LATCP $! AS WELL AS TERMINAL DEVICE SETUP, AND QUEUE CREATION $! COMMANDS. $!****************************************************************** $! STEP 1) MAKE LOGICAL ASSIGNMENT required for downloading a DS250 $!****************************************************************** $! You can make the following logical assignment. This definition $! should be added to the site-specific startup command file. $! $! $define/system/exec/name_attribute=no_alias/nolog MOM$LOAD - $! _$ SYS$SYSROOT:[DECSERVER] $!****************************************************************** $! STEP 2) USE THE DSVCONFIG.COM to Configure your DECserver 250 $!****************************************************************** $!@SYS$SYSROOT:[DECSERVER]DSVCONFIG $! or $!@SYS$COMMON:[DECSERVER]DSVCONFIG $! $! The DSVCONFIG.COM file will configure your DECNET for you as shown $! below, however from the DSVCONFIG.COM menu you will not see the $! DECNET NCP commands invoked. $! NCP Commands SET the DS250 DECNET ADDRESS under NCP $! and set SERVICE ENABLED $! 10 DECserver 250 V2.0 VAX/VMS Release notes $!$MC NCP SET NODE ***server_name*** $!$MC NCP DEF NODE ***server_name*** $! $!$MC NCP SHO ACT CIR CHAR $!$MC NCP SET CIR QNA-0 STATE OFF $!$MC NCP SET CIR QNA-0 SERVICE ENABLE ! Set SERVICE = ENABLE $!$MC NCP DEF CIR QNA-0 SERVICE ENABLE ! Set SERVICE = ENABLE $! ! ENABLE in NCP DATABASE $!$MC NCP SET CIR QNA-0 STATE ON $! $! This command procedure starts up the LAT protocol $! and configures applications devices for remote printer use. $! $!****************************************************************** $! STEP 3) RUN SYSGEN to CONNECT Virtual Device LTA0 $!****************************************************************** $! $ RUN SYS$SYSTEM:SYSGEN CONNECT LTA0/NOADAPTER EXIT $! $!****************************************************************** $! STEP 4) Run LATCP to CREATE and SETUP virtual LTAxx ports $!****************************************************************** $! $ RUN SYS$SYSTEM:LATCP ! ! The following commands will set up LAT service with the default name ! SYS$NODE and default ident SYS$ANNOUNCE. Insert your own name or ! identification string if desired or if these logicals are not ! defined. ! SET NODE /ENABLE=(0,40,41,42,43,44,45,141,216,255) CREATE SERVICE ***nodename***/IDENT="***nodename*** VAX - Finance System" ! ! Set up the applications devices that will support remote printer ! access. ! 11 DECserver 250 V2.0 VAX/VMS Release notes ! Create the devices. ! CREATE PORT LTA251: /NOLOG ! ! Maps applications port(s) to a specific port(s) on the terminal ! server ! SET PORT LTA251: /APPLICATION /NODE=***server_name*** /PORT=PORT_1 ! ! Start LAT Service ! START NODE EXIT $! $!****************************************************************** $! STEP 5) Logon to DS250 via a Remote Console Connection (RCF), $! Terminal Server Manager Software TSM or simply $! logon to Port 1 and setup the DS250 Port 1 if you wish $! to use Port 1 as a printer port. $!****************************************************************** $!NOTE: system Manager must perform this section manually. $!****************************************************************** $! Remote Console Facility (RCF) procedure $! MC NCP CONNECT VIA xxx-0 PHYSICAL ADDRESS 08-00-2B-0F-77-20 $! # ACCESS $! Enter Username> Test $! Local> $! Local> Set Priv $! Password>SYSTEM $! Local> $! $! Note: xxx-0 is the Ethernet controller (QNA-0,UNA-0, BNA-0, etc.) $! $!Logon to the DS250 Server directly or from a Vax by using either $!RCF or TSM software and set the port as follows (REMOTE access $!for printer port, AUTOBAUD DISABLED) $! $!Local>DEF/SET SERVER NAME ***server_name*** 12 DECserver 250 V2.0 VAX/VMS Release notes $!Local>DEF/SET PORT 1 ACCESS REMOTE $!Local>DEF/SET PORT 1 SPEED 9600 $!Local>DEF/SET PORT 1 AUTHORIZED GROUPS 0,2,45,255 ENABLED! Ports 1-6 $! (or) $!Local>DEF/SET PORT 1 AUTHORIZED GROUPS 0-255 ENABLED! Groups on port 1 $! (or) $!Local>DEF/SET PORT ALL AUTHORIZED GROUPS 0-255 ENABLED! All groups/All $! ports $! **************************************************************** $!NOTE: *** Be sure to DEF/SET PORT ALL AUTHORIZED groups to the *** $! *** proper group codes to match the nodes which may print to *** $! *** the DS250 Server ports 1-6. It is recommended that you *** $! *** selectively enable authorized group codes on each port. *** $! **************************************************************** $! $!Local> SHO PORT 1 $! $!Port 1: $! $!Character Size: 8 Input Speed: 9600 $!Flow Control: XON Output Speed: 9600 $!Parity: None Modem Control: Disabled $! $!Access: Remote Local Switch: None $!Backward Switch: None Name: PORT_1 $!Break: Disabled Session Limit: 4 $!Forward Switch: None Type: Hard $! $!Preferred Service: None $! $!Authorized Groups: 0-1 $!(Current) Groups: 0-1 $! $!Enabled Characteristics: $! $!Autoprompt, Broadcast, Input Flow Control, Loss Notification, $!Message Codes, Output Flow Control, Verification $!***************************************************************** 13 DECserver 250 V2.0 VAX/VMS Release notes $! $!****************************************************************** $! STEP 6) SET VIRTUAL DEVICES for NOSPOOL (useful when this file $! is reinvoked.) $!****************************************************************** $ SET DEVICE LTA251:/NOSPOOL $! $! Set up print queue -- commented out below. $! Remove comment delimiters if you have installed queues from the $! Secure User Environment Option and want a print queue set up. $ $! Your print device can be either a line printer or a hard-copy terminal. $! There are different commands depending upon what you use for a print $! device. $!****************************************************************** $! STEP 7) SETUP LOGICAL ASSIGNMENT of PRINT QUEUE NAMES TO VIRTUAL $! DEVICES $!****************************************************************** $! First define $PRINTER to name the device you will use for printing. $ ASSIGN /SYSTEM LTA251: LTA251$QUE ! if terminal $! $!****************************************************************** $! STEP 8) SETUP TERMINAL CHARACTERISTICS for VIRTUAL LTAxx ports $!****************************************************************** $!Set the printer characteristics if you will be printing on a line $!printer. $!Set the terminal characteristics if you will be printing on a terminal. $!Some terminal characteristics vary, depending upon the type of terminal $!being used. These include: speed, width, length, and device_type. $ SET TERMINAL LTA251: /PERMANENT /NOBROADCAST /NOTYPEAHEAD /NOWRAP - /SPEED=(9600) /WIDTH=(132) /PAGE=(66) $! $!****************************************************************** $! STEP 9) SETTING THE PROTECTION of DEVICE LTAxx Virtual Devices $!****************************************************************** $! $ SET PROT=(S:RWLP,O,G,W) /DEVICE LTA251: $! 14 DECserver 250 V2.0 VAX/VMS Release notes $!****************************************************************** $! STEP 10) SETTING THE QUEUE SPOOLED to the system disk. $!****************************************************************** $! Set your printing device spooled to the queue SYS$PRINT. $ SET DEVICE LTA251: /SPOOLED=(LTA251$QUE, SYS$SYSDEVICE:) $! $!****************************************************************** $! STEP 11) CREATE the PRINT QUEUES for your virtual ports $!****************************************************************** $! Start the queue manager and the print queue. You may want to specify $! a flag page if you have a line printer for a printing device. $! INITIALIZE /QUEUE /START /ON=LTA2: LTA2$QUE ! if terminal $! $ INITIALIZE /QUEUE /START /SEPARATE=(RESET=RESET) /ON=LTA251 LTA251$QUE - /DEFAULT=(NOFEED,FLAG=1,NOBURST) - / NOGENERIC /PROT=(S:D,O:E,G:R,W:W) /PROCESSOR=LATSYM /FORM=0 /RETAIN=ERROR $! $exit 15