#EDIR DATA#
NetWare for Macintosh Installation and MaintenanceDisclaimerNovell®, Inc. makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.Further, Novell, Inc. makes no representations or warranties with respect to any NetWare software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of NetWare software, at any time, without any obligation to notify any person or entity of such changes.TrademarksBtrieve, DR DOS, EXOS, LANalyzer, NetWare, OnLan/PC, Novell, and the N design are registered trademarks of Novell, Inc.Advanced NetWare, Boot Support Module, BSM, ElectroText, Hardware Specific Module, Hot Fix, HSM, Internetwork Packet Exchange, LAN Service, Link Support Layer, LSL, Media Support Module, MSM, Multiple Link Interface, MLI, Multiple Link Interface Driver, MLID, Multiple Protocol Interface, MPI, NetWare Access Server, NetWare Access Services, NetWare Core Protocol, NCP, NetWare Directory Services, NDS, NetWare DOS Requester, NDR, NetWare Express, NetWare Loadable Module, NLM, NetWare Management Agent, NetWare MultiProtocol Router, NetWare NFS, NetWare Requester, NetWare RPC, NetWare Runtime, Network Support Encyclopedia, NetWare 3270 LAN Workstation, NetWare 3270 LAN Workstation for DOS, NetWare 3270 LAN Workstation for Windows, NLM, NE/2, NE/2-32, NE1000, NE1500T, NE2000, NE2100, NE3200, NE32HUB, Novell Labs, Novell Virtual Terminal, NVT, NTR2000, Open Data-Link Interface, ODI, Packet Burst, RX-Net/2, SFT, Topology Specific Module, TSM, TSA, Transaction Tracking System, TTS, Turbo RX-Net, Virtual Loadable Module, and VLM are trademarks of Novell, Inc.NetWire is a service mark of Novell, Inc.Novell Authorized Reseller is a collective mark of Novell, Inc.3Com and 3+Share are registered trademarks of 3Com Corporation.ARCnet is a registered trademark of Datapoint Corporation.AT&T is a registered trademark of AT&T.Apple, AppleShare, AppleTalk, ImageWriter, LaserWriter, LocalTalk, and Macintosh are registered trademarks of Apple Computer, Inc.Citizen is a registered trademark of Tokei Kabushiki Kaisha.COMPAQ is a registered trademark of Compaq Computer Corporation.CompuServe is a registered trademark of CompuServe, Inc.DDS is a trademark of Sony Corporation.DEC is a trademark of Digital Equipment Corporation.Epson is a registered trademark of Seiko Epson Corporation.GE Information Services is a trademark of General Electric Company, USA, which is not connected with the General Electric Company p.l.c. of England.Hayes is a registered trademark of Hayes Microcomputer Products, Inc.Hewlett-Packard, Deskjet, HP, Laserjet, PCL, and Vectra are registered trademarks of Hewlett-Packard Company.IBM, AT, Micro Channel, NetView, OS/2, ProPrinter, and PS/2 are registered trademarks of International Business Machines Corporation.IBM Operating System/2 Local Area Network Server (LAN Server), Presentation Manager, SAA, and XT are trademarks of International Business Machines Corporation.Intel is a registered trademark of Intel Corporation.LAN Manager and LAN Manager Server are trademarks of Microsoft Corporation.Lotus is a registered trademark of Lotus Development Corporation.Microsoft and MS-DOS are registered trademarks of Microsoft Corporation.NFS is a registered trademark of Sun Microsystems, Inc.Okidata and Microline are registered trademarks of Oki Electric Industry Co., Ltd.Panasonic is a registered trademark of Panasonic Office Automation.Pinwriter, Spinwriter, and NEC are registered trademarks of NEC Corporation.PostScript is a registered trademark of Adobe Systems Incorporated.SDI is a registered trademark of Systems Data, Inc.SQL Server is a trademark of Sybase, Inc.Unicode is a registered trademark of Transoft Ltd.UNIX is a registered trademark of UNIX System Laboratories, Inc., a subsidiary of AT&T.WordPerfect is a registered trademark of WordPerfect Corporation.Xerox Diablo is a registered trademark of Xerox Corporation.Copyright Notices© Copyright 1983-1993 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.Novell, Inc.122 East 1700 SouthProvo, UT 84606U.S.A.Portions of Concepts and Supervising the Network are copyrighted © 1993 Imagery Software, Inc.LBL="0"ID="FM19403"About This GuideThis guide explains how to install and maintain NetWare for Macintosh on a file server running NetWare v3.12.This guide does not explain the full procedures for installing idxid="w4104"book="_idx" docset="nw312" tidref="i4444"NetWare v3.12 or configuring the many NetWare features. These procedures are described in idxid="w4105"book="_idx" docset="nw312" tidref="i4450"NetWare v3.12 Installation.Who Should Read This GuideThis guide is for the network administrator responsible for setting up and maintaining AppleTalk networks and for managing file and print services on NetWare networks.idxid="w4106"book="_idx" docset="nw312" tidref="i4488"As the network administrator, you must plan and implement the idxid="w4107"book="_idx" docset="nw312" tidref="i3067"physical internet; this task involves laying the network cables, installing network interface boards, adding and removing nodes, and placing bridges and routers. In addition, you are responsible for installing and configuring network software and services. To perform these tasks, you should have technical knowledge of protocols, network addressing, routing, and operational issues.For information on basic NetWare for Macintosh operations such as logging in to a NetWare file server and using the NetWare Tools software from a Macintosh system, please see idxid="w4108"book="_idx" docset="nw312" tidref="i4293"Using the NetWare for Macintosh Client.Before you install NetWare for Macintosh, be sure to read the READ_ME.1ST file on either the idxid="w4109"book="_idx" docset="nw312" tidref="i4784"NW_MAC diskette or idxid="w4110"book="_idx" docset="nw312" tidref="i3602"MAC UTILITIES diskette. This file contains vital information about the NetWare for Macintosh software and issues of which you should be aware.idxid="w4111"book="_idx" docset="nw312" tidref="i4294"How to Use This GuideThis guide provides the information you need to carry out the following tasks:Install NetWare for MacintoshConfigure AppleTalk networks and zonesSet up the user login environment and login accountsEstablish the security environment for Macintosh clientsidxid="w4112"book="_idx" docset="nw312" tidref="i324"Set up AppleTalk Print Services for Macintosh and DOS usersPrint to NetWare print queuesTroubleshoot the environment and AppleTalk networkMaintain the NetWare for Macintosh environmentMaintain AppleTalk networks and zonesAs the network administrator, your focus usually shifts between two distinct interests: installing NetWare for Macintosh, and maintaining the network after the product is installed. The following two sections offer suggestions on how to make best use of this manual, depending on the nature of your interest.When You Install NetWare for MacintoshWhen you install NetWare for Macintosh on a NetWare v3.12 file server, use this guide as follows:Read Chapter 1, "Before You Begin," for an introduction to the product and a discussion of system requirements. IDREF="FM41478""A Note about AppleTalk Networks" on page 8 introduces AppleTalk terms and concepts that will be helpful while configuring the product. IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 describes the syntax you need to use to configure AppleTalk on the server.Look at the examples in Chapter 3, "Simple Network Installations," and Chapter 4, "More Complex Network Configurations," to find an example network that is close to the one you are installing. Then, substitute the proper data for your site, and follow the step-by-step instructions to install and configure the product.Refer to Chapter 6, "Managing AppleTalk File Services," for information on options in setting up file services.Refer to Chapter 7, "Managing AppleTalk Print Services," for information on options in setting up print services.Read Appendix A, "AppleTalk Configuration Concepts," if you need more technical information about the router configuration.Read Appendix B, "Transition Routing," if you need to configure the router on an internet that contains AppleTalk Phase 1 routers.After you log in as a supervisor from a Macintosh client, you can use the idxid="w4113"book="_idx" docset="nw312" tidref="i4235"NetWare workstation software to create login accounts, set security, and so forth.Logging in to a NetWare server from a Macintosh client requires that the NetWare workstation software be installed on the Macintosh system. For information about installing that software and using it to log in and to perform many other tasks, refer to the Using the NetWare for Macintosh Client manual, which is included with NetWare v3.12.If the environment or the network do not work as you expected, see Chapter 9, "Troubleshooting," Appendix C, "Using ATCON," and Appendix D, "System Messages."When You Maintain NetWare for MacintoshAfter you install and configure NetWare for Macintosh, you can perform most routine maintenance tasks (such as backing up the server) by using standard NetWare utilities. These utilities are documented in NetWare v3.12 System Administration and NetWare v3.12 Utilities Reference.In addition to standard NetWare system maintenance tasks, this guide describes specific Macintosh issues:Chapter 5, "Changing the Configuration," explains how to modify the NetWare for Macintosh configuration.Chapter 6, "Managing AppleTalk File Services," describes how to clear, rebuild, and maintain the desktop. It also describes the NetWare for Macintosh Client software to change the NetWare environment.Chapter 7, "Managing AppleTalk Print Services," describes how to configure and manage print queues that are advertised on the AppleTalk network or serviced by an AppleTalk printer, or both. Managing PostScript fonts and Laser Prep files is also described in Chapter 7.Chapter 9, "Troubleshooting," describes error conditions you might see, and provides solutions.Appendix A, "AppleTalk Configuration Concepts," provides background information about the AppleTalk configuration required in NetWare for Macintosh. It also introduces general AppleTalk network and zone information.idxid="w4114"book="_idx" docset="nw312" tidref="i482"Appendix C, "Using ATCON," describes each of the functions provided in the AppleTalk server console utility and how to use them to check AppleTalk conditions on your network.The system messages that can be generated at the console or in the system log are listed in Appendix D.At the back of this guide, you will find a Glossary and an Index. idxid="w4115"book="_idx" docset="nw312" tidref="i4294"idxid="w4116"book="_idx" docset="nw312" tidref="i4294"Standards and Conventions Used in This GuideThis guide uses italic type to introduce new terms. idxid="w4117"book="_idx" docset="nw312" tidref="i3035"Italics also indicate emphasis, and are used to highlight the names of products, diskettes, and manuals.When a word appears in idxid="w4118"book="_idx" docset="nw312" tidref="i3959"bold font (in any type face), you should type that word at a command line, either at a DOS workstation or at the console. If this font is followed by a word in italics, the italicized word is a parameter that you must substitute with a real value. Consider, for example, this command line: load NLMYou must replace the word NLM with the name of the module you wish to load. idxid="w4119"book="_idx" docset="nw312" tidref="i4294"ID="FM37400"Additional ReadingThese publications provide detailed information about idxid="w4120"book="_idx" docset="nw312" tidref="i357"AppleTalk idxid="w4121"book="_idx" docset="nw312" tidref="i271"protocols, standards, and uses:AppleTalk Network System Overview, Addison-Wesley Publishing Company, Inc. This book provides a comprehensive introduction to AppleTalk. It is available at book stores or from the publisher.idxid="w4122"book="_idx" docset="nw312" tidref="i271"Planning and Managing AppleTalk Networks, Addison-Wesley Publishing Company, Inc. This book provides a comprehensive introduction to AppleTalk. It is available at book stores or from the publisher.idxid="w4123"book="_idx" docset="nw312" tidref="i2826"Inside AppleTalk, Second Edition, Addison-Wesley Publishing Company, Inc. This book is available in book stores, from Apple Computer, and from the publisher. idxid="w4124"book="_idx" docset="nw312" tidref="i271"It provides the complete AppleTalk Phase 2 network specification. The Routing Table Maintenance Protocol (RTMP) and Zone Information Protocol (ZIP) chapters provide detailed technical information about AppleTalk routers and different internet configurations.idxid="w4125"book="_idx" docset="nw312" tidref="i2827"Inside Macintosh, Second Edition, Addison-Wesley Publishing Company, Inc. All five volumes are available in book stores, from Apple Computer, and from the publisher. Chapter 28 in Volume V, "The AppleTalk Manager," provides detailed information about programming the Macintosh to work in AppleTalk networks. It also provides background information about the idxid="w4126"book="_idx" docset="nw312" tidref="i271"AppleTalk architecture.LBL="1"Before You BeginThis chapter introduces NetWare for Macintosh and provides background information to assist you in carrying out the installation and configuration procedures. This chapter also presents system requirements and trouble-saving recommendations to help ensure a smooth installation and configuration process.idxid="w4127"book="_idx" docset="nw312" tidref="i4280"About NetWare for MacintoshNetWare for Macintosh includes NetWare Loadable Modules (NLMs) that provide these services:NetWare file services for idxid="w4128"book="_idx" docset="nw312" tidref="i3610"Macintosh clientsNetWare print services for Macintosh clients as well as for DOS or other clients that send print jobs to PostScript and QuickDraw printersAppleTalk network protocols and an AppleTalk routerATCON console utility for monitoring AppleTalk networksNetWare for Macintosh also includes utilities that run on Macintosh workstations, described in the Using the NetWare for Macintosh Client manual, included with NetWare v3.12.NetWare Loadable Modules (NLMs)The NLMs shown in IDREF="FM29092"Table 1-1 on page 2 and IDREF="FM17171"Table 1-2 on page 3 are included in NetWare for Macintosh. With the exception of the product installation module, these NLMs are copied to idxid="w4129"book="_idx" docset="nw312" tidref="i6624"SYS:SYSTEM during installation.LBL="1-1" INLINE="F"NetWare for Macintosh NLMsID="FM29092"WIDTH="108"ModuleWIDTH="312"DescriptionWIDTH="108"APPLETLK.NLM idxid="w4130"book="_idx" docset="nw312" tidref="i418"WIDTH="312"(AppleTalk idxid="w4131"book="_idx" docset="nw312" tidref="i357"protocol stack and router). idxid="w4132"book="_idx" docset="nw312" tidref="i356"This manual frequently refers to this  module as the "AppleTalk module." It contains the AppleTalk stack and  router. The AppleTalk router must be configured to enable   file and print services. See IDREF="FM20865""AppleTalk Configuration in NetWare  for Macintosh" on page 16 for more information.idxid="w4133"book="_idx" docset="nw312" tidref="i229"AFP.NLM idxid="w4134"book="_idx" docset="nw312" tidref="i182"(AppleTalk Filing Protocol 2.0). idxid="w4135"book="_idx" docset="nw312" tidref="i229"The AFP module allows Macintosh  workstations running the idxid="w4136"book="_idx" docset="nw312" tidref="i216"AppleShare Workstation software idxid="w4137"book="_idx" docset="nw312" tidref="i216"to log in to and  work on the  file server. It provides configuration options  for customizing the file service environment, described in IDREF="FM12331""Setting Up a  Specialized Environment" on page 137.ATPS.NLM idxid="w4138"book="_idx" docset="nw312" tidref="i324"idxid="w4139"book="_idx" docset="nw312" tidref="i324"idxid="w4140"book="_idx" docset="nw312" tidref="i324"(AppleTalk Print Services). idxid="w4141"book="_idx" docset="nw312" tidref="i271"The ATPS module provides idxid="w4142"book="_idx" docset="nw312" tidref="i524"NetWare print  services on the AppleTalk network. You can use this NLM to send print jobs  from NetWare print queues to an AppleTalk printer, to advertise NetWare idxid="w4143"book="_idx" docset="nw312" tidref="i324"print queues to Macintosh clients, or both. Both Macintosh and DOS  clients can access queues serviced by the ATPS NLM. See IDREF="FM11507"Chapter 7,  "Managing AppleTalk Print Services," on page 143 for more information. idxid="w4144"book="_idx" docset="nw312" tidref="i482"ATCON.NLM idxid="w4145"book="_idx" docset="nw312" tidref="i271"(AppleTalk idxid="w4146"book="_idx" docset="nw312" tidref="i509"console utility). idxid="w4147"book="_idx" docset="nw312" tidref="i311"The idxid="w4148"book="_idx" docset="nw312" tidref="i509"ATCON NLM is a idxid="w4149"book="_idx" docset="nw312" tidref="i482"console utility for  diagnosing AppleTalk network conditions. ATCON provides information  about the file server's AppleTalk idxid="w4150"book="_idx" docset="nw312" tidref="i6466"stack and idxid="w4151"book="_idx" docset="nw312" tidref="i362"router, about any networks on  each of the file server's interfaces, and about other AppleTalk networks on  the internet. This utility is described in IDREF="FM31636"Appendix C, "Using ATCON," on  page 271.If you intend to support Macintosh clients on Token Ring, you must manually copy an additional NLM, named ATTOKLLC.NLM, from the NW-MAC diskette to the server's SYS:SYSTEM directory. See IDREF="FM20948""Example 8 Configuration Procedure" on page 94 for instructions on loading this NLM.The NLMs in IDREF="FM17171"Table 1-2 on page 3 are provided to install, configure, or remove NetWare for Macintosh. These NLMs are loaded by the idxid="w4152"book="_idx" docset="nw312" tidref="i2831"INSTALL module. They will not load if DOS has been removed, if the NetWare server is running a version of NetWare earlier than 3.12, or if the SYS volume has not been mounted.LBL="1-2" INLINE="F"Installation and Configuration NLMsID="FM17171"WIDTH="108"ModuleWIDTH="312"DescriptionWIDTH="108"ATCFG.NLM idxid="w4153"book="_idx" docset="nw312" tidref="i481"WIDTH="312"(Product reconfiguration module). idxid="w4154"book="_idx" docset="nw312" tidref="i5767"The ATCFG module allows you to  configure . The INSTALL module loads this NLM  when you press <Enter> in the "Product Options" window. idxid="w4155"book="_idx" docset="nw312" tidref="i544"ATREM.NLM idxid="w4156"book="_idx" docset="nw312" tidref="i361"idxid="w4157"book="_idx" docset="nw312" tidref="i544"(Product removal module). The ATREM module allows you to remove  . The INSTALL module loads this NLM when you  press <Del> in the "Product Options" window. PINSTALL.NLM idxid="w4158"book="_idx" docset="nw312" tidref="i5088"( idxid="w4159"book="_idx" docset="nw312" tidref="i5088"Product installation module). idxid="w4160"book="_idx" docset="nw312" tidref="i5595"The PINSTALL module is used to install  . It is not copied to SYS:SYSTEM and cannot be  loaded from SYS:SYSTEM. The INSTALL module loads this NLM when you  press<Ins> in the "Product Options" window. ID="FM10634"Macintosh idxid="w4161"book="_idx" docset="nw312" tidref="i423"Utilities idxid="w4162"book="_idx" docset="nw312" tidref="i3652"idxid="w4163"book="_idx" docset="nw312" tidref="i7151"In addition to NetWare for Macintosh software that you install and configure on the NetWare v3.12 file server, you must also install special software onto each Macintosh workstation that will take advantage of its connection to NetWare. For information about the Macintosh workstation software, refer to the Using the NetWare for Macintosh Client manual, which accompanies NetWare v3.12.idxid="w4164"book="_idx" docset="nw312" tidref="i4280"Hardware and idxid="w4165"book="_idx" docset="nw312" tidref="i2898"Software RequirementsThis section describes the NetWare for Macintosh system requirements for file servers, Macintosh clients, and Apple printers.idxid="w4166"book="_idx" docset="nw312" tidref="i2227"Server idxid="w4167"book="_idx" docset="nw312" tidref="i6402"Software idxid="w4168"book="_idx" docset="nw312" tidref="i2227"Requirements idxid="w4169"book="_idx" docset="nw312" tidref="i2227"idxid="w4170"book="_idx" docset="nw312" tidref="i2898"Before you idxid="w4171"book="_idx" docset="nw312" tidref="i4280"install NetWare for Macintosh, the NetWare file server must meet these conditions:idxid="w4172"book="_idx" docset="nw312" tidref="i4444"The file server must be running NetWare v3.12 or higher.idxid="w4173"book="_idx" docset="nw312" tidref="i4450"Please see NetWare v3.12Installation if the file server is not yet running NetWare v3.12. idxid="w4174"book="_idx" docset="nw312" tidref="i4450"idxid="w4175"book="_idx" docset="nw312" tidref="i1638"DOS must be present in memory. The installation procedure can transfer files from the idxid="w4176"book="_idx" docset="nw312" tidref="i4784"NW-MAC diskette in a floppy drive, from a DOS partition, or from a NetWare volume directly attached to the local server. However, STARTUP.NCF must be accessible in the file server's DOS boot directory. When the installation is complete and you reboot, you can remove DOS from memory. Please see NetWare v3.12Installation for information about why and how to remove DOS from server memory.The SYS volume must be mounted. NetWare for Macintosh must be installed in idxid="w4177"book="_idx" docset="nw312" tidref="i6624"SYS:SYSTEM. The installation procedure then creates or modifies configuration files in SYS:SYSTEM (see IDREF="FM25239"Table 1-4 on page 5 for details).The modules shown in IDREF="FM21122"Table 1-3 must be installed on the server. When you follow the instructions in NetWare v3.12 Installation and install the System Files, all of these modules are installed. Make sure that the latest versions of these modules are present before installing NetWare for Macintosh.LBL="1-3" INLINE="F"idxid="w4178"book="_idx" docset="nw312" tidref="i2227"Required idxid="w4179"book="_idx" docset="nw312" tidref="i6400"Server ModulesID="FM21122"WIDTH="108"ModuleWIDTH="312"DescriptionWIDTH="108"STREAMS.NLM idxid="w4180"book="_idx" docset="nw312" tidref="i6544"WIDTH="312"idxid="w4181"book="_idx" docset="nw312" tidref="i480"The STREAMS module provides the AT&T STREAMS environment for  network protocol modules. This environment is required by the AppleTalk  module. The STREAMS module resides in idxid="w4182"book="_idx" docset="nw312" tidref="i6624"SYS:SYSTEM.BTRIEVE.NLM idxid="w4183"book="_idx" docset="nw312" tidref="i850"idxid="w4184"book="_idx" docset="nw312" tidref="i839"The BTRIEVE module allows access to the database of installed products  created by INSTALL. The BTRIEVE module is required to run INSTALL.CLIB.NLM idxid="w4185"book="_idx" docset="nw312" tidref="i982"The CLIB module provides the interface between the STREAMS module  and application NLMs (such as AFP.NLM). The CLIB module is required by  the AFP and ATPS modules. This module should reside in SYS:SYSTEM.NUT.NLM idxid="w4186"book="_idx" docset="nw312" tidref="i4768"The NUT module provides a graphical user interface to the NetWare  operating system. This module is required to run PINSTALL.idxid="w4187"book="_idx" docset="nw312" tidref="i3603"MAC.NAM idxid="w4188"book="_idx" docset="nw312" tidref="i3645"idxid="w4189"book="_idx" docset="nw312" tidref="i4004"This name space support module must be loaded to support the  Macintosh name space on the file server's volumes. You must add the  Macintosh name space to all volumes that support Macintosh clients. After  you add the name space to the volumes, you must load the name space  support module, or the volumes will not mount.V_MAC idxid="w4190"book="_idx" docset="nw312" tidref="i7272"This idxid="w4191"book="_idx" docset="nw312" tidref="i7416"VREPAIR module handles the Macintosh name space. It must be  present idxid="w4192"book="_idx" docset="nw312" tidref="i4280"in idxid="w4193"book="_idx" docset="nw312" tidref="i2898"the file idxid="w4194"book="_idx" docset="nw312" tidref="i2227"server's idxid="w4195"book="_idx" docset="nw312" tidref="i6400"DOS idxid="w4196"book="_idx" docset="nw312" tidref="i2227"boot idxid="w4197"book="_idx" docset="nw312" tidref="i423"directory. idxid="w4198"book="_idx" docset="nw312" tidref="i2227"idxid="w4199"book="_idx" docset="nw312" tidref="i2300"System Files idxid="w4200"book="_idx" docset="nw312" tidref="i2898"Created or Modified During InstallationWhile installing and configuring NetWare for Macintosh, the files shown in IDREF="FM25239"Table 1-4 are created or modified:LBL="1-4" INLINE="F"ID="FM25239"Installation and Configuration FilesWIDTH="108"FilenameWIDTH="312"DescriptionWIDTH="108"STARTUP.NCF idxid="w4201"book="_idx" docset="nw312" tidref="i6489"WIDTH="312"This file resides in the NetWare server's DOS boot directory. It is the first  file to be read after SERVER is executed at boot time. It must contain all  parameters required to access the server's SYS volume; typically, these  include a disk driver and any name spaces used on the SYS volume. You  will modify this file when configuring .idxid="w4202"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF idxid="w4203"book="_idx" docset="nw312" tidref="i6628"This file resides in the NetWare server's idxid="w4204"book="_idx" docset="nw312" tidref="i6624"SYS:SYSTEM directory. It is read  after STARTUP.NCF at boot time. It contains parameters that load and  configure the server. NLMs that are loaded in this file should reside in  SYS:SYSTEM. You modify this file when configuring  .idxid="w4205"book="_idx" docset="nw312" tidref="i1389"DESKTOP.AFP idxid="w4206"book="_idx" docset="nw312" tidref="i2453"idxid="w4207"book="_idx" docset="nw312" tidref="i2453"This is a hidden directory created in the root directory of each server  volume that supports the Macintosh name space. It contains three hidden  files: APPLDATA.AFP, ICONDATA.AFP, and ICONINDX.AFP. These files store  information used to describe the Macintosh desktop, including icons,  document-to-application mappings, and icon mappings to various  documents and applications.VOLNAMES.AFPThis is a hidden file created in the NetWare server's SYS:SYSTEM directory.  It stores the name of the server and volume that will be mounted on the  Macintosh desktop. If this file does not already exist, it is created when the  AFP NLM is loaded. In most cases, you do not need to use this file at all.  However, if you change the name of a volume after it has been mounted  by a Macintosh workstation, you need to manually edit this file to reflect  the change. Otherwise, the new names will not show up on the Macintosh  desktop.VOLICON.AFPThis is a hidden file created in the NetWare server's SYS:SYSTEM directory.  It contains information about the volume icon displayed on the Macintosh  desktop. If this file does not already exist, it is created when the AFP NLM  is loaded.WIDTH="108"FilenameWIDTH="312"DescriptionATZONES.CFG idxid="w4208"book="_idx" docset="nw312" tidref="i569"(optional)If you configure zones that would result in a BIND command line  exceeding 82 characters, you must specify the zones in  SYS:SYSTEM\ATZONES.CFG. If you create this file and load the AppleTalk  module with the -z option, the zone configurations in this file can replace  the zone specification on AppleTalk LOAD and BIND command lines. You  can create it from the INSTALL utility.ATPS idxid="w4209"book="_idx" docset="nw312" tidref="i514"idxid="w4210"book="_idx" docset="nw312" tidref="i2453"By default, idxid="w4211"book="_idx" docset="nw312" tidref="i5282"this directory is created within the server's SYS:SYSTEM  directory when the ATPS NLM is loaded. idxid="w4212"book="_idx" docset="nw312" tidref="i6627"It will contain directories for all  NetWare print queues that will be advertised or serviced by the ATPS NLM,  as well as the idxid="w4213"book="_idx" docset="nw312" tidref="i516"ATPS.CFG file, described immediately below. If you wish, you  can specify a different location for the idxid="w4214"book="_idx" docset="nw312" tidref="i5282"idxid="w4215"book="_idx" docset="nw312" tidref="i5282"ATPS directory by using the idxid="w4216"book="_idx" docset="nw312" tidref="i18"-d  option when loading the ATPS module.ATPS.CFGThis optional file typically resides in the ATPS subdirectory of the NetWare  server's SYS:SYSTEM directory. If you create NetWare print queues that will  be advertised or serviced by the ATPS NLM, ATPS.CFG contains an entry  for each of these queues.In addition to these system files, several print-related files are created within the ATPS directory or its print queue subdirectories when print services start up. These are idxid="w4217"book="_idx" docset="nw312" tidref="i2898"described idxid="w4218"book="_idx" docset="nw312" tidref="i2300"in IDREF="FM21863""Files and Directories Used by ATPS" on page 182. idxid="w4219"book="_idx" docset="nw312" tidref="i6402"idxid="w4220"book="_idx" docset="nw312" tidref="i2227"Server idxid="w4221"book="_idx" docset="nw312" tidref="i3794"Memory RequirementsNetWare for Macintosh requires that the server support a total of at least 4 Mbytes of memory. If the demand on the server is heavy and you are running additional NLMs, or if you are supporting more than 20 AFP (Macintosh) connections as well as IPX (DOS) connections and AppleTalk print queues, you might need to supplement this recommendation with more server memory. Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for idxid="w4222"book="_idx" docset="nw312" tidref="i3794"more idxid="w4223"book="_idx" docset="nw312" tidref="i2227"details. idxid="w4224"book="_idx" docset="nw312" tidref="i2227"Macintosh idxid="w4225"book="_idx" docset="nw312" tidref="i3610"Workstation idxid="w4226"book="_idx" docset="nw312" tidref="i7532"RequirementsAll Apple Macintosh computers developed after the idxid="w4227"book="_idx" docset="nw312" tidref="i3626"128K and 512K systems can be used as NetWare for Macintosh clients. No additional memory is required in Macintosh clients.Macintosh Network Requirementsidxid="w4228"book="_idx" docset="nw312" tidref="i3610"Please refer to "Macintosh Network Connection Software" in the Using the NetWare for Macintosh Client manual for information about the Macintosh network software that is required for the following types of network connections:LocalTalkARCnetEthernetToken RingIf you intend to support Macintosh clients on Token Ring, you must load and configure the ATTOKLLC NLM. See IDREF="FM29030""Example 7 Configuration Procedure" on page 86 for instructions.ID="FM13425"Apple idxid="w4229"book="_idx" docset="nw312" tidref="i5482"Printer idxid="w4230"book="_idx" docset="nw312" tidref="i4280"Requirements idxid="w4231"book="_idx" docset="nw312" tidref="i251"NetWare for Macintosh supports PostScript, PostText, and Diablo 630 mode printing to Apple LaserWriter printers as well as printing to the Apple ImageWriter printers listed below.idxid="w4232"book="_idx" docset="nw312" tidref="i3178"LaserWriteridxid="w4233"book="_idx" docset="nw312" tidref="i5482"LaserWriter PlusLaserWriter II NTLaserWriter II NTXLaserWriter II SCPersonal LaserWriter LSPersonal LaserWriter NTidxid="w4234"book="_idx" docset="nw312" tidref="i2772"ImageWriteridxid="w4235"book="_idx" docset="nw312" tidref="i5482"ImageWriter LQImageWriter IIidxid="w4236"book="_idx" docset="nw312" tidref="i2898"Please see IDREF="FM26694""Options for Non-Apple Printers: -t, -s, -f, and -l" on page 161 for idxid="w4237"book="_idx" docset="nw312" tidref="i4280"information idxid="w4238"book="_idx" docset="nw312" tidref="i4280"about using idxid="w4239"book="_idx" docset="nw312" tidref="i251"non-Apple idxid="w4240"book="_idx" docset="nw312" tidref="i5482"printers. idxid="w4241"book="_idx" docset="nw312" tidref="i4280"ID="FM41478"A Note about AppleTalk NetworksThis section introduces the AppleTalk networking issues you should be aware of when installing NetWare for Macintosh. It does not provide a comprehensive introduction to AppleTalk. Please see IDREF="FM37400""Additional Reading" on page xv of IDREF="FM19403""About This Guide" for introductory books on AppleTalk networking.This section introduces these topics:AppleTalk routers: how they work on the internal AppleTalk network as well as on external AppleTalk networksAppleTalk Phase 2 networks and zonesAppleTalk protocols and packet framesSee IDREF="FM23848"Chapter 6, "Managing AppleTalk File Services," on page 127 and IDREF="FM11507"Chapter 7, "Managing AppleTalk Print Services," on page 143 for an introduction to NetWare for Macintosh file services and print services, respectively.Definition of TermsBefore you begin reading about AppleTalk routers, you should know the following terms:AppleTalk is Apple Computer's suite of protocols that enables the hardware and software on an AppleTalk network to interact.idxid="w4242"book="_idx" docset="nw312" tidref="i251"idxid="w4243"book="_idx" docset="nw312" tidref="i271"AppleTalk Phase 2idxid="w4244"book="_idx" docset="nw312" tidref="i318"is the latest version of AppleTalk. idxid="w4245"book="_idx" docset="nw312" tidref="i5075"Apple Computer introduced AppleTalk Phase 2 in 1989 to provide support for AppleTalk networks with thousands of nodes, support for multiple AppleTalk zones on a network, support for Token Ring, and more efficient routing techniques that improve performance in multi-protocol environments.An idxid="w4246"book="_idx" docset="nw312" tidref="i271"AppleTalk networkis a collection of interconnected, individually controlled computers, together with the hardware and software used to connect them.An extended AppleTalk network is an AppleTalk Phase 2 network on media such as idxid="w4247"book="_idx" docset="nw312" tidref="i1874"Ethernet or Token Ring. An extended network is capable of supporting the Phase 2 addressing extensions of a network range and zones list.A nonextended AppleTalk network is an AppleTalk Phase 2 network on idxid="w4248"book="_idx" docset="nw312" tidref="i3355"LocalTalk or ARCnet. Ethernet also supports nonextended networks, called idxid="w4249"book="_idx" docset="nw312" tidref="i1881""EtherTalk 1.0." idxid="w4250"book="_idx" docset="nw312" tidref="i1881"A nonextended network is not capable of supporting the Phase 2 addressing extensions of a network range and zones list.Anidxid="w4251"book="_idx" docset="nw312" tidref="i4652"AppleTalk node is a connection point between the AppleTalk software and a network.An idxid="w4252"book="_idx" docset="nw312" tidref="i311"AppleTalk packet is a unit of information that has been formatted for transmission on a network.idxid="w4253"book="_idx" docset="nw312" tidref="i362"Anidxid="w4254"book="_idx" docset="nw312" tidref="i362"AppleTalk routeridxid="w4255"book="_idx" docset="nw312" tidref="i271"connects multiple networks so that all the nodes on each network can access services and nodes on any other network. It receives and forwards idxid="w4256"book="_idx" docset="nw312" tidref="i311"AppleTalk packets idxid="w4257"book="_idx" docset="nw312" tidref="i311"on the networks to which it is directly connected.An idxid="w4258"book="_idx" docset="nw312" tidref="i251"AppleTalk internetidxid="w4259"book="_idx" docset="nw312" tidref="i251"is a group of AppleTalk networks interconnected by one or more AppleTalk routers. Network users in an internet can share information and network devices.An idxid="w4260"book="_idx" docset="nw312" tidref="i396"AppleTalk zone is a logical grouping of shared devices, such as file servers and printers. You create zones by associating a name (or list of names) with a network.The idxid="w4261"book="_idx" docset="nw312" tidref="i260"AppleTalk module is the NLM in NetWare for Macintosh v3.12 that includes the complete suite of AppleTalk Phase 2 protocols, including all the layers required to handle transmission and receipt of packets, and an AppleTalk Phase 2 router. The idxid="w4262"book="_idx" docset="nw312" tidref="i6466"AppleTalk stack is the complete suite of AppleTalk Phase 2 protocols in the AppleTalk module.ID="FM35675"idxid="w4263"book="_idx" docset="nw312" tidref="i362"The idxid="w4264"book="_idx" docset="nw312" tidref="i362"AppleTalk idxid="w4265"book="_idx" docset="nw312" tidref="i362"Router in idxid="w4266"book="_idx" docset="nw312" tidref="i251"NetWare for MacintoshThe AppleTalk router in NetWare for Macintosh enables all of the nodes on multiple networks to communicate and to access services on other networks, as well as on their own "local" network. A correctly configured AppleTalk router enables Macintosh clients in the internet to take full advantage of all available NetWare resources.Do You Need to Configure the AppleTalk Router in NetWare for Macintosh?Yes. You always need to configure the AppleTalk router, even if the file server is connected to a single AppleTalk network.idxid="w4267"book="_idx" docset="nw312" tidref="i271"NetWare for Macintosh includes an internal "virtual" network, which is required to support future NetWare architectures. Therefore, with even one AppleTalk network connection, the router always sees at least two networks---the internal "virtual" network and the external "physical" network.The AppleTalk configuration on the internal network must always be unique to the file server, so you must always supply a unique internal network configuration in each file server that supports NetWare for Macintosh.If there is a configured AppleTalk router on one or more of the external networks connected to the file server, you can allow the AppleTalk router in NetWare for Macintosh to "learn" its configuration from that router. This is described in IDREF="FM14046""Learning Network and Zone Configurations from Seed Routers" on page 20.ID="FM29425"How the Router Works on the idxid="w4268"book="_idx" docset="nw312" tidref="i2912"Internal Networkidxid="w4269"book="_idx" docset="nw312" tidref="i271"The internal network is a idxid="w4270"book="_idx" docset="nw312" tidref="i7312"virtual network; it has no physical components, but is entirely contained within the AppleTalk module. As far as the router is concerned, the internal network is just one of a number of networks to which the router is connected. The internal network is configured with an AppleTalk network number and zone name, following exactly the same configuration rules as an external, physical network.When the router receives AppleTalk packets that have a idxid="w4271"book="_idx" docset="nw312" tidref="i168"idxid="w4272"book="_idx" docset="nw312" tidref="i1395"destination idxid="w4273"book="_idx" docset="nw312" tidref="i168"address for the file server itself (for example, during a login session with a Macintosh user), the router forwards the packets internally to the idxid="w4274"book="_idx" docset="nw312" tidref="i6466"AppleTalk protocol stack, where the idxid="w4275"book="_idx" docset="nw312" tidref="i271"file services module can access them (see IDREF="FM18025"Figure 1-1).LBL="1-1"ID="FM18025"The Internal AppleTalk NetworkFILE="n312r001.pbm"idxid="w4276"book="_idx" docset="nw312" tidref="i2912"The internal network always supports idxid="w4277"book="_idx" docset="nw312" tidref="i4652"two nodes, the AppleTalk stack (node 1 on the internal network) and the AppleTalk router (node 2 on the internal network). Nodes on the internal network are connection points between the AppleTalk software and the internal network. They do not represent physical devices. idxid="w4278"book="_idx" docset="nw312" tidref="i271"idxid="w4279"book="_idx" docset="nw312" tidref="i271"How AppleTalk Routers Work on External Networksidxid="w4280"book="_idx" docset="nw312" tidref="i271"When the AppleTalk router is connected to two or more idxid="w4281"book="_idx" docset="nw312" tidref="i865"idxid="w4282"book="_idx" docset="nw312" tidref="i4518"network cables (like SERVER-2 in IDREF="FM12964"Figure 1-2 on page 12), it receives idxid="w4283"book="_idx" docset="nw312" tidref="i311"packets from a node on one cable and forwards them to a node on another cable. Each network in an internet is assigned a unique identifier (a number or range of numbers), and every AppleTalk packet that is sent out on the internet includes the network number of its destination. The router is a forwarding device; it receives packets on one of its networks, consults the destination network number, and forwards the packet out to the proper network.When the router receives an AppleTalk packet that has a idxid="w4284"book="_idx" docset="nw312" tidref="i168"idxid="w4285"book="_idx" docset="nw312" tidref="i1395"destination idxid="w4286"book="_idx" docset="nw312" tidref="i168"address for a node other than i idxid="w4287"book="_idx" docset="nw312" tidref="i168"tself or the protocol stack on its own internal network, it forwards the packet out to the node whose address is contained in the packet or to another router that is closer to the destination node (IDREF="FM12964"Figure 1-2).LBL="1-2"ID="FM12964"External AppleTalk NetworksFILE="n312r001.pbm"idxid="w4288"book="_idx" docset="nw312" tidref="i251"In IDREF="FM12964"Figure 1-2, the AppleTalk routers in SERVER-1, SERVER-2, and SERVER-3 allow full intercommunication between AppleTalk nodes on all AppleTalk networks. This means that all four networks shown in IDREF="FM12964"Figure 1-2 are connected to form an AppleTalk internet.IDREF="FM41215"Figure 1-3 on page 13 shows how internet connectivity is affected if SERVER-3 does not support AppleTalk routing.LBL="1-3"ID="FM41215"AppleTalk Networks without Full ConnectivityFILE="n312r003.pbm"In IDREF="FM41215"Figure 1-3, SERVER-3 does not support an AppleTalk router. This means that the Macintosh on the EtherTalk 1.0 network can access only the services provided by SERVER-1, and none of the other idxid="w4289"book="_idx" docset="nw312" tidref="i362"Macintosh idxid="w4290"book="_idx" docset="nw312" tidref="i271"workstations idxid="w4291"book="_idx" docset="nw312" tidref="i251"can access idxid="w4292"book="_idx" docset="nw312" tidref="i362"SERVER-1. idxid="w4293"book="_idx" docset="nw312" tidref="i362"ID="FM13830"AppleTalk idxid="w4294"book="_idx" docset="nw312" tidref="i362"Phase idxid="w4295"book="_idx" docset="nw312" tidref="i271"2 idxid="w4296"book="_idx" docset="nw312" tidref="i5075"Networks and idxid="w4297"book="_idx" docset="nw312" tidref="i251"Zones idxid="w4298"book="_idx" docset="nw312" tidref="i318"idxid="w4299"book="_idx" docset="nw312" tidref="i318"The principal administrative features in AppleTalk Phase 2 include an extended network addressing scheme to support thousands (or theoretically, up to 16 million) nodes per network, and zones lists to support multiple zones per network. AppleTalk networks that make use of the extended network addressing scheme are called extended networks, and those that cannot support the extended scheme are called nonextended networks. ID="FM15499"idxid="w4300"book="_idx" docset="nw312" tidref="i271"Nonextended idxid="w4301"book="_idx" docset="nw312" tidref="i168"Networks idxid="w4302"book="_idx" docset="nw312" tidref="i271"idxid="w4303"book="_idx" docset="nw312" tidref="i168"Some idxid="w4304"book="_idx" docset="nw312" tidref="i251"AppleTalk idxid="w4305"book="_idx" docset="nw312" tidref="i271"networks do not require, and cannot support, extended Phase 2 network addressing. In NetWare for Macintosh, these networks include LocalTalk, ARCnet, and EtherTalk 1.0.idxid="w4306"book="_idx" docset="nw312" tidref="i4661"On nonextended networks, idxid="w4307"book="_idx" docset="nw312" tidref="i4661"each network is assigned one unique 16-bit network number (an integer between 1 and 62,579) and one zone name. Each AppleTalk node is identified by an 8-bit node number. This limits the total number of nodes per network to 254 (256 is the highest number that can be represented in 8 bits, and two numbers are reserved by AppleTalk).The node acquires its unique 8-bit node number dynamically when it connects to the network. It "remembers" its node number when it is turned off, and tries to use that address again when it connects to the network the next time. If it finds that its previous number is already in use, it tries again until it finds a unique idxid="w4308"book="_idx" docset="nw312" tidref="i4649"idxid="w4309"book="_idx" docset="nw312" tidref="i4652"node address.ID="FM36182"Extended Networks idxid="w4310"book="_idx" docset="nw312" tidref="i1934"AppleTalk networks that support extended Phase 2 network addressing include idxid="w4311"book="_idx" docset="nw312" tidref="i1896"EtherTalk 2.0 and Token Ring.idxid="w4312"book="_idx" docset="nw312" tidref="i271"On an extended Phase 2 network, a idxid="w4313"book="_idx" docset="nw312" tidref="i4569"contiguous idxid="w4314"book="_idx" docset="nw312" tidref="i1934"range of unique16-bit network numbers can be assigned to each network. For example, a network can be assigned the range 1-10. In addition, each extended network can be assigned multiple zone names.Each of the nodes on an extended network uses the full 24-bit combination of network and node number as its unique identifier. This increases the theoretical limit of the number of nodes per network to greater than 16 million.The size of the network range you assign determines the maximum number of AppleTalk devices on the physical cable; for example, an extended network with the range 1-10 could support up to 10 x 253, or 2,530 nodes. (On extended networks, three 8-bit node numbers are reserved by AppleTalk.) Although there is no hard-coded limit to the size of a network range, you should specify the smallest range that suits your needs.idxid="w4315"book="_idx" docset="nw312" tidref="i4652"On extended networks, the node acquires a full 24-bit number by choosing a network number from a reserved "startup range" and a random node number to allow it to communicate with the router. It then acquires a valid network number from the assigned range, and finds an unused node number for the network number it acquired. As on nonextended networks, the node "remembers" its address when it is turned off, and uses the same address when idxid="w4316"book="_idx" docset="nw312" tidref="i4652"it idxid="w4317"book="_idx" docset="nw312" tidref="i4649"idxid="w4318"book="_idx" docset="nw312" tidref="i4652"connects idxid="w4319"book="_idx" docset="nw312" tidref="i1934"to idxid="w4320"book="_idx" docset="nw312" tidref="i318"the idxid="w4321"book="_idx" docset="nw312" tidref="i271"network again idxid="w4322"book="_idx" docset="nw312" tidref="i271"unless idxid="w4323"book="_idx" docset="nw312" tidref="i251"another idxid="w4324"book="_idx" docset="nw312" tidref="i251"node idxid="w4325"book="_idx" docset="nw312" tidref="i168"has obtained idxid="w4326"book="_idx" docset="nw312" tidref="i318"idxid="w4327"book="_idx" docset="nw312" tidref="i168"that idxid="w4328"book="_idx" docset="nw312" tidref="i271"address. idxid="w4329"book="_idx" docset="nw312" tidref="i362"Multiple Zones on a Networkidxid="w4330"book="_idx" docset="nw312" tidref="i396"An AppleTalk idxid="w4331"book="_idx" docset="nw312" tidref="i362"zone is a idxid="w4332"book="_idx" docset="nw312" tidref="i396"logical grouping of devices that enables users to locate and access network services in the Chooser. Network administrators define zone names in a router configuration.On nonextended networks, where only one zone name is assigned to a network, all nodes on that network belong to the same zone.idxid="w4333"book="_idx" docset="nw312" tidref="i396"On extended networks, idxid="w4334"book="_idx" docset="nw312" tidref="i7592"each network can be a member of up to 255 zones. When a network is a member of multiple zones, it is idxid="w4335"book="_idx" docset="nw312" tidref="i396"configured idxid="w4336"book="_idx" docset="nw312" tidref="i396"with a idxid="w4337"book="_idx" docset="nw312" tidref="i1934"zones list, idxid="w4338"book="_idx" docset="nw312" tidref="i7592"which contains the names of its zones. idxid="w4339"book="_idx" docset="nw312" tidref="i7576"A node on an extended network can belong to any zone in that list.When a node first starts up, it is always placed in the idxid="w4340"book="_idx" docset="nw312" tidref="i1346"default zone. The default zone is defined by the router. Each type of router might use its own method of defining which zone in the list is the default zone. idxid="w4341"book="_idx" docset="nw312" tidref="i396"The AppleTalk router in NetWare for Macintosh uses the first zone in a zones list as the default zone.All AppleTalk routers on a network must agree about which zone name is the default zone.Administrators can group devices in a zone by informing certain devices that they belong in a zone other than the default. idxid="w4342"book="_idx" docset="nw312" tidref="i5075"AppleTalk Protocols and idxid="w4343"book="_idx" docset="nw312" tidref="i4897"Packet idxid="w4344"book="_idx" docset="nw312" tidref="i3085"Frames idxid="w4345"book="_idx" docset="nw312" tidref="i3085"for idxid="w4346"book="_idx" docset="nw312" tidref="i271"LAN idxid="w4347"book="_idx" docset="nw312" tidref="i271"DriversThe idxid="w4348"book="_idx" docset="nw312" tidref="i3355"LocalTalk idxid="w4349"book="_idx" docset="nw312" tidref="i3355"hardware was designed for AppleTalk, so no packet frame configuration is required for LocalTalk LAN drivers in the NetWare for Macintosh server.Apple Computer idxid="w4350"book="_idx" docset="nw312" tidref="i1881"initially made idxid="w4351"book="_idx" docset="nw312" tidref="i1881"AppleTalk available on Ethernet by embedding AppleTalk packets in an Ethernet Type II packet frame. (The Ethernet Type II frame was commonly in use by most Ethernet devices at that time, including TCP/IP hosts.) EtherTalk 1.0 uses the ETHERNET_II packet idxid="w4352"book="_idx" docset="nw312" tidref="i1881"frame. idxid="w4353"book="_idx" docset="nw312" tidref="i1881"When idxid="w4354"book="_idx" docset="nw312" tidref="i1896"AppleTalk Phase 2 was introduced, the idxid="w4355"book="_idx" docset="nw312" tidref="i1896"Ethernet 802.2 Type 1 SNAP packet frame was adopted to handle extended AppleTalk networks. EtherTalk 2.0 uses the ETHERNET_SNAP packet frame.Token Ring idxid="w4356"book="_idx" docset="nw312" tidref="i6810"support for idxid="w4357"book="_idx" docset="nw312" tidref="i6839"AppleTalk was idxid="w4358"book="_idx" docset="nw312" tidref="i6839"developed as part of AppleTalk Phase 2, so TokenTalk does not (and never did) support nonextended networks. TokenTalk uses the 802.2 SNAP frame (TOKEN-RING_SNAP).AppleTalk on ARCnet (nonextended) networks uses the NOVELL_RXNET packet frame type. This is the same packet frame used by the idxid="w4359"book="_idx" docset="nw312" tidref="i4897"IPX idxid="w4360"book="_idx" docset="nw312" tidref="i3085"protocols idxid="w4361"book="_idx" docset="nw312" tidref="i3085"on idxid="w4362"book="_idx" docset="nw312" tidref="i271"ARCnet idxid="w4363"book="_idx" docset="nw312" tidref="i271".ID="FM20865"AppleTalk idxid="w4364"book="_idx" docset="nw312" tidref="i362"Configuration idxid="w4365"book="_idx" docset="nw312" tidref="i362"in idxid="w4366"book="_idx" docset="nw312" tidref="i2898"NetWare for Macintosh idxid="w4367"book="_idx" docset="nw312" tidref="i6033"idxid="w4368"book="_idx" docset="nw312" tidref="i362"This idxid="w4369"book="_idx" docset="nw312" tidref="i362"section describes the syntax of the commands you will use to configure networks and zones in the AppleTalk router in NetWare for Macintosh. It also explains the general AppleTalk rules for network numbers, zone names, and the default zone on extended networks.How to Use This InformationThis information should be used as a reference when you are installing and configuring NetWare for Macintosh.Remember that you can press <F1> for on-line help when using the INSTALL module during the configuration procedure. The on-line help screens provide command-line syntax and other useful information for setting up your server.idxid="w4370"book="_idx" docset="nw312" tidref="i362"Nonextended idxid="w4371"book="_idx" docset="nw312" tidref="i4661"Network and Zone ConfigurationEtherTalk 1.0, LocalTalk, and ARCnet networks are nonextended networks that can support a maximum of 254 idxid="w4372"book="_idx" docset="nw312" tidref="i4649"idxid="w4373"book="_idx" docset="nw312" tidref="i4652"node addresses. Configuration data and syntax for nonextended networks is shown in IDREF="FM42355"Table 1-5.LBL="1-5" INLINE="F"ID="FM42355"idxid="w4374"book="_idx" docset="nw312" tidref="i1881"Configuring idxid="w4375"book="_idx" docset="nw312" tidref="i3355"Nonextended idxid="w4376"book="_idx" docset="nw312" tidref="i4661"Networks (EtherTalk 1.0, LocalTalk, and ARCnet)WIDTH="108"Configurable ComponentWIDTH="312"ExplanationWIDTH="108"Network idxid="w4377"book="_idx" docset="nw312" tidref="i4556"number idxid="w4378"book="_idx" docset="nw312" tidref="i362"WIDTH="312"All nonextended AppleTalk networks require a valid network number. The  number must be specified on the BIND command line, using this syntax:net=1000Zone nameAll nonextended AppleTalk networks require a valid zone name. The name  may be specified on the BIND command line or in a global file named  "ATZONES.CFG." Zones must be specified using this syntax:zone={"Zone 1"}Note that the braces ({ }) and double-quotes (") are required.idxid="w4379"book="_idx" docset="nw312" tidref="i4661"A valid AppleTalk network number is any integer between 1 and 65,279. idxid="w4380"book="_idx" docset="nw312" tidref="i4556"All AppleTalk routers connected to a network must use the same number for that network, and no other network can use that number.NetWare for Macintosh uses base-10 (decimal) numbers to define AppleTalk network numbers. Some third-party routers may use base-16 (hexadecimal) numbers instead.idxid="w4381"book="_idx" docset="nw312" tidref="i4661"A valid zone name is a string of up to 32 characters, which can include embedded spaces. All of the characters must be legal printing characters, and they can include the Macintosh control characters shown in IDREF="FM24403"Table 9-1 on page 222. In NetWare for Macintosh, zone names are case-insensitive.All AppleTalk routers connected to a network must agree about the zone name assigned to it.All AppleTalk routers keep track of zones once the zones have been established, and it is not a straightforward task to change zone names once you have defined them on a large AppleTalk internet. Please see IDREF="FM27796""How Zone Information Is Maintained on an Internet" on page 255 for information about changing zone idxid="w4382"book="_idx" docset="nw312" tidref="i4661"names. idxid="w4383"book="_idx" docset="nw312" tidref="i362"Extended Network and idxid="w4384"book="_idx" docset="nw312" tidref="i1934"Zone Configurationidxid="w4385"book="_idx" docset="nw312" tidref="i362"Ethernet and idxid="w4386"book="_idx" docset="nw312" tidref="i6839"Token Ring networks are extended networks. Configuration data and syntax for extended networks is shown in idxid="w4387"book="_idx" docset="nw312" tidref="i362"IDREF="FM10767"Table 1-6.LBL="1-6" INLINE="F"ID="FM10767"idxid="w4388"book="_idx" docset="nw312" tidref="i1896"Configuring idxid="w4389"book="_idx" docset="nw312" tidref="i1934"Extended Networks (EtherTalk 2.0 and TokenTalk)WIDTH="108"Configurable ComponentWIDTH="312"ExplanationWIDTH="108"Network idxid="w4390"book="_idx" docset="nw312" tidref="i4556"range idxid="w4391"book="_idx" docset="nw312" tidref="i362"WIDTH="312"Both EtherTalk 2.0 and TokenTalk require a network range that includes  one or more valid AppleTalk network numbers separated by a hyphen. The  range must be specified on the BIND command line, using this syntax:net=1-10Zones listBoth EtherTalk 2.0 and TokenTalk require a list of AppleTalk zones, which  can include up to 255 valid zone names. These may be specified on the  BIND command line or in a global file named "ATZONES.CFG." Zones  must be specified using this syntax:zone={"Zone 1","Zone 2","Zone 3"}Note that the braces ({ }), double-quotes (") and commas (,) are all  significant.idxid="w4392"book="_idx" docset="nw312" tidref="i1934"A network range is a contiguous range of valid network numbers. The size of the network range you assign determines the maximum number of AppleTalk devices on the network; for example, an extended network with the range 1-10 could support up to 10 x 253, or 2,530 nodes. Although there is no hard-coded limit to the size of a network range, you should specify the smallest range that suits your needs.A range of one, such as 10-10, is acceptable and is required if there are Phase 1 routers present on the internet. idxid="w4393"book="_idx" docset="nw312" tidref="i4556"All AppleTalk routers connected to that network must use the same range for that network, and no other network can use that range or any idxid="w4394"book="_idx" docset="nw312" tidref="i1934"number idxid="w4395"book="_idx" docset="nw312" tidref="i362"contained within idxid="w4396"book="_idx" docset="nw312" tidref="i362"it.idxid="w4397"book="_idx" docset="nw312" tidref="i4556"idxid="w4398"book="_idx" docset="nw312" tidref="i396"A zones list can contain up to 255 zone names, and the first name you enter is the default zone.All AppleTalk routers connected to that network must agree about the zones list and about which zone is the default zone.idxid="w4399"book="_idx" docset="nw312" tidref="i1934"ID="FM34323"Internal Network idxid="w4400"book="_idx" docset="nw312" tidref="i2912"and Zone ConfigurationThe internal network is an extended network, and the general rules for extended networks apply. However, because the internal network can never support more than two nodes (the router and the protocol stack), there are some special conditions to consider.LBL="1-7" INLINE="F"ID="FM15876"Configuring the idxid="w4401"book="_idx" docset="nw312" tidref="i2912"Internal NetworkWIDTH="108"Configurable ComponentWIDTH="312"ExplanationWIDTH="108"Network numberWIDTH="312"The internal network requires a valid network number. The number must  be specified on the LOAD command line, using this syntax:net=10ornet=10-10Zone name or zones  listThe internal network requires a valid zone name, and can support multiple  zone names. The name(s) may be specified on the LOAD command line  or in a global file named "ATZONES.CFG." Zones must be specified using  this syntax:zone={"Zone 1"}orzone={"Zone 1","Zone 2","Zone 3"}The purpose of configuring multiple zones on the internal network is to allow print queues to be advertised in any one of these AppleTalk zones. idxid="w4402"book="_idx" docset="nw312" tidref="i271"AFP file services are always advertised in the first zone entered for the internal network, which is the default zone for the internal network.idxid="w4403"book="_idx" docset="nw312" tidref="i2912"Although a range of one (such as 10-10) is accepted on the internal network configuration, a single network number (such as 10) is allowed. However, even if the internal network is configured with a single network number, the router sees it as an extended network. See IDREF="FM36717""What Is Transition Mode?" on page 259 for information about how this affects Phase 1 networks and transition routing internets.When multiple zones are specified for the internal network, you can choose one of the specified zones as the zone in which an AppleTalk spooler will appear in the Chooser. This is described in IDREF="FM12141""Advertising a Queue in a Specified Zone: -o" on page 160. You cannot---under any circumstances---specify multiple zones for the internal network of a server that performs transition routing. See IDREF="FM28649"Appendix B, "Transition Mode Routing," on page 259 for more information. idxid="w4404"book="_idx" docset="nw312" tidref="i2912"ID="FM15947"Important Note about Phase 1 Environmentsidxid="w4405"book="_idx" docset="nw312" tidref="i362"Because the internal network is an extended Phase 2 network, you must always use the -tidxid="w4406"book="_idx" docset="nw312" tidref="i6881"Transition Mode option if you are using NetWare for Macintosh in an AppleTalk Phase 1 environment. Please see IDREF="FM28649"Appendix B, "Transition Mode Routing," on page 259 for a full explanation of Transition Mode and Phase 2 extended networks.NetWare print queues advertised in extended zones do not appear with any reliability on AppleTalk internets that contain Phase 1 routers. idxid="w4407"book="_idx" docset="nw312" tidref="i362"ID="FM14046"Learning Network and Zone Configurations from idxid="w4408"book="_idx" docset="nw312" tidref="i6212"idxid="w4409"book="_idx" docset="nw312" tidref="i6212"Seed Routersidxid="w4410"book="_idx" docset="nw312" tidref="i271"In NetWare for Macintosh, the AppleTalk router can be configured to "learn" its network and zone configuration for one or idxid="w4411"book="_idx" docset="nw312" tidref="i4547"more interfaces automatically by "listening" for packets from another AppleTalk router connected to that network interface. This ability to learn a complete configuration is called seeding. A network interface that is not explicitly configured is called a idxid="w4412"book="_idx" docset="nw312" tidref="i4668"non-seed interface. A router that has a network configuration on a particular interface is called a seed router. A seed router can be explicitly configured or can have a configuration that was obtained by seeding.ID="FM17600"If you configure an AppleTalk router interface as a non-seed interface and there is no seed router on that cable, the AppleTalk router remains inactive on the non-seed interface until it receives a configuration from a seed router on that network.Benefits of the Seeding FeatureWhen you configure a non-seed interface in an AppleTalk router, the router obtains a network configuration that is consistent with other routers connected to that network. Provided that the network is correctly configured to start with, you can add other AppleTalk routers with non-seed interfaces without introducing inconsistent configurations.If you use one seed router and configure non-seed interfaces in all other AppleTalk routers connected to that network, it is much easier to change the network or zone configuration if you should need to do so in the future. Instead of reconfiguring all routers on a network, you can down all routers and reconfigure only the seed router.How the Seeding Feature WorksThe AppleTalk Routing Table Maintenance Protocol (RTMP) is the protocol used by AppleTalk routers to distribute network configuration information. Every ten seconds, each AppleTalk router broadcasts RTMP packets containing information about networks. Other AppleTalk routers receive the RTMP packets and use the information to build and maintain a complete view of the AppleTalk internet. Please see "How routing tables are maintained" on page 264 if you would like more information about RTMP.When the AppleTalk router in NetWare for Macintosh is configured with one or more non-seed interfaces, it uses information received in the RTMP packets to acquire the network number on a non-seed interface. It then sends a request to learn the zone information for that network. IDREF="FM42745"Figure 1-4 on page 22 shows a router configured with a non-seed interface (that is,net=0-0), acquiring its configuration from a seed router on an extended network.IDREF="FM36596""Example 5: Learning from Other Routers" on page 65 provides a step-by-step example of how to use non-seed interfaces in NetWare for Macintosh.LBL="1-4"ID="FM42745"How Seeding WorksFILE="n312r004.pbm"A non-seed interface remains inactive until another router is heard from and a network number obtained. If you suspect a non-seed interface was configured on a network that does not have any seed routers, load the ATCON utility and check View RTMP Table. The address field is network number 0 while the router is acquiring its network configuration on a non-seed interface. On a Phase 2 interface, the node number is also 0. If these conditions persist for longer than 20 seconds, then the router is not idxid="w4413"book="_idx" docset="nw312" tidref="i6212"idxid="w4414"book="_idx" docset="nw312" tidref="i6212"obtaining idxid="w4415"book="_idx" docset="nw312" tidref="i362"its idxid="w4416"book="_idx" docset="nw312" tidref="i362"network idxid="w4417"book="_idx" docset="nw312" tidref="i2898"configuration idxid="w4418"book="_idx" docset="nw312" tidref="i362"for idxid="w4419"book="_idx" docset="nw312" tidref="i6033"that idxid="w4420"book="_idx" docset="nw312" tidref="i4547"interface. idxid="w4421"book="_idx" docset="nw312" tidref="i271"LBL="2"idxid="w4422"book="_idx" docset="nw312" tidref="i2898"Installing NetWare for Macintosh idxid="w4423"book="_idx" docset="nw312" tidref="i4280"This chapter shows how to install the NetWare for Macintosh software by using the INSTALL utility or Remote Console. It also gives instructions for upgrading the product if you already have a previous version of NetWare for Macintosh installed and configured.NetWare for Macintosh will not be usable until you have completed the configuration procedure shown in Chapters 3 and 4. If you wish, you can prepare your configuration data first and complete the installation and configuration in one session.ID="FM31285"Installing idxid="w4424"book="_idx" docset="nw312" tidref="i2898"the NetWare for Macintosh SoftwareTo install the Macintosh NLMs by using the idxid="w4425"book="_idx" docset="nw312" tidref="i2831"INSTALL utility, follow these steps:At the server console, add the Macintosh name space to all volumes that will support Macintosh clients by typing these commands:  idxid="w4426"book="_idx" docset="nw312" tidref="i3272"LOAD MAC <Enter>  idxid="w4427"book="_idx" docset="nw312" tidref="i144"ADD NAME SPACE MACINTOSH TO VOLUMEname<Enter>name is a single volume name. If you have already added the Macintosh name space to a volume, you do not need to add it again at this point, but it does no harm to do so.If the server supports Macintosh clients on multiple volumes, repeat the ADD NAME SPACE command for each volume. (You do not need to repeat the LOAD MAC command to add the name space to additional volumes.) See IDREF="FM33358""The Macintosh Name Space" on page 128 if you would like more information.Insert the idxid="w4428"book="_idx" docset="nw312" tidref="i4784"NW_MAC diskette into the file server's floppy drive.Load the idxid="w4429"book="_idx" docset="nw312" tidref="i2831"INSTALL utility.At the console prompt, type LOAD INSTALL <Enter>Select Product Options in the main idxid="w4430"book="_idx" docset="nw312" tidref="i2831"INSTALL menu.FILE="n312r005.pbm"Press <Ins> to install NetWare for Macintosh.FILE="n312r006.pbm"The installation procedure prompts you for the location of the product's source.If the NW_MAC diskette is in the A drive, press <Enter>.FILE="n312r007.pbm"If you are using a different floppy drive, or if you copied the installation files to another DOS drive, delete the characters "A:" and enter the drive letter (and path, if applicable) before pressing <Enter>.To idxid="w4431"book="_idx" docset="nw312" tidref="i6489"confirm the use of the current STARTUP.NCF, press <Enter>.FILE="n312r008.pbm"idxid="w4432"book="_idx" docset="nw312" tidref="i6489"If you do not wish to edit the current STARTUP.NCF file, delete the characters following the ">" prompt, enter a drive, path, and the filename STARTUP.NCF, and then press <Enter>. If you edit a STARTUP.NCF file other than the current one, you must copy it to the directory containing SERVER.EXE. Otherwise, when you later boot the server to activate AppleTalk, the system will use the wrong STARTUP.NCF file.ID="FM42221"To begin the file transfer, select Install NW-MAC and press <Enter>.FILE="n312r009.pbm"If you choose "Cancel installation," you return to the "Currently Installed Products" window.Press<Enter> to begin the installation. A window displays messages indicating that files are being transferred. When the file transfer is complete, the "Editable Configuration Files" menu appears.If you have prepared the configuration data you need, configure NetWare for Macintosh; otherwise, go to IDREF="FM31815"Step 10.Please see the examples in Chapter 3 or Chapter 4 for step-by-step instructions.Before you begin configuring NetWare for Macintosh, please be sure to read the READ_ME.1ST file on the idxid="w4433"book="_idx" docset="nw312" tidref="i4784"NW_MAC diskette or idxid="w4434"book="_idx" docset="nw312" tidref="i3602"MAC UTILITIES diskette. (The file contents are the same on either diskette.) This file contains vital information about the NetWare for Macintosh software and specific issues of which you should be aware before you install the software on your NetWare v3.12 server.ID="FM31815"Press <Esc>.FILE="n312r010.pbm"idxid="w4435"book="_idx" docset="nw312" tidref="i2831"Exit the INSTALL utility, saving your changes.ID="FM10294"If the Server Has Macintosh Clients on Token RingIf the file server will support Macintosh clients connected to Token Ring, you must manually copy the ATTOKLLC NLM a from the NW_MAC diskette to the SYS:SYSTEM directory of the server(s) on which you install NetWare for Macintosh. For example, use this command: NCOPY A:ATTOKLLC.NLM SYS:SYSTEM <Enter>See IDREF="FM37829""Using Token Ring with Macintosh Clients" on page 92 and the configuration procedure that follows that section for instructions on configuring the ATTOKLLC NLM in the server. idxid="w4436"book="_idx" docset="nw312" tidref="i2898"Using Remote idxid="w4437"book="_idx" docset="nw312" tidref="i2898"Console to Install NetWare for MacintoshIf you want to use Remote Console (RCONSOLE) to install NetWare for Macintosh, follow these steps:At a DOS workstation, map a drive to the target server's SYS volume.For example, use this command to map the "Y" drive to the target server's SYS volume: MAP Y:=SERVER:SYS <Enter>Insert the idxid="w4438"book="_idx" docset="nw312" tidref="i4784"NW_MAC diskette in the workstation's floppy drive.Create a new directory on the remote target server.For example, use this command to create the \NW-MAC directory on the target server's SYS volume: MKDIR Y:\NW-MAC <Enter>Copy all files from the NW_MAC diskette to the directory you created on the target server.For example, use this command: NCOPY A:*.* Y:\NW-MAC <Enter>Invoke the idxid="w4439"book="_idx" docset="nw312" tidref="i5801"Remote Console program by typing: RCONSOLE<Enter>Follow the installation instructions beginning on IDREF="FM31285"page 23.Use the Remote Console utility to install the product as if you were at the server console, but specify the directory you created (SYS:\NW-MAC in this example) as the location of the product idxid="w4440"book="_idx" docset="nw312" tidref="i2898"source media.ID="FM42608"Upgrading a Previous idxid="w4441"book="_idx" docset="nw312" tidref="i7095"Version of NetWare for MacintoshIf you are upgrading a previous version of NetWare for Macintosh to Version 3.12 and you do not wish to change the configuration, follow these steps:At the server console, UNLOAD the NetWare for Macintosh NLMs by typing these commands:  idxid="w4442"book="_idx" docset="nw312" tidref="i324"UNLOAD ATPS <Enter>  idxid="w4443"book="_idx" docset="nw312" tidref="i229"UNLOAD AFP <Enter>  idxid="w4444"book="_idx" docset="nw312" tidref="i260"UNLOAD APPLETLK <Enter>These commands break all of the server's AppleTalk connections. AppleTalk automatically unbinds itself from all network boards before unloading.Follow the installation instructions beginning on IDREF="FM31285"page 23.When you get to IDREF="FM42221"Step 8, the PINSTALL window asks you to confirm that you wish to Update (rather than install) the product:FILE="n312r011.pbm"Select "Update NW-MAC" and then press <Enter>.When the update procedure is complete, the "Currently Installed Products" window opens again.FILE="n312r012.pbm"Exit the INSTALL utility, saving your changes.Please see IDREF="FM27319""Modifying Configuration Files" on page 117 if you wish to modify the NetWare for Macintosh configuration at this point.idxid="w4445"book="_idx" docset="nw312" tidref="i3245"LOAD idxid="w4446"book="_idx" docset="nw312" tidref="i3245"the NetWare for Macintosh NLMs by typing these commands:  idxid="w4447"book="_idx" docset="nw312" tidref="i324"LOAD idxid="w4448"book="_idx" docset="nw312" tidref="i5425"ATPS <Enter>  idxid="w4449"book="_idx" docset="nw312" tidref="i229"LOAD AFP idxid="w4450"book="_idx" docset="nw312" tidref="i2263"<Enter>  idxid="w4451"book="_idx" docset="nw312" tidref="i260"LOAD APPLETLK <Enter>idxid="w4452"book="_idx" docset="nw312" tidref="i4280"idxid="w4453"book="_idx" docset="nw312" tidref="i2898"LBL="3"Simple Network ConfigurationsThis chapter describes how to configure NetWare for Macintosh for several simple AppleTalk network environments. See IDREF="FM16400"Chapter 4, "More Complex Network Configurations," on page 71 if your network is more complex than these examples:IDREF="FM33222""Example 1: Adding NetWare for Macintosh to Ethernet" on page 34 shows how to add NetWare for Macintosh to a file server connected to Ethernet.IDREF="FM27327""Example 2: Adding NetWare for Macintosh to ARCnet" on page 42 shows how to add NetWare for Macintosh to a file server connected to ARCnet.IDREF="FM14390""Example 3: Creating a LocalTalk Network" on page 48 shows how to add a LocalTalk network for AppleTalk services.IDREF="FM31333""Example 4: EtherTalk 2.0 with Other AppleTalk Routers" on page 58 shows a file server on Ethernet where another AppleTalk router already exists on that network.IDREF="FM36596""Example 5: Learning from Other Routers" on page 65 shows an easier way to configure a server when another AppleTalk router already exists on a network. The procedures described in this chapter specify that you must down the file server and bring it up again to activate AppleTalk with the most current configuration specifications. This requirement is based on the recommendation that you configure your networks and zones in the server's STARTUP.NCF and AUTOEXEC.NCF files. An alternative to this approach is to type the commands at the server console. If you type the commands at the console instead of entering them in the server's STARTUP.NCF and AUTOEXEC.NCF files, you do not need to down the file server to activate AppleTalk.See Chapters 6 and 7 for important information about your options in AFP and print service configurations. idxid="w4454"book="_idx" docset="nw312" tidref="i1175"Quick Overview of the Configuration ProcedureThese steps show a broad overview of the configuration process. The examples beginning on IDREF="FM33222"page 34 provide complete instructions.If you have just completed the installation and are running INSTALL, skip the first two steps.Load INSTALL.Select Product Options and press <Enter> on the line specifying NW-MAC v3.01.Edit the file server's STARTUP.NCF file to specify these commands: load mac set minimum packet receive buffers=100Edit SYS:\SYSTEM\AUTOEXEC.NCF to specify commands that accomplish these tasks:LOAD the AppleTalk module and configure the internal AppleTalk network.LOAD LAN drivers for AppleTalk networks and specify the appropriate AppleTalk frame types.BIND AppleTalk to the appropriate LAN drivers and configure AppleTalk networks on those interfaces.LOAD the AFP file service module (optional), specifying configuration options if appropriate.LOAD the ATPS print module (optional).If ATPS is loaded, edit ATPS.CFG to configure print queues.Exit the INSTALL utility, saving your changes.Down the file server and bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply. idxid="w4455"book="_idx" docset="nw312" tidref="i1175"idxid="w4456"book="_idx" docset="nw312" tidref="i1175"Preparing the Configuration Data You NeedThe AppleTalk network configuration affects not only the file server and its Macintosh clients but also all AppleTalk networks with which the router can communicate.It is very important that you check your router configuration data before you carry out your configuration tasks. If you are part of a large organization where networks are managed by internet administrators, make sure that you obtain valid AppleTalk network addresses before you configure the AppleTalk router.If you are installing NetWare for Macintosh on an existing AppleTalk internet, determine whether the network(s) to which you will connect the router support an AppleTalk router already. If so, you must configure the new router in accordance with the configuration of the existing router, or allow it to "learn" from other routers on its network(s).If you are configuring multiple zones on an extended network, and the total number of characters on the AppleTalk BIND command line will exceed 82 characters, you need to specify the zone configuration in the ATZONES.CFG file. See IDREF="FM10439""Using the ATZONES.CFG Configuration File" on page 243 for details.Determine which file servers must support NetWare for Macintosh to make sure that Macintosh clients on different networks can log in to NetWare. See IDREF="FM35675""The AppleTalk Router in NetWare for Macintosh" on page 10 for a quick overview.If a network interface board will not be sending and receiving IPX packets, it is not necessary to bind IPX to that board and assign it an IPX network number. However, an IPX network number is necessary for the internal network.Please refer to Appendix B if you must accommodate Phase 1 routers by using Transition Mode.ID="FM33222"Example idxid="w4457"book="_idx" docset="nw312" tidref="i1896"1: idxid="w4458"book="_idx" docset="nw312" tidref="i1874"Adding NetWare for Macintosh to idxid="w4459"book="_idx" docset="nw312" tidref="i1175"Ethernetidxid="w4460"book="_idx" docset="nw312" tidref="i3610"This example shows how to add NetWare for Macintosh to a NetWare v3.12 server connected to Ethernet. The server already supports DOS clients via IPX, as shown in IDREF="FM13679"Figure 3-1.LBL="3-1"ID="FM13679"File Server on EthernetFILE="n312r013.pbm"In this example, you will add an AppleTalk network with Macintosh workstations to the existing Ethernet cable. The resulting network is shown in IDREF="FM36442"Figure 3-2 on page 35.LBL="3-2"ID="FM36442"Adding Macintosh Clients on EthernetFILE="n312r014.pbm"Example 1 Configuration DataThe router in this example uses the configuration data in IDREF="FM39552"Table 3-1.LBL="3-1" INLINE="F"ID="FM39552"Example 1 idxid="w4461"book="_idx" docset="nw312" tidref="i1896"ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4462"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=55000zone={"Admin"}WIDTH="180"Use a unique network number.Use a valid zone name.EtherTalk 2.0net=101-105zone={"Sales","Marketing"}Use a valid network range.Use a list of at least one zone name.WIDTH="108"NE2000 LAN driverWIDTH="324"frame=ETHERNET_SNAPWIDTH="108"AFP file services idxid="w4463"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print servicesWIDTH="324"Not installed on this serverSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.This example shows how to add NetWare for Macintosh file services only. Adding ATPS print services is not shown. See IDREF="FM11507"Chapter 7, "Managing AppleTalk Print Services," on page 143 for information on print services.IDREF="FM23847"Figure 3-3 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="3-3"ID="FM23847"Example of EtherTalk 2.0 ConfigurationFILE="n312r015.pbm"Example 1 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section. Load idxid="w4464"book="_idx" docset="nw312" tidref="i2831"INSTALL, select Product Options in the main idxid="w4465"book="_idx" docset="nw312" tidref="i2831"INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4466"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r016.pbm"Highlight STARTUP.NCF and press <Enter>.idxid="w4467"book="_idx" docset="nw312" tidref="i6489"Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4468"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM13719"Figure 3-4.LBL="3-4"ID="FM13719"Example 1 idxid="w4469"book="_idx" docset="nw312" tidref="i1896"AUTOEXEC.NCFFILE="n312r017.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown in the steps below.idxid="w4470"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=55000 zone={"Admin"}If you would like more information, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.idxid="w4471"book="_idx" docset="nw312" tidref="i247"Load the LAN idxid="w4472"book="_idx" docset="nw312" tidref="i3085"driver with the idxid="w4473"book="_idx" docset="nw312" tidref="i2520"ETHERNET_SNAP frame type: load ne2000 int=2 port=300 frame=ethernet_snap name=esnapidxid="w4474"book="_idx" docset="nw312" tidref="i1735"The NAME idxid="w4475"book="_idx" docset="nw312" tidref="i3085"option is a idxid="w4476"book="_idx" docset="nw312" tidref="i4267"NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4477"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4478"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4479"book="_idx" docset="nw312" tidref="i3085"LAN driver and configure the EtherTalk 2.0 network: bind appletlk esnap net=101-105 zone={"Sales","Marketing"}The name esnap in this command refers to the NE2000 driver configuration name assigned above. See IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241 if you need more information about BIND command lines.idxid="w4480"book="_idx" docset="nw312" tidref="i229"Load AppleTalk idxid="w4481"book="_idx" docset="nw312" tidref="i2263"file services idxid="w4482"book="_idx" docset="nw312" tidref="i3245": load afpFor details about AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.idxid="w4483"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.idxid="w4484"book="_idx" docset="nw312" tidref="i2227"Down the file server and bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example:  DOWN <Enter> EXIT <Enter>  idxid="w4485"book="_idx" docset="nw312" tidref="i2227"SERVER idxid="w4486"book="_idx" docset="nw312" tidref="i6235"<Enter>A series of messages appears, indicating that the system is loading the modules you specified. For this example, these messages appear: Loading. . . Minimum Packet Receive Buffers set to 100 Loading module ISADISK.DSK Loading module MAC.NAM Loading module NE2000.LAN Loading module APPLETLK.NLM APPLETALK LAN protocol bound to NE-2000 LAN Driver Loading module AFP.NLM Auto-loading module STREAMS.NLM Auto-loading module CLIB.NLM :At this point, NetWare for Macintosh is up and running. idxid="w4487"book="_idx" docset="nw312" tidref="i2227"ID="FM36626"Verify idxid="w4488"book="_idx" docset="nw312" tidref="i3649"that the modules have loaded.When you see the console colon (:) prompt, type  idxid="w4489"book="_idx" docset="nw312" tidref="i3930"MODULES <Enter>You will see a list of NLMs such as this one: APPLETLK.NLM  NetWare AppleTalk Stack/Router AFP.NLM  NetWare AFP module CLIB.NLM  NetWare C Runtime Library STREAMS.NLM  NetWare STREAMS NE2000.LAN  NE-2000 LAN Driver MAC.NAM  Macintosh Name Space Support ISADISK.DSK  NetWare ISA Device Driver idxid="w4490"book="_idx" docset="nw312" tidref="i3649"idxid="w4491"book="_idx" docset="nw312" tidref="i362"Check the AppleTalk configuration.idxid="w4492"book="_idx" docset="nw312" tidref="i4547"Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type  idxid="w4493"book="_idx" docset="nw312" tidref="i482"LOAD ATCON idxid="w4494"book="_idx" docset="nw312" tidref="i1896"<Enter>idxid="w4495"book="_idx" docset="nw312" tidref="i2912"Then, choose View Router Interfaces in the main ATCON menu. A window opens, showing the interfaces you configured (IDREF="FM36122"Figure 3-5).LBL="3-5"ID="FM36122"Checking the Configuration in ATCONFILE="n312r018.pbm"ATCON displays network numbers for the EtherTalk network (101-105) and the internal network (55000); it also provides the AppleTalk router's node address on the internal network (55000.2).Check the network numbers and zones against your records to make sure they are correct. See IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for an explanation of the fields in this window.idxid="w4496"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client.In this example, both the file server and its queues appear in the Admin zone, because this is idxid="w4497"book="_idx" docset="nw312" tidref="i3610"the idxid="w4498"book="_idx" docset="nw312" tidref="i3610"zone idxid="w4499"book="_idx" docset="nw312" tidref="i1175"of the idxid="w4500"book="_idx" docset="nw312" tidref="i1896"internal idxid="w4501"book="_idx" docset="nw312" tidref="i1874"network.FILE="n312r019.pbm"ID="FM27327"Example 2: idxid="w4502"book="_idx" docset="nw312" tidref="i458"Adding idxid="w4503"book="_idx" docset="nw312" tidref="i1175"NetWare for Macintosh to ARCnetThis example shows how to add NetWare for Macintosh to a NetWare v3.12 server connected to ARCnet.LBL="3-6"File Server on ARCnetFILE="n312r020.pbm"Example 2 Configuration DataIn this example, you will configure the router with the data shown in IDREF="FM36661"Table 3-2.LBL="3-2" INLINE="F"ID="FM36661"Example 2 idxid="w4504"book="_idx" docset="nw312" tidref="i458"ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4505"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=55510zone={"Marketing"}WIDTH="180"Use a unique network number.Use a valid zone name.AppleTalk on ARCnetnet=11zone={"Marketing"}Use a valid network number.Use a valid zone name.TRXNET LAN driverframe=NOVELL_RXNETThe default frame type, also used by IPX.WIDTH="108"AFP file idxid="w4506"book="_idx" docset="nw312" tidref="i2263"servicesWIDTH="324"Installed (no options used)WIDTH="108"ATPS print servicesWIDTH="324"Not installed on this serverSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.This example shows how to add NetWare for Macintosh file services only. Adding ATPS print services is not shown. See IDREF="FM11507"Chapter 7, "Managing AppleTalk Print Services," on page 143 for information on print services.IDREF="FM36862"Figure 3-7 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual network more clearly.LBL="3-7"ID="FM36862"Example of ARCnet ConfigurationFILE="n312r021.pbm"Example 2 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load idxid="w4507"book="_idx" docset="nw312" tidref="i2831"INSTALL, select Product Options in the idxid="w4508"book="_idx" docset="nw312" tidref="i2831"main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4509"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r022.pbm"Highlight STARTUP.NCF and press <Enter>.Add these to the existing commands in STARTUP.NCF: idxid="w4510"book="_idx" docset="nw312" tidref="i6489" load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and in IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4511"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4512"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM33983"Figure 3-8.LBL="3-8"ID="FM33983"Example 2 idxid="w4513"book="_idx" docset="nw312" tidref="i458"AUTOEXEC.NCFFILE="n312r023.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. idxid="w4514"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=55510 zone={"Marketing"}If you would like more information, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.idxid="w4515"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4516"book="_idx" docset="nw312" tidref="i3085"LAN driver and idxid="w4517"book="_idx" docset="nw312" tidref="i3085"configure the AppleTalk network: bind appletlk arcnet net=11 zone={"Marketing"}The name arcnet in this command refers to the name assigned in the load trxnet command which appears before the NetWare for Macintosh configuration command lines in IDREF="FM33983"Figure 3-8 on page 45. Because IPX and idxid="w4518"book="_idx" docset="nw312" tidref="i247"AppleTalk both use the same idxid="w4519"book="_idx" docset="nw312" tidref="i2520"frame type on ARCnet, you do not need to reload the LAN driver.idxid="w4520"book="_idx" docset="nw312" tidref="i229"Load AppleTalk file services:  idxid="w4521"book="_idx" docset="nw312" tidref="i2263"load afp idxid="w4522"book="_idx" docset="nw312" tidref="i3245"For details on the AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. idxid="w4523"book="_idx" docset="nw312" tidref="i595"idxid="w4524"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.idxid="w4525"book="_idx" docset="nw312" tidref="i2227"Down the file server and idxid="w4526"book="_idx" docset="nw312" tidref="i2227"bring it back up.If you don't wish down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example:  DOWN <Enter> EXIT <Enter>  idxid="w4527"book="_idx" docset="nw312" tidref="i6235"SERVER <Enter>A series of messages appears, indicating that the system is loading the modules you specified. When the messages have completed, NetWare for Macintosh is up and idxid="w4528"book="_idx" docset="nw312" tidref="i2227"running. idxid="w4529"book="_idx" docset="nw312" tidref="i2227"Verify that the idxid="w4530"book="_idx" docset="nw312" tidref="i3649"modules have loaded.When you see the console colon (:) prompt, type  idxid="w4531"book="_idx" docset="nw312" tidref="i3930"MODULES <Enter>You will see a list of NLMs such as this one: APPLETLK.NLM  NetWare AppleTalk Stack/Router AFP.NLM  NetWare AFP module CLIB.NLM  NetWare C Runtime Library STREAMS.NLM  NetWare STREAMS TRXNET.LAN  TRXNET LAN Driver MAC.NAM  Macintosh Name Space Support ISADISK.DSK  NetWare ISA Device Driveridxid="w4532"book="_idx" docset="nw312" tidref="i362"Check the AppleTalk configuration.idxid="w4533"book="_idx" docset="nw312" tidref="i458"Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type  idxid="w4534"book="_idx" docset="nw312" tidref="i482"LOAD ATCON <Enter>idxid="w4535"book="_idx" docset="nw312" tidref="i2912"Then, choose View Router Interfaces in the main ATCON menu. Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for an explanation.idxid="w4536"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client.In this example, the file server appears in the "Marketing" zone, because this is the zone idxid="w4537"book="_idx" docset="nw312" tidref="i3610"of the idxid="w4538"book="_idx" docset="nw312" tidref="i1175"internal idxid="w4539"book="_idx" docset="nw312" tidref="i458"network.FILE="n312r024.pbm"ID="FM14390"Example 3: idxid="w4540"book="_idx" docset="nw312" tidref="i3355"Creating a idxid="w4541"book="_idx" docset="nw312" tidref="i3610"LocalTalk idxid="w4542"book="_idx" docset="nw312" tidref="i1175"NetworkThis example uses a file server that has an Ethernet connection, as shown in IDREF="FM41778"Figure 3-9.LBL="3-9"ID="FM41778"File Server with DOS Clients on EthernetFILE="n312r025.pbm"In this example, you will add an AppleTalk network with Macintosh workstations by installing a LocalTalk network board. The resulting networks are shown in IDREF="FM25995"Figure 3-10 on page 49.LBL="3-10"ID="FM25995"Adding a LocalTalk NetworkFILE="n312r026.pbm"Example 3 Configuration DataIn this example, you will configure the router with the information in IDREF="FM27724"Table 3-3.LBL="3-3" INLINE="F"ID="FM27724"Example 3 ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4543"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=55001zone={"Server zone"}WIDTH="180"Use a unique network number.Use a valid zone name.LocalTalk idxid="w4544"book="_idx" docset="nw312" tidref="i3355"net=110zone={"Mac zone"}Use a valid network number.Use a valid zone name.WIDTH="108"DL2000 LAN driverWIDTH="324"Frame type not requiredWIDTH="108"AFP file services idxid="w4545"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print servicesWIDTH="324"Installed, one NetWare print queue for LaserWriter (named "Laser")See IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.IDREF="FM39989"Figure 3-11 on page 50 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="3-11"ID="FM39989"Example of a LocalTalk ConfigurationFILE="n312r027.pbm"ID="FM25396"Example 3 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, idxid="w4546"book="_idx" docset="nw312" tidref="i2831"select Product Options in the idxid="w4547"book="_idx" docset="nw312" tidref="i2831"main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4548"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r028.pbm"Highlight STARTUP.NCF and press <Enter>.A idxid="w4549"book="_idx" docset="nw312" tidref="i6489"dd these to the existing commands in STARTUP.NCF: load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.Use the arrow keys to highlight idxid="w4550"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4551"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM30758"Figure 3-12.LBL="3-12"ID="FM30758"idxid="w4552"book="_idx" docset="nw312" tidref="i3355"Example 3 AUTOEXEC.NCFFILE="n312r029.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. idxid="w4553"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=55001 zone={"Server zone"}For more information, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.ID="FM41462"Load the idxid="w4554"book="_idx" docset="nw312" tidref="i3085"LocalTalk LAN driver: load dl2000 int=3 port=320 name=localtalkidxid="w4555"book="_idx" docset="nw312" tidref="i1735"The NAME option is a idxid="w4556"book="_idx" docset="nw312" tidref="i3085"NetWare idxid="w4557"book="_idx" docset="nw312" tidref="i4267"driver-naming feature that lets you specify a name for a specific configuration. idxid="w4558"book="_idx" docset="nw312" tidref="i247"This option is described in the idxid="w4559"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. idxid="w4560"book="_idx" docset="nw312" tidref="i2520"For more details, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4561"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4562"book="_idx" docset="nw312" tidref="i3085"LocalTalk LAN driver and configure an AppleTalk network: bind appletlk localtalk net=110 zone={"Mac zone"}The name localtalk refers to the driver configuration names assigned in IDREF="FM41462"Step 5. For more details, refer to IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241.Load file and idxid="w4563"book="_idx" docset="nw312" tidref="i324"print idxid="w4564"book="_idx" docset="nw312" tidref="i3245"services idxid="w4565"book="_idx" docset="nw312" tidref="i5425":  idxid="w4566"book="_idx" docset="nw312" tidref="i229"load idxid="w4567"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4568"book="_idx" docset="nw312" tidref="i2263"  idxid="w4569"book="_idx" docset="nw312" tidref="i324"load idxid="w4570"book="_idx" docset="nw312" tidref="i3245"atps idxid="w4571"book="_idx" docset="nw312" tidref="i5425"For details on the AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4572"book="_idx" docset="nw312" tidref="i595"If you are idxid="w4573"book="_idx" docset="nw312" tidref="i516"ready to enter a idxid="w4574"book="_idx" docset="nw312" tidref="i5282"print queue configuration, highlight ATPS.CFG in the menu and then press <Enter>; otherwise, go to IDREF="FM17605"Step 9.Add a queue configuration command line, such as the example queue shown in IDREF="FM13490"Figure 3-13 on page 53.LBL="3-13"ID="FM13490"A Queue Configuration Using the Default SyntaxFILE="n312r030.pbm"This example uses the default "printer-name:zone-name" syntax, where printer-name is the name of the AppleTalk printer, and zone-name is the zone in which the printer resides. idxid="w4575"book="_idx" docset="nw312" tidref="i5282"This syntax creates a NetWare print queue and an AppleTalk print spooler that advertises the queue in the Chooser. The AppleTalk spooler will use the name "NW printer-name" (for example, "NW Laser"). The queue name will be derived from the spooler name; in this case, it will be "NW_LASER."The AppleTalk spooler will be visible in the zone of the internal network. In this example, it will appear in "Server zone." The printer itself resides in "Mac zone."See IDREF="FM25504""Print Services Configuration" on page 147 for information about your options in configuring and naming idxid="w4576"book="_idx" docset="nw312" tidref="i5282"queues. idxid="w4577"book="_idx" docset="nw312" tidref="i516"ID="FM17605"Exit INSTALL, s idxid="w4578"book="_idx" docset="nw312" tidref="i2831"aving your changes.idxid="w4579"book="_idx" docset="nw312" tidref="i2227"Installing the Network Interface Board idxid="w4580"book="_idx" docset="nw312" tidref="i4508"In this example, you will install a DL2000 LocalTalk board in the file server to support the AppleTalk network. To install the network interface board, follow these steps:Configure the network idxid="w4581"book="_idx" docset="nw312" tidref="i4508"board hardware.Typically, you need to set the interrupt switch on the board before installing it. The interrupt and port you set on the DL2000 board must exactly match the interrupt and port you supplied as parameters to the LocalTalk LAN driver, and must be unique within this file server.Use BROADCAST to inform the existing DOS clients on Ethernet that the file server is going down.At the console prompt, enter this command: BROADCAST "The file server is going down."You might want to specify a reasonable warning time, such as "The file server is going down in 2 minutes." When the time you specify has passed, go on to Step 3.Down the file server.At the console prompt, type  idxid="w4582"book="_idx" docset="nw312" tidref="i2227"DOWN <Enter> EXIT <Enter>When the messages have printed and you have resolved any open file issues, go on to the next step.Turn off the power on the file server system unit.Install the board in the file server.Follow the instructions that accompany the network board to install it in the file server.idxid="w4583"book="_idx" docset="nw312" tidref="i4508"Turn on the power on the file server system unit. idxid="w4584"book="_idx" docset="nw312" tidref="i2227"Bringing Up the File Server idxid="w4585"book="_idx" docset="nw312" tidref="i2227"Follow the procedure you usually follow for downing and bringing up the file server.Bring up the server by typing the SERVER command.For example, if there is no DOS partition on the file server, boot from the DOS diskette that contains SERVER.EXE by entering this command at the DOS prompt:  idxid="w4586"book="_idx" docset="nw312" tidref="i6235"SERVERMessages indicate that the system is loading the modules you specified. idxid="w4587"book="_idx" docset="nw312" tidref="i2227"idxid="w4588"book="_idx" docset="nw312" tidref="i3649"Use the idxid="w4589"book="_idx" docset="nw312" tidref="i3930"MODULES command to verify that the NLMs loaded.See IDREF="FM36626"page 40 if you would like an example.Use idxid="w4590"book="_idx" docset="nw312" tidref="i3355"ATCON to idxid="w4591"book="_idx" docset="nw312" tidref="i3355"verify the configuration.idxid="w4592"book="_idx" docset="nw312" tidref="i362"Now that idxid="w4593"book="_idx" docset="nw312" tidref="i2912"the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type  idxid="w4594"book="_idx" docset="nw312" tidref="i482"LOAD ATCON <Enter>idxid="w4595"book="_idx" docset="nw312" tidref="i4547"Then, choose View Router Interfaces in the main ATCON menu. A window opens, showing the networks and zones you configured. Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for more information.idxid="w4596"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client. In this example, both the file server and its print queue appear in "Server zone" (the zone of the internal network).FILE="n312r031.pbm"To see the print queue "NW Laser," click the LaserWriter icon while "Server zone" is selected.FILE="n312r032.pbm"In this example, you specified different zone names for the internal and LocalTalk interfaces, so the printer and print queue appear in different zones. The printer appears in the zone of the network to which it is connected.FILE="n312r033.pbm"You can enforce the use of NetWare queues by using the -h option when you configure the queue in ATPS.CFG. The-h option "hides" the LaserWriter. idxid="w4597"book="_idx" docset="nw312" tidref="i3610"See IDREF="FM18651""Enabling Printer Security: -h" on page 157idxid="w4598"book="_idx" docset="nw312" tidref="i1175"for idxid="w4599"book="_idx" docset="nw312" tidref="i3610"details. idxid="w4600"book="_idx" docset="nw312" tidref="i3355"ID="FM31333"Example 4: idxid="w4601"book="_idx" docset="nw312" tidref="i1175"EtherTalk 2.0 idxid="w4602"book="_idx" docset="nw312" tidref="i1896"with Other AppleTalk RoutersThis example shows how to configure NetWare for Macintosh for EtherTalk 2.0 when another AppleTalk router has already been configured on that Ethernet. The basic network is shown in IDREF="FM19940"Figure 3-14.LBL="3-14"ID="FM19940"An AppleTalk NetworkFILE="n312r034.pbm"In this example, the configured AppleTalk router is a Phase 2 router. If there are AppleTalk Phase 1 routers on the network at your site, and you wish to maintain full internet connectivity, you must configure all Phase 2 routers in Transition Mode. This procedure is described in Appendix B.Example 4 Configuration DataIn this example, you will configure the router for EtherTalk 2.0 using the information in IDREF="FM29419"Table 3-4.LBL="3-4" INLINE="F"ID="FM29419"Example 4 ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4603"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=55002zone={"Admin","Q zone"}WIDTH="180"Use a unique network number.*See Note below about multiple internal  zones.EtherTalk 2.0 idxid="w4604"book="_idx" docset="nw312" tidref="i1896"net=150-152zone={"Sales","Marketing"}This network configuration must exactly  match that of the existing router for this  network.WIDTH="108"NE2000 LAN driverWIDTH="324"frame=ETHERNET_SNAPWIDTH="108"AFP file services idxid="w4605"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print services idxid="w4606"book="_idx" docset="nw312" tidref="i5425"WIDTH="324"Installed, one print queue for LaserWriter (named "Pubs LW") on the  LocalTalk networkThis example shows how to configure more than one zone on the internal network. The purpose of configuring multiple zones on the internal network is to advertise print queue in any one of these AppleTalk zones. (AFP file services are always advertised in the default zone of the internal network.) To configure multiple internal zones, you must be operating in a Phase 2 environment, where no Phase 1 routers are present.See IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.IDREF="FM22987"Figure 3-15 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="3-15"ID="FM22987"Matching the Router ConfigurationsFILE="n312r035.pbm"You can allow the AppleTalk router to "learn" its configuration automatically from the configured AppleTalk router. This is shown in IDREF="FM26587"Figure 3-18 on page 66.Example 4 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, idxid="w4607"book="_idx" docset="nw312" tidref="i2831"select Product Options in the main idxid="w4608"book="_idx" docset="nw312" tidref="i2831"INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the Editable Configuration Files menu opens.FILE="n312r036.pbm"Highlight STARTUP.NCF and press <Enter>.idxid="w4609"book="_idx" docset="nw312" tidref="i6489"Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4610"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in bold monospace type in IDREF="FM24157"Figure 3-16 on page 61.LBL="3-16"ID="FM24157"Example 4 idxid="w4611"book="_idx" docset="nw312" tidref="i1896"AUTOEXEC.NCFFILE="n312r037.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. idxid="w4612"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=55002 zone={"Admin","Q zone"}If you would like more information about this command line, see IDREF="FM22523""Loading the AppleTalk Module" on page 237. ID="FM14328"Load the idxid="w4613"book="_idx" docset="nw312" tidref="i3085"LAN driver and idxid="w4614"book="_idx" docset="nw312" tidref="i247"AppleTalk frame type:  idxid="w4615"book="_idx" docset="nw312" tidref="i2520"load ne2000 int=2 port=300 frame=ethernet_snap name=esnapidxid="w4616"book="_idx" docset="nw312" tidref="i1735"The NAME option is a idxid="w4617"book="_idx" docset="nw312" tidref="i4267"NetWare idxid="w4618"book="_idx" docset="nw312" tidref="i3085"driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4619"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4620"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4621"book="_idx" docset="nw312" tidref="i3085"LAN drivers and configure the AppleTalk networks: bind appletlk esnap net=150-152 zone={"Sales","Marketing"}The name esnap is established with the NAME parameter on the LOAD command line, and it refers to the driver name assigned in IDREF="FM14328"Step 5. For more information about BIND command lines, refer to IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241.ID="FM38768"Load the file and print service modules: idxid="w4622"book="_idx" docset="nw312" tidref="i5425"  idxid="w4623"book="_idx" docset="nw312" tidref="i229"load idxid="w4624"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4625"book="_idx" docset="nw312" tidref="i2263"  idxid="w4626"book="_idx" docset="nw312" tidref="i324"load idxid="w4627"book="_idx" docset="nw312" tidref="i3245"atpsFor details on the AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. See IDREF="FM17711""Loading the ATPS Module" on page 146 for ATPS options.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4628"book="_idx" docset="nw312" tidref="i595"ID="FM25541"If you are idxid="w4629"book="_idx" docset="nw312" tidref="i516"ready to enter a idxid="w4630"book="_idx" docset="nw312" tidref="i5282"print queue configuration, highlight ATPS.CFG in the menu and then press <Enter>; otherwise, go to IDREF="FM17605"Step 9.Add a queue configuration command line, such as the example queue shown in IDREF="FM40045"Figure 3-17.LBL="3-17"ID="FM40045"idxid="w4631"book="_idx" docset="nw312" tidref="i5282"Creating and Naming a Print Queue That Will Be Visible in the "Q zone"FILE="n312r038.pbm"When more than one zone name is specified for the internal network, the first name in the list is the default zone ("Admin" in this example). You can choose to advertise print queues in a zone other than the default zone of the internal network by using the-o option and specifying the queue name and zone name, as shown in IDREF="FM40045"Figure 3-17 on page 63. See IDREF="FM12141""Advertising a Queue in a Specified Zone: -o" on page 160 for details.This example uses the default "printer-name:zone-name" syntax, where printer-name is the name of the AppleTalk printer, and zone-name is the zone in which the printer resides, and explicitly names the AppleTalk print spooler "Queue1." This is the name that will appear in the Macintosh Chooser.The spooler will be visible in the specified zone of the internal network. In this example, it will appear in "Q zone." The printer itself resides in "Publications."Please see IDREF="FM25504""Print Services Configuration" on page 147 for a discussion of your options in configuring queues.idxid="w4632"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.ID="FM10950"Down the file server and idxid="w4633"book="_idx" docset="nw312" tidref="i2227"bring it back up. idxid="w4634"book="_idx" docset="nw312" tidref="i2227"If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example:  DOWN <Enter> EXIT <Enter> SERVER <Enter>A series of messages appears, indicating that the system is loading the modules you idxid="w4635"book="_idx" docset="nw312" tidref="i2227"specified. idxid="w4636"book="_idx" docset="nw312" tidref="i2227"idxid="w4637"book="_idx" docset="nw312" tidref="i3649"Use the idxid="w4638"book="_idx" docset="nw312" tidref="i3930"MODULES command to verify that the NLMs loaded.See IDREF="FM36626"page 40 if you would like an example.idxid="w4639"book="_idx" docset="nw312" tidref="i362"Use idxid="w4640"book="_idx" docset="nw312" tidref="i482"ATCON to verify the idxid="w4641"book="_idx" docset="nw312" tidref="i1896"configuration.Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type LOAD ATCON <Enter>idxid="w4642"book="_idx" docset="nw312" tidref="i2912"Then, idxid="w4643"book="_idx" docset="nw312" tidref="i4547"choose View Router Interfaces in the main ATCON menu. A window opens, showing the networks and zones you configured. See IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for more information.idxid="w4644"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client.In this example, the file server appears in the "Admin" zone, because this is the default zone of the internal network.FILE="n312r039.pbm"The print queue appears idxid="w4645"book="_idx" docset="nw312" tidref="i3610"in "Q zone," as you idxid="w4646"book="_idx" docset="nw312" tidref="i1896"specified in idxid="w4647"book="_idx" docset="nw312" tidref="i1175"ATPS.CFG.FILE="n312r040.pbm"ID="FM36596"Example 5: Learning idxid="w4648"book="_idx" docset="nw312" tidref="i1175"from Other idxid="w4649"book="_idx" docset="nw312" tidref="i1896"RoutersThis example provides an alternative way to configure the router when other AppleTalk routers are present on one or more of its networks. It uses exactly the same network setup as IDREF="FM31333""Example 4: EtherTalk 2.0 with Other AppleTalk Routers" on page 58, but it allows the AppleTalk router to "learn" its network configuration automatically by "listening" to the other AppleTalk router.The basic network in this example is the same one shown in IDREF="FM19940"Figure 3-14 on page 58. In this example, the EtherTalk 2.0 network will be configured as a "non-seed interface" (IDREF="FM26587"Figure 3-18 on page 66).LBL="3-18"ID="FM26587"Configuring a Non-Seed InterfaceFILE="n312r041.pbm"In this example, the EtherTalk 2.0 interface in the server is configured as a "non-seed interface" by assigning the network range "0-0." This instructs the router to obtain its configuration from existing routers on that network.Example 5 Configuration DataIn this example, you will configure the router using this data:LBL="3-5" INLINE="F"Example 5 idxid="w4650"book="_idx" docset="nw312" tidref="i1896"ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4651"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=55002zone={"Admin","Q zone"}WIDTH="180"Use a unique network number.See Note below about multiple internal  zones.EtherTalk 2.0net=0-0Non-seed interfaceWIDTH="108"NE2000 LAN driverWIDTH="324"frame=ETHERNET_SNAPWIDTH="108"AFP file services idxid="w4652"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print servicesWIDTH="324"Installed, one print queue for LaserWriter (named "Pubs LW") on the  LocalTalk networkThis example shows how to configure more than one zone on the internal network. The purpose of configuring multiple zones on the internal network is to allow print queues to be advertised in any one of these AppleTalk zones. (AFP file services are always advertised in the first zone entered for the internal network, which is the default zone for the internal network.) To configure multiple internal zones, you must be operating in a Phase 2 environment, where no Phase 1 routers are present.Example 5 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, idxid="w4653"book="_idx" docset="nw312" tidref="i2831"select Product Options in the idxid="w4654"book="_idx" docset="nw312" tidref="i2831"main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4655"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r042.pbm"idxid="w4656"book="_idx" docset="nw312" tidref="i6489"Highlight STARTUP.NCF and press <Enter>.Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4657"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4658"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM33809"Figure 3-19.LBL="3-19"ID="FM33809"Example 5 idxid="w4659"book="_idx" docset="nw312" tidref="i1896"AUTOEXEC.NCFFILE="n312r043.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.Load the idxid="w4660"book="_idx" docset="nw312" tidref="i260"AppleTalk module and configure the internal network: load appletlk net=55002 zone={"Admin","Q zone"}If you would like more information about this command line, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.ID="FM35368"Load the idxid="w4661"book="_idx" docset="nw312" tidref="i247"LAN driver and idxid="w4662"book="_idx" docset="nw312" tidref="i3085"AppleTalk idxid="w4663"book="_idx" docset="nw312" tidref="i2520"frame type: load ne2000 int=2 port=300 frame=ethernet_snap name=esnapidxid="w4664"book="_idx" docset="nw312" tidref="i1735"The NAME idxid="w4665"book="_idx" docset="nw312" tidref="i3085"option is a idxid="w4666"book="_idx" docset="nw312" tidref="i4267"NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4667"book="_idx" docset="nw312" tidref="i3085"NetWare idxid="w4668"book="_idx" docset="nw312" tidref="i4451"v3.11System Administration manual. idxid="w4669"book="_idx" docset="nw312" tidref="i2520"For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238. idxid="w4670"book="_idx" docset="nw312" tidref="i247"Bind idxid="w4671"book="_idx" docset="nw312" tidref="i271"AppleTalk to the idxid="w4672"book="_idx" docset="nw312" tidref="i3085"LAN drivers and configure the AppleTalk networks: bind appletlk esnap net=0-0The name esnap is specified in IDREF="FM35368"Step 5 and refers to the driver name assigned in the LOAD command.The parameter net=0-0 creates a non-seed interface. The router will listen for information from other routers on that network for its own configuration data.Load the file and idxid="w4673"book="_idx" docset="nw312" tidref="i5425"print service modules:  idxid="w4674"book="_idx" docset="nw312" tidref="i229"load idxid="w4675"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4676"book="_idx" docset="nw312" tidref="i2263"  idxid="w4677"book="_idx" docset="nw312" tidref="i324"load idxid="w4678"book="_idx" docset="nw312" tidref="i3245"atpsFor details on the AFP configuration options you can specify on the LOAD command line, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu.If you are ready idxid="w4679"book="_idx" docset="nw312" tidref="i516"to enter a print queue configuration, highlight ATPS.CFG in the menu and then press <Enter>.idxid="w4680"book="_idx" docset="nw312" tidref="i5282"See IDREF="FM25541"page 62 for idxid="w4681"book="_idx" docset="nw312" tidref="i5282"instructions on creating a print queue for the LaserWriter shown in this example.idxid="w4682"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.You can now complete the configuration procedure by idxid="w4683"book="_idx" docset="nw312" tidref="i2227"downing the server or by re-entering the STARTUP.NCF and AUTOEXEC.NCF commands at the server console. Please see IDREF="FM10950"page 63 for idxid="w4684"book="_idx" docset="nw312" tidref="i595"instructions. idxid="w4685"book="_idx" docset="nw312" tidref="i1896"idxid="w4686"book="_idx" docset="nw312" tidref="i1175"LBL="4"ID="FM16400"More Complex Network ConfigurationsThis chapter describes how to configure NetWare for Macintosh for network environments that are more complex than those covered in Chapter 3. This chapter includes these examples:IDREF="FM12590""Example 6: EtherTalk 2.0 and LocalTalk" on page 73 shows how to add a LocalTalk network and install NetWare for Macintosh on a file server connected to Ethernet.IDREF="FM26030""Example 7: An EtherTalk 1.0 and EtherTalk 2.0 Network" on page 84 shows how to use both EtherTalk 1.0 and EtherTalk 2.0 on a single Ethernet cable.IDREF="FM28863""Example 8: TokenTalk, EtherTalk 1.0, and LocalTalk" on page 92 shows how to use configure a server with three AppleTalk interfaces.IDREF="FM36439""Example 9: Learning from Routers on an Internet" on page 100 shows how to use AppleTalk "seeding" when configuring three routers to form a five-network AppleTalk internet.The procedures described in this chapter specify that you must down the file server and bring it up again to activate AppleTalk with the most current configuration specifications. This requirement is based on the recommendation that you configure your networks and zones in the server's STARTUP.NCF and AUTOEXEC.NCF files. An alternative to this approach is to type the commands at the server console. If you type the commands at the console instead of entering them in the server's STARTUP.NCF and AUTOEXEC.NCF files, you do not need to down the file server to activate AppleTalk.See Chapters 6 and 7 for important information about your options in AFP and print service configurations.idxid="w4687"book="_idx" docset="nw312" tidref="i1175"Quick Overview of the Configuration ProcedureThese steps show a broad overview of the configuration process. The examples beginning on IDREF="FM12590"page 73 provide complete instructions.Load INSTALL.Select Product Options and press <Enter> on the line specifying NW-MAC to open the Editable Configuration Files menu.Edit the file server's STARTUP.NCF file to specify these commands: load mac set minimum packet receive buffers=100Edit SYS:\SYSTEM\AUTOEXEC.NCF to specify commands that accomplish these tasks:LOAD the AppleTalk module and configure the internal AppleTalk network.LOAD LAN drivers for AppleTalk networks and specify the appropriate AppleTalk frame types.BIND AppleTalk to the appropriate LAN drivers and configure AppleTalk networks on those interfaces.LOAD the AFP file service module (optional), specifying configuration options if appropriate.LOAD the ATPS print module (optional).If ATPS is loaded, edit ATPS.CFG to configure print queues.Exit the INSTALL utility, saving your changes.Down the file server and bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.idxid="w4688"book="_idx" docset="nw312" tidref="i1175"Preparing the Configuration Data You NeedThe AppleTalk network configuration affects not only the file server and its Macintosh clients, but also all AppleTalk networks with which the router can communicate.It is very important that you check your router configuration data before you carry out your configuration tasks. If you are part of a large organization where networks are managed by internet administrators, make sure that you obtain valid AppleTalk network addresses before you configure the AppleTalk router.If you are installing NetWare for Macintosh on an existing AppleTalk internet, determine whether the network(s) to which you will connect the router support an AppleTalk router already. If so, you must configure the new router in accordance with the configuration of the existing router, or allow it to "learn" from other routers on its network(s).If you are configuring multiple zones on an extended network, and the total number of characters on the AppleTalk BIND command line will exceed 82 characters, you need to specify the zone configuration in the ATZONES.CFG file. See IDREF="FM10439""Using the ATZONES.CFG Configuration File" on page 243 for details.Determine which file servers must support NetWare for Macintosh to make sure that Macintosh clients on different networks can log in to NetWare. See IDREF="FM35675""The AppleTalk Router in NetWare for Macintosh" on page 10 for a quick overview.If a network interface board will not be sending and receiving IPX packets, it is not necessary to bind IPX to that board and assign it an IPX network number. However, an IPX network number is necessary for the internal network.Please refer to Appendix B if you must accommodate Phase 1 routers by using Transition Mode.ID="FM12590"Example idxid="w4689"book="_idx" docset="nw312" tidref="i3610"6 idxid="w4690"book="_idx" docset="nw312" tidref="i3355": idxid="w4691"book="_idx" docset="nw312" tidref="i1874"EtherTalk 2.0 idxid="w4692"book="_idx" docset="nw312" tidref="i1896"and idxid="w4693"book="_idx" docset="nw312" tidref="i1175"LocalTalkThis example shows how to add NetWare for Macintosh to a NetWare v3.12 server connected to Ethernet. The server already supports DOS clients via IPX, as shown in IDREF="FM19114"Figure 4-1 on page 74.LBL="4-1"ID="FM19114"File Server with an IPX Network on EthernetFILE="n312r044.pbm"In this example, you will add a LocalTalk network for Macintosh workstations and an idxid="w4694"book="_idx" docset="nw312" tidref="i5482"Apple printer; you will also add an AppleTalk network and Macintosh workstations to the existing Ethernet cable. The resulting networks are shown in IDREF="FM38014"Figure 4-2 on page 74.LBL="4-2"ID="FM38014"Adding EtherTalk 2.0 and LocalTalk NetworksFILE="n312r045.pbm"Example 6 Configuration DataIn this example, you will configure the router for EtherTalk 2.0 and LocalTalk, using the information in IDREF="FM23701"Table 4-1.LBL="4-1" INLINE="F"ID="FM23701"Example 6 idxid="w4695"book="_idx" docset="nw312" tidref="i1896"ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4696"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=50000zone={"Admin"}WIDTH="180"Use a unique network number.Use a valid zone name.EtherTalk 2.0net=1-5zone={"Sales","Marketing"}Use a valid network range.Use a list of at least one zone name.LocalTalk idxid="w4697"book="_idx" docset="nw312" tidref="i3355"net=6zone={"Admin"}Use a valid network number.Use a valid zone name.WIDTH="108"NE2000 LAN driverWIDTH="324"frame=ETHERNET_SNAPWIDTH="108"DL2000 LAN driverWIDTH="324"No frame requiredWIDTH="108"AFP file services idxid="w4698"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print services idxid="w4699"book="_idx" docset="nw312" tidref="i5425"WIDTH="324"Installed, one print queue for LaserWriter (named "Admin NT") on  LocalTalkSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.IDREF="FM16533"Figure 4-3 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="4-3"ID="FM16533"Example of EtherTalk 2.0 and LocalTalk ConfigurationFILE="n312r046.pbm"Example 6 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, idxid="w4700"book="_idx" docset="nw312" tidref="i2831"select Product Options in the idxid="w4701"book="_idx" docset="nw312" tidref="i2831"main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4702"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r047.pbm"Highlight STARTUP.NCF and press <Enter>.idxid="w4703"book="_idx" docset="nw312" tidref="i6489"Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press<Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4704"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4705"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM16059"Figure 4-4 on 77.LBL="4-4"ID="FM16059"idxid="w4706"book="_idx" docset="nw312" tidref="i3355"Example 6 idxid="w4707"book="_idx" docset="nw312" tidref="i1896"AUTOEXEC.NCFFILE="n312r048.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. Load the idxid="w4708"book="_idx" docset="nw312" tidref="i260"AppleTalk module and configure the internal network: load appletlk net=50000 zone={"Admin"}If you would like more information, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.idxid="w4709"book="_idx" docset="nw312" tidref="i247"Load idxid="w4710"book="_idx" docset="nw312" tidref="i3085"LAN drivers (and AppleTalk idxid="w4711"book="_idx" docset="nw312" tidref="i2520"frame types, if applicable): load ne2000 int=2 port=300 frame=ethernet_snap name=esnap load dl2000 int=3 port=200 name=ltalkidxid="w4712"book="_idx" docset="nw312" tidref="i1735"The NAME idxid="w4713"book="_idx" docset="nw312" tidref="i3085"option is a idxid="w4714"book="_idx" docset="nw312" tidref="i4267"NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4715"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4716"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4717"book="_idx" docset="nw312" tidref="i3085"LAN drivers and configure AppleTalk networks: bind appletlk esnap net=1-5 zone={"Sales","Marketing"} bind appletlk ltalk net=6 zone={"Admin"}The names esnap and ltalk in these command lines refer to the NE2000 and DL2000 driver configuration names assigned above. See IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241 if you need more information about BIND command lines.Load AppleTalk file and idxid="w4718"book="_idx" docset="nw312" tidref="i5425"print services:  idxid="w4719"book="_idx" docset="nw312" tidref="i229"load idxid="w4720"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4721"book="_idx" docset="nw312" tidref="i2263"  idxid="w4722"book="_idx" docset="nw312" tidref="i324"load idxid="w4723"book="_idx" docset="nw312" tidref="i3245"atpsFor details on the AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. See IDREF="FM17711""Loading the ATPS Module" on page 146 for information about ATPS options.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4724"book="_idx" docset="nw312" tidref="i595"If you are ready to enter a idxid="w4725"book="_idx" docset="nw312" tidref="i516"print idxid="w4726"book="_idx" docset="nw312" tidref="i5282"queue configuration, highlight ATPS.CFG in the menu and then press <Enter>; otherwise, go to IDREF="FM40206"Step 9.Add a queue configuration command line, such as the example queue shown in IDREF="FM38911"Figure 4-5 on page 79.LBL="4-5"ID="FM38911"A Print Queue Using the Default SyntaxFILE="n312r049.pbm"This example uses the default "printer-name:zone-name" syntax, where printer-name is the name of the AppleTalk printer, and zone-name is the zone in which the printer resides. idxid="w4727"book="_idx" docset="nw312" tidref="i5282"This syntax creates a NetWare print queue and an AppleTalk print spooler that advertises the queue in the Chooser. The AppleTalk spooler will use the name "NW printer-name" (for example, "NW Admin NT"). The queue name will be derived from the spooler name; in this case, the queue name will be "NW_ADMIN_NT."The AppleTalk spooler will be visible in the zone of the internal network. In this example, it will appear in the "Admin" zone. The printer itself resides on LocalTalk, which in this example also uses the zone name "Admin."See IDREF="FM25504""Print Services Configuration" on page 147 for information about your options in configuring and naming queues.ID="FM40206"Exit INSTALL, idxid="w4728"book="_idx" docset="nw312" tidref="i2831"saving your changes.Installing the idxid="w4729"book="_idx" docset="nw312" tidref="i2227"Network idxid="w4730"book="_idx" docset="nw312" tidref="i4508"Interface BoardIn this example, you will install a DL2000 LocalTalk board in the file server to support the Apple printer. To install the network interface board, follow these steps:Configure the network board hardware.idxid="w4731"book="_idx" docset="nw312" tidref="i4508"Typically, you need to set the interrupt switch on the board before installing it. The interrupt and port you set on the DL2000 board must exactly match the interrupt and port you supplied as parameters to the LocalTalk LAN driver, and must be unique within this file server.Use BROADCAST to inform the existing DOS clients on Ethernet that the file server is going down.At the console prompt, enter this command: BROADCAST "The file server is going down."You might want to specify a reasonable warning time, such as "The file server is going down in 2 minutes." When the time you specify has passed, go to Step 3.idxid="w4732"book="_idx" docset="nw312" tidref="i2227"Down the file server.At the console prompt, type DOWN<Enter> EXIT<Enter>When the messages have printed and you have resolved any open file issues, go on the next step.Turn off the power on the file server system unit.Install the board in the file server.Follow the instructions that accompany the network board to install it in the file server.Turn on the power on the file server system unit.Bringing Up the File ServerFollow the procedure you usually follow for downing and bringing up the file server.Bring up the server idxid="w4733"book="_idx" docset="nw312" tidref="i2227"by typing the SERVER command.For example, if there is no DOS partition on the file server, boot from the DOS diskette that contains SERVER.EXE by typing this command at the DOS prompt:  idxid="w4734"book="_idx" docset="nw312" tidref="i6235"SERVER<Enter>Messages indicate that the system is loading the modules you specified. For our example, these messages appear: Loading . . . Minimum Packet Receive Buffers set to 100 Loading module ISADISK.DSK Loading module MAC.NAM Loading module NE2000.LAN Loading module DL2000.LAN Loading module APPLETLK.NLM APPLETALK LAN protocol bound to NE-2000 LAN Driver APPLETALK LAN protocol bound to DL-2000 LAN Driver Loading module AFP.NLM Loading module ATPS.NLM Auto-loading module STREAMS.NLM Auto-loading module CLIB.NLM :At this point, NetWare for Macintosh is up and running.ID="FM36869"Verify that the idxid="w4735"book="_idx" docset="nw312" tidref="i3930"modules idxid="w4736"book="_idx" docset="nw312" tidref="i3649"have loaded.When you see the console colon (:) prompt, type MODULES <Enter>You will see a list of NLMs such as this one: APPLETLK.NLM NetWare AppleTalk Stack/Router AFP.NLM NetWare AFP module ATPS.NLM Macintosh Print Services CLIB.NLM NetWare C Runtime Library STREAMS.NLM NetWare STREAMS DL2000.LAN DL-2000 LAN Driver NE2000.LAN NE-2000 LAN Driver MAC.NAM Macintosh Name Space Support ISADISK.DSK idxid="w4737"book="_idx" docset="nw312" tidref="i3930"NetWare ISA Device Driver idxid="w4738"book="_idx" docset="nw312" tidref="i3649"idxid="w4739"book="_idx" docset="nw312" tidref="i362"Check the AppleTalk configuration.Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type  idxid="w4740"book="_idx" docset="nw312" tidref="i482"LOAD ATCON idxid="w4741"book="_idx" docset="nw312" tidref="i4547"<Enter>idxid="w4742"book="_idx" docset="nw312" tidref="i1896"Then, idxid="w4743"book="_idx" docset="nw312" tidref="i2912"choose idxid="w4744"book="_idx" docset="nw312" tidref="i3355"View Router Interfaces in the main ATCON menu. A window opens, showing the interfaces you configured (IDREF="FM26180"Figure 4-6).LBL="4-6"ID="FM26180"Checking the Configuration in ATCONFILE="n312r050.pbm"Check the network numbers and zones against your records to make sure they are correct. Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for an explanation of the fields in this window.idxid="w4745"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client. In this example, both the file server and its queues appear in the Admin zone, because this is the zone of the internal network.FILE="n312r051.pbm"To see the print queue "NW Admin NT," click the LaserWriter icon and choose the Admin zone.FILE="n312r052.pbm"In this example, you specified the same zone name for both the internal and LocalTalk interfaces, so both the printer and print queue appear when a user selects the Admin zone.You can idxid="w4746"book="_idx" docset="nw312" tidref="i3610"enforce the use of NetWare queues by using the -h option when you configure the queue in idxid="w4747"book="_idx" docset="nw312" tidref="i3610"ATPS.CFG. The -h option "hides" idxid="w4748"book="_idx" docset="nw312" tidref="i3355"the idxid="w4749"book="_idx" docset="nw312" tidref="i1175"LaserWriter. idxid="w4750"book="_idx" docset="nw312" tidref="i1896"See IDREF="FM18651""Enabling Printer Security: -h" on page 157 for details. idxid="w4751"book="_idx" docset="nw312" tidref="i1874"ID="FM26030"Example idxid="w4752"book="_idx" docset="nw312" tidref="i1175"7: idxid="w4753"book="_idx" docset="nw312" tidref="i1881"An idxid="w4754"book="_idx" docset="nw312" tidref="i1881"EtherTalk 1.0 idxid="w4755"book="_idx" docset="nw312" tidref="i1896"and idxid="w4756"book="_idx" docset="nw312" tidref="i1896"EtherTalk 2.0 NetworkThis example uses a file server that has an Ethernet and a LocalTalk connection, as shown in IDREF="FM29426"Figure 4-7.LBL="4-7"ID="FM29426"Network with Both EtherTalk 1.0 and EtherTalk 2.0 ClientsFILE="n312r053.pbm"For the purposes of this example, assume that some of the Macintosh clients have been upgraded to EtherTalk 2.0, and that other Macintosh clients are running EtherTalk 1.0.To route both EtherTalk 2.0 and EtherTalk 1.0 packets on the same cable, you must configure the router for both EtherTalk 2.0 and 1.0 on the same LAN driver. The two versions of EtherTalk use idxid="w4757"book="_idx" docset="nw312" tidref="i1881"different idxid="w4758"book="_idx" docset="nw312" tidref="i1896"frame types, and as a result, AppleTalk sees EtherTalk 1.0 and EtherTalk 2.0 as two separate networks that happen to be running on the same Ethernet cable. See IDREF="FM12917""AppleTalk Packet Frames" on page 239 for more information.Example 7 Configuration DataIn this example, you will configure the router for EtherTalk 2.0, EtherTalk 1.0 and LocalTalk, using the information in IDREF="FM15618"Table 4-2.LBL="4-2" INLINE="F"ID="FM15618"Example 7 ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4759"book="_idx" docset="nw312" tidref="i2912"WIDTH="156"net=50010zone={"TechOps"}WIDTH="156"Use a unique network number.Use a valid zone name.LocalTalk idxid="w4760"book="_idx" docset="nw312" tidref="i3355"net=500zone={"Sales"}Use a valid network number.Use a valid zone name.EtherTalk 2.0 idxid="w4761"book="_idx" docset="nw312" tidref="i1896"net=1000-1002zone={"TechOps","Marketing"}Use a valid network range.Use a list of at least one zone  name.EtherTalk 1.0 idxid="w4762"book="_idx" docset="nw312" tidref="i1881"net=100zone={"TechOps"}Use a valid network number.Use a valid zone name.NE2000 LAN driver idxid="w4763"book="_idx" docset="nw312" tidref="i3085"frame=ETHERNET_SNAPframe=ETHERNET_IIFor EtherTalk 2.0For EtherTalk 1.0WIDTH="108"AFP file services idxid="w4764"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print services idxid="w4765"book="_idx" docset="nw312" tidref="i5425"WIDTH="324"Installed, one print queue for LaserWriter (named "Sales NT") on LocalTalkSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.IDREF="FM15100"Figure 4-8 on page 86 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="4-8"ID="FM15100"Configuring Both EtherTalk 1.0 and 2.0 on the Same Ethernet CableFILE="n312r054.pbm"ID="FM29030"Example 7 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section. Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4766"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r055.pbm"Highlight STARTUP.NCF and press <Enter>.idxid="w4767"book="_idx" docset="nw312" tidref="i6489"Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4768"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4769"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM32326"Figure 4-9.LBL="4-9"ID="FM32326"Example 7 AUTOEXEC.NCFFILE="n312r056.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. idxid="w4770"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=50010 zone={"TechOps"}You can use any valid AppleTalk network number, as long as it is unique on the internet. For more information, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.ID="FM30332"Load LAN drivers idxid="w4771"book="_idx" docset="nw312" tidref="i3085"(and AppleTalk idxid="w4772"book="_idx" docset="nw312" tidref="i3085"frame types, if applicable): load ne2000 int=2 port=300 frame=ethernet_ii name=etalk1 load ne2000 int=2 port=300 frame=ethernet_snap name=etalk2 load dl2000 int=3 port=320 name=ltalkThe NAME option is a NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the NetWare v3.12System Administration manual. For more information about the FRAME option and AppleTalk frame types, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4773"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the LAN drivers and configure AppleTalk networks: bind appletlk etalk1 net=100 zone={"TechOps"} bind appletlk etalk2 net=1000-1002 zone={"TechOps","Marketing"} bind appletlk ltalk net=500 zone={"Sales"}The names etalk1, etalk2, and ltalk refer to the driver configuration names assigned in IDREF="FM30332"Step 5.The NET option configures the AppleTalk networks shown in IDREF="FM15618"Table 4-2 on page 85. See IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241 if you need more information about BIND command lines.Load file and print services:  idxid="w4774"book="_idx" docset="nw312" tidref="i229"load idxid="w4775"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4776"book="_idx" docset="nw312" tidref="i2263"  idxid="w4777"book="_idx" docset="nw312" tidref="i324"load idxid="w4778"book="_idx" docset="nw312" tidref="i3245"atps idxid="w4779"book="_idx" docset="nw312" tidref="i5425"For details on the AFP configuration options you can specify on the LOAD command line, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4780"book="_idx" docset="nw312" tidref="i595"If you are ready to enter a print queue idxid="w4781"book="_idx" docset="nw312" tidref="i5282"configuration, highlight idxid="w4782"book="_idx" docset="nw312" tidref="i516"ATPS.CFG in the menu and then press <Enter>; otherwise, go to IDREF="FM40206"Step 9.Add a queue configuration command line, such as the example queue shown in IDREF="FM28145"Figure 4-10.LBL="4-10"ID="FM28145"ID="FM23809"Print Queue Using the Default SyntaxFILE="n312r057.pbm"This example uses the default "printer-name:zone-name" syntax, where printer-name is the name of the AppleTalk printer, and zone-name is the zone in which the printer resides. This syntax creates a NetWare print queue and an AppleTalk print spooler that advertises the queue in the Chooser. The AppleTalk spooler will use the name "NW printer-name" (for example, "NW Sales NT"). The queue name will be derived from the spooler name; in this case, it will be "NW_SALES_NT."The AppleTalk spooler will be visible in the zone of the internal network. In this example, it will appear in "TechOps." The printer itself resides in the "Sales" zone.See IDREF="FM25504""Print Services Configuration" on page 147 for information about your options in configuring and idxid="w4783"book="_idx" docset="nw312" tidref="i5282"naming queues. idxid="w4784"book="_idx" docset="nw312" tidref="i516"idxid="w4785"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.Down the file idxid="w4786"book="_idx" docset="nw312" tidref="i2227"server and bring it idxid="w4787"book="_idx" docset="nw312" tidref="i2227"back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example:  DOWN<Enter> EXIT<Enter> SERVER<Enter>A series of messages appears, indicating that the system is loading the modules you specified.idxid="w4788"book="_idx" docset="nw312" tidref="i3649"Use the MODULES idxid="w4789"book="_idx" docset="nw312" tidref="i3930"command to verify that the NLMs loaded.See IDREF="FM36869"page 81 if you would like an example.idxid="w4790"book="_idx" docset="nw312" tidref="i362"Use ATCON idxid="w4791"book="_idx" docset="nw312" tidref="i482"to verify the configuration.idxid="w4792"book="_idx" docset="nw312" tidref="i4547"Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type LOAD ATCON <Enter>Then, choose View Router Interfaces in the main ATCON menu. A window opens, showing the networks and zones you configured. Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for more information.Verifying Services idxid="w4793"book="_idx" docset="nw312" tidref="i3610"from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client.In this example, both the file server and its print queue appear in the idxid="w4794"book="_idx" docset="nw312" tidref="i6757"TechOps zone (the zone of the internal network).FILE="n312r058.pbm"To see the print queue "NW Sales NT," click the LaserWriter icon and choose the TechOps zone.FILE="n312r059.pbm"In this example, the AppleTalk print spooler appears in the default zone of the internal network, because only one zone was configured on the internal network. See IDREF="FM31333""Example 4: EtherTalk 2.0 with Other AppleTalk Routers" on page 58 for an example showing how to configure idxid="w4795"book="_idx" docset="nw312" tidref="i3610"multiple idxid="w4796"book="_idx" docset="nw312" tidref="i1175"zones idxid="w4797"book="_idx" docset="nw312" tidref="i1896"on the idxid="w4798"book="_idx" docset="nw312" tidref="i1896"internal idxid="w4799"book="_idx" docset="nw312" tidref="i1881"network. idxid="w4800"book="_idx" docset="nw312" tidref="i1881"ID="FM28863"Example 8: idxid="w4801"book="_idx" docset="nw312" tidref="i1881"TokenTalk, idxid="w4802"book="_idx" docset="nw312" tidref="i1175"EtherTalk 1.0, idxid="w4803"book="_idx" docset="nw312" tidref="i1175"and idxid="w4804"book="_idx" docset="nw312" tidref="i3355"LocalTalk idxid="w4805"book="_idx" docset="nw312" tidref="i6839"This example shows how to configure NetWare for Macintosh for TokenTalk, EtherTalk 1.0, and LocalTalk in a file server with idxid="w4806"book="_idx" docset="nw312" tidref="i251"Micro-Channel idxid="w4807"book="_idx" docset="nw312" tidref="i3890"architecture, running NetWare v3.12. The basic network is shown in IDREF="FM14327"Figure 4-11.LBL="4-11"ID="FM14327"AppleTalk Networks Using Micro-Channel AdaptersFILE="n312r060.pbm"ID="FM37829"Using Token Ring with Macintosh ClientsWhen Macintosh clients are connected to Token Ring, you must load the ATTOKLLC NLM as described in this example configuration. If you have not already manually copied the NLM to the server's SYS:SYSTEM directory, see IDREF="FM10294""If the Server Has Macintosh Clients on Token Ring" on page 26.Example 8 Configuration DataIn this example, the router uses the information in IDREF="FM30796"Table 4-3.LBL="4-3" INLINE="F"ID="FM30796"Example 8 ConfigurationWIDTH="108"Configurable ComponentWIDTH="324"Example DataWIDTH="108"Internal AppleTalk  network idxid="w4808"book="_idx" docset="nw312" tidref="i2912"WIDTH="132"net=50001zone={"Engineering"}WIDTH="180"Use a unique network number.Use a valid zone name.EtherTalk 1.0 idxid="w4809"book="_idx" docset="nw312" tidref="i1881"net=10zone={"North"}Use a valid network number.Use a valid zone name.LocalTalknet=11zone={"South"}Use a valid network number.Use a valid zone name.idxid="w4810"book="_idx" docset="nw312" tidref="i6839"TokenTalkidxid="w4811"book="_idx" docset="nw312" tidref="i6839"net=20-25zone={"North","South"}Use a valid network range.Use a list of at least one zone name.WIDTH="108"3c523 LAN driverWIDTH="324"frame=ETHERNET_IIWIDTH="108"DL/2 LAN driverWIDTH="324"No frame requiredWIDTH="108"Token Ring LAN  driverWIDTH="324"frame=TOKEN-RING_SNAPWIDTH="108"AFP file services idxid="w4812"book="_idx" docset="nw312" tidref="i2263"WIDTH="324"Installed (no options used)WIDTH="108"ATPS print services idxid="w4813"book="_idx" docset="nw312" tidref="i5425"WIDTH="324"Installed, two print queues for ImageWriter (named "Reports IW") on  LocalTalkSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.IDREF="FM34131"Figure 4-12 on page 94 shows the AppleTalk network configuration when the installation is complete. No clients are shown, to enable you to see the actual networks more clearly.LBL="4-12"ID="FM34131"EtherTalk 1.0, LocalTalk, and TokenTalk ConfigurationsFILE="n312r061.pbm"ID="FM20948"Example 8 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section. Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4814"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r062.pbm"idxid="w4815"book="_idx" docset="nw312" tidref="i6489"Highlight STARTUP.NCF and press <Enter>.Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4816"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4817"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM13055"Figure 4-13 on page 96.LBL="4-13"ID="FM13055"Example 8 AUTOEXEC.NCF (Micro Channel)FILE="n312r063.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below. idxid="w4818"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=50001 zone={"Engineering"}If you would like more information about this command line, see IDREF="FM22523""Loading the AppleTalk Module" on page 237. ID="FM23885"Load the idxid="w4819"book="_idx" docset="nw312" tidref="i3085"LAN drivers and idxid="w4820"book="_idx" docset="nw312" tidref="i247"AppleTalk idxid="w4821"book="_idx" docset="nw312" tidref="i2520"frame types: load 3c523 slot=6 frame=ethernet_ii name=etalk1 load dl2 slot=4 name=ltalk load token int=2 saps=4 ls=32frame=token-ring_snap name=ttalkThe NAME option is a NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4822"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4823"book="_idx" docset="nw312" tidref="i1934"Bind idxid="w4824"book="_idx" docset="nw312" tidref="i6810"AppleTalk to the idxid="w4825"book="_idx" docset="nw312" tidref="i271"LAN idxid="w4826"book="_idx" docset="nw312" tidref="i3085"drivers and configure the AppleTalk networks: bind appletlk etalk1 net=10 zone={"North"} bind appletlk ltalk net=11 zone={"South"} bind appletlk ttalk net=20-25 zone={"North","South"}The names etalk1, ltalk, and ttalk each refer to the driver names assigned in IDREF="FM23885"Step 5.Please see IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241 if you need more information about BIND command lines.Because this example has already configured IPX and APPLETLK on the same Token-Ring LAN driver, you do not need to load the frame type TOKEN-RING for the Token-Ring LAN driver being used for AppleTalk. In this example, the TOKEN-RING frame type is already loaded. It is the default frame used by IPX on Token Ring boards.Load the Token-Ring Source Routing NLM (ROUTE.NLM) for the Token-Ring board with the TOKEN-RING frame type: load route board=1 load route board=2Load ATTOKLLC.NLM: load attokllcThere are no options for this NLM. (Remember that you manually copy this NLM from the NW-MAC diskette to the server's SYS:SYSTEM.)Bind ATTOKLLC to the Token-Ring board handling TOKEN-RING frames: bind attokllc to tring-ipxNote that this is not the same logical board to which APPLETLK is bound.Load the file and print service modules:  idxid="w4827"book="_idx" docset="nw312" tidref="i3245"load idxid="w4828"book="_idx" docset="nw312" tidref="i2263"afp idxid="w4829"book="_idx" docset="nw312" tidref="i229"  idxid="w4830"book="_idx" docset="nw312" tidref="i5425"load idxid="w4831"book="_idx" docset="nw312" tidref="i3245"atps idxid="w4832"book="_idx" docset="nw312" tidref="i324"For details on the AFP configuration options you can specify on the LOAD command line, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4833"book="_idx" docset="nw312" tidref="i595"If idxid="w4834"book="_idx" docset="nw312" tidref="i516"you are ready to enter a print queue configuration, highlight idxid="w4835"book="_idx" docset="nw312" tidref="i5282"ATPS.CFG in the menu and then press <Enter>; otherwise, go to IDREF="FM41998"Step 12.Add a queue configuration command line, such as the example queue shown in IDREF="FM25613"Figure 4-14.LBL="4-14"ID="FM25613"ImageWriter and Color ImageWriter Print QueuesFILE="n312r064.pbm"idxid="w4836"book="_idx" docset="nw312" tidref="i32"Theidxid="w4837"book="_idx" docset="nw312" tidref="i5282"--o option is used to create a name for the AppleTalk print spooler that advertises the print queue in the Chooser. In IDREF="FM25613"Figure 4-14, two AppleTalk print spoolers are created; one is named "IW_queue" and the other is named "Color_queue." See IDREF="FM29796""Assigning a Descriptive Name: -o" on page 159 for details.The -t option enables you to specify a printer type. In IDREF="FM25613"Figure 4-14, "IW_queue" will send print jobs to an ImageWriter named "Reports IW." "Color_queue" will send print jobs to the same ImageWriter with a color ribbon loaded. This allows users with color Macintosh applications to generate the proper codes for an ImageWriter with a color ribbon. See IDREF="FM32652""Specifying a Color ImageWriter: -t and -c" on page 155.See IDREF="FM25504""Print Services Configuration" on page 147 for a complete discussion of your options in configuring idxid="w4838"book="_idx" docset="nw312" tidref="i5282"queues. idxid="w4839"book="_idx" docset="nw312" tidref="i516"ID="FM41998"idxid="w4840"book="_idx" docset="nw312" tidref="i2831"Exit INSTALL, saving your changes.Down idxid="w4841"book="_idx" docset="nw312" tidref="i2227"the file server and idxid="w4842"book="_idx" docset="nw312" tidref="i2227"bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example: DOWN<Enter> EXIT<Enter> SERVER<Enter>A series of messages appears, indicating that the system is loading idxid="w4843"book="_idx" docset="nw312" tidref="i2227"the modules you specified. idxid="w4844"book="_idx" docset="nw312" tidref="i2227"idxid="w4845"book="_idx" docset="nw312" tidref="i3649"Verify that the modules have loaded.When you see the console colon (:) prompt, type  idxid="w4846"book="_idx" docset="nw312" tidref="i3930"MODULES <Enter>A list of loaded NLMs appears on the screen.idxid="w4847"book="_idx" docset="nw312" tidref="i362"Use ATCON to verify the configuration.idxid="w4848"book="_idx" docset="nw312" tidref="i4547"Now that the router is up and running, you should make sure that it is using the correct AppleTalk configuration. At the file server console, type  idxid="w4849"book="_idx" docset="nw312" tidref="i482"LOAD ATCON <Enter>Then, choose View Router Interfaces in the main ATCON menu. A window opens, showing the networks and zones you configured. Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for more information.idxid="w4850"book="_idx" docset="nw312" tidref="i3610"Verifying Services from a Macintosh ClientAfter you have configured NetWare for Macintosh and have installed the required Macintosh client software, you can follow the instructions in the Using the NetWare for Macintosh Client guide to check the configuration from a Macintosh client.In this example, the file server appears in the idxid="w4851"book="_idx" docset="nw312" tidref="i1827"Engineering idxid="w4852"book="_idx" docset="nw312" tidref="i2912"zone, because this idxid="w4853"book="_idx" docset="nw312" tidref="i6839"is the idxid="w4854"book="_idx" docset="nw312" tidref="i3355"zone idxid="w4855"book="_idx" docset="nw312" tidref="i1175"of the idxid="w4856"book="_idx" docset="nw312" tidref="i1175"internal idxid="w4857"book="_idx" docset="nw312" tidref="i1881"network. idxid="w4858"book="_idx" docset="nw312" tidref="i3610"FILE="n312r065.pbm"ID="FM36439"Example 9: idxid="w4859"book="_idx" docset="nw312" tidref="i1175"Learning from idxid="w4860"book="_idx" docset="nw312" tidref="i6212"Routers on an idxid="w4861"book="_idx" docset="nw312" tidref="i1175"InternetThis example configures NetWare for Macintosh on three NetWare v3.12 file servers, shown in IDREF="FM18163"Figure 4-15 on page 101.One AppleTalk router will be manually configured on each network, and the other AppleTalk router(s) connected to that network will "learn" the correct network number(s) and zone(s) from the configured router.A router that is explicitly configured on a network is called a "seed router." The configuration you specify to instruct another router on that network to "learn" from the seed router is called a "non-seed interface."This example focuses on the "seeding" feature of the AppleTalk router in NetWare for Macintosh, and does not include example print queue configurations. Please see IDREF="FM11507"Chapter 7, "Managing AppleTalk Print Services," on page 143 for details about AppleTalk print services.LBL="4-15"ID="FM18163"AppleTalk Phase 2 Internet Using Non-Seed InterfacesFILE="n312r066.pbm"Of course, the networks that are not shared with SERVER-1 must be explicitly configured in both SERVER-2 and SERVER-3. IDREF="FM24295"Table 4-4 shows the data used in the three servers.LBL="4-4" INLINE="F"ID="FM24295"Example 9 ConfigurationsWIDTH="96"Configurable ComponentWIDTH="96"SERVER-1 Example DataWIDTH="96"SERVER-2 Example DataWIDTH="96"SERVER-3 Example DataWIDTH="96"Internal AppleTalk  network idxid="w4862"book="_idx" docset="nw312" tidref="i2912"WIDTH="96"idxid="w4863"book="_idx" docset="nw312" tidref="i2912"net=50005zone={"Admin"} idxid="w4864"book="_idx" docset="nw312" tidref="i2912"WIDTH="96"net=50006zone={"Admin"}WIDTH="96"net=50007zone={"Engineering}LocalTalk idxid="w4865"book="_idx" docset="nw312" tidref="i3355"idxid="w4866"book="_idx" docset="nw312" tidref="i3355"net=100zone={"Admin"}net=200zone={"Admin"}N/AWIDTH="96"Configurable ComponentWIDTH="96"SERVER-1 Example DataWIDTH="96"SERVER-2 Example DataWIDTH="96"SERVER-3 Example DataEtherTalk 2.0 idxid="w4867"book="_idx" docset="nw312" tidref="i1896"net=1-10zone={"Admin",  "Sales"}net=0-0N/ATokenTalk idxid="w4868"book="_idx" docset="nw312" tidref="i6839"net=11-20zone={"Engineering" ,"TechOps"}N/Anet=0-0EtherTalk 2.0N/AN/Anet=21-25zone={"Engineering,"Maintenance"}DL2000 LAN DriverNo frame required.No frame required.N/ANE2000 LAN Driverframe=ETHERNET_SNAPframe=ETHERNET_SNAPN/AToken Ring LAN  Driverframe=TOKEN-RING_SNAPN/Aframe=TOKEN-RING_SNAPSee IDREF="FM20865""AppleTalk Configuration in NetWare for Macintosh" on page 16 for information about the configuration data and syntax.After SERVER-1 has been configured, the following events can occur:SERVER-2 can learn its network and zone configuration from SERVER-1 on the EtherTalk network. Because there is no "seed router" on SERVER-2's LocalTalk interface, the network and zone configuration for that interface must be explicitly supplied.SERVER-3 can learn its network and zone configuration from SERVER-1 on the TokenTalk network. Because there is no "seed router" on SERVER-3's EtherTalk interface, the network and zone configuration for that interface must be explicitly supplied.The internal network configuration can never be "learned" from another router. You must always supply an explicit configuration for the internal network in each file server.IDREF="FM11980"Figure 4-16 shows the AppleTalk internet configuration on all three file servers. No clients are shown, to enable you to see the actual networks more clearly.LBL="4-16"ID="FM11980"EtherTalk 2.0, TokenTalk, and LocalTalk ConfigurationsFILE="n312r067.pbm"ID="FM37708"ID="FM20050"SERVER-1 idxid="w4869"book="_idx" docset="nw312" tidref="i1896"Configuration Procedure idxid="w4870"book="_idx" docset="nw312" tidref="i3355"idxid="w4871"book="_idx" docset="nw312" tidref="i6839"To enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the idxid="w4872"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens.FILE="n312r068.pbm"idxid="w4873"book="_idx" docset="nw312" tidref="i6489"Highlight STARTUP.NCF and press <Enter>.Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4874"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4875"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM21984"Figure 4-17 on page 105.LBL="4-17"ID="FM21984""Seed" Configuration for SERVER-1FILE="n312r001.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.Load the AppleTalk module and configure the internal network:  idxid="w4876"book="_idx" docset="nw312" tidref="i260"load appletlk net=50005 zone={"Admin"}For more information about this command line, see IDREF="FM22523""Loading the AppleTalk Module" on page 237.ID="FM40027"Load LAN idxid="w4877"book="_idx" docset="nw312" tidref="i3085"drivers (and AppleTalk idxid="w4878"book="_idx" docset="nw312" tidref="i247"frame types, idxid="w4879"book="_idx" docset="nw312" tidref="i2520"if applicable): load dl2000 int=5 port=200 name=ltalk load ne2000 int=3 port=300 frame=ethernet_snap name=etalk2 load token int=2 frame=token-ring_snap name=ttalkThe NAME option is a NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in the idxid="w4880"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration manual. For more information about the FRAME option and AppleTalk frame idxid="w4881"book="_idx" docset="nw312" tidref="i3085"types, idxid="w4882"book="_idx" docset="nw312" tidref="i2520"see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238. idxid="w4883"book="_idx" docset="nw312" tidref="i247"idxid="w4884"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4885"book="_idx" docset="nw312" tidref="i3085"LAN drivers and configure AppleTalk networks: bind appletlk ltalk net=100 zone={"Admin"} bind appletlk etalk2 net=1-10 zone={"Admin","Sales"} bind appletlk ttalk net=11-20 zone={"Engineering","TechOps"}The names ltalk, etalk2, and ttalk each refer to the names assigned in IDREF="FM40027"Step 5. See IDREF="FM28641""Binding AppleTalk to a LAN Driver" on page 241 if you need more information abut BIND command lines.Because this example has already configured IPX and APPLETLK on the same Token-Ring LAN driver, you do not need to load the frame type TOKEN-RING for the Token-Ring LAN driver being used for AppleTalk.In this example, the TOKEN-RING frame type is already loaded. It is the default frame used by IPX on Token Ring boardsLoad the Token-Ring Source Routing NLM (ROUTE.NLM) for the Token-Ring board with the TOKEN-RING frame type: load route board=1 load route board=2Load ATTOKLLC.NLM: load attokllcThere are no options for this NLM. (Remember that you manually copy this NLM from the NW-MAC diskette to the server's SYS:SYSTEM directory.)Bind ATTOKLLC to the Token-Ring board handling TOKEN-RING frames: bind attokllc to token-ipxNote that this is not the same logical board to which APPLETLK is bound.Load file services:  idxid="w4886"book="_idx" docset="nw312" tidref="i229"load idxid="w4887"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4888"book="_idx" docset="nw312" tidref="i2263"For details on the AFP configuration options you can specify on the LOAD command line, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Press <Esc> and then <Enter> to save your changes and to return to the "Editable Configuration Files" menu. idxid="w4889"book="_idx" docset="nw312" tidref="i595"Exit INSTALL, saving your changes.idxid="w4890"book="_idx" docset="nw312" tidref="i2227"Down the file server and bring it back up idxid="w4891"book="_idx" docset="nw312" tidref="i2227".If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example: DOWN<Enter> EXIT<Enter> SERVER<Enter>A series of messages appears, indicating that the system is loading the modules you specified.ID="FM26711"Use the idxid="w4892"book="_idx" docset="nw312" tidref="i3649"MODULES idxid="w4893"book="_idx" docset="nw312" tidref="i3930"command to verify that the NLMs loaded.When you see the console colon (:) prompt, type MODULES <Enter>idxid="w4894"book="_idx" docset="nw312" tidref="i3930"A list of loaded NLMs appears on the screen. idxid="w4895"book="_idx" docset="nw312" tidref="i3649"idxid="w4896"book="_idx" docset="nw312" tidref="i362"Check the router's interfaces in ATCON.idxid="w4897"book="_idx" docset="nw312" tidref="i482"Please idxid="w4898"book="_idx" docset="nw312" tidref="i4547"see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for details.idxid="w4899"book="_idx" docset="nw312" tidref="i3610"Log in to the server from a Macintosh client.The Using the NetWare for Macintosh Client guide describes how to check the configuration from a Macintosh client. In this example, the server will appear in the "Admin" idxid="w4900"book="_idx" docset="nw312" tidref="i6839"zone:FILE="n312r070.pbm"SERVER-2 Configuration ProcedureTo enter a configuration that will be in effect when you bring up the server, follow the steps in this section.Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.idxid="w4901"book="_idx" docset="nw312" tidref="i6489"Highlight STARTUP.NCF in the idxid="w4902"book="_idx" docset="nw312" tidref="i1784""Editable Configuration Files" menu and press <Enter>.Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.idxid="w4903"book="_idx" docset="nw312" tidref="i6489"Press <Esc> and then <Enter> to save changes to STARTUP.NCF.idxid="w4904"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w4905"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM15374"Figure 4-18. LBL="4-18"ID="FM15374"A Non-Seed Configuration on SERVER-2's EtherTalk 2.0 NetworkFILE="n312r071.pbm"The internal network is explicitly configured. The internal network configuration can never be "learned" from another router. Before loading the AFP or ATPS module, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.Load the AppleTalk idxid="w4906"book="_idx" docset="nw312" tidref="i260"module and configure the internal network: load appletlk net=50006 zone={"Admin"}See IDREF="FM22523""Loading the AppleTalk Module" on page 237 if you would like more information about this command.ID="FM30784"Load LAN drivers idxid="w4907"book="_idx" docset="nw312" tidref="i3085"(and AppleTalk idxid="w4908"book="_idx" docset="nw312" tidref="i247"frame idxid="w4909"book="_idx" docset="nw312" tidref="i2520"types, if applicable): load dl2000 int=5 port=200 name=ltalk load ne2000 int=3 port=300 frame=ethernet_snap name=etalk2The NAME option is a NetWare driver-naming feature that lets you specify a name for a specific configuration. This option is described in theNetWare v3.12System Administration manual. For more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4910"book="_idx" docset="nw312" tidref="i271"Bind AppleTalk to the idxid="w4911"book="_idx" docset="nw312" tidref="i3085"LAN drivers and configure AppleTalk networks: bind appletlk ltalk net=200 zone={"Admin"} bind appletlk etalk2 net=0-0The names ltalk and etalk2 each refer to the LAN drivers by the names assigned in IDREF="FM30784"Step 5. The parameter net=0-0 creates a non-seed interface. The router will listen for information from other routers on that network for its own configuration data.Load the idxid="w4912"book="_idx" docset="nw312" tidref="i3245"AFP module:  idxid="w4913"book="_idx" docset="nw312" tidref="i229"load afp idxid="w4914"book="_idx" docset="nw312" tidref="i2263"For details on AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. idxid="w4915"book="_idx" docset="nw312" tidref="i595"Exit INSTALL, saving your changes.idxid="w4916"book="_idx" docset="nw312" tidref="i2227"Down the file server and idxid="w4917"book="_idx" docset="nw312" tidref="i2227"bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example:  DOWN<Enter> EXIT<Enter> SERVER<Enter>A series of messages appears, indicating that the system is loading the modules you specified.idxid="w4918"book="_idx" docset="nw312" tidref="i3649"Use the idxid="w4919"book="_idx" docset="nw312" tidref="i3930"MODULES command to verify that the NLMs loaded.idxid="w4920"book="_idx" docset="nw312" tidref="i362"Check the router's interfaces in idxid="w4921"book="_idx" docset="nw312" tidref="i482"ATCON.idxid="w4922"book="_idx" docset="nw312" tidref="i4547"Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for details.idxid="w4923"book="_idx" docset="nw312" tidref="i3610"Log in to the server from a Macintosh client.The Using the NetWare for Macintosh Client guide describes how to check the configuration from a Macintosh client. In this example, the server will appear in the "Admin" idxid="w4924"book="_idx" docset="nw312" tidref="i3355"zone:FILE="n312r072.pbm"ID="FM36896"SERVER-3 Configuration Procedure idxid="w4925"book="_idx" docset="nw312" tidref="i6839"To enter a configuration that will be in effect when you bring up the server, follow the steps in this section. Load idxid="w4926"book="_idx" docset="nw312" tidref="i2831"INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.If you have just finished installing the NetWare for Macintosh software and are running INSTALL, skip this first step.When you press <Enter>, the Editable Configuration Files menu opens.FILE="n312r073.pbm"idxid="w4927"book="_idx" docset="nw312" tidref="i6489"Highlight STARTUP.NCF and press <Enter>.Add these to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100See IDREF="FM33358""The Macintosh Name Space" on page 128 and in IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like an explanation of these commands.Press <Esc> and then <Enter> to save changes to STARTUP.NCF. idxid="w4928"book="_idx" docset="nw312" tidref="i6489"idxid="w4929"book="_idx" docset="nw312" tidref="i595"Use the arrow keys to highlight AUTOEXEC.NCF and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear idxid="w4930"book="_idx" docset="nw312" tidref="i719"in bold monospace type in IDREF="FM14198"Figure 4-19 on page 113.LBL="4-19"ID="FM14198"A Non-Seed Configuration on SERVER-3's TokenTalk 2.0 NetworkFILE="n312r074.pbm"The internal network is explicitly configured. idxid="w4931"book="_idx" docset="nw312" tidref="i2912"The internal network configuration can never be "learned" from another router. Before loading the AFP or ATPS module, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.idxid="w4932"book="_idx" docset="nw312" tidref="i260"Load the AppleTalk module and configure the internal network: load appletlk net=50007 zone={"Engineering"}For more information about this command line, see IDREF="FM22523""Loading the AppleTalk Module" on page 237. idxid="w4933"book="_idx" docset="nw312" tidref="i247"Load LAN drivers and idxid="w4934"book="_idx" docset="nw312" tidref="i3085"extended idxid="w4935"book="_idx" docset="nw312" tidref="i2520"frame types: load ne2000 int=3 port=300 frame=ethernet_snap name=etalk2 load token int=2 frame=token-ring_snap name=ttalkFor more information, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w4936"book="_idx" docset="nw312" tidref="i271"Bind idxid="w4937"book="_idx" docset="nw312" tidref="i3085"AppleTalk to the LAN drivers and configure AppleTalk networks: bind appletlk etalk2 net=21-25 zone={"Engineering","TechOps"} bind appletlk ttalk net=0-0The names etalk2 and ttalk each refer to the LAN drivers by the names assigned in IDREF="FM30784"Step 5. The parameter net=0-0 creates a non-seed interface. The router will listen for information from other routers on that network for its own configuration data.Because this example has already configured IPX and APPLETLK on the same Token-Ring LAN driver, you do not need to load the frame type TOKEN-RING for the Token-Ring LAN driver being used for AppleTalk. In this example, the TOKEN-RING frame type is already loaded. It is the default frame used by IPX on Token Ring boardsLoad the Token-Ring Source Routing NLM (ROUTE.NLM) for the Token-Ring board with the TOKEN-RING frame type: load route board=1 load route board=2Load ATTOKLLC.NLM: load attokllcThere are no options for this NLM. (Remember that you manually copy this NLM from the NW-MAC diskette to the server's SYS:SYSTEM directory.)Bind ATTOKLLC to the Token-Ring board handling TOKEN-RING frames: bind attokllc to TR-ipxNote that this is not the same logical board to which APPLETLK is bound.Load AFP file services:  idxid="w4938"book="_idx" docset="nw312" tidref="i229"load idxid="w4939"book="_idx" docset="nw312" tidref="i3245"afp idxid="w4940"book="_idx" docset="nw312" tidref="i2263"For details on the AFP configuration options, see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. idxid="w4941"book="_idx" docset="nw312" tidref="i595"Exit INSTALL, saving your changes.idxid="w4942"book="_idx" docset="nw312" tidref="i2227"Down the file server and bring it back up. idxid="w4943"book="_idx" docset="nw312" tidref="i2227"If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure, for example: DOWN<Enter> EXIT<Enter> SERVER<Enter>A series of messages appears, indicating that the system is loading the modules you idxid="w4944"book="_idx" docset="nw312" tidref="i2227"specified. idxid="w4945"book="_idx" docset="nw312" tidref="i2227"idxid="w4946"book="_idx" docset="nw312" tidref="i3649"Use the MODULES idxid="w4947"book="_idx" docset="nw312" tidref="i3930"command to verify that the NLMs loaded.See IDREF="FM26711"page 107 if you would like an example.idxid="w4948"book="_idx" docset="nw312" tidref="i482"Check the router's idxid="w4949"book="_idx" docset="nw312" tidref="i4547"interfaces in ATCON.Please see IDREF="FM29117""Checking the Router's Configuration and Function" on page 285 for details.idxid="w4950"book="_idx" docset="nw312" tidref="i3610"Log in to the server from a Macintosh client.The Using the NetWare for Macintosh Client guide describes how to check the configuration from a Macintosh client. idxid="w4951"book="_idx" docset="nw312" tidref="i6212"In this example, the server will idxid="w4952"book="_idx" docset="nw312" tidref="i1175"appear in idxid="w4953"book="_idx" docset="nw312" tidref="i6839"the idxid="w4954"book="_idx" docset="nw312" tidref="i1896""Engineering" zone: idxid="w4955"book="_idx" docset="nw312" tidref="i1175"FILE="n312r075.pbm"LBL="5"Changing the ConfigurationIn NetWare for Macintosh, you must modify configuration files to make "permanent" changes to the network or service configuration. Changes made to configuration files are in effect whenever you bring up the file server and load the NLMs.The sections in this chapter describe how to modify the NetWare for Macintosh configuration files and how to make "temporary" changes by entering configuration data at the idxid="w4956"book="_idx" docset="nw312" tidref="i1227"server console.ID="FM27319"Modifying idxid="w4957"book="_idx" docset="nw312" tidref="i271"Configuration idxid="w4958"book="_idx" docset="nw312" tidref="i4280"FilesTo modify NetWare for Macintosh configuration files, follow these steps:Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC v3.12.NetWare asks you to choose between the current STARTUP.NCF file and a previous STARTUP.NCF file, if you have relocated the file since you installed the product. When you select the proper STARTUP.NCF file, the "Editable Configuration Files" menu appears:FILE="n312r076.pbm"Use the arrow keys to select the file you wish to modify, and press <Enter>.You can now follow the same procedure documented in the example configurations in this chapter to change the configuration data.Exit the INSTALL utility, saving your changes.You might need to down the file server and bring it up again, or unload and load the NLMs, for the changes you made to take effect. These tasks are discussed in the sections that follow.If you wish, you can use the "Edit STARTUP.NCF" or "Edit AUTOEXEC.NCF" functions in the "System Options" menu of INSTALL instead of the "Product Options" function. However, if you open the "System Options" menu to edit these files, be careful not to select "Create STARTUP.NCF" or "Create AUTOEXEC.NCF." Choosing either of the "Create" functions could cause you to inadvertently overwrite your NetWare for Macintosh v3.12 configuration.Changing the idxid="w4959"book="_idx" docset="nw312" tidref="i4899"Packet-Receive Buffer AllocationSee IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for a discussion of the memory issues that would warrant changing the minimum (or maximum) number of packet-receive buffers in STARTUP.NCF. To change the number of packet-receive buffers in STARTUP.NCF, follow these steps:Use the INSTALL utility to edit STARTUP.NCF to include the modified command.For example, you might change this command line: set minimum packet receive buffers=100to set minimum packet receive buffers=300Unless you have removed the Macintosh name space from a server's volumes by using VREPAIR, you should never remove the LOAD MAC command from STARTUP.NCF. Otherwise, you cannot mount the volumes supporting the Macintosh name space.Down the file server and bring it back up.Follow the procedure you usually follow for booting the file server, such as this one:  DOWN <Enter> EXIT <Enter> SERVER <Enter>When you bring up the server, the system allocates the specified number of packet-receive buffers. idxid="w4960"book="_idx" docset="nw312" tidref="i4899"Changing the AFP Configuration idxid="w4961"book="_idx" docset="nw312" tidref="i229"You can unload and load the AFP module at the console prompt, specifying different LOAD options as desired. See IDREF="FM17320""Maintenance Issues: Clearing and Rebuilding the Desktop" on page 134 and IDREF="FM12331""Setting Up a Specialized Environment" on page 137 for information about the options you can specify on the LOAD command line.Changes specified at the console prompt are temporary, and are in effect only until the next time you down the file server.To make a temporary change to the AFP environment, follow these steps:Make sure all Macintosh clients are logged out, or warn them that you are about to interrupt file service.Unload AFP at the server console and reload it with a LOAD option. For example, you might type these commands at the console (:) prompt: UNLOAD AFP <Enter> LOAD AFP DELAY30 <Enter>File service will be restored almost immediately.To make a permanent change that will be in effect each time you bring up the file server, follow these steps:Make sure all Macintosh clients are logged out, or warn them that you are about to interrupt file service.Unless you plan to down the file server immediately, enter the modified command at the console prompt. For example, type UNLOAD AFP <Enter> LOAD AFP DELAY30 <Enter>idxid="w4962"book="_idx" docset="nw312" tidref="i595"Use the INSTALL utility to edit AUTOEXEC.NCF to include the modified command.Because you already entered the command at the console prompt, you do not need to down the file server. The next time you down the file server and bring it up again, the permanent change made in AUTOEXEC.NCF takes effect. idxid="w4963"book="_idx" docset="nw312" tidref="i229"Changing the AppleTalk Print Services Configuration idxid="w4964"book="_idx" docset="nw312" tidref="i324"See IDREF="FM25504""Print Services Configuration" on page 147 and IDREF="FM17711""Loading the ATPS Module" on page 146 for more details on configuring AppleTalk print services.The ATPS module recognizes changes to the idxid="w4965"book="_idx" docset="nw312" tidref="i516"ATPS.CFG file only when the module is loading, so changes to the configuration file require that you unload ATPS and reload it.idxid="w4966"book="_idx" docset="nw312" tidref="i5282"To change idxid="w4967"book="_idx" docset="nw312" tidref="i5282"print queue information, idxid="w4968"book="_idx" docset="nw312" tidref="i5425"follow these steps:Use the INSTALL utility to edit ATPS.CFG to include the new queue configuration command line.Load and unload the ATPS module at the console prompt: UNLOAD ATPS <Enter> LOAD ATPS <Enter>ID="FM13387"Changing the AppleTalk idxid="w4969"book="_idx" docset="nw312" tidref="i271"Network Number or idxid="w4970"book="_idx" docset="nw312" tidref="i271"RangeIf you have more than one AppleTalk router connected to a network that you must reconfigure, remember that all AppleTalk routers connected to a network must have a consistent network and zone configuration for that cable.When a Seed Router is in UseIf you configured one seed router and used non-seed interfaces in the other AppleTalk routers connected to the cable, the reconfiguration process is as follows:Down all AppleTalk routers directly connected to the network.To down an AppleTalk router, unload the AppleTalk module by typing this command at the console prompt: UNLOAD APPLETLK <Enter>AppleTalk is automatically unbound from all interfaces.idxid="w4971"book="_idx" docset="nw312" tidref="i595"On the seed router, use INSTALL to edit AUTOEXEC.NCF.In AUTOEXEC.NCF, modify the BIND command line on which the network number or range is defined. Make sure that the new network number or range is not already in use on another cable.If you used the ATZONES.CFG file for a BIND command line exceeding 82 characters, remember to edit ATZONES.CFG to modify the network/zone specification.Bring up the seed router with the new configuration.If you cannot down the file server at this time, re-enter the LOAD APPLETLK and BIND APPLETLK command lines at the console prompt, exactly as they appear in AUTOEXEC.NCF.Bring up the AppleTalk routers with non-seed interfaces on the network.When Each Router is Configured ManuallyIf you configured each router manually (rather than using the seeding feature of AppleTalk routers), you need to manually change the configuration in each router connected to the network:Down all AppleTalk routers directly connected to the network.To down an AppleTalk router, unload the AppleTalk module by typing this command at the console prompt: UNLOAD APPLETLK <Enter>AppleTalk is automatically unbound from all interfaces.On each router connected to the network, use INSTALL to edit AUTOEXEC.NCF.In AUTOEXEC.NCF, modify the BIND command line on which the network number or range is defined. Make sure that the new network number or range is not already in use on another cable.If you used the ATZONES.CFG file for a BIND command line exceeding 82 characters, remember to edit ATZONES.CFG to modify the network/zone specification.idxid="w4972"book="_idx" docset="nw312" tidref="i595"When you have manually edited AUTOEXEC.NCF on each router, bring up the routers again, one by one.If you cannot down the file server at this time, re-enter the LOAD APPLETLK and BIND APPLETLK command lines at the console prompt, exactly as they appear in idxid="w4973"book="_idx" docset="nw312" tidref="i271"AUTOEXEC.NCF. idxid="w4974"book="_idx" docset="nw312" tidref="i271"ID="FM18960"Changing the idxid="w4975"book="_idx" docset="nw312" tidref="i7592"AppleTalk idxid="w4976"book="_idx" docset="nw312" tidref="i396"Zone Name or idxid="w4977"book="_idx" docset="nw312" tidref="i396"Zones List idxid="w4978"book="_idx" docset="nw312" tidref="i396"If you must change the name of one or more zones, first read IDREF="FM27796""How Zone Information Is Maintained on an Internet" on page 255 to understand how routers keep track of zone names and why you might see unexpected results if you do not allow enough time to elapse before bringing routers back up.When a Seed Router is in UseIf you configured one seed router and used non-seed interfaces in the other AppleTalk routers connected to the cable, the zone reconfiguration process is as follows:Down all AppleTalk routers directly connected to the network.To down an AppleTalk router, unload the AppleTalk module by typing this command at the console prompt: UNLOAD APPLETLK <Enter>AppleTalk is automatically unbound from all interfaces.idxid="w4979"book="_idx" docset="nw312" tidref="i595"On the seed router, use INSTALL to edit AUTOEXEC.NCF.In AUTOEXEC.NCF, modify the BIND command line on which the zone or zones list is defined.If you used the ATZONES.CFG file for a BIND command line exceeding 82 characters, remember to edit ATZONES.CFG to modify the network/zone specification.Wait ten to twenty minutes (or more, if the AppleTalk internet is large).Waiting ten or twenty minutes allows other AppleTalk routers on the internet to recognize that the "old" zones are no longer there. If you are not sure that you have allowed enough time, check the RTMP table in one or more routers by using the ATCON utility, as described in IDREF="FM32085""Viewing the RTMP Routing Table" on page 287.If you don't wish to wait ten or twenty minutes, and the AppleTalk internet is small, you can create the new zones list, and then down all AppleTalk routers on the internet. When you bring the routers back up, each router will create a new zones list that contains only the current zone names.idxid="w4980"book="_idx" docset="nw312" tidref="i595"Bring up the seed router with the new configuration.If you cannot down the file server at this time, re-enter the LOAD APPLETLK and BIND APPLETLK command lines at the console prompt, exactly as they appear in AUTOEXEC.NCF.Bring up the AppleTalk routers with non-seed interfaces on the network.When Each Router is Configured ManuallyIf you configured each router manually (rather than using the seeding feature of AppleTalk routers), you need to manually change the configuration in each router connected to the network:Down all AppleTalk routers directly connected to the network.To down an AppleTalk router, unload the AppleTalk module by typing this command at the console prompt: UNLOAD APPLETLK <Enter>AppleTalk is automatically unbound from all interfaces.idxid="w4981"book="_idx" docset="nw312" tidref="i595"On each router connected to the network, use INSTALL to edit AUTOEXEC.NCF.In AUTOEXEC.NCF, modify the BIND command line on which the zone or zones list is defined.If you used the ATZONES.CFG file for a BIND command line exceeding 82 characters, remember to edit ATZONES.CFG to modify the network/zone specification.Make sure that ten to twenty minutes have elapsed (or more, if the AppleTalk internet is large) since you downed the routers.Waiting ten or twenty minutes allows other AppleTalk routers on the internet to recognize that the "old" zones are no longer there. If you are not sure that you have allowed enough time, check the RTMP table in one or more routers by using the ATCON utility, as described in IDREF="FM32085""Viewing the RTMP Routing Table" on page 287.If you don't wish to wait ten or twenty minutes, and the AppleTalk internet is small, you can create the new zones list, and then down all AppleTalk routers on the internet. When you bring the routers back up, each router will create a new zones list that contains only the current zone names.When you have manually edited AUTOEXEC.NCF on each router, bring up the routers again, one by one.If you cannot down the file server at this time, re-enter the LOAD APPLETLK and BIND APPLETLK command lines at the idxid="w4982"book="_idx" docset="nw312" tidref="i396"console idxid="w4983"book="_idx" docset="nw312" tidref="i7592"prompt, idxid="w4984"book="_idx" docset="nw312" tidref="i396"exactly as idxid="w4985"book="_idx" docset="nw312" tidref="i396"they appear in idxid="w4986"book="_idx" docset="nw312" tidref="i4280"AUTOEXEC.NCF. idxid="w4987"book="_idx" docset="nw312" tidref="i271"ID="FM17210"Removing idxid="w4988"book="_idx" docset="nw312" tidref="i2227"NetWare idxid="w4989"book="_idx" docset="nw312" tidref="i4280"for idxid="w4990"book="_idx" docset="nw312" tidref="i2898"Macintosh idxid="w4991"book="_idx" docset="nw312" tidref="i271"To remove NetWare for Macintosh, you must delete the NLMs from SYS:SYSTEM and clear the NetWare for Macintosh data from SYS:SYSTEM\PRODUCTS.DAT (the products database maintained by the INSTALL module). PRODUCTS.DAT is cleared automatically when you follow the steps below. In addition, you must manually remove or comment out commands relevant to NetWare for Macintosh, as described below.Load INSTALL, idxid="w4992"book="_idx" docset="nw312" tidref="i2831"select Product Options in the main INSTALL menu, and then press <Del> on the line specifying NW-MAC v3.12.If you have installed multiple products, use the arrow keys to select NW-MAC before pressing <Del>.FILE="n312r077.pbm"NetWare asks you to confirm that you wish to remove the product. The system also asks you to choose between the current and previous STARTUP.NCF file, if you have relocated the file since you installed the product.When you select the STARTUP.NCF file you wish to use, the "Editable Configuration Files" menu appears:FILE="n312r078.pbm"Use the arrow keys to select idxid="w4993"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF, and press <Enter>.SYS:SYSTEM\AUTOEXEC.NCF is the only file that requires changes. You must remove or comment out the command lines that load the AppleTalk module, specify AppleTalk frame types for a LAN driver, bind AppleTalk to a LAN driver, and load the AFP and ATPS modules. (To comment out a command line, insert the pound-sign character (#) as the first character in that command line.)When you have removed or commented out command lines in AUTOEXEC.NCF, press <Esc> and then <Enter> to save your changes and to return to the idxid="w4994"book="_idx" docset="nw312" tidref="i1784""Editable Configuration Files" idxid="w4995"book="_idx" docset="nw312" tidref="i595"menu. Down the file server and bring it back up.Follow the procedure you usually use for booting the file server, such as this one:  DOWN <Enter> EXIT <Enter> SERVER <Enter>NetWare for Macintosh is no longer available on the file server.If you want to be complete, you can use the VREPAIR utility to remove the Macintosh name space from the server's volumes, and then remove or comment out the LOAD MAC command and the SET MINIMUM PACKET RECEIVE BUFFERS command from the idxid="w4996"book="_idx" docset="nw312" tidref="i6489"STARTUP.NCF file. You can also delete the files in DESKTOP.AFP and remove the directory.Finally, you can use a DOS client to delete the ATPS.CFG and ATZONES.CFG files from SYS:SYSTEM. However, note that these files contain valuable configuration information for restoring NetWare for Macintosh in the future. You might want to print their contents or save them to idxid="w4997"book="_idx" docset="nw312" tidref="i4280"other idxid="w4998"book="_idx" docset="nw312" tidref="i2898"files for future idxid="w4999"book="_idx" docset="nw312" tidref="i2227"reference. idxid="w5000"book="_idx" docset="nw312" tidref="i271"LBL="6"ID="FM23848"Managing AppleTalk File Services idxid="w5001"book="_idx" docset="nw312" tidref="i229"idxid="w5002"book="_idx" docset="nw312" tidref="i229"idxid="w5003"book="_idx" docset="nw312" tidref="i271"idxid="w5004"book="_idx" docset="nw312" tidref="i2263"This chapter explains how the AFP module establishes the NetWare for Macintosh file service and how to customize the environment for your site. It also covers file service security issues, performance and memory trade-offs, and maintenance issues.ID="FM34925"The AFP idxid="w5005"book="_idx" docset="nw312" tidref="i229"File Service Environment idxid="w5006"book="_idx" docset="nw312" tidref="i2263"The AppleTalk Filing Protocol (AFP) file service environment is established when you idxid="w5007"book="_idx" docset="nw312" tidref="i229"load the AFP module. Typically, the AFP module is loaded from the file server's idxid="w5008"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF file, as shown in the sample configurations in this guide (see IDREF="FM13719"Figure 3-4 on page 38 for an example).Macintosh requests are sent to the NetWare file server via AppleTalk, as shown in IDREF="FM30305"Figure 6-1 on page 128. The file server receives these requests and uses the AppleTalk Filing Protocol (AFP) to allow the Macintosh user to log in and access data on the server. LBL="6-1"ID="FM30305"Macintosh Initiating a Login Session with a NetWare ServerFILE="n312r079.pbm"Once a Macintosh user logs in to the NetWare file server, the Macintosh interface and applications appear very much as if the user were accessing a local Macintosh disk. Two basic NetWare for Macintosh features make this possible:Macintosh name spaceDesktop databaseID="FM33358"The Macintosh idxid="w5009"book="_idx" docset="nw312" tidref="i3645"Name idxid="w5010"book="_idx" docset="nw312" tidref="i2263"Space idxid="w5011"book="_idx" docset="nw312" tidref="i229"idxid="w5012"book="_idx" docset="nw312" tidref="i2021"The idxid="w5013"book="_idx" docset="nw312" tidref="i2300"NetWare operating system idxid="w5014"book="_idx" docset="nw312" tidref="i4330"(Version 3.0 or later) uses "name spaces" to extend the directory structure to accommodate different file naming conventions used by client operating systems. idxid="w5015"book="_idx" docset="nw312" tidref="i3630"A name space maintains and checks the validity of filenames based on a specific set of rules, such as the Macintosh rules that a filename can be up to 31 characters, can include spaces, and cannot include the colon character (:). Name spaces allow a user who logs in to a NetWare file server from a different client platform to see folders and files as he or she would expect to see them.ID="FM31949"Loading the Name Space idxid="w5016"book="_idx" docset="nw312" tidref="i4004"Support Module idxid="w5017"book="_idx" docset="nw312" tidref="i3645"The Macintosh name space depends on a support module, which must be loaded before adding the name space to a volume. Once the name space has been added to a volume, the support module must be loaded before that volume is mounted; otherwise, the volume fails to mount.To load the support module before adding the Macintosh name space, type this command at the server console prompt:  idxid="w5018"book="_idx" docset="nw312" tidref="i3272"LOAD MAC <Enter>You can then add the name space, as described in IDREF="FM13479""Adding the Macintosh Name Space to Volumes," below.idxid="w5019"book="_idx" docset="nw312" tidref="i6489"To make sure the support module is loaded before the server attempts to mount its volumes, you should add the LOAD MAC command to the STARTUP.NCF file, as shown in the configuration examples in this guide.ID="FM13479"Adding the Macintosh Name Space to Volumes idxid="w5020"book="_idx" docset="nw312" tidref="i7372"idxid="w5021"book="_idx" docset="nw312" tidref="i3645"The DOS name space is part of the NetWare operating system. However, you must explicitly add the Macintosh name space to each volume that supports Macintosh clients. Use this command:  ADD NAME SPACE MACINTOSH TO VOLUME name<Enter>name is the name of the volume. When you add the Macintosh name space to a volume, NetWare version 3.0 or later creates a separate name space for Macintosh folder and filenames and links those name space entries to directory table entries. Macintosh users and processes can then create folders and files on the volume.For example, IDREF="FM31136"Figure 6-2 on page 130 shows directory table entries for a Macintosh file on a volume that has both the Macintosh and idxid="w5022"book="_idx" docset="nw312" tidref="i4855"OS/2 name space:LBL="6-2"ID="FM31136"Directory Table Entries Linked to Three Name SpacesFILE="n312r080.pbm"idxid="w5023"book="_idx" docset="nw312" tidref="i4855"When a Macintosh user creates "Basic text file," NetWare calls the Macintosh name space and the filename is checked for validity according to Macintosh file-naming rules. When the Macintosh name space has validated the filename, NetWare calls the idxid="w5024"book="_idx" docset="nw312" tidref="i1691"DOS name space. The DOS name space finds the name invalid according idxid="w5025"book="_idx" docset="nw312" tidref="i1680"to idxid="w5026"book="_idx" docset="nw312" tidref="i2021"DOS file naming rules, so it creates a valid DOS filename by truncating the name to eight characters and dropping the spaces, resulting in the name "BASICTEX" for that file. In the OS/2 name space, idxid="w5027"book="_idx" docset="nw312" tidref="i7372"the idxid="w5028"book="_idx" docset="nw312" tidref="i3645"same idxid="w5029"book="_idx" docset="nw312" tidref="i3645"procedure is idxid="w5030"book="_idx" docset="nw312" tidref="i2263"repeated. idxid="w5031"book="_idx" docset="nw312" tidref="i229"ID="FM42369"The idxid="w5032"book="_idx" docset="nw312" tidref="i2263"Desktop idxid="w5033"book="_idx" docset="nw312" tidref="i1387"Database idxid="w5034"book="_idx" docset="nw312" tidref="i229"AFP requires that file servers maintain a desktop database that contains information associating documents and applications with icons, and providing bitmap representations of the idxid="w5035"book="_idx" docset="nw312" tidref="i2715"icons. The Macintosh Finder uses this database to build the familiar Macintosh graphical user interface on the server's volumes, just as it uses the Macintosh desktop file on the local Macintosh disk(s). In NetWare for Macintosh, the idxid="w5036"book="_idx" docset="nw312" tidref="i1389"idxid="w5037"book="_idx" docset="nw312" tidref="i2453"DESKTOP.AFP folder contains three files that implement the AFP desktop database. The AFP module creates DESKTOP.AFP and creates and initializes its files at the root of each volume that supports the Macintosh name space. idxid="w5038"book="_idx" docset="nw312" tidref="i3638"The Macintosh Finder initializes updates of these three files:WIDTH="108"FilenameWIDTH="312"ContentsWIDTH="108"ICONINDX.AFP idxid="w5039"book="_idx" docset="nw312" tidref="i2714"WIDTH="312"Information linking documents and applications with their iconsICONDATA.AFP idxid="w5040"book="_idx" docset="nw312" tidref="i2713"Bitmap representations of the iconsAPPLDATA.AFP idxid="w5041"book="_idx" docset="nw312" tidref="i208"Information about the location of an application so that it can be found  quickly when a user double-clicks a document idxid="w5042"book="_idx" docset="nw312" tidref="i1389"idxid="w5043"book="_idx" docset="nw312" tidref="i2453"How the Desktop Is Updatedidxid="w5044"book="_idx" docset="nw312" tidref="i1383"The Macintosh Finder updates the desktop. Typically, when the Finder on a client Macintosh copies an application to the file server or moves an application to a new folder, the Finder adds the icon and application data to the desktop.You can force a complete update by rebuilding the desktop from a Macintosh client. (See IDREF="FM35267""Rebuilding the Desktop" on page 133.) Doing so causes the Macintosh Finder to traverse the file systems on the rebuilt volume in order to update all Macintosh icon and application data.ID="FM12407"Special Considerations with idxid="w5045"book="_idx" docset="nw312" tidref="i7372"Target Volumes from idxid="w5046"book="_idx" docset="nw312" tidref="i4441"NetWare idxid="w5047"book="_idx" docset="nw312" tidref="i6699"Versions 2.15 and 2.2 idxid="w5048"book="_idx" docset="nw312" tidref="i2227"If you support NetWare for Macintosh on a volume that was previously configured as a target volume for the Macintosh VAPs, the newly initialized DESKTOP.AFP folder (created by the AFP module) will not contain any icons or application information related to the Macintosh applications that have already been installed on the file server.Macintosh users logging in via the AFP NLM will see the existing files and applications, idxid="w5049"book="_idx" docset="nw312" tidref="i2545"but the idxid="w5050"book="_idx" docset="nw312" tidref="i2715"icons will be "generic," and double-clicking the icons will not open the appropriate application. Generic icons for Microsoft Word® are shown in IDREF="FM28420"Figure 6-3 on page 132.LBL="6-3"ID="FM28420"Generic Icons Indicating That the idxid="w5051"book="_idx" docset="nw312" tidref="i2715"Desktop idxid="w5052"book="_idx" docset="nw312" tidref="i2545"Should Be RebuiltFILE="n312r081.pbm"idxid="w5053"book="_idx" docset="nw312" tidref="i3653"The Macintosh VAPs created a hidden folder named DESKTOP. While this folder follows the same principles as the desktop database created by the AFP NLM, it uses a different format and will maintain information only as it is updated by clients logging in to a NetWare v3.12 file server through the Macintosh VAPs. Clients logging in to the file server via the AFP NLM will be able to access only the information contained in DESKTOP.AFP. If you wish to maintain this type of configuration, you should occasionally rebuild the desktop from each type of Macintosh client. idxid="w5054"book="_idx" docset="nw312" tidref="i2227"If you are idxid="w5055"book="_idx" docset="nw312" tidref="i4033"installing NetWare for Macintosh on a file server that was previously a NetWare version 3.0 or later target for the NetWare for Macintosh VAPs and you intend to use the file server both in native-mode (using the NLMs) and as a target to the Macintosh VAPs, you should be aware that the two desktop folders, DESKTOP.AFP for the NLMs and DESKTOP for the VAPs, will become inconsistent over time. For this reason, using a file server both in native-mode and as a target to the Macintosh idxid="w5056"book="_idx" docset="nw312" tidref="i2227"VAPs is idxid="w5057"book="_idx" docset="nw312" tidref="i7372"not idxid="w5058"book="_idx" docset="nw312" tidref="i6699"recommended. idxid="w5059"book="_idx" docset="nw312" tidref="i4441"ID="FM35267"Rebuilding idxid="w5060"book="_idx" docset="nw312" tidref="i3610"the Desktop idxid="w5061"book="_idx" docset="nw312" tidref="i1383"idxid="w5062"book="_idx" docset="nw312" tidref="i1389"To force an update of the idxid="w5063"book="_idx" docset="nw312" tidref="i7372"application and icon data in the DESKTOP.AFP folder, follow these steps:Restart the Macintosh using the Finder (not MultiFinder, if the Macintosh is running System 6.x).Log in as a supervisor from a Macintosh client.Make sure you are logging in from a client using the AFP NLM, not across the IPX internet using the Macintosh VAPs.When you mount the server's volume(s), hold down the Command-Option keys on the Macintosh keyboard.This action causes the Finder to traverse the file system on the file server's volumes and update the contents of each DESKTOP.AFP folder with the current location and document icon for each Macintosh application. You will be prompted to confirm that you wish to rebuild the desktop on the server's volume(s).idxid="w5064"book="_idx" docset="nw312" tidref="i2715"After the Finder rebuilds the desktop, Macintosh users see the appropriate icons for Macintosh applications and, in most cases, can open an application by double-clicking it. Macintosh icons are shown in IDREF="FM39114"Figure 6-4.LBL="6-4"ID="FM39114"Macintosh Icons after Rebuilding the DesktopFILE="n312r082.pbm"If you have removed an application from the server's volume and the application does not exist on any mounted volumes or on the Macintosh local hard disk, the icons for documents created in that application still appear generic after you rebuild the desktop. You can remedy this situation by copying the application to the server and rebuilding the desktop again.idxid="w5065"book="_idx" docset="nw312" tidref="i4035"NBACKUP does not back up the desktop files. If you are restoring data and applications by using NBACKUP, idxid="w5066"book="_idx" docset="nw312" tidref="i7372"you idxid="w5067"book="_idx" docset="nw312" tidref="i3610"should idxid="w5068"book="_idx" docset="nw312" tidref="i2715"rebuild idxid="w5069"book="_idx" docset="nw312" tidref="i1389"the idxid="w5070"book="_idx" docset="nw312" tidref="i1387"desktop idxid="w5071"book="_idx" docset="nw312" tidref="i1383"following the idxid="w5072"book="_idx" docset="nw312" tidref="i2263"restoration. idxid="w5073"book="_idx" docset="nw312" tidref="i229"ID="FM17320"Maintenance idxid="w5074"book="_idx" docset="nw312" tidref="i1389"Issues: idxid="w5075"book="_idx" docset="nw312" tidref="i1383"Clearing and idxid="w5076"book="_idx" docset="nw312" tidref="i1387"Rebuilding the Desktopidxid="w5077"book="_idx" docset="nw312" tidref="i1389"The information maintained in the DESKTOP.AFP is never automatically cleared. If the environment allows Macintosh clients to add and move applications, the desktop folder can eventually contain enough obsolete information that Macintosh users begin to notice slowed performance in launching applications. In addition, the DESKTOP.AFP folder can become corrupted if the Finder modifies it during an error condition, or if you maintain it incorrectly (for example, if you inadvertently restore it from an old backup tape). If the desktop has become corrupted, icons can sometimes display incorrectly.NetWare for Macintosh provides an option for clearing the information in DESKTOP.AFP; you must then rebuild the desktop from a Macintosh client. While the AFP module is loaded on the file server, the files contained in DESKTOP.AFP are in use and cannot be deleted, so you must unload AFP first. To clear the DESKTOP.AFP folder on all volumes that support Macintosh clients and are currently mounted, first make sure that all Macintosh clients are logged out. Then, at the file server console, type UNLOAD AFP <Enter>  idxid="w5078"book="_idx" docset="nw312" tidref="i945"LOAD AFP CDT <Enter>idxid="w5079"book="_idx" docset="nw312" tidref="i1389"You should then rebuild the idxid="w5080"book="_idx" docset="nw312" tidref="i1387"desktop. idxid="w5081"book="_idx" docset="nw312" tidref="i1389"See IDREF="FM35267""Rebuilding the Desktop" on page 133. idxid="w5082"book="_idx" docset="nw312" tidref="i1383"ID="FM33670"Advertising a Volume idxid="w5083"book="_idx" docset="nw312" tidref="i7372"under a idxid="w5084"book="_idx" docset="nw312" tidref="i194"Different Name idxid="w5085"book="_idx" docset="nw312" tidref="i7360"When Macintosh users mount volumes other than the SYS volume on the Macintosh desktop, only the volume name (not the server name) displays under the icon. If you have not assigned descriptive names to server volumes, Macintosh users can be confused about which volumes belong to which servers when they have mounted multiple volumes on their desktop.If you wish, you can assign "alias" volume names that will be advertised on the AppleTalk network. The alias you assign will be advertised only on the AppleTalk network. It does not affect users who are logging in via other protocols, such as NCP.The AFP module creates a hidden ASCII file named idxid="w5086"book="_idx" docset="nw312" tidref="i7339"VOLNAMES.AFP in SYS:\SYSTEM. The AFP module initializes this file with the following name mapping for the SYS volume: SYS=server-name.SYSidxid="w5087"book="_idx" docset="nw312" tidref="i6606"server-name is the NetWare server name. You can assign an alias name to the SYS volume, using this format: SYS=aliasYou can assign an alias name to any other volume that supports Macintosh clients by adding a command line to the file, using this format: Volume-name=aliasalias can be up to 27 characters, and cannot include the colon (:) character. (You should also avoid the underscore (_) and slash (/) characters in order to prevent confusion with pathname conventions in Macintosh software that emulates other platforms.) Control characters (such as Ĺ) and any character whose ASCII code is less than a blank, are treated as carriage returns.For example, if two NetWare servers support a volume named PROJ, you can assign an AppleTalk alias to the PROJ volume on SERVER-1 as follows:Open VOLNAMES.AFP in a text editor.You can use any ASCII text editor from a client or at the server console. For example, at the server console type LOAD EDIT SYS:\SYSTEM\VOLNAMES.AFP <Enter>idxid="w5088"book="_idx" docset="nw312" tidref="i1778"This command line loads the EDIT NLM and opens a window for the file. In this example, assume two volumes supporting the Macintosh name space: SYS and PROJ. The file initially contains only one line, mapping the SYS volume name: SYS=SERVER-1.SYSAdd a command line for the PROJ volume and its alias.After you establish the alias for the PROJ volume, the file looks like this: SYS=SERVER-1.SYS PROJ=SERVER-1.PROJPress<Esc> to save your changes and exit the editor.Unload the AFP module and load it again.The new name will not be advertised on the AppleTalk network until you unload the AFP module and load it again. Type these commands at the console prompt:  idxid="w5089"book="_idx" docset="nw312" tidref="i7372"UNLOAD AFP idxid="w5090"book="_idx" docset="nw312" tidref="i229"<Enter>idxid="w5091"book="_idx" docset="nw312" tidref="i7360"  idxid="w5092"book="_idx" docset="nw312" tidref="i194"LOAD AFP idxid="w5093"book="_idx" docset="nw312" tidref="i2263"<Enter>idxid="w5094"book="_idx" docset="nw312" tidref="i229"ID="FM12331"Setting Up a idxid="w5095"book="_idx" docset="nw312" tidref="i229"Specialized idxid="w5096"book="_idx" docset="nw312" tidref="i2263"Environmentidxid="w5097"book="_idx" docset="nw312" tidref="i229"This section describes your configuration options when loading the AFP module. You can specify most of these options on the standard LOAD AFP command line in AUTOEXEC.NCF. The LOAD command-line syntax for specifying these options is  idxid="w5098"book="_idx" docset="nw312" tidref="i229"LOAD idxid="w5099"book="_idx" docset="nw312" tidref="i3245"AFP optionsoptions can be any combination of the arguments described in IDREF="FM42312"Table 6-1.LBL="6-1" INLINE="F"ID="FM42312"AFP LOAD Command Line OptionsWIDTH="108"AFP OptionWIDTH="312"Effect on NetWare File Services EnvironmentWIDTH="108"ENCRYPTWIDTH="312"See IDREF="FM30929""Changing the Macintosh User Authentication Method," below, for a  description of this argument.DELAYnnnSee IDREF="FM21944""Performance Issues: Delaying Macintosh Finder Updates" on page  139.IFSee IDREF="FM36533""Performance Issues: Changing Cache-Buffer Writes" on page 140.LSnnnSee IDREF="FM22417""Memory Issues: Limiting the Number of AFP Login Sessions" on page  141.NCPWSee IDREF="FM12108""Protecting the NetWare Name Services Environment" on page 141.CDTThis argument is a maintenance option rather than a configuration option,  and is intended for use at the console command line rather than in  AUTOEXEC.NCF. See IDREF="FM17320""Maintenance Issues: Clearing and Rebuilding the  Desktop" on page 134.ID="FM30929"Changing idxid="w5100"book="_idx" docset="nw312" tidref="i7128"the idxid="w5101"book="_idx" docset="nw312" tidref="i4424"Macintosh User idxid="w5102"book="_idx" docset="nw312" tidref="i4338"Authentication idxid="w5103"book="_idx" docset="nw312" tidref="i3610"Method idxid="w5104"book="_idx" docset="nw312" tidref="i1821"idxid="w5105"book="_idx" docset="nw312" tidref="i5017"You can enforce NetWare password encryption on Macintosh clients by loading the AFP module with the ENCRYPT option: LOAD AFP ENCRYPTWhen you set the ENCRYPT option and the NetWare UAM software has not been installed on a Macintosh client, the user will be unable to log in to the server.The ENCRYPT option causes the AFP module to accept only passwords encrypted by the NetWare User Authentication Method (UAM) software on the Macintosh client. NetWare password encryption represents a significant security enhancement. If your installation is security-conscious, you should use it.Note that you must install the NetWare UAM software on each Macintosh client to enforce password encryption. Please see the Using the NetWare for Macintosh Client guide for instructions. idxid="w5106"book="_idx" docset="nw312" tidref="i4424"When you use the ENCRYPT option, all passwords on Macintosh clients must be encrypted by the NetWare UAM software before being transmitted to the file server. This action prevents a user with packet-analyzer software from detecting a "clear text" idxid="w5107"book="_idx" docset="nw312" tidref="i219"AppleShare-style idxid="w5108"book="_idx" docset="nw312" tidref="i5017"password while it is in transit to the file server on the network cable. (Although AppleShare supports its own "Scrambled" encryption method, the server does not recognize AppleShare's encryption method, so the password defaults to clear text.)idxid="w5109"book="_idx" docset="nw312" tidref="i3610"Once you install the NetWare UAM on the Macintosh client, the Macintosh user's login procedure changes in these ways:Macintosh users must explicitly select NetWare authentication at each login. The AppleShare Workstation software presents users with a dialog box before accepting their passwords, shown in IDREF="FM42078"Figure 6-5.LBL="6-5"ID="FM42078"UAM Dialog Box idxid="w5110"book="_idx" docset="nw312" tidref="i4424"During idxid="w5111"book="_idx" docset="nw312" tidref="i7062"LoginFILE="n312r083.pbm"The Using the NetWare for Macintosh Client manual presumes this login procedure.The AppleShare software does not allow start-up mounting of a file server's volumes when a user logs in using NetWare password encryption.The Macintosh Chooser does not allow users to change their idxid="w5112"book="_idx" docset="nw312" tidref="i5017"passwords when they log in using NetWare password encryption. Macintosh users must ask the administrator to change their passwords, or use the NetWare Tools software. The idxid="w5113"book="_idx" docset="nw312" tidref="i4293"Using the NetWare for Macintosh Client manual recommends that users idxid="w5114"book="_idx" docset="nw312" tidref="i7128"contact idxid="w5115"book="_idx" docset="nw312" tidref="i3610"their administrator idxid="w5116"book="_idx" docset="nw312" tidref="i5017"to idxid="w5117"book="_idx" docset="nw312" tidref="i4424"change idxid="w5118"book="_idx" docset="nw312" tidref="i4338"a idxid="w5119"book="_idx" docset="nw312" tidref="i3610"password. idxid="w5120"book="_idx" docset="nw312" tidref="i1821"ID="FM21944"Performance idxid="w5121"book="_idx" docset="nw312" tidref="i2263"Issues: idxid="w5122"book="_idx" docset="nw312" tidref="i1348"Delaying idxid="w5123"book="_idx" docset="nw312" tidref="i229"Macintosh idxid="w5124"book="_idx" docset="nw312" tidref="i3638"Finder UpdatesYou can use the DELAY option to specify the number of seconds for the AFP module to delay before informing the Macintosh Finder that a folder's contents have been changed. This option reduces background traffic caused by the default Finder behavior when many Macintosh clients are accessing a common folder hierarchy.By default, the Finder behaves like this when accessing a file server volume:When a Macintosh user changes a folder's contents (for example, by creating or deleting a file), the Finder on that user's Macintosh immediately updates the folder contents to reflect the change.The Finder on other Macintosh clients who are working in the same folder delays up to 10 seconds and then updates the folder contents on the other users' screens to reflect the change.To specify a longer delay for the Finder on other Macintosh clients accessing the same folder, use the command: LOAD AFP DELAYnnnnnn is the number of seconds delay (greater than 10). For example, the command line might look like this: LOAD AFP DELAY30This command line causes the AFP module to wait thirty seconds before informing the Finder that folder contents have changed. In this case, the other users sharing the same folder do not see an update until (1) they close and reopen the folder window (causing the Finder on their Macintosh to automatically update folder contents), or (2) thirty seconds has elapsed, whichever comes first.The trade-offs in using the DELAY option are these:If many Macintosh clients access a common folder hierarchy, the DELAY option reduces the amount of background traffic on the network.Macintosh users can be inconvenienced if they are not shown folder changes in a short period of time. For example, users may try to access files that have been deleted but still appear in their idxid="w5125"book="_idx" docset="nw312" tidref="i3638"version of the folder. idxid="w5126"book="_idx" docset="nw312" tidref="i1348"ID="FM19672"ID="FM36533"Performance Issues: idxid="w5127"book="_idx" docset="nw312" tidref="i895"Changing Cache-Buffer idxid="w5128"book="_idx" docset="nw312" tidref="i895"Writes idxid="w5129"book="_idx" docset="nw312" tidref="i2766"The NetWare cache-buffer flush mechanism is highly reliable, but it returns disk-write confirmation before it finishes writing the cache-buffer contents to disk. You can force the AFP module to wait for the entire contents to be written to disk by using the IF ("Immediate Flush") option on the LOAD AFP command line. The main benefit of this flag option is increased assurance that users will not lose data in the event of a system crash.To modify the cache-buffer flush mechanism for AFP logins, use this command:  idxid="w5130"book="_idx" docset="nw312" tidref="i2766"LOAD AFP IFWhen you use this command line, cache buffers will continue to write their data to disk every three seconds (the standard NetWare mechanism), but the AFP module will wait for full disk write confirmation before proceeding.The use of this option idxid="w5131"book="_idx" docset="nw312" tidref="i2263"causes a significant performance penalty. idxid="w5132"book="_idx" docset="nw312" tidref="i229"ID="FM22417"Memory idxid="w5133"book="_idx" docset="nw312" tidref="i229"Issues: idxid="w5134"book="_idx" docset="nw312" tidref="i229"Limiting idxid="w5135"book="_idx" docset="nw312" tidref="i3598"the idxid="w5136"book="_idx" docset="nw312" tidref="i2263"Number idxid="w5137"book="_idx" docset="nw312" tidref="i3561"of AFP idxid="w5138"book="_idx" docset="nw312" tidref="i2263"Login SessionsYou can limit the number of login sessions the AFP module allows by using the LS option on the LOAD AFP command line. To limit the number of AFP login sessions, use the command: LOAD AFP LSnnnnnn is the number of sessions. For example, if you are running the 100-user version of NetWare for Macintosh, you might enter LOAD AFP LS50This command line limits the number of sessions to 50. If 50 login sessions are in use and another user attempts to log in, a message appears indicating that the server is not responding or is busy.You might want to use this option if you have a very large print requirement and expect Macintosh users to require more concurrent print jobs than are currently provided for, or if you are running NetWare applications or NLMs idxid="w5139"book="_idx" docset="nw312" tidref="i3561"that use idxid="w5140"book="_idx" docset="nw312" tidref="i2263"AppleTalk idxid="w5141"book="_idx" docset="nw312" tidref="i229"connections, idxid="w5142"book="_idx" docset="nw312" tidref="i229"but idxid="w5143"book="_idx" docset="nw312" tidref="i2263"not AFP login idxid="w5144"book="_idx" docset="nw312" tidref="i3598"sessions.ID="FM12108"Protecting the idxid="w5145"book="_idx" docset="nw312" tidref="i4314"NetWare Name Services idxid="w5146"book="_idx" docset="nw312" tidref="i4314"Environment idxid="w5147"book="_idx" docset="nw312" tidref="i4057"If you are running in a NetWare Name Services (NNS) environment, you can protect the consistency of user idxid="w5148"book="_idx" docset="nw312" tidref="i5017"passwords in Name Services domains by using the NCPW option on the LOAD AFP command line. This option causes the AFP module to prevent Macintosh users from changing their passwords on the file server. To accomplish this task, use this command: LOAD AFP NCPWThe Macintosh Chooser does not allow a user to change his or her password when the NetWare UAM is installed. However, only the NCPW option will cause the AFP module to actively idxid="w5149"book="_idx" docset="nw312" tidref="i3245"prevent passwords from being idxid="w5150"book="_idx" docset="nw312" tidref="i2263"changed by any idxid="w5151"book="_idx" docset="nw312" tidref="i229"idxid="w5152"book="_idx" docset="nw312" tidref="i229"application based on AFP. idxid="w5153"book="_idx" docset="nw312" tidref="i229"Network Administration from a Macintosh WorkstationOnce you have configured AFP at the NetWare v3.12 file server, you can administer it from a Macintosh workstation connected to the server. NetWare Tools software for the Macintosh, included with NetWare v3.12, enable you to perform a full set of administrative tasks from a Macintosh workstation, such as creating users and groups, or setting user privileges and file system security.For information about the NetWare Tools software, including installation at the Macintosh workstation, refer to the Using the NetWare for Macintosh Client manual, included with NetWare v3.12 and idxid="w5154"book="_idx" docset="nw312" tidref="i2263"NetWare for idxid="w5155"book="_idx" docset="nw312" tidref="i271"idxid="w5156"book="_idx" docset="nw312" tidref="i229"Macintosh. idxid="w5157"book="_idx" docset="nw312" tidref="i229"LBL="7"ID="FM11507"idxid="w5158"book="_idx" docset="nw312" tidref="i271"idxid="w5159"book="_idx" docset="nw312" tidref="i324"idxid="w5160"book="_idx" docset="nw312" tidref="i324"idxid="w5161"book="_idx" docset="nw312" tidref="i324"Managing AppleTalk Print Servicesidxid="w5162"book="_idx" docset="nw312" tidref="i5282"This idxid="w5163"book="_idx" docset="nw312" tidref="i5425"chapter explains how AppleTalk print services work and how to configure NetWare print queues that will be visible to Macintosh clients, or that will be serviced by an AppleTalk printer, or both.This chapter also provides information about general print queue maintenance (including Macintosh-specific issues such as Laser Prep files and PostScript font lists) and about using NetWare print utilities with queues that are spooled to or serviced by the ATPS module.How AppleTalk Print idxid="w5164"book="_idx" docset="nw312" tidref="i5425"Services WorkThe ATPS module provides two main functions: AppleTalk print spooling and AppleTalk print serving. Both of these functions are built into the ATPS NLM.LBL="7-1"AppleTalk Print Spooler and Print ServerFILE="n312r084.pbm"The AppleTalk Print Spooler idxid="w5165"book="_idx" docset="nw312" tidref="i5438"TheAppleTalk print spooler "advertises" a NetWare print queue on AppleTalk networks and accepts print jobs submitted by Macintosh clients. The print spooler makes a queue visible to Macintosh clients by responding to requests for LaserWriter or ImageWriter devices.LBL="7-2"AppleTalk Print Spooler Advertises the QueueFILE="n312r085.pbm"There are several configuration options that affect how Macintosh users see AppleTalk print services in the Chooser. For example,You can assign a descriptive AppleTalk print spooler name that helps Macintosh users to choose the right queue. The name of the queue itself is derived from the spooler name you assign. (Macintosh users see the spooler name only, but DOS or other clients can see the queue in PCONSOLE or other NetWare utilities.)You can hide the AppleTalk printer itself, so that only the spooler appears in the Chooser.If you are operating in a Phase 2 environment and have configured multiple zones on the internal network, you can advertise the queue in any one of those zones.See IDREF="FM25504""Print Services Configuration" on page 147 for a complete discussion of queue configuration options.The AppleTalk Print Server idxid="w5166"book="_idx" docset="nw312" tidref="i5421"idxid="w5167"book="_idx" docset="nw312" tidref="i5482"The AppleTalk print server takes print jobs out of a NetWare print queue and sends them to a printer on the AppleTalk network. For idxid="w5168"book="_idx" docset="nw312" tidref="i5282"each NetWare queue it services, the AppleTalk print server manages the communication between the queue and the idxid="w5169"book="_idx" docset="nw312" tidref="i5482"AppleTalk printer. For AppleTalk PostScript printers, the AppleTalk print server also manages the Laser Prep issues.LBL="7-3"PSERVER Also Services Macintosh Print JobsFILE="n312r086.pbm"There are several configuration options that affect how print jobs are handled once they are placed in the queue. For example,You can turn off the AppleTalk print server altogether, and configure idxid="w5170"book="_idx" docset="nw312" tidref="i5679"PSERVER to poll the queue and ship print jobs to a serial, parallel, or Novell Remote printer. See IDREF="FM14927""Print Server Configuration Options" on page 169 for a full description of alternative print server configurations. You can assign multiple AppleTalk printers to service a single queue. See IDREF="FM27251""Multiple AppleTalk Printers Servicing a Print Queue: -wf" on page 166 for details.See IDREF="FM25504""Print Services Configuration" on page 147 for a complete discussion of queue configuration options. idxid="w5171"book="_idx" docset="nw312" tidref="i5425"ID="FM17711"Loading the idxid="w5172"book="_idx" docset="nw312" tidref="i5425"ATPS idxid="w5173"book="_idx" docset="nw312" tidref="i5425"Module idxid="w5174"book="_idx" docset="nw312" tidref="i324"Before loading the idxid="w5175"book="_idx" docset="nw312" tidref="i260"ATPS module, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as described in Chapters 3 and 4.idxid="w5176"book="_idx" docset="nw312" tidref="i516"When the ATPS module is loaded on the server, it opens and reads SYS:SYSTEM\ATPS.CFG for its list of queues. If the ATPS.CFG file does not exist or contains errors, the ATPS module does not load.The ATPS module supports two options on the LOAD command line, using the following syntax: LOAD ATPS [-D pathname][-V](Square brackets indicate that a parameter is optional, and are not part of the syntax.) These options are described in IDREF="FM17897"Table 7-1.LBL="7-1" INLINE="F"ID="FM17897"LOAD ATPS OptionsWIDTH="120"ParameterWIDTH="192"ActionWIDTH="120"idxid="w5177"book="_idx" docset="nw312" tidref="i324"-Dpathnameidxid="w5178"book="_idx" docset="nw312" tidref="i17"WIDTH="192"Create the specified directory (pathname)  to contain all queues spooled to or serviced  by the ATPS module, idxid="w5179"book="_idx" docset="nw312" tidref="i5282"as well as files used  internally by ATPS. See IDREF="FM36084""Specifying an  Alternative Location for Queue Directories"  on page 190.idxid="w5180"book="_idx" docset="nw312" tidref="i324"-Vidxid="w5181"book="_idx" docset="nw312" tidref="i42"idxid="w5182"book="_idx" docset="nw312" tidref="i42""Verbose option." Create an ATPS console  window and display informational, as well  as standard, error messages. IDREF="FM20159""Verbose  Mode: Viewing Troubleshooting Messages"  on page 190.Unloading the ATPS Module idxid="w5183"book="_idx" docset="nw312" tidref="i324"When you type UNLOAD ATPS at the console while ATPS is receiving jobs from AppleTalk clients or printing jobs on AppleTalk printers, a prompt appears at the console asking if you really wish to unload.Answering "Yes" to the confirmation prompt unloads the ATPS module but may interrupt printing. Print jobs that are currently being received from a Macintosh workstation are lost. Jobs that are currently being printed are interrupted but remain in the queue until ATPS is loaded again and the jobs are printed or otherwise removed from the queue.ATPS automatically attempts to restore hidden printers upon unloading. However, hidden printers remain hidden if the server is downed or turned off without first unloading ATPS. You can make a printer visible again by turning it off and on. In addition, hidden printers may slow the process of unloading ATPS, particularly if the hidden printers are processing jobs or off-line at the time of unloading. Allow up to 90 seconds per hidden printer when unloading ATPS. If the printer is still busy or unreachable after this time, the printer will not be restored. Power-cycle the printer to restore it. For more information, see IDREF="FM13509""ATPS Console Commands" on page 191. idxid="w5184"book="_idx" docset="nw312" tidref="i324"ID="FM25504"Print Services idxid="w5185"book="_idx" docset="nw312" tidref="i5282"ConfigurationThis section shows the basic procedure for creating or modifying AppleTalk print spoolers and print servers with the ATPS module, and describes all of the available print services configuration options.ID="FM32440"How to Configure AppleTalk Print Services in ATPS.CFG idxid="w5186"book="_idx" docset="nw312" tidref="i516"To enter a configuration that will be in effect when you load the ATPS module, follow these steps at the file server console:Load the INSTALL utility and select Product Options in the main INSTALL menu.Press <Enter> on the line specifying NW-MAC v3.12.If you have installed multiple products, use the arrow keys to select NW-MAC v3.12 before pressing <Enter>.FILE="n312r087.pbm"When you press <Enter>, the Editable Configuration Files menu opens:FILE="n312r088.pbm"idxid="w5187"book="_idx" docset="nw312" tidref="i2831"Use the arrow keys to select ATPS.CFG in the menu and then press <Enter>.idxid="w5188"book="_idx" docset="nw312" tidref="i516"An ATPS.CFG window opens in which you can enter the server's print queue configuration. For example, to idxid="w5189"book="_idx" docset="nw312" tidref="i5282"create a queue using the default syntax, enter the command line: "my printer:printer zone"This example uses the "printer-name:zone-name" default queue configuration syntax. See IDREF="FM35890""Using the Default Configuration Syntax" on page 151 for details.See IDREF="FM25644""AppleTalk Print Services Configuration Options" on page 149 for a list of all of the available queue configuration options. When you have configured the printer in ATPS.CFG, Exit the INSTALL utility, saving your changes.Unload and load ATPS.If ATPS is already running on this server, unload it by typing UNLOAD ATPS <Enter>(Otherwise, skip this step.) Load ATPS by typing LOAD ATPS <Enter>This example assumes that you have already fully configured NetWare for Macintosh. Please see Chapters 3 and 4 if you have not already configured and loaded the AppleTalk NLM. idxid="w5190"book="_idx" docset="nw312" tidref="i516"ID="FM25644"AppleTalk Print Services idxid="w5191"book="_idx" docset="nw312" tidref="i5282"Configuration OptionsIDREF="FM10948"Table 7-2 describes the options you can use on ATPS.CFG configuration command lines.If a parameter to one of these options includes a space character, you must enclose the parameter in double-quotes.LBL="7-2" INLINE="F"ID="FM10948"Print Services Configuration Options and ParametersWIDTH="108"ParameterWIDTH="312"ExplanationWIDTH="108"-pidxid="w5192"book="_idx" docset="nw312" tidref="i5477"printer-name idxid="w5193"book="_idx" docset="nw312" tidref="i34"WIDTH="312"idxid="w5194"book="_idx" docset="nw312" tidref="i5282"printer-name is idxid="w5195"book="_idx" docset="nw312" tidref="i5482"the name idxid="w5196"book="_idx" docset="nw312" tidref="i34"assigned idxid="w5197"book="_idx" docset="nw312" tidref="i5282"to an AppleTalk printer by using  Macintosh software. The name can be up to 31 characters in length and  cannot include a colon character (:) or an at-sign (@). If you do not specify  a spooler name, ATPS creates a default spooler name by prefixing "NW"  to printer-name. See IDREF="FM35890""Using the Default Configuration Syntax" on page  151 for information about a shorthand syntax for specifying the printer  name without the -p option, and IDREF="FM33631""Specifying an AppleTalk Printer  Explicitly: -p" on page 152 for examples using -p.-zidxid="w5198"book="_idx" docset="nw312" tidref="i5282"zone-name idxid="w5199"book="_idx" docset="nw312" tidref="i5482"zone-nameidxid="w5200"book="_idx" docset="nw312" tidref="i7586"is the idxid="w5201"book="_idx" docset="nw312" tidref="i48"name of the idxid="w5202"book="_idx" docset="nw312" tidref="i5282"AppleTalk zone in which an AppleTalk printer  resides. If you do not specify zone-name, ATPS assumes the default zone  of the internal network. See IDREF="FM35890""Using the Default Configuration Syntax" on  page 151 for information about a shorthand syntax for specifying the zone  name without the -z option, and IDREF="FM31698""Specifying an AppleTalk Printer's Zone  Explicitly: -z" on page 153 for examples using -z.-aidxid="w5203"book="_idx" docset="nw312" tidref="i5282"(Print spooler option.) idxid="w5204"book="_idx" docset="nw312" tidref="i9"Allows Macintosh users to spool print jobs to the  queue only if they are logged in to the server via AFP and are designated  as Queue Users. See IDREF="FM31255""Enabling Print Queue Security: -a" on page 154 for  an example using -a.-bidxid="w5205"book="_idx" docset="nw312" tidref="i5282"(Print spooler idxid="w5206"book="_idx" docset="nw312" tidref="i11"option.) idxid="w5207"book="_idx" docset="nw312" tidref="i654"Causes idxid="w5208"book="_idx" docset="nw312" tidref="i11"Macintosh idxid="w5209"book="_idx" docset="nw312" tidref="i654"print jobs submitted via the  spooler to be marked for printing with a idxid="w5210"book="_idx" docset="nw312" tidref="i5210"banner page. See IDREF="FM22242""Printing  Banner Pages: -b" on page 154 for an example using -b.-cidxid="w5211"book="_idx" docset="nw312" tidref="i1025"(Print idxid="w5212"book="_idx" docset="nw312" tidref="i5282"spooler option.) idxid="w5213"book="_idx" docset="nw312" tidref="i14"Causes the AppleTalk idxid="w5214"book="_idx" docset="nw312" tidref="i2772"print spooler of idxid="w5215"book="_idx" docset="nw312" tidref="i5482"type  "ImageWriter" or "ImageWriter LQ" to return status as an ImageWriter  with the color ribbon loaded. This enables Macintosh applications to  generate the appropriate color codes. See IDREF="FM32652""Specifying a Color  ImageWriter: -t and -c" on page 155 for an example configuration line  specifying a LaserWriter with a color ribbon.-eidxid="w5216"book="_idx" docset="nw312" tidref="i654"( idxid="w5217"book="_idx" docset="nw312" tidref="i21"Print server option.) idxid="w5218"book="_idx" docset="nw312" tidref="i21"Turns off idxid="w5219"book="_idx" docset="nw312" tidref="i1837"error idxid="w5220"book="_idx" docset="nw312" tidref="i5282"banner pages that are idxid="w5221"book="_idx" docset="nw312" tidref="i1848"otherwise  generated for PostScript errors. See IDREF="FM18793""Turning Off Error Banner Pages: -e"  on page 155 for an example using -e.WIDTH="108"ParameterWIDTH="312"Explanation-f idxid="w5222"book="_idx" docset="nw312" tidref="i24"idxid="w5223"book="_idx" docset="nw312" tidref="i5282"filename(Print spooler option.) filename is a PostScript font list file located in NW- MAC\FONTS. See IDREF="FM35138""Specifying a PostScript Font List: -f" on page 156 for  an example configuration line using -f. IDREF="FM38361""PostScript Font Lists: *.FNT Files"  on page 183 discusses the issues related to PostScript fonts.-hidxid="w5224"book="_idx" docset="nw312" tidref="i26"idxid="w5225"book="_idx" docset="nw312" tidref="i5282"(Print server option: "disable bypass printing.") Hides the AppleTalk  printer by changing its NBP type. This option is used to prevent users from  submitting print jobs directly to the printer. See IDREF="FM18651""Enabling Printer Security:  -h" on page 157 for an example configuration using -h.-lidxid="w5226"book="_idx" docset="nw312" tidref="i28"idxid="w5227"book="_idx" docset="nw312" tidref="i5282"(Print spooler option.) Includes the necessary Macintosh Laser Prep file in  each job placed in the queue. See IDREF="FM21715""Including Laser Prep Files in All  Macintosh Print Jobs: -l" on page 157 for an example using -l. IDREF="FM17526""Laser Prep  Files: *.PRS" on page 186 discusses the issues related to Laser Prep files.-nN(Print spooler option.) idxid="w5228"book="_idx" docset="nw312" tidref="i30"N is the idxid="w5229"book="_idx" docset="nw312" tidref="i5282"number of idxid="w5230"book="_idx" docset="nw312" tidref="i5210"concurrent print idxid="w5231"book="_idx" docset="nw312" tidref="i5282"jobs allowed to  print to an AppleTalk print spooler, which must be between 1 and 50. If  you do not specify this option, the default is 10. If you increase or decrease N, more or less server memory and processor time are accessible to print  jobs. See IDREF="FM12488""Changing the Number of Concurrent Print Jobs Allowed: -n" on  page 158 for an example configuration using -n.-ospooler-name idxid="w5232"book="_idx" docset="nw312" tidref="i32"idxid="w5233"book="_idx" docset="nw312" tidref="i4791"spooler-nameidxid="w5234"book="_idx" docset="nw312" tidref="i5282"is the "object name" idxid="w5235"book="_idx" docset="nw312" tidref="i32"of the AppleTalk print spooler, that is,  the name that appears in the Chooser. spooler-name can be any valid  Chooser name (up to 31 characters), but should not include these  characters: : @. idxid="w5236"book="_idx" docset="nw312" tidref="i5045"The print queue name itself (visible to DOS users in idxid="w5237"book="_idx" docset="nw312" tidref="i5282"idxid="w5238"book="_idx" docset="nw312" tidref="i5482"PCONSOLE) idxid="w5239"book="_idx" docset="nw312" tidref="i5425"is derived from spooler-name; if necessary, underscores are  substituted for spaces and the characters / \ ; , * ? % and + in spooler-name  to create a valid queue name. If the print spooler is turned off, this option  can be used to provide a descriptive name for the queue itself. See IDREF="FM29796""Assigning a Descriptive Name: -o" on page 159 for an example using -o.-ospooler-name[:izone-name](Shown on two lines  above for printing  purposes only.)When the spooler name is followed by a colon (:) and a zone name, the  spooler will be visible in the specified zone of the internal network. See IDREF="FM12141""Advertising a Queue in a Specified Zone: -o" on page 160 for an example  configuration specifying an internal zone. See IDREF="FM34323""Internal Network and Zone  Configuration" on page 19 for information about configuring the internal  network with multiple zones.WIDTH="108"ParameterWIDTH="312"Explanation-tidxid="w5240"book="_idx" docset="nw312" tidref="i38"printer-typeidxid="w5241"book="_idx" docset="nw312" tidref="i5482"printer-typeidxid="w5242"book="_idx" docset="nw312" tidref="i5480"is the NBP idxid="w5243"book="_idx" docset="nw312" tidref="i5282"type of the printer that accepts print jobs from the  print server. Unless you specify the -t option, idxid="w5244"book="_idx" docset="nw312" tidref="i5482"the default printer type is  "LaserWriter." See IDREF="FM35853""Specifying a Printer Type: -t" on page 161 for an  example using -t to specify an idxid="w5245"book="_idx" docset="nw312" tidref="i5482"ImageWriter printer, and IDREF="FM26694""Options for Non- Apple Printers: -t, -s, -f, and -l" on page 161 for information on specifying  a non-Apple printer type.-sidxid="w5246"book="_idx" docset="nw312" tidref="i5123"If you idxid="w5247"book="_idx" docset="nw312" tidref="i5282"are using a idxid="w5248"book="_idx" docset="nw312" tidref="i5482"PostScript idxid="w5249"book="_idx" docset="nw312" tidref="i36"printer that is not the default LaserWriter type  (if you have specified a different printer type by using the -t option), use  the -s option to specify that the printer is a PostScript printer. See IDREF="FM26694""Options for Non-Apple Printers: -t, -s, -f, and -l" on page 161 for more  information.-wb idxid="w5250"book="_idx" docset="nw312" tidref="i44"idxid="w5251"book="_idx" docset="nw312" tidref="i5282"("Without back end.") This option specifies that the AppleTalk print server  will not be in use. Presumably, idxid="w5252"book="_idx" docset="nw312" tidref="i5679"PSERVER or some other print server will  service the queue. See IDREF="FM16947""Turning Off the AppleTalk Print Server: -wb" on  page 164 for an example configuration using -wb, and IDREF="FM14927""Print Server  Configuration Options" on page 169 for details on configuring a queue to  be serviced by PSERVER.-wf idxid="w5253"book="_idx" docset="nw312" tidref="i46"idxid="w5254"book="_idx" docset="nw312" tidref="i5282"("Without front end.") This option specifies that the AppleTalk print  spooler will not be in use. The queue will be usable by PC users but not  Macintosh clients. You can also use this option to allow multiple printers  to service a queue that is advertised via a single AppleTalk print spooler.  See IDREF="FM39916""Turning Off the AppleTalk Print Spooler: -wf" on page 165 and IDREF="FM27251""Multiple AppleTalk Printers Servicing a Print Queue: -wf" on page 166 for  examples.ID="FM35890"Using the Default idxid="w5255"book="_idx" docset="nw312" tidref="i5282"Configuration SyntaxThe following default configuration syntax specifies a queue that will be serviced by the specified LaserWriter printer and will be advertised on AppleTalk---in other words, the specified queue has both an AppleTalk print spooler and an AppleTalk print server: printer-name[:zone-name](The brackets shown above indicate that the zone name is optional. They are not part of the default syntax.) When you specify the printer name and zone name without explicitly specifying the -p and -z options, they must appear first on the configuration line. If a space character appears anywhere in the "printer-name:zone-name" string, you must enclose the entire string in double-quotes.When you use the default syntax, the AppleTalk print spooler name is derived by preceding the printer name with "NW," and a valid queue name is derived as usual from the AppleTalk print spooler name. ATPS will create the queue if it does not already exist.printer-name is the name assigned to the LaserWriter by using Macintosh software. If you are not sure about the name of the printer or the name of the zone in which it is located, you can check them in the Macintosh Chooser or by using the Lookup service in the ATCON utility. See IDREF="FM18937""Looking Up an AppleTalk Service" on page 274 for details.zone-name is the name of the AppleTalk zone in which the printer resides. If you do not specify zone-name, ATPS assumes the default zone of the internal network. This means that you can omit the zone-name parameter only if the printer resides in the same AppleTalk zone as the default zone of the internal network. The name is case-insensitive but must include any leading or trailing white-space characters.You can add configuration options to the default syntax, provided that the printer name appears first on the configuration line (optionally followed by a colon character (:) and a zone name). For example, the following configuration line creates a queue that will send print jobs to the specified idxid="w5256"book="_idx" docset="nw312" tidref="i5482"ImageWriter printer, and that has both an AppleTalk print spooler and an AppleTalk print server: printer-name[:zone-name] -t ImageWriter idxid="w5257"book="_idx" docset="nw312" tidref="i5282"ID="FM33631"Specifying idxid="w5258"book="_idx" docset="nw312" tidref="i5282"an idxid="w5259"book="_idx" docset="nw312" tidref="i5482"AppleTalk idxid="w5260"book="_idx" docset="nw312" tidref="i5282"Printer idxid="w5261"book="_idx" docset="nw312" tidref="i5477"Explicitly: -p idxid="w5262"book="_idx" docset="nw312" tidref="i34"idxid="w5263"book="_idx" docset="nw312" tidref="i5282"The following configuration line specifies a queue that will send jobs to a LaserWriter named "LaserWriter IINT" in the "Admin" zone: -o "Admin Q" -p "LaserWriter IINT" -z AdminThe AppleTalk spooler will be visible in the Chooser as "Admin Q," and the queue will be named "ADMIN_Q."Note that the "Admin" zone is the zone in which the printer resides, and not the zone in which the AppleTalk print spooler will be visible. See IDREF="FM12141""Advertising a Queue in a Specified Zone: -o" on page 160 for details.When you use the-p option to specify an AppleTalk printer's name instead of using the default syntax, the printer name can appear anywhere on the configuration line. If you are not sure about the name of the printer or name of the zone in which it is located, you can check them in the Macintosh Chooser or by idxid="w5264"book="_idx" docset="nw312" tidref="i5282"using the Lookup service in the idxid="w5265"book="_idx" docset="nw312" tidref="i5282"ATCON idxid="w5266"book="_idx" docset="nw312" tidref="i5282"utility. See IDREF="FM18937""Looking Up an AppleTalk Service" on page 274idxid="w5267"book="_idx" docset="nw312" tidref="i5477"for idxid="w5268"book="_idx" docset="nw312" tidref="i5482"details. idxid="w5269"book="_idx" docset="nw312" tidref="i34"ID="FM31698"Specifying an idxid="w5270"book="_idx" docset="nw312" tidref="i7586"AppleTalk idxid="w5271"book="_idx" docset="nw312" tidref="i48"Printer's idxid="w5272"book="_idx" docset="nw312" tidref="i5282"Zone idxid="w5273"book="_idx" docset="nw312" tidref="i5482"Explicitly: idxid="w5274"book="_idx" docset="nw312" tidref="i5282"-zThe following configuration line specifies a queue that will send jobs to a LaserWriter named "Tech Pubs" in the "Publications" zone: -z Publications -p "Tech Pubs"The AppleTalk spooler will be visible in the Chooser as "NW Tech Pubs" (the default name derived from the printer name) and the queue will be named "NW_TECH_PUBS."Note that the "Publications" zone is the zone in which the printer resides, and not the zone in which the AppleTalk print spooler will be visible. See IDREF="FM12141""Advertising a Queue in a Specified Zone: -o" on page 160 for details. If you do not specify a zone name, ATPS uses the default zone of the internal network. This means that you can omit the name of the zone in which a printer resides only if the same zone is specified as the default zone of the internal network.When you use the-z option to specify an AppleTalk printer's zone name instead of using the default syntax, the zone name can appear anywhere on the configuration line.ID="FM31255"Enabling Print Queue Security: idxid="w5275"book="_idx" docset="nw312" tidref="i5282"idxid="w5276"book="_idx" docset="nw312" tidref="i9"-aTo prevent Macintosh users from submitting print jobs when they have not logged in to the NetWare v3.12 server via AFP, use the -a option on the configuration line in ATPS.CFG. When the -a option is in use, the AppleTalk print spooler will be visible in the Chooser, but if a user has not logged in to the NetWare server or is not a designated Queue User, that user's connection is dropped and an error message appears on the Macintosh screen indicating that the print job has failed.The following configuration line specifies a queue located in the server's default zone that will send jobs to a LaserWriter on the AppleTalk network named "LaserWriter1." LaserWriter1 -o "Tim's Queue" -h -aThe AppleTalk print spooler will be visible in the Chooser as "Tim's Queue," and the queue will be named "TIM_S_QUEUE." Because a zone name is not specified, the printer must reside in the same zone configured as the default zone of the internal network.The -h option hides the LaserWriter named "LaserWriter1" to prevent users from printing directly to the printer, and the -a option prevents Macintosh users from printing to the queue unless they have logged in to the server.If you configure a print queue with the -a option in ATPS.CFG, you must designate Macintosh users who are to use that queue as Queue Users in PCONSOLE. By default, the group EVERYONE is designated as a Queue User, so all members of that group can print to a queue. idxid="w5277"book="_idx" docset="nw312" tidref="i5282"idxid="w5278"book="_idx" docset="nw312" tidref="i9"ID="FM22242"Printing idxid="w5279"book="_idx" docset="nw312" tidref="i11"Banner idxid="w5280"book="_idx" docset="nw312" tidref="i5282"Pages: idxid="w5281"book="_idx" docset="nw312" tidref="i5282"-b idxid="w5282"book="_idx" docset="nw312" tidref="i654"idxid="w5283"book="_idx" docset="nw312" tidref="i5210"By idxid="w5284"book="_idx" docset="nw312" tidref="i654"default, idxid="w5285"book="_idx" docset="nw312" tidref="i11"Macintosh print jobs submitted to a queue are not marked for printing with a banner page. However, you can use the -b option to have all Macintosh jobs submitted to the queue so marked. The print server will then generate banner pages that specify the user's name for appropriately marked jobs. DOS users can mark their jobs by using idxid="w5286"book="_idx" docset="nw312" tidref="i5441"PRINTCON.If you are using idxid="w5287"book="_idx" docset="nw312" tidref="i5679"PSERVER to service a queue advertised by ATPS, do not use the-b (banner) option with LaserWriters and other PostScript printers. The banner page created by PSERVER is not in PostScript format, and it causes the PostScript job to fail. For the same reason, when printing to PSERVER-connected PostScript printers from DOS, specify NO to "Print banner" and YES to "Suppress form feed" in PRINTCON.The following configuration line specifies a queue that will send jobs to a LaserWriter named "Printer-1" in the "Engineering" zone, and each Macintosh print job submitted to the queue will be marked for printing with a banner page that specifies the user's name: Printer-1:Engineering -bIn this example configuration line, the AppleTalk print spooler will be named "NW Printer-1" (the default spooler name derived from the printer name), and the queue will be named "NW_PRINTER_1."For an ImageWriter queue, the Macintosh user's name will appear in the banner only if the idxid="w5288"book="_idx" docset="nw312" tidref="i11"user idxid="w5289"book="_idx" docset="nw312" tidref="i654"is idxid="w5290"book="_idx" docset="nw312" tidref="i5282"logged in idxid="w5291"book="_idx" docset="nw312" tidref="i5282"to the file idxid="w5292"book="_idx" docset="nw312" tidref="i5210"server via idxid="w5293"book="_idx" docset="nw312" tidref="i11"AFP. idxid="w5294"book="_idx" docset="nw312" tidref="i654"ID="FM32652"Specifying a idxid="w5295"book="_idx" docset="nw312" tidref="i5282"Color idxid="w5296"book="_idx" docset="nw312" tidref="i2772"ImageWriter: idxid="w5297"book="_idx" docset="nw312" tidref="i1025"-t and idxid="w5298"book="_idx" docset="nw312" tidref="i14"-c idxid="w5299"book="_idx" docset="nw312" tidref="i5482"Either of these lines specifies a queue that will send jobs to a color ImageWriter named "Dot matrix" in the "Admin" zone: -p "Dot matrix" -z Admin -t ImageWriter -c "Dot matrix:Admin" -t ImageWriter -cThe AppleTalk print spooler will be named "NW Dot matrix" (the default name derived from the printer name), and the queue will be named "NW_DOT_MATRIX."The spooler will be visible as an ImageWriter in the Chooser. Provided that Macintosh users have the right printer driver software, the Macintosh applications can generate the codes necessary to print in color on an ImageWriter.ID="FM18793"Turning idxid="w5300"book="_idx" docset="nw312" tidref="i5282"Off idxid="w5301"book="_idx" docset="nw312" tidref="i1848"Error idxid="w5302"book="_idx" docset="nw312" tidref="i1837"Banner idxid="w5303"book="_idx" docset="nw312" tidref="i21"Pages: idxid="w5304"book="_idx" docset="nw312" tidref="i21"-e idxid="w5305"book="_idx" docset="nw312" tidref="i654"By default, PostScript errors returned by a printer to the AppleTalk print server are printed on a special banner page. For printers that use high-resolution film, this situation can cause unacceptable waste. To turn off error banner pages, use the -e option on the configuration line in ATPS.CFG.The following configuration line specifies a queue that will send jobs to a LaserWriter named "Tech Support" in the "TechOps" zone, and PostScript errors will not generate a special banner page. "Tech Support:TechOps" -o "QUEUE 1" -eThe spooler will be named "QUEUE 1" and the queue itself will be named "QUEUE_1."ID="FM35138"Specifying a idxid="w5306"book="_idx" docset="nw312" tidref="i2467"PostScript Font List: -f idxid="w5307"book="_idx" docset="nw312" tidref="i24"idxid="w5308"book="_idx" docset="nw312" tidref="i5282"Please refer to IDREF="FM38361""PostScript Font Lists: *.FNT Files" on page 183 for a discussion of PostScript font files and how they are used by the ATPS module, and for information on creating a customized font file.If you are specifying a queue for a LaserWriter on AppleTalk, you can specify a font list for that printer to allow the AppleTalk print spooler to advertise its queue even if the printer is not available on the network when ATPS is loaded. To do so, use the -f option on the configuration line. For example, the following line specifies a queue using the default font list for a Apple LaserWriter NT: printer-name:zone-name -f applwntFont list files must be stored in the SYS:SYSTEM\NW-MAC\FONTS directory and must use the ".FNT" filename extension. Please see IDREF="FM26258"Table 7-5 on page 183 for the standard font list files.If you are specifying a queue for a PostScript printer on a serial or parallel (or remote) connection, you must specify a font list file for the queue.The following configuration line specifies a queue named "MAIN_Q" and a print spooler named "Main Q." The AppleTalk print server has been disabled by specifying the -wb option, so the-f option is used to provide the print spooler with the proper list of fonts, in this case, the default font list supported by the Apple LaserWriter IINT: -o "Main Q" -wb -f applwntThis configuration line instructs ATPS to obtain the font list from SYS:SYSTEM\NW-MAC\FONTS\APPLWNT.FNT. For each AppleTalk spooler, a font list must be obtained either from the specified AppleTalk printer or from a font list file.See IDREF="FM16947""Turning Off the AppleTalk Print Server: -wb" on page 164 for more information about the -wb option.ID="FM18651"Enabling idxid="w5309"book="_idx" docset="nw312" tidref="i5482"Printer Security: idxid="w5310"book="_idx" docset="nw312" tidref="i26"idxid="w5311"book="_idx" docset="nw312" tidref="i5282"-hThe -h option prevents Macintosh users from bypassing the queue and submitting print jobs directly to the printer (sometimes called "bypass printing").The following configuration line specifies a queue that will send jobs to a LaserWriter named "LaserWriter1" in the "Engineering" zone. LaserWriter1:Engineering -o "Tim's Queue" -hThe AppleTalk print spooler will be named "Tim's Queue" and the NetWare queue will be named "TIM_S_QUEUE." The -h option causes the AppleTalk print server to instruct the printer to use a different NBP type, for example, "LaserShared" instead of "LaserWriter." This prevents the Chooser from listing the printer as a device of type "LaserWriter." If you have multiple print queues configured for one printer, a single instance of -h hides the printer on the AppleTalk internet.The printer becomes visible again if ATPS is unloaded, or if you choose to make it visible again by using the ATPSSHOW command. IDREF="FM13509""ATPS Console Commands" on page 191 describes console commands for hiding AppleTalk printers or making "hidden" printers visible.ID="FM21715"Including Laser Prep Files in All idxid="w5312"book="_idx" docset="nw312" tidref="i3172"Macintosh Print idxid="w5313"book="_idx" docset="nw312" tidref="i5282"Jobs: -l idxid="w5314"book="_idx" docset="nw312" tidref="i28"Please refer to IDREF="FM17526""Laser Prep Files: *.PRS" on page 186 for a discussion of Laser Prep files and how they are used by printers.If you are configuring a queue for a LaserWriter or compatible printer on a serial or parallel (or remote) connection, you use -l (lowercase L) to include the correct Macintosh Laser Prep file in each Macintosh print job as it is placed in the queue.For example, the following configuration line specifies the default font list for the Apple LaserWriter NT, and specifies that the required Laser Prep file will be included in each Macintosh print job: -o "Main Q" -wb -f applwnt -lThis example configuration line creates a queue named "MAIN_Q" and a print spooler named "Main Q." It also turns off the AppleTalk print server, to allow PSERVER to send print jobs to a serial, parallel, or remote printer. See IDREF="FM16947""Turning Off the AppleTalk Print Server: -wb" on page 164 for information about the -wb option.IDREF="FM37933""Recommended Way to Handle Laser Prep Files" on page 187 describes an alternative way to manage these files, which avoids the print performance penalty caused by using the idxid="w5315"book="_idx" docset="nw312" tidref="i3172"-lidxid="w5316"book="_idx" docset="nw312" tidref="i5282"option. idxid="w5317"book="_idx" docset="nw312" tidref="i28"ID="FM12488"Changing the idxid="w5318"book="_idx" docset="nw312" tidref="i5282"Number of idxid="w5319"book="_idx" docset="nw312" tidref="i5210"Concurrent Print idxid="w5320"book="_idx" docset="nw312" tidref="i5282"Jobs Allowed: -n idxid="w5321"book="_idx" docset="nw312" tidref="i30"By default, NetWare for Macintosh v3.12 allows ten Macintosh print jobs (ten Printer Access Protocol connections) to write to a single AppleTalk print spooler at any given moment. If more than ten print jobs attempt to write to a print spooler concurrently, ATPS returns a message to the Macintosh indicating that the printer is busy. This message will disappear and the spooler will accept the print job as soon as one of the print jobs has been written to the queue.If you wish to allow more or less than ten print jobs to write to a queue concurrently, use the -n option when configuring ATPS. For example, the following line creates a spooler named "NW LaserWriter2" and a queue named "NW_LASERWRITER2," and allows 5 Macintosh print jobs to be submitted concurrently: "LaserWriter2:Engineering" -n5Because the print spooler accepts jobs very quickly, a setting of less than ten should suffice for most sites. You can reduce the maximum amount of memory that could be used by the print queue and control the number of AppleTalk connections it can consume by limiting the number of print jobs it will accept at the same time.The number of concurrent print jobs must be 50 or less. The amount of memory on the file server, available disk space, available AppleTalk stack connections, and processor time are factors to consider when increasing or decreasing the number of concurrent print jobs. idxid="w5322"book="_idx" docset="nw312" tidref="i5282"ID="FM29796"Assigning a idxid="w5323"book="_idx" docset="nw312" tidref="i32"Descriptive idxid="w5324"book="_idx" docset="nw312" tidref="i5282"Name: -o idxid="w5325"book="_idx" docset="nw312" tidref="i4791"When you specify a configuration line in ATPS.CFG, you can allow ATPS to create a default print spooler name of "NWprinter-name," or you can use the -o option to specify a spooler name explicitly. In either case, the queue name is derived from the spooler name.The following configuration line specifies a queue for a LaserWriter named "Robin" in the "Publications" zone: Robin:Publications -o "Doc Queue"The AppleTalk print spooler will be named "Doc Queue" and the NetWare print queue used will be named "DOC_QUEUE."AppleTalk print spooler names follow the rules for all Macintosh Chooser names: they can include up to 31 characters but cannot include the : or @ characters. NetWare print queue names can include up to 47 characters, and cannot include (in addition to : or @) spaces or the / \ ; , * ? % or + characters.The name of a queue used by ATPS is derived from the spooler name by converting special characters and spaces in the spooler name to underscore characters, and converting uppercase and lowercase characters to all uppercase. The queue is created by ATPS if it does not already exist.You must use the -o option to name queues for serial, parallel, or remote printers. Because these printers are not on the AppleTalk network, ATPS cannot use the AppleTalk printer name in the default configuration syntax.See IDREF="FM16947""Turning Off the AppleTalk Print Server: -wb" on page 164 for information about naming queues for serial, parallel, or remote printers.ID="FM12141"Advertising a Queue in a Specified Zone: -oIn NetWare for Macintosh, the internal AppleTalk network is an extended Phase 2 network, which can support multiple zones. A reason for configuring multiple zones on an internal network is to advertise AppleTalk print spoolers in a zone other than the default internal zone. See IDREF="FM34323""Internal Network and Zone Configuration" on page 19 for more information about the internal network.Configuring an AppleTalk print spooler to appear in one of the multiple zones on the internal network is not recommended on AppleTalk internets that support Phase 1 routers. The spooler will not appear reliably to all Macintosh users.To specify the zone in which the AppleTalk print spooler will appear in the Macintosh Chooser, use the -o option with this syntax: -o spooler-name[:izone-name]When you specify a zone name following the spooler name, it must be preceded by a colon character (:). The zone name you specify must be one of the zones of the server's internal AppleTalk network. If a space character appears anywhere in the "spooler-name:izone-name" string, you must enclose the entire string in double-quotes.spooler-name is the name of the AppleTalk print spooler, and izone-name is the name of the internal zone in which the print spooler will be visible. If you don't specify the izone-name parameter, the spooler will always appear in the default zone of the server's internal network (the first zone in the zones list specified for the internal network).For example, assuming that the internal network has been configured with two zones, "Sales" and "Marketing," the following configuration line creates a spooler named "LW_queue," which will appear in the "Marketing" zone: "my-printer:my zone" -o LW_queue:MarketingIf you wish to use the default spooler name ("NW printer-name") but you wish to advertise in a zone other than the default zone of the internal network, you can simply specify the izone-name parameter as follows: printer-name:zone-name -o :izone-nameFor example, the following configuration line creates a spooler named "NW my-printer" which will appear in the "Marketing" zone of the internal network: "my-printer:my zone" -o :MarketingThe queue name will be visible to users of DOS users of the idxid="w5326"book="_idx" docset="nw312" tidref="i5282"Print Queue module as idxid="w5327"book="_idx" docset="nw312" tidref="i4791""NW_MY_PRINTER." idxid="w5328"book="_idx" docset="nw312" tidref="i32"ID="FM35853"Specifying a idxid="w5329"book="_idx" docset="nw312" tidref="i5282"Printer idxid="w5330"book="_idx" docset="nw312" tidref="i5480"Type: idxid="w5331"book="_idx" docset="nw312" tidref="i38"-t idxid="w5332"book="_idx" docset="nw312" tidref="i5482"To create a spooler or specify a printer other than the default LaserWriter type, you must specify the printer type on the configuration line by using the -t option. The -t option requires that you specify a valid NBP type. The default printer types are "LaserWriter" (the default), "ImageWriter," or "LQ." idxid="w5333"book="_idx" docset="nw312" tidref="i5482"The following configuration line sends print jobs to an ImageWriter LQ named "Reports IW" in the "Marketing" zone. "Reports IW:Marketing" -t LQThe AppleTalk print spooler will named "NW Reports IW," and the NetWare queue will be named "NW_REPORTS_IW."If you wish to specify a printer type other than the default printer types, see IDREF="FM39781""AppleTalk Printers That Use a Different NBP Type" on page 162.ID="FM26694"Options for idxid="w5334"book="_idx" docset="nw312" tidref="i5482"Non-Apple idxid="w5335"book="_idx" docset="nw312" tidref="i5282"Printers: -t, -s, -f, and -lThere are two types of non-Apple printers for which you might want to create a queue in ATPS.CFG: (1) printers that are fully compatible with Apple printers, and (2) AppleTalk printers that use a different NBP type. Please turn to IDREF="FM25043""AppleTalk Basics" on page 250 if you would like background information about NBP.Fully Compatible Non-Apple Printers idxid="w5336"book="_idx" docset="nw312" tidref="i5482"For printers that are truly compatible with the Apple LaserWriter, idxid="w5337"book="_idx" docset="nw312" tidref="i5482"ImageWriter, or ImageWriter LQ, you can use the same configuration lines as those shown for the respective Apple printers in this chapter.If the printer is a LaserWriter-compatible PostScript printer, there can be PostScript and TrueType font issues that might cause problems between the Macintosh LaserWriter driver and the printer itself. If you run into problems with PostScript extensions or TrueType fonts, contact the printer manufacturer.ID="FM39781"AppleTalk Printers That Use a Different idxid="w5338"book="_idx" docset="nw312" tidref="i5482"NBP TypeFor third-party printers that use their own Macintosh print software rather than the Apple LaserWriter or ImageWriter drivers, you need to use the Lookup service function in the ATCON utility to determine the printer's NBP type. To do so, follow these steps:Load ATCON at the file server console and choose Lookup and Echo Services in the ATCON menu.Highlight Edit Lookup Parameters and then press <Enter>.When you press <Enter>, a dialog opens.If you know the printer's name, enter the printer's name in the Name field. If you do not know the printer's name, leave the default equals sign (=) in both the Name and Type fields.Highlight the Zone field and press <Enter> to choose the printer's zone.Press <Esc> and answer Yes to use these settings.Use the arrow keys to select Execute Lookup Test in the Available Actions menu, and then press <Enter>.After a few seconds, you should see the results of the Lookup service, where the printer's type (or the types of all printers in that zone) will be displayed. If the Lookup fails, the name of the service won't appear. If no services are available, a message is displayed.If you are creating a queue for a non-Apple printer that is not completely compatible, keep these suggestions in mind:Specify the idxid="w5339"book="_idx" docset="nw312" tidref="i38"printer's NBP type by idxid="w5340"book="_idx" docset="nw312" tidref="i5282"using the -t option on the ATPS configuration line. ATPS uses the NBP printer type you specify both when a user selects an icon in the Chooser (client-to-server lookup), and when the print server ships a print job to the printer (server-to-printer lookup).idxid="w5341"book="_idx" docset="nw312" tidref="i5123"If the printer is a idxid="w5342"book="_idx" docset="nw312" tidref="i5482"PostScript printer, idxid="w5343"book="_idx" docset="nw312" tidref="i5282"use the idxid="w5344"book="_idx" docset="nw312" tidref="i36"-s option on the ATPS configuration line. The -s option informs ATPS that the printer behaves like a LaserWriter, even though its NBP type is different, and that the spooler should behave like a LaserWriter.If the printer is a PostScript printer not on the AppleTalk network, use the-f option to specify a font list for the AppleTalk print spooler, as described in IDREF="FM35138""Specifying a PostScript Font List: -f" on page 156 and IDREF="FM38361""PostScript Font Lists: *.FNT Files" on page 183 for a discussion of font lists.If the printer is a PostScript printer not on AppleTalk, use the-l option to include the Laser Prep file in Macintosh print jobs, as described in IDREF="FM21715""Including Laser Prep Files in All Macintosh Print Jobs: -l" on page 157. For a discussion of Laser Prep files, see IDREF="FM17526""Laser Prep Files: *.PRS" on page 186.For example, to create a print queue for a non-Apple PostScript printer that behaves like a LaserWriter, use this configuration line: printer-name -t printer-type -sThe Macintosh must be running printer software for the third-party printer, as would be true if Macintosh users were printing directly to the printer over idxid="w5345"book="_idx" docset="nw312" tidref="i5482"AppleTalk. idxid="w5346"book="_idx" docset="nw312" tidref="i5482"Potential Problems with Using PSERVER idxid="w5347"book="_idx" docset="nw312" tidref="i5679"with idxid="w5348"book="_idx" docset="nw312" tidref="i5482"idxid="w5349"book="_idx" docset="nw312" tidref="i6233"Serial PrintersConnecting a printer serially via PSERVER instead of over AppleTalk via ATPS can have many disadvantages. Performance will most likely be slower, potentially by a factor of 10, and the communications channel itself is less reliable (data is more likely to contain errors). Additionally, with PostScript printers connected serially via PSERVER, you lose the following capabilities:The ability to send binary PostScript data (see IDREF="FM41272""Technical Note about Printer Communication Channels" on page 169)The ability to print banners before jobsThe reporting of idxid="w5350"book="_idx" docset="nw312" tidref="i5282"PostScript errors idxid="w5351"book="_idx" docset="nw312" tidref="i5482"ID="FM16947"Turning Off the Apple idxid="w5352"book="_idx" docset="nw312" tidref="i5421"Talk Print Server: idxid="w5353"book="_idx" docset="nw312" tidref="i44"-wb idxid="w5354"book="_idx" docset="nw312" tidref="i5282"In NetWare for Macintosh, print queues can be advertised on AppleTalk and serviced by PSERVER to a serial, parallel, or Novell Remote printer. The print queues can also be serviced by third-party print server products.When using ATPS to advertise a queue that is not to be serviced by an AppleTalk printer, you need to "turn off" the AppleTalk print server and configure PSERVER instead. This section describes how to "turn off" the AppleTalk print server.See IDREF="FM14927""Print Server Configuration Options" on page 169 for information on configuring PSERVER.IDREF="FM25963"Figure 7-4 shows how a queue operates when the AppleTalk print server has been disabled:LBL="7-4"ID="FM25963"NetWare Queue with AppleTalk Print Spooler but No AppleTalk Print ServerFILE="n312r089.pbm"To specify a queue such as the one shown in IDREF="FM25963"Figure 7-4, use the -wb option. For example, the following configuration line specifies a spooler for a queue named QUEUE1: -o QUEUE1 -wb -l -f applwntWhen PostScript printers are not on AppleTalk, ATPS cannot query the printer for its font list or Laser Prep version.For PostScript printers, use the-f option to specify a font list for the printer, as described in IDREF="FM35138""Specifying a PostScript Font List: -f" on page 156.For PostScript printers, use the -l option to include the correct Laser Prep file in Macintosh print jobs, as described in IDREF="FM21715""Including Laser Prep Files in All Macintosh Print Jobs: -l" on page 157.ImageWriter and ImageWriter LQ queues can also be serviced by PSERVER if you specify a configuration line like this: -o IW_QUEUE -wb -t ImageWriteror -o LQ_QUEUE -wb -t LQNote that ImageWriter queues do not use the -l option or the -f option, because Laser Prep files and PostScript fonts do not apply. The -c option applies for color idxid="w5355"book="_idx" docset="nw312" tidref="i44"ImageWriters and idxid="w5356"book="_idx" docset="nw312" tidref="i5282"ImageWriter LQs. idxid="w5357"book="_idx" docset="nw312" tidref="i5421"ID="FM39916"Turning Off the AppleTalk idxid="w5358"book="_idx" docset="nw312" tidref="i5438"Print Spooler: idxid="w5359"book="_idx" docset="nw312" tidref="i46"-wf idxid="w5360"book="_idx" docset="nw312" tidref="i5282"In NetWare for Macintosh, you can configure a queue that sends print jobs to a printer on AppleTalk, but does not accept print jobs from the AppleTalk network (Macintosh clients). This enables you to create a queue for an AppleTalk printer that accepts jobs from DOS, Windows, and OS/2 users, as well as other print packages such as NFS PRINT.To specify a queue to be serviced by an AppleTalk printer but not advertised to Macintosh users, you need to "turn off" the AppleTalk print spooler. IDREF="FM20729"Figure 7-5 on page 166 shows how a queue operates when the AppleTalk print spooler has been disabled:LBL="7-5"ID="FM20729"NetWare Queue with AppleTalk Print Server but without the Print SpoolerFILE="n312r090.pbm"To specify a queue such as the one shown in IDREF="FM20729"Figure 7-5, use the -wf option. For example, the following configuration line creates a queue named QUEUE1 for an AppleTalk printer named "LaserWriter1": LaserWriter1 -o QUEUE1 -wfThe-wf option instructs ATPS not to advertise the queue on AppleTalk, but to send its print jobs to the specified printer on the AppleTalk network.Please refer to IDREF="FM27251""Multiple AppleTalk Printers Servicing a Print Queue: -wf" on page 166 for additional uses for the -wf option. idxid="w5361"book="_idx" docset="nw312" tidref="i5438"ID="FM27251"Multiple AppleTalk Printers idxid="w5362"book="_idx" docset="nw312" tidref="i5282"Servicing a idxid="w5363"book="_idx" docset="nw312" tidref="i5482"Print Queue: -wfIn NetWare for Macintosh, a print queue can be serviced by more than one printer.When multiple printers are servicing a print queue, a print job is sent to the first available printer servicing that queue.All of the printers servicing one queue should be of the same printer type; for example, multiple LaserWriters and compatibles, multiple ImageWriters, or multiple ImageWriter LQs. There is no maximum number of AppleTalk printers that can service a single print queue.IDREF="FM15685"Figure 7-6 shows a single print queue being serviced by three LaserWriter NT printers on the AppleTalk network:LBL="7-6"ID="FM15685"One Print Spooler with Multiple AppleTalk PrintersFILE="n312r091.pbm"To configure a queue such as the one shown in IDREF="FM15685"Figure 7-6, create three configuration lines in ATPS.CFG, all using the same queue name. Only one of the configurations will create an AppleTalk print spooler; the other two configuration lines "turn off" the print spooler by using the -wf option. This insures that only one spooler is created for the queue. For example, the following configuration lines create a queue and spooler named QUEUE1, which will be serviced by three AppleTalk printers, named "LaserWriter1," "LaserWriter2,"and "LaserWriter3": LaserWriter1:zone1 -o QUEUE1 -f applwnt LaserWriter2:zone2 -o QUEUE1 -wf LaserWriter3:zone3 -o QUEUE1 -wfThe -f option is recommended when you configure multiple printers to service a single queue. If the printers do not all support the identical set of fonts, you can create a "global" font list, which includes each font that is supported on each and every printer servicing the queue, to ensure that print jobs print correctly on any of the associated printers. (Otherwise, the font list for the queue is obtained by querying the printer configured without -wf for the queue.) See IDREF="FM40373""Creating Specialized Font Files" on page 185 for information about creating a "global" font list.IDREF="FM42204"Figure 7-7 shows a single print queue being serviced by three LaserWriter NT printers, two on the AppleTalk network and one on a direct or remote serial port:LBL="7-7"ID="FM42204"Another Example with Multiple PrintersFILE="n312r092.pbm"To create a queue such as the one shown in IDREF="FM42204"Figure 7-7, create two configuration lines in ATPS.CFG, both of which use the same queue name. Only one of the configuration lines specifies an AppleTalk print spooler, and the other one "turns off" the print spooler by using the -wf option. The following configuration lines create a spooler and a queue named QUEUE1, which will be serviced by two AppleTalk printers named "LaserWriter1" and "LaserWriter2": LaserWriter1:zone1 -o QUEUE1 -f applwnt - LaserWriter2:zone2 -o QUEUE1 -wfThe serial printer that will service this queue must obtain its Laser Prep file along with Macintosh print jobs, so the ATPS.CFG configuration must include the -l option. See IDREF="FM17526""Laser Prep Files: *.PRS" on page 186 for more information.After creating the configuration lines in ATPS.CFG, you must use PCONSOLE to configure PSERVER for the serial printer. Make sure to select the correct queue (named "QUEUE1" in this example) in PCONSOLE. Please see IDREF="FM13176""Creating a Queue for an Apple Printer on a Direct Serial Connection" on page 171 for idxid="w5364"book="_idx" docset="nw312" tidref="i5282"detailed idxid="w5365"book="_idx" docset="nw312" tidref="i5282"idxid="w5366"book="_idx" docset="nw312" tidref="i5282"instructions idxid="w5367"book="_idx" docset="nw312" tidref="i46". idxid="w5368"book="_idx" docset="nw312" tidref="i5282"idxid="w5369"book="_idx" docset="nw312" tidref="i5482"ID="FM14927"Print Server Configuration Optionsidxid="w5370"book="_idx" docset="nw312" tidref="i5282"This idxid="w5371"book="_idx" docset="nw312" tidref="i5425"section describes how to idxid="w5372"book="_idx" docset="nw312" tidref="i5045"use idxid="w5373"book="_idx" docset="nw312" tidref="i324"PCONSOLE idxid="w5374"book="_idx" docset="nw312" tidref="i5482"to configure PSERVER for the following printers:idxid="w5375"book="_idx" docset="nw312" tidref="i5482"An Apple printer connected to a serial port on the server.An Apple printer connected to a DOS workstation.Please refer to IDREF="FM26694""Options for Non-Apple Printers: -t, -s, -f, and -l" on page 161 for suggestions if you are using LaserWriter-compatible PostScript printers.ID="FM41272"Technical Note about idxid="w5376"book="_idx" docset="nw312" tidref="i5476"Printer Communication ChannelsThis section discusses the differences between AppleTalk connections and serial, parallel, or Novell Remote Printer connections. These types of communications channels are shown in IDREF="FM16674"Table 7-3.LBL="7-3" INLINE="F"ID="FM16674"Printer Communication ChannelsWIDTH="108"Type of ConnectionWIDTH="312"Description of Communications ChannelWIDTH="108"AppleTalkWIDTH="312"AppleTalk's Printer Access Protocol (PAP) is a "binary capable"  communications channel, which means that it has ways of handling flow  control, requesting status, and signaling the end of a job which do not  depend on a print job's data stream. A binary capable channel allows all 8- bit characters to be received by the printer.WIDTH="108"Type of ConnectionWIDTH="312"Description of Communications ChannelSerialSerial (RS-232) communication channels may depend on certain control  codes such as X-On/X-Off being sent as part of the data stream. A  PostScript job on an RS-232 channel includes additional control characters  to request printer status (0x14), interrupt the PostScript interpreter (0x3)  or signal the end of a job (0x4). When a serial printer receives a data  stream including control codes, the printer's communications interface  detects the control codes and removes them from the data stream so that  they can be acted upon. This means that the serial channel is not "binary- capable," that is, some data values cannot be received by the printer's  PostScript interpreter because the communications interface will always  intercept them. A serial channel may be configured to use less than 8 bits  of data per character.Parallel or Novell  Remote PrinterCentronix Parallel and Novell Remote Printer communications channels  use 0x4 (Control-D) to signal the end of a job to the PostScript interpreter,  primarily because of the precedent set by the serial channel. This means  that parallel and Remote Printer connections are also not binary capable.Macintosh idxid="w5377"book="_idx" docset="nw312" tidref="i5115"PostScript ApplicationsMost Macintosh applications and drivers generate "Clean8Bit" PostScript data. ("Clean8bit" is a PostScript classification specified by Adobe Systems, Inc. in which the PostScript data does not rely on the binary-capable nature of AppleTalk.)When you use NPRINT to download the SERIAL.PS program to a LaserWriter on a serial channel, the program changes the LaserWriter's interface to accept 8-bit rather than 7-bit data. For all Macintosh applications that produce Clean8Bit data, this program solves problems with character translation or loss of characters that might otherwise be seen on a serial interface.Some Macintosh applications rely on the binary-capable nature of AppleTalk to send bitmap information or other binary data. Although Adobe Systems has developed a standard for safely encoding binary information for transmission across non-binary channels, few printers currently support it.If applications at your site produce binary PostScript data, you should connect the printer via AppleTalk rather than by using a serial or other non-binary connection.ID="FM42682"DOS PostScript idxid="w5378"book="_idx" docset="nw312" tidref="i5115"ApplicationsMany DOS and Windows applications generate PostScript to be sent to a printer across a serial or parallel interface. These applications include the Control-D (0x4) character to signal the end of the job. If this data is sent to a queue serviced by an AppleTalk printer, the Control-D character will be passed to the printer's PostScript interpreter instead of being intercepted by the printer's serial or parallel interface. This can cause PostScript errors or job failures from these applications. ATPS solves this problem by filtering jobs for Control-D characters and replacing them with Printer Access Protocol (PAP) EOFs.Other DOS and Windows applications may generate binary PostScript data, which could use Control-D as data rather than to signal the end of a job. For these applications, you should create a print job configuration using the "PostScript (Binary Graphics)" mode in PRINTCON. See IDREF="FM25534""PostScript Binary Graphics Mode" on page 202 for details. idxid="w5379"book="_idx" docset="nw312" tidref="i5476"ID="FM13176"Creating a idxid="w5380"book="_idx" docset="nw312" tidref="i5282"Queue for an Apple Printer on a idxid="w5381"book="_idx" docset="nw312" tidref="i5482"Direct Serial ConnectionThis example shows how to create a print queue that will be advertised on the AppleTalk network for a LaserWriter NT connected to a serial port on the NetWare v3.12 file server. The example printer setup is shown in IDREF="FM41911"Figure 7-8.LBL="7-8"ID="FM41911"Apple Printer on a Direct Serial ConnectionFILE="n312r093.pbm"To enter a configuration that will be in effect when you load the ATPS module, follow these steps:Load INSTALL and select Product Options in the main INSTALL menu.Press <Enter> on the line specifying NW-MAC v3.12.When you press <Enter>, the Editable Configuration Files menu opens.Use the arrow keys to select ATPS.CFG in the menu and then press <Enter>.Pressing <Enter> opens a text editor window in which you can enter the server's print queue configuration. In the ATPS.CFG text window, enter the following configuration line: -o serial_Q -l -f applwnt -wbIf you are creating an AppleTalk print spooler for an existing NetWare print queue, you enter a configuration line such as the one shown above, specifying the existing queue name. In that case, the name of the existing queue must be 31 characters or less.When you have entered the configuration line in ATPS.CFG, Exit the INSTALL program, saving your changes.Go to a DOS workstation, and log in to the server as supervisor or equivalent.Open PCONSOLE, highlight Print Queue Information in the Available Options menu, and then press <Enter>.To open PCONSOLE, type PCONSOLE at the prompt.Press <Ins> to create a new queue and enter the name for the queue you just created in ATPS.CFG.For this example, type SERIAL_Q.In PCONSOLE, the name of a queue is always upper-case, no matter how you type it, so it is not important that you match upper- and lowercase characters when you type the queue name.Press <Esc>, highlight Print Server Information, and press <Enter>.Press <Ins> to create a new print server and enter a name for the print server you are creating.For this example, type SERIAL_PSRVR (you can specify any valid PCONSOLE name) and then press <Enter>.Press <Enter> again to get to the Print Server Information window for the server you just created.Highlight Print Server Configuration and press <Enter>.Highlight Printer Configuration and press <Enter>.Now you have a list of printers that say "Not Installed."Press <Enter> to define a printer.Enter a name for the printer connected to the server's serial port.Enter a name or leave PRINTER_0 (you can enter any valid PCONSOLE name).Highlight the Type field and press <Enter>.There are four serial choices, one for each possible port on the server. Select the correct choice for the port you used to connect the printer, e.g., COM1.Make sure that you choose Serial rather than Remote Serial.Use the arrow keys to move to the Use Interrupt field.If you know the correct interrupt for the serial port you have chosen, leave "Use Interrupts" as "Yes," and enter the IRQ in the proper field below. Otherwise, choose "No."Unless you have server-specific information that should be added in the next three fields, leave them with the default values.Use the arrow keys to move to the "Baud Rate" field.This and the remaining fields are for information specific to the configuration of your printer's serial interface. For most LaserWriters, the default information will be correct, except for X-ON/X-OFF, which should be turned on. To turn it on,Choose "Yes" in the "Use X-ON/X-OFF" field.If your LaserWriter's serial interface is configured differently, make sure that you change these fields appropriately.See IDREF="FM16569"Figure 7-9 for an example PCONSOLE window.LBL="7-9"ID="FM16569"Example PCONSOLE Window Showing Direct Serial ConnectionFILE="n312r094.pbm"Press <Esc> and say "Yes" to save your changes.Press <Esc> again to leave the configured printer's menu.In the Print Server Configuration menu, highlight "Queues Serviced by Printer" and press <Enter>.The printer you just defined should be listed here.Choose that printer's name and press <Enter>.Press <Ins> to see all queues on the server.Choose SERIAL_Q and press <Enter>.Press <Enter> again in the "Priority" window.Press <Esc> twice and highlight "Notify List for Printer" in the Print Server Configuration menu. Then press <Enter>.You will see a list of defined printers.Select your printer and press <Enter>.Press <Ins> to bring up a list of Notify candidates.Press <Enter> on "Job Owner."Choosing "Job Owner" as a Notify candidate means that the print server will notify the owner of a print job when a printer runs out of paper or goes off-line when processing his or her job.When you press <Enter>, a "Notify Intervals" window opens. Press <Esc> and say "Yes" to save all the changes you have made. If you wish to configure more Notify candidates, press <Ins> and repeat the process. When you have configured the Notify List,Press <Esc> as necessary to exit PCONSOLE.Return to the file server on which the queue was created.At the file server console, type LOAD PSERVER SERIAL_PSRVR <Enter>If ATPS is already running on this server, unload it by typing UNLOAD ATPS <Enter>(Otherwise, skip this step.)Load ATPS by typing LOAD ATPS <Enter>Return to the DOS workstation again.Change directories to SYS:PUBLIC and use NPRINT to send the program "SERIAL.PS" to the queue.The SERIAL.PS program changes the Apple LaserWriter's serial interface to use 8 bits of data rather than 7 bits. This is recommended for Macintosh print jobs. See IDREF="FM41272""Technical Note about Printer Communication Channels" on page 169 for idxid="w5382"book="_idx" docset="nw312" tidref="i5482"details. idxid="w5383"book="_idx" docset="nw312" tidref="i5282"ID="FM17983"Creating a idxid="w5384"book="_idx" docset="nw312" tidref="i5282"Queue for an idxid="w5385"book="_idx" docset="nw312" tidref="i5482"Apple Printer on a Remote DOS WorkstationThis example shows how to create a print queue for a LaserWriter connected to a serial port on a remote DOS workstation. The example printer setup is shown in IDREF="FM34353"Figure 7-10:LBL="7-10"ID="FM34353"Apple Printer on a Remote DOS WorkstationFILE="n312r095.pbm"To enter a configuration that will be in effect when you load the ATPS module, follow these steps:Load INSTALL and select Product Options in the main INSTALL menu.Press <Enter> on the line specifying NW-MAC v3.12.When you press <Enter>, the Editable Configuration Files menu opens.Use the arrow keys to select ATPS.CFG in the menu and then press <Enter>.Pressing <Enter> opens a text editor window in which you can enter the server's print queue configuration. In the ATPS.CFG text window, enter the following configuration line: -o remote_Q -l -f applwnt -wbWhen you have entered this configuration line,Exit the INSTALL program, saving your changes.Go to a DOS workstation, and log in to the server as supervisor or equivalent.Open PCONSOLE, highlight Print Queue Information in the Available Options menu, and then press <Enter>.To open PCONSOLE, type PCONSOLE at the prompt.Press <Ins> to create a new queue and enter the name for the queue you just created in ATPS.CFG.For this example, type REMOTE_Q.In PCONSOLE, the name of a queue is always upper-case, no matter how you type it, so it is not important that you match upper- and lowercase characters when you type the queue name.Press <Esc>, highlight Print Server Information, and press <Enter>.Press <Ins> to create a new print server and enter a name for the print server you are creating.For this example, type any valid PCONSOLE name, such as REMOTE_PSRVR, and then press <Enter>.Press <Enter> again to get to the Print Server Information window for the server you just created.Highlight Print Server Configuration and press <Enter>.Highlight Printer Configuration and press <Enter>.Now you have a list of printers that say "Not Installed."Press <Enter> to define a printer.Enter a name for the printer connected to the remote DOS workstation's serial port.Enter a name or leave PRINTER_0 (you can enter any valid PCONSOLE name).Highlight the Type field and press <Enter>.There are four serial choices, one for each possible port on the server. Select the correct choice for the port you used to connect the printer, e.g., REMOTE COM1.Make sure that you choose Remote Serial rather than Serial.Use the arrow keys to move to the Use Interrupt field.If you know the correct interrupt for the serial port you have chosen, leave "Use Interrupts" as "Yes," and enter the IRQ in the proper field below. Otherwise, choose "No."Unless you have server-specific information that should be added in the next three fields, leave them with the default values.Use the arrow keys to move to the "Baud Rate" field.This and the remaining fields are for information specific to the configuration of your printer's serial interface. For most LaserWriters, the default information will be correct, except for X-ON/X-OFF, which should be turned on. To turn it on,Choose "Yes" in the "Use X-ON/X-OFF" field.If your LaserWriter's serial interface is configured differently, make sure that you change these fields appropriately.LBL="7-11"Example PCONSOLE Window Showing Remote Serial ConnectionFILE="n312r096.pbm"Press <Esc> and say "Yes" to save your changes.Press <Esc> again to leave the configured printer's menu.In the Print Server Configuration menu, highlight "Queues Serviced by Printer" and press <Enter>.The printer you just defined should be listed here.Choose that printer's name and press <Enter>.Press <Ins> to see all queues on the server.Choose REMOTE_Q and press <Enter>.Press <Enter> again in the "Priority" window.Press <Esc> twice and highlight "Notify List for Printer" in the Print Server Configuration menu. Then press <Enter>.You will see a list of defined printers.Select your printer and press <Enter>.Press <Ins> to bring up a list of Notify candidates.Press <Enter> on "Job Owner."Choosing "Job Owner" as a Notify candidate means that the print server will notify the owner of a print job when a printer runs out of paper or goes off-line when processing his or her job.When you press <Enter>, a "Notify Intervals" window opens. Press <Esc> and say "Yes" to save all the changes you have made. If you wish to configure more Notify candidates, press <Ins> and repeat the process. When you have configured the Notify List,Press <Esc> as necessary to exit PCONSOLE.Return to the file server on which the queue was created.At the file server console, type LOAD PSERVER REMOTE_PSRVR <Enter>Return to the remote DOS workstation to which the printer is connected.Modify SHELL.CFG to contain the line SPX=50Reload the NetWare shell to make this change active.Log in as GUEST to the server on which the queue was created.Type RPRINTER at the command line.In the main RPRINTER menu, Select the print server you configured earlier and press <Enter> to open a list of remote printers defined for this print server. Choose the name of the remote printer you defined for this print server and press <Enter>.Exit to DOS.You will see a message indicating that the remote printer has been installed.Return to the file server on which the queue was created.If ATPS is already running on this server, unload it by typing UNLOAD ATPS <Enter>(Otherwise, skip this step.)Load ATPS by typing LOAD ATPS <Enter>Return to a DOS workstation again.Change directories to SYS:PUBLIC and use NPRINT to send the program "SERIAL.PS" to the queue.The SERIAL.PS program changes the Apple LaserWriter's serial interface to use 8 bits of data rather than 7 bits. This is idxid="w5386"book="_idx" docset="nw312" tidref="i5282"recommended for Macintosh idxid="w5387"book="_idx" docset="nw312" tidref="i5045"print jobs. idxid="w5388"book="_idx" docset="nw312" tidref="i5425"See IDREF="FM41272""Technical Note about Printer Communication Channels" on page 169idxid="w5389"book="_idx" docset="nw312" tidref="i5282"for idxid="w5390"book="_idx" docset="nw312" tidref="i5482"idxid="w5391"book="_idx" docset="nw312" tidref="i5482"details. idxid="w5392"book="_idx" docset="nw312" tidref="i324"Managing Print Queues, Font Lists, and Laser Prep FilesThis section describes how to manage print queues. It describes the issues related to PostScript fonts, Laser Prep files, and queue directories in detail. It also lists the ATPS console commands and describes how to view "verbose" messages when troubleshooting a queue. PCONSOLE management tasks are described, including step-by-step instructions for deleting a queue.ID="FM21863"Files and Directories Used by ATPSThe files and directories shown in IDREF="FM22848"Table 7-4 are related to AppleTalk print services.LBL="7-4" INLINE="F"ID="FM22848"ATPS-Related FilesWIDTH="108"File or DirectoryWIDTH="312"ExplanationWIDTH="108"NW-MAC\FONTSWIDTH="312"This directory is created within the server's SYS:SYSTEM directory when    is installed. It contains *.FNT files for the  default font lists (the fonts that are always resident) for Apple LaserWriters.ATPSBy default, this directory is created within the server's SYS:SYSTEM  directory when the ATPS NLM is loaded. It will contain directories for all  NetWare print queues that will be advertised or serviced by the ATPS NLM,  as well as the ATPS.CFG file, described below. If you wish, you can specify  a different name and location for the ATPS directory by using the -D  option when loading the ATPS module.ATPS.CFGThis file resides in the NetWare server's SYS:SYSTEM directory. If you  specify NetWare print queues that will be advertised or serviced by the  ATPS NLM, ATPS.CFG contains an entry for each of these queues. This file  can be created or edited by using the INSTALL utility.*.QDRA *.QDR directory is created in the ATPS directory for each queue created  in the ATPS.CFG file. These directories are used to temporarily store print  jobs when they are submitted to the queue. There must be enough  available disk space to accommodate incoming print jobs on the volume  containing the *.QDR directories.ATPS\*.FNTOne *.FNT file is created in the ATPS directory for each AppleTalk  PostScript printer serviced by a queue created in the ATPS.CFG file. These  files can be created by specifying a font list when creating the queue, or  they can be created automatically when ATPS queries an AppleTalk printer.*.QRYWhen a Macintosh client sends a print job, it sends a ProcSet query to the  spooler to find out whether the printer is initialized with the same version  of the Laser Prep file that is present on the Macintosh. This query is stored  in a *.QRY file in the ATPS directory and used by the ATPS module  whenever it is necessary to query the printer for its Laser Prep version.*.PRSWhen ATPS receives a ProcSet query from a Macintosh client, it checks to  be sure that the current version of the Laser Prep file is stored in the ATPS  directory. All versions of the Laser Prep files are stored in *.PRS files. When  a Macintosh uses a Laser Prep version that ATPS does not have, a new  *.PRS file is created.ID="FM38361"PostScript idxid="w5393"book="_idx" docset="nw312" tidref="i2471"Font idxid="w5394"book="_idx" docset="nw312" tidref="i5282"Lists: idxid="w5395"book="_idx" docset="nw312" tidref="i3178"*.FNT idxid="w5396"book="_idx" docset="nw312" tidref="i2471"Files idxid="w5397"book="_idx" docset="nw312" tidref="i5482"The idxid="w5398"book="_idx" docset="nw312" tidref="i2467"ATPS idxid="w5399"book="_idx" docset="nw312" tidref="i5482"module idxid="w5400"book="_idx" docset="nw312" tidref="i5282"must be able to ascertain which fonts are supported on a PostScript printer that services the queue. If the ATPS module cannot determine a font list for a queue, that queue will not be advertised on AppleTalk.When you install NetWare for Macintosh, the following font list files are copied to SYS:SYSTEM\NW-MAC\FONTS:LBL="7-5" INLINE="F"ID="FM26258"Default Font Files idxid="w5401"book="_idx" docset="nw312" tidref="i2471"WIDTH="120"FilenameWIDTH="192"Font ListWIDTH="120"APPLW.FNTWIDTH="192"Default fonts for the Apple LaserWriter APPLWPLS.FNTDefault fonts for the Apple LaserWriter Plus APPLWNT.FNTDefault fonts for the Apple LaserWriter II NT APPLWNTX.FNTDefault fonts for the Apple LaserWriter II  NTXHPLASER.FNTDefault fonts for the HP Laser Jet family with  installed PostScript optionExcept for APPLW.FNT, all of the font list files listed in IDREF="FM26258"Table 7-5 have the same list of fonts and can be used interchangeably.ATPS can obtain a font list for a queue in one of the following ways:ATPS can query an AppleTalk printer servicing the queue. It then creates a *.FNT file in the ATPS directory containing that printer's current font list. You can use the idxid="w5402"book="_idx" docset="nw312" tidref="i534"ATPSQUERY command to update the font list at any time. Please refer to IDREF="FM29687""Updating AppleTalk Print Spoolers' Font Lists" on page 193 for information about this command.ATPS can use the font list specified on the configuration line (via the -f option). You can specify one of the default font files provided with NetWare for Macintosh, or create a specialized font list. (See IDREF="FM40373""Creating Specialized Font Files" on page 185.)ATPS can query the AppleTalk printer specified on the configuration line and use that printer's font list, even if the queue is serviced by another printer.Issues Related to PostScript FontsEach type of Apple LaserWriter has a set of idxid="w5403"book="_idx" docset="nw312" tidref="i2471"resident fonts available in ROM when you turn on the printer. idxid="w5404"book="_idx" docset="nw312" tidref="i2471"A printer can also support additional fonts that have been downloaded by using a Macintosh idxid="w5405"book="_idx" docset="nw312" tidref="i3642"Font Downloader application, which will be stored in the printer's RAM until the printer is turned off and on again. If the printer supports an external hard disk, downloaded fonts can be stored on the external disk, in which case they are still available after you turn the printer off and on again.Macintosh applications query a printer for its font list and automatically download fonts that are required for the print job but are not currently on the printer. If the required font is not available, a bitmap of the font is sent instead. The printer uses the downloaded fonts only for the current print job.If the spooler does not advertise a font that the printer does have, the spooler will request that the Macintosh application download the font. This will cause unnecessary delays in printing or idxid="w5406"book="_idx" docset="nw312" tidref="i2471"substitution of a bitmap font when a required font is unavailable on the Macintosh. If the spooler advertises a font that the printer does not support, the printer will substitute a default font, usually the monospace Courier font.In NetWare for Macintosh, the "conversation" between the Macintosh application and the printer is handled instead by the ATPS module, which answers the query from the Macintosh application based on its understanding of the printer's font list. The ATPS module must have a font list for each PostScript-capable spooler when the ATPS module is loaded; if it cannot set the spooler's font list, ATPS does not advertise the queues.Recommended Way to Handle PostScript FontsIf an AppleTalk printer is turned off and on again or reset after ATPS has been loaded, or if a Macintosh application downloads a font to the printer's RAM, the queue's font list can become inconsistent with the list of fonts actually supported in the printer.For AppleTalk printers that will support only the default set of resident fonts, you can either allow the ATPS module to query the printer each time it is loaded, or you can specify one of the default *.FNT files on the configuration line in ATPS.CFG. Either way, you do not need to worry about font lists becoming inconsistent over time.For AppleTalk printers that will support fonts other than the default resident fonts, the best way to ensure that a queue's font list is consistent with the printer's font list is to supervise the font download process (using a Macintosh Font Downloader), and then manually update the queue's font list by using the idxid="w5407"book="_idx" docset="nw312" tidref="i534"ATPSQUERYprinter-name command. See IDREF="FM29687""Updating AppleTalk Print Spoolers' Font Lists" on page 193 for information about ATPSQUERY.Fonts should be downloaded directly to the printer, not via a queue.ID="FM40373"Creating Specialized Font FilesIf a standard font file is not applicable for the model of PostScript printer you are using, or your printer has more fonts (for example, due to expansion boards or attached hard disks), you can create your own font file.This is not necessary for printers on AppleTalk, because ATPS retrieves a font list directly from the printer.To create a font list for a PostScript printer connected to the file server's serial or parallel port, follow these steps:Change directories to SYS:PUBLIC.Use NPRINT to send the file named FONTLIST.PS to the queue.FONTLIST.PS is a PostScript file that instructs the printer to print out its list of fonts in the correct format.Use a text editor such as EDIT.NLM to create a font file.Create a new file and type in the list of the printer's fonts as they appear on the printed output.The name of the file must use the ".FNT" extension.The file must be located in SYS:SYSTEM\NW-MAC\FONTS. The last item in the list of fonts must be a single asterisk (*).Lines beginning with a pound-sign character (#) are treated as comments and ignored.Every line must end with a linefeed character (0xA). The EDIT NLM and most DOS text editors use the linefeed character for end-of-line.Standard Macintosh text editors such as TeachText do not use linefeed characters. Font files created idxid="w5408"book="_idx" docset="nw312" tidref="i5482"with these idxid="w5409"book="_idx" docset="nw312" tidref="i5282"editors will idxid="w5410"book="_idx" docset="nw312" tidref="i2471"not be idxid="w5411"book="_idx" docset="nw312" tidref="i2467"read idxid="w5412"book="_idx" docset="nw312" tidref="i5282"correctly idxid="w5413"book="_idx" docset="nw312" tidref="i3178"by idxid="w5414"book="_idx" docset="nw312" tidref="i5482"ATPS. idxid="w5415"book="_idx" docset="nw312" tidref="i2471"ID="FM17526"Laser idxid="w5416"book="_idx" docset="nw312" tidref="i5282"Prep idxid="w5417"book="_idx" docset="nw312" tidref="i5482"Files: idxid="w5418"book="_idx" docset="nw312" tidref="i3178"*.PRS idxid="w5419"book="_idx" docset="nw312" tidref="i3172"Laser Prep files contain a dictionary of idxid="w5420"book="_idx" docset="nw312" tidref="i5114"PostScript "shorthand" commands required by the LaserWriter or LaserWriter-compatible printer. These files are used by the LaserWriter driver on the Macintosh when formatting PostScript print jobs, and are used to initialize the printer with the required commands.The AppleTalk print server must be able to ascertain which idxid="w5421"book="_idx" docset="nw312" tidref="i3172"version of the Laser Prep file is currently supported on the AppleTalk PostScript printer that services a queue, so it can download a new version if a Macintosh print job requires it. It can do so in one of the following ways:When a Macintosh application sends a ProcSet query to determine which version of the Laser Prep file---as reported by ATPS---initialized the printer, ATPS stores the query in files named *.QRY in the ATPS directory. If the printer's Laser Prep file differs from the Laser Prep on the Macintosh, the Macintosh downloads its Laser Prep file, and ATPS stores the Laser Prep file in files named *.PRS in the ATPS directory. ATPS only reports that the Laser Prep file is different if the file is not already stored in the ATPS directory. ATPS can then repeat the process of querying the printer and downloading Laser Prep files for other Macintosh print jobs.ATPS can include the correct version of the Macintosh Laser Prep file with each Macintosh print job, as it is placed on the queue. This is recommended for print queues that are serviced by a print server other than the AppleTalk print server.Aldus Prep files used by Aldus PageMaker are also supported and downloaded as required. idxid="w5422"book="_idx" docset="nw312" tidref="i3172"Issues Related to Laser Prep FilesFor compatibility with the LaserWriter 7.0 driver, ATPS resets AppleTalk printers if they are initialized with a version of Laser Prep other than the one required by the current job. This process takes roughly 30 seconds and it causes the printer to generate its initialization page.Print performance is significantly better if all Macintosh clients accessing a queue use the same version of the Laser Prep file.You can prevent the printer from printing its initialization page when it is reset by following these steps:Change directories to SYS:PUBLIC.Use NPRINT to send the file named NOSTRTPG.PS to the queue.NOSTRTPG.PS is a PostScript file that instructs the printer never to print its initialization page, even if the printer is power-cycled.If you wish to re-enable the initialization page, use these steps:Change directories to SYS:PUBLIC.Use NPRINT to send the file named STRTPGON.PS to the queue.STRTPGON.PS is a PostScript file that instructs the printer to resume printing its initialization page when it is power-cycled or reset.Alternatively, you can send PostScript files to an AppleTalk printer by using a PostScript downloader from a Macintosh workstation.ID="FM37933"Recommended Way to Handle Laser Prep FilesThe best way to handle Laser Prep files is to ensure that all Macintosh clients are running the same version of the LaserWriter software. If one Macintosh on your network uses System 7.0 or later, we recommend that you install the System 7.0 LaserWriter driver(s) on all Macintosh workstations. Please see the Using the NetWare for Macintosh Client guide for details.If you cannot upgrade all Macintosh clients to use the same version of the Laser Prep file, you can allow the ATPS module to handle Laser Prep versions for AppleTalk printers. When a Macintosh application requires a different Laser Prep version than the one that initialized the printer, ATPS automatically downloads the correct version to the printer. While this causes a print performance penalty, the delay is experienced by the AppleTalk print server rather than the print spooler, so users are not seriously affected.For serial, parallel, or remote printers, the recommended way to handle Laser Prep files is to instruct the print spooler to include the correct Laser Prep file in each Macintosh print job as it is placed on the queue. You can do this by using the -l option on the configuration line in ATPS.CFG. The -l option causes ATPS to download the correct Macintosh Laser Prep file with each job it places in the queue.For queues serviced by PSERVER, ATPS cannot guarantee the success of print jobs sent from Macintosh workstations running different versions of the LaserWriter driver software.You can avoid the performance penalty caused by the -l option by following these steps:Verify that all Macintosh users who can access the queue are using the same version of the Laser Prep file.Specify the -l option on the configuration line in ATPS.CFG, and then unload and load ATPS.Send a print job to the queue from a Macintosh workstation.This step creates a Laser Prep file on the server. The Laser Prep file uses the ".PRS" filename extension and is located in the ATPS directory (SYS:SYSTEM\ATPS by default).Remove the -l option from the configuration line in the ATPS.CFG file, and then unload and load ATPS.Load ATPS again.The preceding five steps avoid downloading the Laser Prep file with each Macintosh print job, but they handle the Laser Prep file management only until the printer is turned off. If you decide to use this method, you can repeat the above steps each time the printer is power-cycled.If you prefer fewer steps, you can use the following method instead:Use NPRINT to send the Laser Prep file to the queue.After the printer has been turned off and on again, you can use the NPRINT program from a DOS workstation to download the idxid="w5423"book="_idx" docset="nw312" tidref="i5482"Laser Prep file idxid="w5424"book="_idx" docset="nw312" tidref="i5282"SYS:SYSTEM\ATPS\*.PRS to the idxid="w5425"book="_idx" docset="nw312" tidref="i3178"printer. idxid="w5426"book="_idx" docset="nw312" tidref="i3172"ID="FM11216"ID="FM40379"Queue Directories: idxid="w5427"book="_idx" docset="nw312" tidref="i5282"*.QDRThe first time you load the ATPS module, it reads ATPS.CFG and may create print queue directories named *.QDR in the ATPS directory. The queue directory name is the queue's idxid="w5428"book="_idx" docset="nw312" tidref="i5282"unique idxid="w5429"book="_idx" docset="nw312" tidref="i4788"bindery object ID (which you can view in PCONSOLE as the print queue ID) followed by the .QDR filename extension.Each queue directory will contain the print jobs spooled to that queue. Each print job resides in the queue as an ordinary file. DOS users can place print jobs in ATPS queues even when the ATPS module is not loaded. (Of course, the print jobs are not sent to an Apple printer until you load the ATPS module again.)Purging Old Print Jobs from a idxid="w5430"book="_idx" docset="nw312" tidref="i5282"Queue DirectoryWhen the AppleTalk print server sends a print job from a queue to a printer, it deletes the file from the queue directory. Because NetWare keeps deleted files on the disk until they are old enough to be "purged," it is possible for print queue directories to use up all available disk space very rapidly. To prevent this condition, you should instruct NetWare to immediately purge deleted files by using the FLAGDIR command: FLAGDIR SYS:SYSTEM\ATPS\*.QDR P <Enter>where "SYS:SYSTEM\ATPS" is the directory containing the queue directories. (If you use the -D option to place the queue directories in another location, substitute that pathname.)idxid="w5431"book="_idx" docset="nw312" tidref="i5282"The FLAGDIR command marks all queue directories for immediate purging when their files are deleted. (Of course, files that have been printed from the queue are not recoverable after you use this command.)ID="FM36084"Specifying an Alternative idxid="w5432"book="_idx" docset="nw312" tidref="i17"Location for idxid="w5433"book="_idx" docset="nw312" tidref="i324"Queue Directories idxid="w5434"book="_idx" docset="nw312" tidref="i5282"If you wish to designate a different volume and/or directory in which to store ATPS queues and other files, you can use the -D option on the LOAD command line. For example, you might enter this command line: LOAD ATPS -D PROJ:NW\PRINTThis command line creates a directory named PRINT below an existing directory named NW on the PROJ volume. The PRINT subdirectory need not exist. However, no harm is done if it does exist; it will simply contain ATPS queues. The idxid="w5435"book="_idx" docset="nw312" tidref="i4783"NW directory must already exist.Once you have specified a location by using the -D option, ATPS uses that directory until you change the directory with the -D option again.If you use the -D option to specify a new location after you have specified queues in SYS:SYSTEM\ATPS or another directory, you must idxid="w5436"book="_idx" docset="nw312" tidref="i5045"delete the existing queues in PCONSOLE; otherwise, ATPS cannot create new queues in the specified location. See IDREF="FM31014""Deleting Print Queues" on page 194.Queues idxid="w5437"book="_idx" docset="nw312" tidref="i5282"that are created using PCONSOLE are accessible to and usable by ATPS, but they are always located in SYS:SYSTEM. idxid="w5438"book="_idx" docset="nw312" tidref="i5282"ID="FM20159"Verbose idxid="w5439"book="_idx" docset="nw312" tidref="i3839"Mode: idxid="w5440"book="_idx" docset="nw312" tidref="i324"Viewing idxid="w5441"book="_idx" docset="nw312" tidref="i42"Troubleshooting idxid="w5442"book="_idx" docset="nw312" tidref="i324"idxid="w5443"book="_idx" docset="nw312" tidref="i1848"Messages idxid="w5444"book="_idx" docset="nw312" tidref="i1848"idxid="w5445"book="_idx" docset="nw312" tidref="i1848"ATPS idxid="w5446"book="_idx" docset="nw312" tidref="i5482"prints idxid="w5447"book="_idx" docset="nw312" tidref="i5282"error idxid="w5448"book="_idx" docset="nw312" tidref="i42"messages to the console and to the system log file. See IDREF="FM27736""Viewing System and Volume Messages in the Log Files" on page 283 for information about viewing these messages by using the idxid="w5449"book="_idx" docset="nw312" tidref="i482"ATCON utility.If you wish to see informational messages generated by ATPS, you should turn on idxid="w5450"book="_idx" docset="nw312" tidref="i7280""Verbose Mode." In Verbose Mode, the ATPS module creates its own window, which can be viewed by pressing <Alt>+<Esc> at the console, and displays informational as well as standard error messages. ATPS also prints the messages to the system log file, so you can view them again at a later time.You might want to turn on Verbose Mode if, for example, if you are creating a print queue for a non-Apple printer and need more explicit information about what is occurring between the queue and the printer. You can turn on Verbose Mode by unloading the ATPS module and loading it again with the -V option: LOAD ATPS -V <Enter>If you prefer, you can use the "ATPSV ON" and "ATPSV OFF" console commands to turn Verbose Mode on and off. See IDREF="FM13509""ATPS Console Commands" on page 191 for more information.Verbose mode consumes disk space by writing many more messages to SYS$LOG.ERR. We recommend that you use Verbose Mode to troubleshoot problems and verify correct operation when loading, but turn it off for normal operations.ID="FM13509"ATPS Console idxid="w5451"book="_idx" docset="nw312" tidref="i324"CommandsATPS supports several new console commands for managing printers and queues.Turning AppleTalk idxid="w5452"book="_idx" docset="nw312" tidref="i5438"idxid="w5453"book="_idx" docset="nw312" tidref="i5438"Print Spoolers Off and OnThe following commands turn off the specified AppleTalk print spooler (or all AppleTalk print spoolers), causing the print spooler to disappear from the Chooser:  idxid="w5454"book="_idx" docset="nw312" tidref="i324"ATPSREM spooler-name  idxid="w5455"book="_idx" docset="nw312" tidref="i536"ATPSREM ALLThe ATPSREM command is useful for halting printing before unloading ATPS or downing the server, or temporarily making a queue invisible to Macintosh clients. Printing in progress continues uninterrupted, but no new print jobs are accepted.The following commands re-enable the specified AppleTalk print spooler (or all AppleTalk print spoolers), causing it to reappear in the Chooser:  idxid="w5456"book="_idx" docset="nw312" tidref="i538"ATPSRES spooler-name  idxid="w5457"book="_idx" docset="nw312" tidref="i324"ATPSRES ALLHiding Printers and idxid="w5458"book="_idx" docset="nw312" tidref="i5482"idxid="w5459"book="_idx" docset="nw312" tidref="i5482"Making Them Visible AgainThe following commands hide the specified AppleTalk printer (LaserWriter, LaserWriter-compatible, ImageWriter, or ImageWriter LQ printer on the network) by changing the device's NBP type:  idxid="w5460"book="_idx" docset="nw312" tidref="i324"ATPSHIDE printer-name  idxid="w5461"book="_idx" docset="nw312" tidref="i531"ATPSHIDE ALLThe following commands reverse the effect of "hiding" printers and make the specified printer (or all AppleTalk printers) visible again on the network:  idxid="w5462"book="_idx" docset="nw312" tidref="i540"ATPSSHOW printer-name  idxid="w5463"book="_idx" docset="nw312" tidref="i324"ATPSSHOW ALLATPS automatically attempts to restore hidden printers upon unloading. However, hidden printers remain hidden if the server is downed or turned off without first unloading ATPS. You can make a printer visible again by turning it off and on. In addition, hidden printers may slow the process of unloading ATPS, particularly if the hidden printers are processing jobs or off-line at the time of unloading. Allow up to 90 seconds per hidden printer when unloading ATPS. If the printer is still busy or unreachable after this time, the printer will not be restored. Power-cycle the printer to restore it.Turning On idxid="w5464"book="_idx" docset="nw312" tidref="i7280"Verbose ModeThe following commands turn Verbose Mode on or off:  idxid="w5465"book="_idx" docset="nw312" tidref="i324"ATPSV ON ATPSV OFFVerbose mode consumes disk space by writing messages to SYS$LOG.ERR, so it is recommended only for troubleshooting or verifying operations. See IDREF="FM20159""Verbose Mode: Viewing Troubleshooting Messages" on page 190 for more information and an alternative way to use Verbose Mode.ID="FM29687"Updating AppleTalk Print Spoolers' idxid="w5466"book="_idx" docset="nw312" tidref="i2467"Font Lists idxid="w5467"book="_idx" docset="nw312" tidref="i534"The following commands cause ATPS to update the font list used by the AppleTalk print spooler.  idxid="w5468"book="_idx" docset="nw312" tidref="i324"ATPSQUERY printer-name ATPSQUERY spooler-name ATPSQUERY ALLidxid="w5469"book="_idx" docset="nw312" tidref="i5477"The ATPSQUERYprinter-name command queries the printer for its current font list and informs the relevant spooler of that list.idxid="w5470"book="_idx" docset="nw312" tidref="i6448"The ATPSQUERYspooler-name command has the same effect, but it will query the printer associated with the specified AppleTalk print spooler.If you wish to force an update of all font lists for all AppleTalk spoolers, type ATPSQUERY ALL. idxid="w5471"book="_idx" docset="nw312" tidref="i324"Managing idxid="w5472"book="_idx" docset="nw312" tidref="i5482"Queues idxid="w5473"book="_idx" docset="nw312" tidref="i5425"in idxid="w5474"book="_idx" docset="nw312" tidref="i324"PCONSOLE idxid="w5475"book="_idx" docset="nw312" tidref="i5282"idxid="w5476"book="_idx" docset="nw312" tidref="i5045"In idxid="w5477"book="_idx" docset="nw312" tidref="i5045"addition idxid="w5478"book="_idx" docset="nw312" tidref="i5282"to the steps shown in the preceding sections for installing printers, configuring queues, and configuring print servers, you will also use PCONSOLE for general administration tasks and for the configuration options described in the following sections. Any user can invoke PCONSOLE, but much of its functionality is accessible only to the supervisor or to a user designated as a idxid="w5479"book="_idx" docset="nw312" tidref="i5282"Queue idxid="w5480"book="_idx" docset="nw312" tidref="i5723"Operator. idxid="w5481"book="_idx" docset="nw312" tidref="i5723"When you are using PCONSOLE, make sure that you do not delete the idxid="w5482"book="_idx" docset="nw312" tidref="i324"ATPS_PSRVR idxid="w5483"book="_idx" docset="nw312" tidref="i525"or idxid="w5484"book="_idx" docset="nw312" tidref="i324"ATPS_QUSER idxid="w5485"book="_idx" docset="nw312" tidref="i527"object from queues that have an entry in ATPS.CFG while ATPS is running. If you remove the ATPS_PSRVR object, AppleTalk printers cannot service the queue. If you remove the ATPS_QUSER object, Macintosh users continue to see the queue advertised in the Chooser, but cannot place print jobs in the queue. Likewise, do not delete queues spooled to or serviced by ATPS while ATPS is running.Please see NetWare v3.12 Installation for details on using PCONSOLE for the tasks described below.Adding Queue Users idxid="w5486"book="_idx" docset="nw312" tidref="i5736"In NetWare print services, DOS users must log in to a file server and be designated as a Queue User (individually or by their group) to access its queues. You can associate any number of Queue Users with a queue, and can delete a Queue User to prevent that particular user from accessing a queue.idxid="w5487"book="_idx" docset="nw312" tidref="i5282"Typically, idxid="w5488"book="_idx" docset="nw312" tidref="i5736"Macintosh users can access a queue by selecting its spooler in the Chooser, and they do not need to log in to the file server. Because placing a job in the queue involves writing to the file system, ATPS creates a single bindery object named ATPS_QUSER with rights to add jobs to the queue.If you configure a print queue with the -a option in ATPS.CFG, Macintosh users must be designated as Queue Users in PCONSOLE. By default, the group EVERYONE is designated as a Queue User, so members of that group can print to a queue.Viewing a Print Queue's Object ID idxid="w5489"book="_idx" docset="nw312" tidref="i4788"idxid="w5490"book="_idx" docset="nw312" tidref="i5282"You can use the queue's object ID to determine which queue directory implements the queue. Please see IDREF="FM11216""Queue Directories: *.QDR" on page 189 for background information.Adding idxid="w5491"book="_idx" docset="nw312" tidref="i5723"Queue Operators idxid="w5492"book="_idx" docset="nw312" tidref="i5282"Designating DOS users, Macintosh users, or both as Queue Operators enables them to modify the queue, including idxid="w5493"book="_idx" docset="nw312" tidref="i5210"deleting, idxid="w5494"book="_idx" docset="nw312" tidref="i5210"postponing, and idxid="w5495"book="_idx" docset="nw312" tidref="i5210"changing the order of all queue jobs idxid="w5496"book="_idx" docset="nw312" tidref="i5210"visible in the NetWare DA. Please see NetWare v3.12 Installation for details on using PCONSOLE to designate idxid="w5497"book="_idx" docset="nw312" tidref="i5723"Queue Operators idxid="w5498"book="_idx" docset="nw312" tidref="i5723".ID="FM31014"Deleting Print Queues idxid="w5499"book="_idx" docset="nw312" tidref="i5045"idxid="w5500"book="_idx" docset="nw312" tidref="i5282"ATPS creates idxid="w5501"book="_idx" docset="nw312" tidref="i5425"print queues, but does not delete them. To remove all traces of a print queue specified in ATPS.CFG, you must remove the configuration line from ATPS.CFG and delete the idxid="w5502"book="_idx" docset="nw312" tidref="i5482"print queue in idxid="w5503"book="_idx" docset="nw312" tidref="i5045"PCONSOLE. idxid="w5504"book="_idx" docset="nw312" tidref="i324"Please see idxid="w5505"book="_idx" docset="nw312" tidref="i4450"NetWare v3.12 Installation for details on using idxid="w5506"book="_idx" docset="nw312" tidref="i5045"PCONSOLE idxid="w5507"book="_idx" docset="nw312" tidref="i5282"to delete print idxid="w5508"book="_idx" docset="nw312" tidref="i5045"queues. idxid="w5509"book="_idx" docset="nw312" tidref="i5282"DOS Printing to Apple Printers idxid="w5510"book="_idx" docset="nw312" tidref="i1667"This section describes the DOS print utilities used to send print jobs to a queue, and the NetWare v3.12 utilities used to create the required forms, printer definitions, and print job configurations for DOS users. These NetWare v3.12 utilities are described in IDREF="FM30324"Table 7-6.LBL="7-6" INLINE="F"ID="FM30324"UtilitiesWIDTH="108"Utility NameWIDTH="312"FunctionalityWIDTH="108"PRINTDEFWIDTH="312"PRINTDEF imports printer definitions (.PDF files) and forms to the network  printer database ( idxid="w5511"book="_idx" docset="nw312" tidref="i4090"NET$PRN.DAT).PRINTCON idxid="w5512"book="_idx" docset="nw312" tidref="i5452"PRINTCON creates print job configurations and adds them to a user's  individual print job database (PRINTCON.DAT).idxid="w5513"book="_idx" docset="nw312" tidref="i903"CAPTURE and idxid="w5514"book="_idx" docset="nw312" tidref="i4747"NPRINT: DOS PrintingDOS users print to NetWare print queues by using the CAPTURE or NPRINT commands. These commands use print information stored in two databases on the server. When the user sends a print job to a NetWare queue, these commands access the print information dynamically and provide it as a header to the print job. The two databases are described in IDREF="FM36758"Table 7-7.LBL="7-7" INLINE="F"ID="FM36758"DOS Print Services DatabasesWIDTH="108"Database NameWIDTH="312"Database DescriptionWIDTH="108"NET$PRN.DAT idxid="w5515"book="_idx" docset="nw312" tidref="i4090"WIDTH="312"This database, located below SYS:SYSTEM, contains printer definitions  (.PDF files) and at least one "print form." See IDREF="FM10725""PRINTDEF: Printer  Definitions and Print Forms" on page 196 for information on updating this  database to contain information related to Apple printers.PRINTCON.DAT idxid="w5516"book="_idx" docset="nw312" tidref="i5452"This database, located in each DOS user's MAIL directory, contains print  job configurations for that user. IDREF="FM33431""PRINTCON: Creating Print Job  Configurations for Apple Printers" on page 198 provides examples.In addition to using these databases, the DOS client must allocate memory for the CAPTURE command to store the header information obtained from these databases. To assign the required memory, add this line to the client's idxid="w5517"book="_idx" docset="nw312" tidref="i6333"SHELL.CFG file: PRINT HEADER = 255When a DOS client loads the NetWare shell, it reads the SHELL.CFG file, which must be located in the same directory that contains the network software NETx.COM. If the client does not have a SHELL.CFG file, you must create one in the directory that is invoked from idxid="w5518"book="_idx" docset="nw312" tidref="i4590"NETx.COM. Please refer to the NetWare v3.12 Installation manual for DOS client idxid="w5519"book="_idx" docset="nw312" tidref="i4747"issues. idxid="w5520"book="_idx" docset="nw312" tidref="i903"ID="FM10725"PRINTDEF: idxid="w5521"book="_idx" docset="nw312" tidref="i324"Printer idxid="w5522"book="_idx" docset="nw312" tidref="i324"Definitions idxid="w5523"book="_idx" docset="nw312" tidref="i4452"and idxid="w5524"book="_idx" docset="nw312" tidref="i4444"Print idxid="w5525"book="_idx" docset="nw312" tidref="i5455"Forms idxid="w5526"book="_idx" docset="nw312" tidref="i5482"idxid="w5527"book="_idx" docset="nw312" tidref="i5282"To idxid="w5528"book="_idx" docset="nw312" tidref="i5282"enable idxid="w5529"book="_idx" docset="nw312" tidref="i5425"users to idxid="w5530"book="_idx" docset="nw312" tidref="i5455"print to idxid="w5531"book="_idx" docset="nw312" tidref="i5455"both types of idxid="w5532"book="_idx" docset="nw312" tidref="i5482"Apple idxid="w5533"book="_idx" docset="nw312" tidref="i5182"printer (LaserWriters and ImageWriters), you idxid="w5534"book="_idx" docset="nw312" tidref="i4090"need to idxid="w5535"book="_idx" docset="nw312" tidref="i211"import idxid="w5536"book="_idx" docset="nw312" tidref="i5482"Apple printer definitions to the idxid="w5537"book="_idx" docset="nw312" tidref="i4090"NET$PRN.DAT database. These printer definitions are ".PDF" files, which should be located in the SYS:\PUBLIC directory on each NetWare v3.11 file server.If you have already created a form called Normal, you do not need to create special forms for the Apple printers. The only requirement is that at least one print form exist.To import the required printer definitions and (if necessary) create a print form, log in to the particular server as a supervisor at a DOS workstation and follow these steps:Run PRINTDEF, choose Print Devices in the main menu, and then press <Enter>.To open PRINTDEF, type PRINTDEF at the DOS prompt.When PRINTDEF prompts you for the source directory containing the printer definition,Type SYS:PUBLIC at the prompt and press <Enter>.If you have printer definition updates from Novell, or printer definition files for non-Apple printers you wish to use with the ATPS module, type the location of those files and press <Enter>.Choose Import Print Definitions in the next menu.A list of .PDF files opens.Import the Apple printer definitions by selecting APPIMAGE.PDF, APPLASER.PDF, and PSTSCRPT.PDF, and pressing <Enter>.Press <Esc> as necessary to back out to the initial PRINTDEF menu.If you need to create the idxid="w5538"book="_idx" docset="nw312" tidref="i5182"Normal print form, complete the rest of these steps; otherwise, press <Esc> again to exit PRINTDEF.Choose Forms in the main menu, and then press <Enter>.Press <Insert> to open the idxid="w5539"book="_idx" docset="nw312" tidref="i2491"Forms Definition Form:FILE="n312r097.pbm"Enter the values shown in IDREF="FM31293"Table 7-8 to create the Normal print form.LBL="7-8" INLINE="F"ID="FM31293"Normal Print Form ValuesWIDTH="108"ValueWIDTH="312"ApplicationWIDTH="108"NormalWIDTH="312"The Normal form is associated with all Macintosh print jobs.0If no other forms exist on this server, the default number is 0. Leave this  number as is, or type another number less than or equal to 255.66This number specifies the number of lines on a standard page.80This number specifies the maximum number of characters on a line of a  standard page.Press <Esc> to exit the Forms Definition Form, idxid="w5540"book="_idx" docset="nw312" tidref="i5182"and idxid="w5541"book="_idx" docset="nw312" tidref="i5182"answer idxid="w5542"book="_idx" docset="nw312" tidref="i5455""Yes" idxid="w5543"book="_idx" docset="nw312" tidref="i5455"when idxid="w5544"book="_idx" docset="nw312" tidref="i5482"PRINTDEF idxid="w5545"book="_idx" docset="nw312" tidref="i5482"prompts idxid="w5546"book="_idx" docset="nw312" tidref="i4090"you idxid="w5547"book="_idx" docset="nw312" tidref="i211"to idxid="w5548"book="_idx" docset="nw312" tidref="i5282"save idxid="w5549"book="_idx" docset="nw312" tidref="i5482"your idxid="w5550"book="_idx" docset="nw312" tidref="i5455"changes. idxid="w5551"book="_idx" docset="nw312" tidref="i324"ID="FM33431"PRINTCON: idxid="w5552"book="_idx" docset="nw312" tidref="i5441"Creating idxid="w5553"book="_idx" docset="nw312" tidref="i324"Print idxid="w5554"book="_idx" docset="nw312" tidref="i5482"Job idxid="w5555"book="_idx" docset="nw312" tidref="i5282"Configurations idxid="w5556"book="_idx" docset="nw312" tidref="i5425"idxid="w5557"book="_idx" docset="nw312" tidref="i5425"for idxid="w5558"book="_idx" docset="nw312" tidref="i5210"Apple idxid="w5559"book="_idx" docset="nw312" tidref="i5482"Printers idxid="w5560"book="_idx" docset="nw312" tidref="i324"idxid="w5561"book="_idx" docset="nw312" tidref="i5441"Each idxid="w5562"book="_idx" docset="nw312" tidref="i5210"DOS user idxid="w5563"book="_idx" docset="nw312" tidref="i5210"has access to one or more print job configurations, which are stored in the idxid="w5564"book="_idx" docset="nw312" tidref="i5452"PRINTCON.DAT database located in each user's MAIL directory. The queue specification in the print job configuration determines to which queue the user's print job(s) are sent. DOS users can invoke PRINTCON to modify the job configuration you install for them; for example, they can modify the job configuration to print to a different print queue.For an Apple ImageWriter, the print job configuration must specify "characters-per-inch" (CPI). See IDREF="FM28414""Apple ImageWriter" on page 204.For an Apple LaserWriter, the print job configuration can specify PostScript, PostScript Binary Graphics (for applications that generate binary PostScript), Diablo 630 (for applications that don't support PostScript), or PostText (for printing ASCII text on a PostScript printer).To create a print job configuration, log in as a supervisor from a DOS client and follow these steps:Open PRINTCON, choose Edit Print Job Configurations in the main menu, and then press <Enter>.To open PRINTCON, type PRINTCON at the DOS prompt.When you press <Enter>, a list of available configurations opens. If you have not defined any print job configurations, the window will be empty.To create a new print job configuration, press <Ins>. A dialog box displays, enabling you to enter a name for the new configuration. You should always name the job configuration so that it is easily identifiable.After you name a new print job configuration, the main dialog box appears, where you can enter the values pertinent to the print job you are creating. The fields in the main PRINTCON dialog box are explained in IDREF="FM28421"Table 7-9.LBL="7-9" INLINE="F"ID="FM28421"Fields in the PRINTCON DialogWIDTH="108"Field TitleWIDTH="312"ExplanationWIDTH="108"Number of copiesWIDTH="312"The value in this field defaults to 1. You can type a higher number here for  DOS print jobs that require idxid="w5565"book="_idx" docset="nw312" tidref="i5210"multiple copies. (Note that when a Macintosh  user chooses to send multiple copies of a print job, the system considers it  a single print job, so this number is always 1 for Macintosh print jobs.)File contentsIf set to "text," the AppleTalk print server will search out and expand tabs.  PostScript jobs should use "byte stream."Tab sizeThis field sets the number of spaces to use to expand tab characters if the  file contents are set to "text."Suppress form feedATPS ignores this field. Set this field to "Yes" for PostScript printers  connected through PSERVER.Notify when doneThe value in this field defaults to No. You can type "Y" here if you wish  DOS users to be notified when their print job has printed, when the printer  is out of paper, or when the printer encounters errors in the print job.Local printerThe value in this field defaults to 1, for LPT1. You can use this value with  the DOS CAPTURE command to idxid="w5566"book="_idx" docset="nw312" tidref="i5210"reroute idxid="w5567"book="_idx" docset="nw312" tidref="i5282"command-line print directions,  such as "dir > lpt1," to the ATPS queue.Auto endcapThe value in this field defaults to No. You can type "Y" here if you wish the  DOS CAPTURE command to automatically quit after sending a print job.File server idxid="w5568"book="_idx" docset="nw312" tidref="i5210"The value in this field defaults to the server you are currently logged in to.  The field must be set to the name of a file server that loads the ATPS  module and supports a print queue serviced by the ATPS print server. If  necessary, you can press <Enter> to select another file server.Print queue idxid="w5569"book="_idx" docset="nw312" tidref="i5282"idxid="w5570"book="_idx" docset="nw312" tidref="i5210"The value in this field must show the name of the print queue to which this  job is being sent. Press <Enter> to display a list of queues on the current  file server. Of course, you must configure the queue you select for the right  type of printer (LaserWriter or ImageWriter) and choose the proper printer  definition in the "Device" field described below.Print server idxid="w5571"book="_idx" docset="nw312" tidref="i5210"idxid="w5572"book="_idx" docset="nw312" tidref="i5421"The value in this field defaults to (Any). This field can be used to choose  between the AppleTalk print server and other print servers.Deviceidxid="w5573"book="_idx" docset="nw312" tidref="i5210"Press <Enter> to open the list of available printer types, and choose Apple  LaserWriter, Apple ImageWriter, or PostScript printer.WIDTH="108"Field TitleWIDTH="312"ExplanationMode idxid="w5574"book="_idx" docset="nw312" tidref="i5482"idxid="w5575"book="_idx" docset="nw312" tidref="i5210"Press <Enter> to open the Modes menu, and choose the appropriate mode  for this print job configuration. For an idxid="w5576"book="_idx" docset="nw312" tidref="i5482"Apple LaserWriter, the mode will  always be idxid="w5577"book="_idx" docset="nw312" tidref="i5120"PostScript, idxid="w5578"book="_idx" docset="nw312" tidref="i3178"PostScript idxid="w5579"book="_idx" docset="nw312" tidref="i3178"(Binary Graphics), idxid="w5580"book="_idx" docset="nw312" tidref="i1412"Diablo 630 idxid="w5581"book="_idx" docset="nw312" tidref="i3178", or idxid="w5582"book="_idx" docset="nw312" tidref="i5118"PostText  with a "CPI" (characters per inch) or Diablo 630 specification. For an Apple  ImageWriter, the mode is a idxid="w5583"book="_idx" docset="nw312" tidref="i2772"CPI specification.Form nameATPS ignores this field.Print banneridxid="w5584"book="_idx" docset="nw312" tidref="i654"The value in this field defaults to idxid="w5585"book="_idx" docset="nw312" tidref="i5282"No. You can type "Y" here idxid="w5586"book="_idx" docset="nw312" tidref="i5210"if you wish to idxid="w5587"book="_idx" docset="nw312" tidref="i5441"print banner pages for DOS print jobs on AppleTalk printers. when printing  to PSERVER-connected PostScript printers from DOS, leave the default  "No."NameThe value in this field defaults to the DOS user's login name. It is the name  that appears in PCONSOLE, the NetWare DA, and on the banner page.Banner file idxid="w5588"book="_idx" docset="nw312" tidref="i653"If idxid="w5589"book="_idx" docset="nw312" tidref="i5210"you enter a name here, the print server includes the name as a "tag" on  each banner page to identify the job. By default, the "tag" name is the  name of the file being printed.Timeoutidxid="w5590"book="_idx" docset="nw312" tidref="i903"The value in this field defaults to No. If you type "Y" in this field, NetWare  assumes a idxid="w5591"book="_idx" docset="nw312" tidref="i1666"DOS CAPTURE print job is finished if it hasn't received any input  for the specified number of seconds.Timeout countThe value in this field specifies the number of seconds DOS CAPTURE waits  if timeout is enabled. idxid="w5592"book="_idx" docset="nw312" tidref="i5441"idxid="w5593"book="_idx" docset="nw312" tidref="i5441"Once idxid="w5594"book="_idx" docset="nw312" tidref="i5210"you create a print job configuration, you can use PRINTCON to copy it to other DOS users (provided that you are logged in as supervisor or equivalent) by following these steps:Press <Esc> to return to the initial PRINTCON menu.Choose Copy Print Job Configurations, and press <Enter>.This action brings up a dialog box labeled "Source User."Type the name of the user whose print job configuration file you want to copy---for example, SUPERVISOR--- and press <Enter>.This action brings up a dialog box labeled "Target User."Type the name of the user for whom you are copying the print job configuration file and press <Enter>.Repeat these steps for each user who needs a copy of the configuration file, and then exit PRINTCON idxid="w5595"book="_idx" docset="nw312" tidref="i5210"by pressing <Esc>. idxid="w5596"book="_idx" docset="nw312" tidref="i5441"idxid="w5597"book="_idx" docset="nw312" tidref="i5452"If you need to idxid="w5598"book="_idx" docset="nw312" tidref="i5210"modify fields for an individual user, you must log in as that user and invoke PRINTCON. Alternatively, individual DOS users can create or modify their own print job configurations.Please refer to idxid="w5599"book="_idx" docset="nw312" tidref="i4451"NetWare v3.12System Administration for more details about PRINTCON.ID="FM39073"Apple idxid="w5600"book="_idx" docset="nw312" tidref="i5210"LaserWriter in idxid="w5601"book="_idx" docset="nw312" tidref="i3178"PostScript idxid="w5602"book="_idx" docset="nw312" tidref="i3178"Mode idxid="w5603"book="_idx" docset="nw312" tidref="i5482"IDREF="FM10122"Figure 7-12 shows a sample print job configuration for an Apple LaserWriter in PostScript mode. DOS or Windows applications must support PostScript and a LaserWriter driver.LBL="7-12"ID="FM10122"Example PRINTCON idxid="w5604"book="_idx" docset="nw312" tidref="i5120"Window Showing LaserWriter Postscript ConfigurationFILE="n312r098.pbm"These are the required values for a queue whose print jobs are sent to a LaserWriter II NT:WIDTH="120"Print serverWIDTH="192"(Any)DeviceApple LaserWriterModePostScriptID="FM25534"PostScript Binary Graphics Modeidxid="w5605"book="_idx" docset="nw312" tidref="i1823""PostScript Binary Graphics" mode instructs the AppleTalk print server not to replace Control-D characters in the print job with Printer Access Protocol (PAP) EOFs. Use this mode for DOS or Windows applications that produce binary PostScript data. Please see IDREF="FM42682""DOS PostScript Applications" on page 171 for background information.See IDREF="FM10432""Symptom: Printer Sends Multiple Error Messages" on page 233 for a description of what can happen if you select the wrong print mode for binary files. idxid="w5606"book="_idx" docset="nw312" tidref="i3178"ID="FM10017"Apple LaserWriter in idxid="w5607"book="_idx" docset="nw312" tidref="i3178"PostText Mode idxid="w5608"book="_idx" docset="nw312" tidref="i5482"IDREF="FM19756"Figure 7-13 on page 203 shows a sample print job configuration for an Apple LaserWriter in PostText mode. PostText mode allows applications to send ASCII text to a PostScript printer.LBL="7-13"ID="FM19756"Example PRINTCON Window Showing LaserWriter idxid="w5609"book="_idx" docset="nw312" tidref="i5125"PostText ConfigurationFILE="n312r099.pbm"The "Mode" field contains the only required value that must be different from the PostScript configuration shown in IDREF="FM10122"Figure 7-12 on page 202. For the PostText configuration, the required values are these:WIDTH="120"Print serverWIDTH="192"(Any)DeviceApple LaserWriterModePostText Courier 10 CPIOf course, you can choose a different "characters per inch" (CPI) specification from the Mode menu. CPI simply specifies the relative size of the characters: the higher the number of CPI, the smaller the character size. idxid="w5610"book="_idx" docset="nw312" tidref="i3178"ID="FM28414"Apple ImageWriter idxid="w5611"book="_idx" docset="nw312" tidref="i5482"An Apple ImageWriter (including the ImageWriter LQ) uses plain text mode to print jobs submitted from DOS. The jobs use the ImageWriter resident font, which produces output something like a line printer. IDREF="FM17778"Figure 7-14 on page 204 shows a sample configuration for an Apple ImageWriter:LBL="7-14"ID="FM17778"Example PRINTCON Window ShowingImageWriter idxid="w5612"book="_idx" docset="nw312" tidref="i2772"ConfigurationFILE="n312r100.pbm"For the ImageWriter configuration, the required values are these:WIDTH="120"Print serverWIDTH="192"(Any)DeviceApple ImageWriterMode12 CPIOf course, you can choose a different "characters per inch" (CPI) idxid="w5613"book="_idx" docset="nw312" tidref="i5210"specification idxid="w5614"book="_idx" docset="nw312" tidref="i5482"from idxid="w5615"book="_idx" docset="nw312" tidref="i5425"the idxid="w5616"book="_idx" docset="nw312" tidref="i5210"Mode idxid="w5617"book="_idx" docset="nw312" tidref="i5210"menu. idxid="w5618"book="_idx" docset="nw312" tidref="i5482"CPI idxid="w5619"book="_idx" docset="nw312" tidref="i324"simply idxid="w5620"book="_idx" docset="nw312" tidref="i5210"specifies idxid="w5621"book="_idx" docset="nw312" tidref="i5425"the idxid="w5622"book="_idx" docset="nw312" tidref="i5282"relative idxid="w5623"book="_idx" docset="nw312" tidref="i5482"size idxid="w5624"book="_idx" docset="nw312" tidref="i324"of idxid="w5625"book="_idx" docset="nw312" tidref="i5441"the idxid="w5626"book="_idx" docset="nw312" tidref="i5425"characters: idxid="w5627"book="_idx" docset="nw312" tidref="i5282"the idxid="w5628"book="_idx" docset="nw312" tidref="i4452"higher idxid="w5629"book="_idx" docset="nw312" tidref="i324"the idxid="w5630"book="_idx" docset="nw312" tidref="i1667"number of idxid="w5631"book="_idx" docset="nw312" tidref="i5425"CPI, the idxid="w5632"book="_idx" docset="nw312" tidref="i5282"smaller idxid="w5633"book="_idx" docset="nw312" tidref="i324"the idxid="w5634"book="_idx" docset="nw312" tidref="i324"character idxid="w5635"book="_idx" docset="nw312" tidref="i324"size. idxid="w5636"book="_idx" docset="nw312" tidref="i271"idxid="w5637"book="_idx" docset="nw312" tidref="i4444"LBL="8"ID="FM38615"SNMP Support in NetWare for MacintoshNetWare for Macintosh offers limited SNMP (Simple Network Management Protocol) idxid="w5638"book="_idx" docset="nw312" tidref="i6365"idxid="w5639"book="_idx" docset="nw312" tidref="i6365"support. SNMP provides network management and monitoring capabilities so that you can use either Novell's AppleTalk console utility (ATCON) or a third-party network management console application. You can find instructions for using ATCON in Appendix C.Typical kinds of information that you can gather with SNMP include zones lists, routing tables, and lookups of network nodes. The full extent of SNMP support is described in IDREF="FM21302""SNMP Operations on the AppleTalk Network" on page 206. SNMP.NLM idxid="w5640"book="_idx" docset="nw312" tidref="i6391"An SNMP agent idxid="w5641"book="_idx" docset="nw312" tidref="i6381"is software that acts as a "middleman" to receive SNMP requests and distribute them to the protocol stack. The SNMP agent also relays replies from the protocol stack to a console utility. Novell's SNMP agent, SNMP.NLM, provides information about the AppleTalk network by communicating with the AppleTalk stack and router, contained in idxid="w5642"book="_idx" docset="nw312" tidref="i418"APPLETLK.NLM.SNMP.NLM uses either the Datagram Deli idxid="w5643"book="_idx" docset="nw312" tidref="i1328"idxid="w5644"book="_idx" docset="nw312" tidref="i1328"very Protocol (DDP) or TCP/IP idxid="w5645"book="_idx" docset="nw312" tidref="i6727"as a transport protocol. DDP is native to AppleTalk and is supported by the APPLETLK.NLM. TCP/IP support is provided with the TCPIP.NLM included with NetWare 3.12. You need an SNMP management console idxid="w5646"book="_idx" docset="nw312" tidref="i6365"application in order to retrieve AppleTalk data. Most third-party applications use the TCP/IP protocol. However, the APPLETLK.NLM allows an SNMP console to communicate with the SNMP.NLM using DDP as the basic transport. NetWare for Macintosh can also support SNMP over IP, but this scenario requires that TCPIP.NLM also be loaded on the NetWare server. Enabling SNMP Support in the AppleTalk Networkidxid="w5647"book="_idx" docset="nw312" tidref="i6365"When you install the NetWare operating system, SNMP.NLM is copied to SYS:SYSTEM. At load time, SNMP.NLM automatically loads with APPLETLK.NLM. If you want to use IP as the transport for obtaining information through SNMP, you must load TCPIP.NLM in addition to APPLETLK.NLM, and bind IP to a card appropriately. It is important to note that versions of TCPIP.NLM previous to NetWare 3.12 are not compatible with SNMP.NLM.ID="FM21302"SNMP Operations on the AppleTalk Networkidxid="w5648"book="_idx" docset="nw312" tidref="i6365"SNMP support in NetWare for Macintosh is compliant with the AppleTalk MIB I specification (described in the Internet document RFC 1243). A MIB (Management Information Base) is a collection of "objects" an application can access through SNMP. The AppleTalk MIB I specification describes the following groups of objects: idxid="w5649"book="_idx" docset="nw312" tidref="i3354"idxid="w5650"book="_idx" docset="nw312" tidref="i3234"idxid="w5651"book="_idx" docset="nw312" tidref="i6365"LocalTalk Link Access Protocol (LLAP): This group provides information about all LocalTalk interfaces on the server. Only the objects llapInPkts and llapOutPkts are supported.idxid="w5652"book="_idx" docset="nw312" tidref="i222"idxid="w5653"book="_idx" docset="nw312" tidref="i65"idxid="w5654"book="_idx" docset="nw312" tidref="i6365"AppleTalk Address Resolution Protocol (AARP): This group is used to map AppleTalk node addresses and the addresses of the underlying data link layer for data links other than LocalTalk. This group provides a view of the AARP Address Mapping table.idxid="w5655"book="_idx" docset="nw312" tidref="i321"idxid="w5656"book="_idx" docset="nw312" tidref="i512"idxid="w5657"book="_idx" docset="nw312" tidref="i6365"AppleTalk Port (ATPort): An AppleTalk port is a logical connection to a network over which AppleTalk packets can be transmitted. This group of objects provides information about the configuration of each AppleTalk port.idxid="w5658"book="_idx" docset="nw312" tidref="i1318"idxid="w5659"book="_idx" docset="nw312" tidref="i1328"idxid="w5660"book="_idx" docset="nw312" tidref="i6365"Datagram Delivery Protocol (DDP): This group provides statistical counters on the operation of DDP.idxid="w5661"book="_idx" docset="nw312" tidref="i6056"idxid="w5662"book="_idx" docset="nw312" tidref="i6092"idxid="w5663"book="_idx" docset="nw312" tidref="i6365"Routing Table Maintenance Protocol (RTMP): This group shows the table that the AppleTalk router uses to forward datagrams on the AppleTalk internet.idxid="w5664"book="_idx" docset="nw312" tidref="i3065"idxid="w5665"book="_idx" docset="nw312" tidref="i3066"idxid="w5666"book="_idx" docset="nw312" tidref="i6365"Kinetics Internet Protocol (KIP): This group provides status and routing information in an Internet Protocol (IP) tunneling environment; because this version of APPLETLK.NLM does not provide tunneling of AppleTalk encapsulated in IP packets, this group is not supported.idxid="w5667"book="_idx" docset="nw312" tidref="i7574"idxid="w5668"book="_idx" docset="nw312" tidref="i7572"idxid="w5669"book="_idx" docset="nw312" tidref="i6365"Zone Information Protocol (ZIP): This group shows the mapping of networks and zone names of which the AppleTalk router is aware.idxid="w5670"book="_idx" docset="nw312" tidref="i3977"idxid="w5671"book="_idx" docset="nw312" tidref="i4036"idxid="w5672"book="_idx" docset="nw312" tidref="i6365"Name Binding Protocol (NBP): This group provides information on the NBP table containing services registered with NBP and statistics on NBP operation in the server.idxid="w5673"book="_idx" docset="nw312" tidref="i226"idxid="w5674"book="_idx" docset="nw312" tidref="i180"idxid="w5675"book="_idx" docset="nw312" tidref="i6365"AppleTalk Echo Protocol (AEP): AEP is a transport level protocol that can verify the status of nodes on the internet. This group provides statistics on the operation of AEP.APPLETLK.NLM supports the Get and GetNext SNMP operations. It does not support the Set SNMP operation, or SNMP Traps.For more information about SNMP idxid="w5676"book="_idx" docset="nw312" tidref="i6365"support in AppleTalk and NetWare, please consult these references:"AppleTalk Management Information Base," Steven Waldbusser, editor (document RFC-1243). This document describes the AppleTalk MIB I.The Simple Book: An Introduction to Management of TCP/IP Based Internets, Marshall T. Rose (Prentice-Hall, 1991).idxid="w5677"book="_idx" docset="nw312" tidref="i5943"RFC documents can be purchased through:SRI InternationalNetwork Information Systems Center333 Ravenswood Ave., Room EJ291Menlo Park, CA 94025Phone: 1-415-859-3695Fax: 1-415-859-6028 idxid="w5678"book="_idx" docset="nw312" tidref="i6365"idxid="w5679"book="_idx" docset="nw312" tidref="i6365"LBL="9"Troubleshooting idxid="w5680"book="_idx" docset="nw312" tidref="i271"idxid="w5681"book="_idx" docset="nw312" tidref="i271"idxid="w5682"book="_idx" docset="nw312" tidref="i4280"This idxid="w5683"book="_idx" docset="nw312" tidref="i6910"chapter idxid="w5684"book="_idx" docset="nw312" tidref="i6910"describes symptoms of error conditions and presents basic guidelines for diagnosing problems with the AppleTalk network, with AppleTalk file services, and with AppleTalk print services.Calling for Helpidxid="w5685"book="_idx" docset="nw312" tidref="i4280"If your idxid="w5686"book="_idx" docset="nw312" tidref="i7149"attempt to resolve a problem fails and you purchased NetWare for Macintosh from an authorized dealer, please call your dealer for assistance.You should be prepared to give a complete description of the problem, including what happens, when it happens, and what you've done to diagnose the problem. You should also have detailed information about your network configuration on hand.ID="FM39252"Diagnosing Network ProblemsWhen you become aware of a network problem, the first step is always to define the specific symptoms of the problem. This section describes some problems, presents strategies for obtaining more specific information, and offers solutions for the possible causes.First Use the idxid="w5687"book="_idx" docset="nw312" tidref="i482"ATCON UtilityNetWare for Macintosh provides the ATCON server utility for diagnosing conditions on the AppleTalk network.If you have a problem with general network operation, it is a good idea to start diagnosing the problem by using ATCON.Please see IDREF="FM37625""Using ATCON to Diagnose the AppleTalk Network" on page 273 for an introduction.ID="FM36163"Symptom: idxid="w5688"book="_idx" docset="nw312" tidref="i2227"Macintosh idxid="w5689"book="_idx" docset="nw312" tidref="i3610"Client idxid="w5690"book="_idx" docset="nw312" tidref="i6910"Can't See Server in the Chooseridxid="w5691"book="_idx" docset="nw312" tidref="i6910"To diagnose the cause of this problem, you need to narrow the problem down and try to localize it to one of the components: the Macintosh client itself, the AppleTalk configuration in the NetWare server, the network hardware connecting them, or the configuration of another router on the network.IDREF="FM27082"Figure 9-1 depicts a typical error condition where zone names appear in the Chooser, but the server name does not appear when the Macintosh user selects the server's zone.LBL="9-1"ID="FM27082"Server Name Does Not Appear in ChooserFILE="n312r101.pbm"Another type of error condition can occur in which no zone names appear in the Chooser, or zones that you just specified in a newly configured server do not appear. In either this case or the case depicted in IDREF="FM27082"Figure 9-1, you can begin to troubleshoot the problem by verifying these conditions:Can the client can see other AppleTalk services?First, choose another AppleTalk service on the same network as the problem Macintosh.If the Macintosh cannot see any AppleTalk services (or any AppleTalk zones) and you know that other services or zones exist, then the workstation itself or the cable to which it is connected are suspect. See IDREF="FM32005""Macintosh Client Solutions" on page 212 and IDREF="FM37970""Network Cabling Solutions" on page 214.If the name of another service appears, you know that the Macintosh is capable of communicating on the AppleTalk network. In this case, the problem is more likely to be a router or cabling problem. See IDREF="FM30171""AppleTalk Solutions on the NetWare Server" on page 213 and IDREF="FM37970""Network Cabling Solutions" on page 214.Can another Macintosh client see the NetWare server?Go to another Macintosh client, select the file server's zone in the Chooser, and see whether the server's name appears. The physical proximity of the client to the server and thus the actual network cable may be a factor.If the Macintosh client at the second location can see the NetWare server, swap the problem Macintosh to that network connection and see whether you can still see the server. If so, the network connection at the original problem location is suspect. See IDREF="FM37970""Network Cabling Solutions" on page 214.If the second Macintosh client can't see the NetWare server either, then the server's AppleTalk configuration is suspect. See IDREF="FM30171""AppleTalk Solutions on the NetWare Server" on page 213.Can the NetWare server see the Macintosh?idxid="w5692"book="_idx" docset="nw312" tidref="i482"Use the idxid="w5693"book="_idx" docset="nw312" tidref="i1765"Echo test function in ATCON. Or, if you have a copy of the Macintosh Responder application, install it in the client Macintosh and then use the Lookup service function in ATCON from the server console. See IDREF="FM18937""Looking Up an AppleTalk Service" on page 274.If the server can "see" the Macintosh but not vice versa, then the network software in the Macintosh is suspect. Step 4 will verify whether the problem originates with the Macintosh, but it helps to narrow the problem if the server cannot see the Macintosh client running Responder.Can the server see another Macintosh on the same network?Use the Echo test function in ATCON. Or, if you have a copy of the Macintosh Responder application, install it in the client Macintosh and then use the Lookup service function in ATCON from the server console. If the server can "see" the second Macintosh but could not see the original problem Macintosh, then there could be a problem with the connectors at the Macintosh client or the Macintosh network interface board. idxid="w5694"book="_idx" docset="nw312" tidref="i6910"ID="FM32005"Macintosh Client Solutions idxid="w5695"book="_idx" docset="nw312" tidref="i6910"This section provides a checklist to rule out possible problems on Macintosh clients that cannot see the NetWare server. In most cases, a problem with one of the items in this section prevents any AppleTalk zones from showing in the Chooser.idxid="w5696"book="_idx" docset="nw312" tidref="i271"Cabling connections idxid="w5697"book="_idx" docset="nw312" tidref="i3610"are secure and correct.idxid="w5698"book="_idx" docset="nw312" tidref="i865"If the network hardware in the Macintosh is loose or incorrect, the Macintosh will not be up on the AppleTalk network, so no zones will show in that workstation's Chooser.If you are using an Ethernet or Token Ring board for the Macintosh, check that the network connection to the Macintosh network board is secure, and properly connected to the board and the cable. On Ethernet, make sure the idxid="w5699"book="_idx" docset="nw312" tidref="i1874"Thick/Thin switch is set correctly on the network board. Also, make sure that any Ethernet cable is properly terminated.idxid="w5700"book="_idx" docset="nw312" tidref="i865"If the client Macintosh is connected to idxid="w5701"book="_idx" docset="nw312" tidref="i3353"LocalTalk, idxid="w5702"book="_idx" docset="nw312" tidref="i3355"make sure the LocalTalk cable is connected to the Macintosh printer port, not the modem port, and that the LocalTalk cable connections are not loose or unplugged. LocalTalk cable connections can work loose if you don't secure them with cable ties.The network idxid="w5703"book="_idx" docset="nw312" tidref="i3610"CDEV is set correctly.idxid="w5704"book="_idx" docset="nw312" tidref="i1237"If idxid="w5705"book="_idx" docset="nw312" tidref="i1896"you idxid="w5706"book="_idx" docset="nw312" tidref="i1896"have set the network idxid="w5707"book="_idx" docset="nw312" tidref="i3628"CDEV in the Macintosh Control Panel incorrectly, the Macintosh will not be up on the AppleTalk network, so no zones will show in the Chooser.idxid="w5708"book="_idx" docset="nw312" tidref="i1881"In the Network area of the Macintosh Control Panel, the selected network connection software idxid="w5709"book="_idx" docset="nw312" tidref="i1881"icon idxid="w5710"book="_idx" docset="nw312" tidref="i2715"indicates idxid="w5711"book="_idx" docset="nw312" tidref="i2715"the network CDEV. This must match the type of network configured in the router for the cable supporting the Macintosh. A common mistake is to confuse EtherTalk Phase 1 and EtherTalk Phase 2. See the Using the NetWare for Macintosh Client guide for more information.Th idxid="w5712"book="_idx" docset="nw312" tidref="i3610"e Macintosh network drivers are correctly installed.Network drivers are provided with Macintosh network boards. Please see the documentation for the board to verify that you installed the driver properly.AppleTalk is enabled in the Chooser.If AppleTalk is not enabled in the Chooser, the Macintosh will not be up on the AppleTalk network, so no zones will show in the Chooser. Token Ring Source Routing is either enabled or disabled to be consistent with the server.If you are using Token Ring Source Routing, make sure that you use it consistently on all Token Ring interfaces, including TokenTalk boards in Macintosh clients. Please see the documentation for the TokenTalk board to verify that you enabled Source Routing if appropriate.The Macintosh client is OK when disconnected from the network.Disconnect the Macintosh client from the network cable and connect it to a printer via a single LocalTalk connection. Verify that its peripheral devices (if any) and power source are operating correctly. idxid="w5713"book="_idx" docset="nw312" tidref="i6910"ID="FM30171"AppleTalk Solutions on the idxid="w5714"book="_idx" docset="nw312" tidref="i6910"NetWare ServerThis section provides a checklist to rule out possible problems in the NetWare server.AppleTalk is bound to the network board in the server.You can check which protocols you bound to the network board by using the CONFIG command at the console prompt. You should see "lan protocol: AARP" and "lan protocol: AppleTlk."idxid="w5715"book="_idx" docset="nw312" tidref="i271"The idxid="w5716"book="_idx" docset="nw312" tidref="i4508"network board works with AppleTalk.The list of AT-compatible and Micro-Channel network boards that are known to work with AppleTalk is continually being updated. The list as of this printing is included in the README.1ST file on the NWMAC diskette. You can obtain the most up-to-date information on these boards from your dealer or through idxid="w5717"book="_idx" docset="nw312" tidref="i4508"NetWire. idxid="w5718"book="_idx" docset="nw312" tidref="i271"The Macintosh idxid="w5719"book="_idx" docset="nw312" tidref="i3649"NLMs are installed.You can check which modules are loaded by using the idxid="w5720"book="_idx" docset="nw312" tidref="i3930"MODULES command at the console prompt. If the NetWare for Macintosh v3.12 modules fail to load and you see an error message that begins with Loader cannot find public ...you are probably loading the modules in incorrect order. The load order is critical to the Macintosh NLMs.You must load the AppleTalk module first. That is, you must load the APPLETLK NLM before any others, such as AFP, ATPS, or ATCON.idxid="w5721"book="_idx" docset="nw312" tidref="i6819"Token Ring Source idxid="w5722"book="_idx" docset="nw312" tidref="i6819"Routing is either enabled or disabled to be consistent with other routers on the internet.If you are using Token Ring Source Routing, make sure that you use it consistently on all Token Ring interfaces, including TokenTalk. Novell's NetWare Supplement for IBM Token Ring boards documents Token Ring Source Routing. See IDREF="FM37829""Using Token Ring with Macintosh Clients" on page 92.The server can communicate with other AppleTalk devices.Use the ATCON utility to see whether the server can communicate on the AppleTalk network and to determine where it runs into problems. Please see IDREF="FM37625""Using ATCON to Diagnose the AppleTalk Network" on page 273 for an introduction and the subsequent sections in Appendix C for details. idxid="w5723"book="_idx" docset="nw312" tidref="i6910"ID="FM37970"Network idxid="w5724"book="_idx" docset="nw312" tidref="i271"Cabling idxid="w5725"book="_idx" docset="nw312" tidref="i3610"Solutions idxid="w5726"book="_idx" docset="nw312" tidref="i2227"idxid="w5727"book="_idx" docset="nw312" tidref="i865"This idxid="w5728"book="_idx" docset="nw312" tidref="i3610"section idxid="w5729"book="_idx" docset="nw312" tidref="i6910"provides idxid="w5730"book="_idx" docset="nw312" tidref="i1874"a checklist to rule out possible problems with the network cabling between the Macintosh client and the NetWare server.If there is a bridge or router between the server and Macintosh client(s), make sure that this condition is true:The intervening router or bridge is configured properly and is routing AppleTalk.If there is more than one router or bridge between the server and the Macintosh client, first try to isolate the problem by using the ATCON utility to verify communication through each router/bridge, idxid="w5731"book="_idx" docset="nw312" tidref="i1765"idxid="w5732"book="_idx" docset="nw312" tidref="i3565"one by one, using idxid="w5733"book="_idx" docset="nw312" tidref="i482"the Echo test idxid="w5734"book="_idx" docset="nw312" tidref="i482"and/or idxid="w5735"book="_idx" docset="nw312" tidref="i482"Lookup services. Please see IDREF="FM37625""Using ATCON to Diagnose the AppleTalk Network" on page 273 for an introduction, and the subsequent sections in Appendix C for details.idxid="w5736"book="_idx" docset="nw312" tidref="i865"If the network cable is either twisted-pair or thin Ethernet, make sure that this condition is true:The cable adheres to the Ethernet 10BASE2 specification.If the network cable is twisted-pair Ethernet, make sure that this condition is true:The ports on the concentrator are working properly. Some twisted-pair concentrators have link-status lights to indicate that a connection is functioning properly.If the cable is thin Ethernet, make sure that these conditions are true:Each node is connected via a T-connector.Make sure all nodes on the cable have a T-connector connecting the node to the thin Ethernet segment, as shown in IDREF="FM32582"Figure 9-2 on page 216.LBL="9-2"ID="FM32582"T-connector Connecting to a MacintoshFILE="n312r102.pbm"Each segment end is terminated with a 50-ohm terminator.On thin Ethernet, the last node on a segment must have the open end of its T-connector terminated.If the cable is thick Ethernet, make sure that this condition is true:The transceiver and drop cable are working properly.If you have packet-analyzer software, you can verify that the transceiver and cable are passing packets. Some transceiver boxes have a status light that verifies that packets are moving properly across the idxid="w5737"book="_idx" docset="nw312" tidref="i1874"cable. idxid="w5738"book="_idx" docset="nw312" tidref="i865"idxid="w5739"book="_idx" docset="nw312" tidref="i865"If the idxid="w5740"book="_idx" docset="nw312" tidref="i6810"cable is Token Ring, make sure that these conditions are true:The Medium Access Unit (MAU) is functioning properly.You should see a console message if the Token Ring MAU is not working.All cards are configured for the same speed.idxid="w5741"book="_idx" docset="nw312" tidref="i6816"Many Token Ring cards support both 4 and 16 MBs. Make sure that all nodes on the cable are operating at the same speed.If you have checked the above conditions and still suspect the network cabling or connectors, follow these steps:idxid="w5742"book="_idx" docset="nw312" tidref="i865"Check for idxid="w5743"book="_idx" docset="nw312" tidref="i4518"cable breakage by using a resistance meter.If you have a resistance meter, use it to look for intermittent faults in the cable and connectors.Swap the cable and connectors.Swapping the equipment with another cable and set of connectors will idxid="w5744"book="_idx" docset="nw312" tidref="i2227"definitely idxid="w5745"book="_idx" docset="nw312" tidref="i6910"verify idxid="w5746"book="_idx" docset="nw312" tidref="i3610"whether idxid="w5747"book="_idx" docset="nw312" tidref="i3610"the idxid="w5748"book="_idx" docset="nw312" tidref="i2227"cable idxid="w5749"book="_idx" docset="nw312" tidref="i865"or idxid="w5750"book="_idx" docset="nw312" tidref="i271"connectors idxid="w5751"book="_idx" docset="nw312" tidref="i6910"are idxid="w5752"book="_idx" docset="nw312" tidref="i3610"at fault.ID="FM26818"Symptom: Reconfigured idxid="w5753"book="_idx" docset="nw312" tidref="i6910"Zones idxid="w5754"book="_idx" docset="nw312" tidref="i396"Continue to Show in the ChooserThis problem results from the way in which AppleTalk maintains routing tables and zone information on the internet. The reasons for this problem are explained in IDREF="FM27796""How Zone Information Is Maintained on an Internet" on page 255.If this problem is occurring at your site, and the reconfigured router is the only router directly connected to the network supporting new zones, bring down the router again and allow it to stay off the network for at least twenty minutes. When you bring up the router again, the new zones will be in effect.Of course, if more than one router is connected to the network supporting new zones, all of them must be reconfigured to support the same zones. Make sure that other networks don't support the old zones. If they do, bring down all the routers, reconfigure the zones, and leave them down for at least twenty minutes. When you bring up the routers, the new zones will be in effect.Please see IDREF="FM18960""Changing the AppleTalk Zone Name or Zones List" on page 122 and IDREF="FM27796""How Zone Information Is Maintained on an Internet" on page 255.ID="FM27955"Symptom: idxid="w5755"book="_idx" docset="nw312" tidref="i4556"Messages idxid="w5756"book="_idx" docset="nw312" tidref="i271"about idxid="w5757"book="_idx" docset="nw312" tidref="i6910"Mismatched Network NumbersYou must correctly configure AppleTalk network numbers for the router to function correctly on an internet. If you see errors about mismatched or conflicting network numbers in the system log, select View Router Interfaces in idxid="w5758"book="_idx" docset="nw312" tidref="i482"ATCON idxid="w5759"book="_idx" docset="nw312" tidref="i482"to see idxid="w5760"book="_idx" docset="nw312" tidref="i4556"what each server is advertising as its network numbers.The DISPLAY NETWORK idxid="w5761"book="_idx" docset="nw312" tidref="i1616"command shows only idxid="w5762"book="_idx" docset="nw312" tidref="i3019"IPX network numbers. idxid="w5763"book="_idx" docset="nw312" tidref="i4556"Use ATCON to view the AppleTalk network numbers.The example internet shown in IDREF="FM41026"Figure 9-3 demonstrates the basic principles of correct configuration:LBL="9-3"ID="FM41026"Consistent Network Numbers on an InternetFILE="n312r103.pbm"idxid="w5764"book="_idx" docset="nw312" tidref="i1874"Port 2 in SERVER-A and Port 1 in SERVER-B connect to the Ethernet backbone.These ports must both use exactly the same network and zone configuration for the backbone. The first name in the zones list (default zone) must be consistent in both routers.Port 1 in SERVER-A and Port 2 in SERVER-B connect to two different LocalTalk networks. These ports must use different network numbers, because they are two different cables.Port 0 in SERVER-A andPort 0 in SERVER-B represent the servers' connection to their internal networks.These ports must use different network numbers, because they represent two different networks.idxid="w5765"book="_idx" docset="nw312" tidref="i4556"All facets of checking for consistent and unique network numbers on an internet cannot be covered here, but you can use the idxid="w5766"book="_idx" docset="nw312" tidref="i362"following general checklist for router configurations.For each AppleTalk port in a router, make sure that these conditions are true:The network number or range is unique on the internet.This condition does not imply that each AppleTalk port must be configured with a unique network number or range. It means that the network number or range of the network in which the AppleTalk port is configured must be unique among networks in the internet. Multiple AppleTalk ports in a single network will be configured with the same network number or range.All routers on the cable agree about the network number or range.All routers on the cable agree about the zone name or zones list and default zone.For a router in Transition Mode (for a description of Transition Mode, see IDREF="FM28649"Appendix B, "Transition Mode Routing"), make sure that these conditions are true:The -toption is enabled on the LOAD APPLETLK command line.The extended network range of the router in Transition Mode has one element (such as 1-1).The extended network range is unique on the internet.All routers on a cable agree about the network range.The extended network's zones list has only one name, and all routers on a cable agree about that name.The non-extended network number is unique on the internet.All routers on a cable agree about the network number.All routers on a cable agree about the zone name. idxid="w5767"book="_idx" docset="nw312" tidref="i362"One of the most effective ways to insure against mismatched network numbers or conflicting zone names is to take advantage of seed routing when you configure your internetwork. For more information about seed routing and its benefits for idxid="w5768"book="_idx" docset="nw312" tidref="i4556"configuring idxid="w5769"book="_idx" docset="nw312" tidref="i1874"your idxid="w5770"book="_idx" docset="nw312" tidref="i6910"internetwork, idxid="w5771"book="_idx" docset="nw312" tidref="i4556"see IDREF="FM14046""Learning Network and Zone Configurations from Seed Routers" on page 20. idxid="w5772"book="_idx" docset="nw312" tidref="i271"Symptom: idxid="w5773"book="_idx" docset="nw312" tidref="i6910"Device Names Appear and Disappear in the ChooserThe most common reason for this error condition is a conflicting AppleTalk configuration on the internet, but this error can also derive from low memory conditions or a Chooser limitation on the number of devices that can be visible.If you are seeing this symptom at Macintosh clients, load the idxid="w5774"book="_idx" docset="nw312" tidref="i482"ATCON utility at the server console and idxid="w5775"book="_idx" docset="nw312" tidref="i6663"check the system log.idxid="w5776"book="_idx" docset="nw312" tidref="i1848"If the system log contains idxid="w5777"book="_idx" docset="nw312" tidref="i3839"messages about mismatched network numbers, refer to IDREF="FM27955""Symptom: Messages about Mismatched Network Numbers" on page 217 for additional information.If the system log contains messages about idxid="w5778"book="_idx" docset="nw312" tidref="i3572"low memory, see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248.If the system log does not contain AppleTalk error messages, the problem could be caused by too many device names ( idxid="w5779"book="_idx" docset="nw312" tidref="i1410"or device names that are too long) in the Chooser.The exact limitation in the Chooser depends on the number of characters in each device name. To fix this problem, you can either divide the AppleTalk network into zones containing fewer services (LaserWriters or file servers), or reduce the number of characters in some or all of the device names.ID="FM10750"Symptom: idxid="w5780"book="_idx" docset="nw312" tidref="i396"Zone Names Do Not Match idxid="w5781"book="_idx" docset="nw312" tidref="i6910"Existing idxid="w5782"book="_idx" docset="nw312" tidref="i7576"Zone NamesIf additional zone names show up in the Chooser or ATCON after you have brought up a file server on the AppleTalk network, check that these conditions hold in the NetWare for Macintosh v3.12 router configuration:You typed the same zone names in different configuration files using the same case.Zone names are case-sensitive, and variations in case in the same words will result in different zone names. This can occur when you create individual ATZONES.CFG files for different routers in the internetwork. It can also occur when you have inconsistent AUTOEXEC.NCF files for the routers in your internetwork.There are no trailing blanks in zone names.Trailing blanks in zone names could exist on other routers, if not on the current router that you are checking. Because space characters are permitted in zone names, these must also be checked.You specified special characters in terms of their decimal values.Special characters that are allowed in zone names are shown in IDREF="FM24403"Table 9-1 on page 222.LBL="9-1" INLINE="F"ID="FM24403"Decimal idxid="w5783"book="_idx" docset="nw312" tidref="i271"Codes for idxid="w5784"book="_idx" docset="nw312" tidref="i396"Eight-bit idxid="w5785"book="_idx" docset="nw312" tidref="i7576"Character Mapping in AppleTalkWIDTH="72"CharacterWIDTH="48"ValueWIDTH="84"CharacterWIDTH="48"ValueWIDTH="72"CharacterWIDTH="48"ValueWIDTH="72"ÄWIDTH="48"128WIDTH="84"(Dagger)WIDTH="48"160WIDTH="72"żWIDTH="48"192Ĺ129°161ˇ193Ç130(U.S. Cent)162¬194É131(U.K. Pound)163€195Ń132§164f196WIDTH="72"ÖWIDTH="144"133WIDTH="48"165WIDTH="72"€WIDTH="48"197Ü134¶166€198á135ß167«199ŕ136®168»200â137©169...201ä138(tm)170(blank)202ă139’171Ŕ203ĺ140¨172Ă204ç141€173Ő205é142Ć174OE206č143Ř175oe207ę144€176-208ë145±177---209í146<=178"210ě147>=179"211î148(Yen)180`212ď149µ181'213ń150€182/214ó151€183€215ň152€184˙216ô153€185(Apple)240WIDTH="72"öWIDTH="48"154WIDTH="84"€WIDTH="192"186WIDTH="72"őWIDTH="48"155WIDTH="84"ŞWIDTH="192"187WIDTH="72"úWIDTH="48"156WIDTH="84"şWIDTH="192"188WIDTH="72"ůWIDTH="48"157WIDTH="84"€WIDTH="192"189WIDTH="72"űWIDTH="48"158WIDTH="84"ćWIDTH="192"190WIDTH="72"üWIDTH="48"159WIDTH="84"řWIDTH="192"191idxid="w5786"book="_idx" docset="nw312" tidref="i569"You can enter the characters shown in IDREF="FM24403"Table 9-1 in the ATZONES.CFG file by using any text editor that lets you enter numerical character codes; for example, you can use the idxid="w5787"book="_idx" docset="nw312" tidref="i6766"editor called by the INSTALL module, the EDIT NLM, or the idxid="w5788"book="_idx" docset="nw312" tidref="i1785"EDLIN text editor on a DOS client.In EDLIN, you can enter these special characters by holding down <Alt> and entering the decimal value for the character. (Note that the character that displays on the screen of the DOS client does not look like the Macintosh character above. However, the specified decimal value matches the Macintosh character in existing idxid="w5789"book="_idx" docset="nw312" tidref="i7576"zone idxid="w5790"book="_idx" docset="nw312" tidref="i6910"names.) idxid="w5791"book="_idx" docset="nw312" tidref="i396"ID="FM42333"Symptom: idxid="w5792"book="_idx" docset="nw312" tidref="i6910"Spoolers and Printers Do Not Show in the Same ZoneThis symptom is not a problem. ATPS always advertises its print queues in the zone of the internal network, or if multiple zones are configured on the internal network, it advertises print queues in the default zone or a specified zone of the internal network. The printers themselves appear in the zone configured for the LocalTalk network to which they are physically connected.For example, IDREF="FM34096"Figure 9-4 on page 224 shows an internet where there is one LaserWriter in the LocalTalk1 zone and two LaserWriters in the LocalTalk2 zone. Both file servers have the zone name Backbone for their internal network:LBL="9-4"ID="FM34096"Spoolers and Printers in Different ZonesFILE="n312r104.pbm"In this case, the print queues supported on both of these servers appear in the Backbone zone in the Chooser, while the individual LaserWriters appear in the LocalTalk1 and LocalTalk2 zones. idxid="w5793"book="_idx" docset="nw312" tidref="i6910"Diagnosing Problems idxid="w5794"book="_idx" docset="nw312" tidref="i2263"with idxid="w5795"book="_idx" docset="nw312" tidref="i6910"File ServicesThis section describes specific symptoms you might see when logging in to or using a NetWare v3.12 file server running NetWare for Macintosh. It also presents one or more solutions for the possible causes.ID="FM28591"Symptom: Macintosh idxid="w5796"book="_idx" docset="nw312" tidref="i3610"Client idxid="w5797"book="_idx" docset="nw312" tidref="i7360"Can't See idxid="w5798"book="_idx" docset="nw312" tidref="i6910"Server's idxid="w5799"book="_idx" docset="nw312" tidref="i7372"Volume NameIn this error condition, Macintosh users can see the NetWare server and begin the login process, but they cannot see the volume name they need.LBL="9-5"Volume Name Does Not Appear in the Dialog BoxFILE="n312r105.pbm"idxid="w5800"book="_idx" docset="nw312" tidref="i229"The idxid="w5801"book="_idx" docset="nw312" tidref="i2263"most likely cause for this symptom is either that you did not add the Macintosh name space to the volume, or that you did not load the MAC.NAM support module; you must do both. At the file sever console, verify the following:idxid="w5802"book="_idx" docset="nw312" tidref="i3603"You loaded the MAC idxid="w5803"book="_idx" docset="nw312" tidref="i6489"support module in STARTUP.NCF.idxid="w5804"book="_idx" docset="nw312" tidref="i3645"You added the idxid="w5805"book="_idx" docset="nw312" tidref="i7372"Macintosh name space to the volume.If you must add the Macintosh name space to a volume at this point (after AppleTalk is active in the server), type the following commands: LOAD MAC <Enter> ADD NAME SPACE MACINTOSH TO VOLUME vol-name<Enter> UNLOAD AFP <Enter> LOAD AFP <Enter>The ADD NAME SPACE command is explicitly required; its functionality is not included in the LOAD MAC command.vol-name is the name of the volume. You should also note that once you have added the Macintosh name space to a volume, you cannot remove it unless you run idxid="w5806"book="_idx" docset="nw312" tidref="i7416"VREPAIR (this feature is supported only in NetWare 3.11 or above). In addition, the volume idxid="w5807"book="_idx" docset="nw312" tidref="i7372"will not idxid="w5808"book="_idx" docset="nw312" tidref="i7360"mount unless you idxid="w5809"book="_idx" docset="nw312" tidref="i7372"load the MAC.NAM idxid="w5810"book="_idx" docset="nw312" tidref="i6910"support idxid="w5811"book="_idx" docset="nw312" tidref="i3610"idxid="w5812"book="_idx" docset="nw312" tidref="i2263"module. idxid="w5813"book="_idx" docset="nw312" tidref="i229"Symptom: Volume idxid="w5814"book="_idx" docset="nw312" tidref="i7360"Name Is Dimmed in the ChooserIn this error condition, Macintosh users can see the NetWare server and begin the login process, but a volume name is dimmed, so they cannot select it.LBL="9-6"Volume Name Is Dimmed in the Dialog BoxFILE="n312r106.pbm"The most likely cause for this condition is that the idxid="w5815"book="_idx" docset="nw312" tidref="i1389"DESKTOP.AFP directory doesn't exist or is corrupted for that volume. You can remedy the problem by using the CDT option to clear the desktop. Type these command lines:  UNLOAD AFP <Enter> LOAD AFP CDT <Enter>idxid="w5816"book="_idx" docset="nw312" tidref="i7372"You should then rebuild the desktop as described in IDREF="FM42369""The Desktop Database" on page 130.idxid="w5817"book="_idx" docset="nw312" tidref="i7372"Another possible cause for a dimmed volume name is that the Macintosh user has no access privileges on the volume. In most cases, the group EVERYONE is made trustee of each volume, which ensures that all users who have login accounts are able to mount the volume. However, if you remove this trustee from the volume and the user has no explicit trustee assignments, he or she cannot mount the volume. idxid="w5818"book="_idx" docset="nw312" tidref="i7360"ID="FM24070"Symptom: Macintosh Client Can See the idxid="w5819"book="_idx" docset="nw312" tidref="i6910"Server idxid="w5820"book="_idx" docset="nw312" tidref="i2227"but Cannot Log InThis symptom can derive from several different conditions. idxid="w5821"book="_idx" docset="nw312" tidref="i7140"The user doesn't have a login account.The simplest case is that the user does not have a login account on the server. In this case, the Macintosh user is likely to see an error message such as this one:LBL="9-7"Incorrect Password Prevents LoginFILE="n312r107.pbm"System accounting is turned on, but the user does not have a balance.When you create new users by using the NCC and accounting is active on the file server, you must use SYSCON to assign an accounting balance to the user before he or she can log in.idxid="w5822"book="_idx" docset="nw312" tidref="i4424"The NetWare UAM is not correctly installed in on the Macintosh client, but you loaded the AFP module with the ENCRYPToption.idxid="w5823"book="_idx" docset="nw312" tidref="i229"Another possible cause is that you did not install the NetWare User Authentication Method (UAM) software in a folder named "AppleShare Folder" below the Macintosh System Folder (System 6.x) or in the Extension folder (System 7.0), but AFP has enforced password encryption using the idxid="w5824"book="_idx" docset="nw312" tidref="i1821"ENCRYPT option. To fix this condition, install the NetWare UAM in the proper location.idxid="w5825"book="_idx" docset="nw312" tidref="i229"There are no available AFP connections.Another possible cause for this problem is that the maximum number of users have already logged in to the file server. The maximum number of users can be from 20 to 100, depending on the version of NetWare for Macintosh you installed. If the user number has reached its maximum, users will see a message such as the one shown in IDREF="FM14161"Figure 9-8:LBL="9-8"ID="FM14161"AFP Connections Used UpFILE="n312r108.pbm"To fix this problem, one Macintosh user must log out of the idxid="w5826"book="_idx" docset="nw312" tidref="i229"server before another can idxid="w5827"book="_idx" docset="nw312" tidref="i6910"log in. idxid="w5828"book="_idx" docset="nw312" tidref="i2227"Symptom: AppleShare idxid="w5829"book="_idx" docset="nw312" tidref="i214"Icon idxid="w5830"book="_idx" docset="nw312" tidref="i2715"Does idxid="w5831"book="_idx" docset="nw312" tidref="i6910"Not Show in the Chooseridxid="w5832"book="_idx" docset="nw312" tidref="i216"This condition means that you have not installed the AppleShare Workstation software on the Macintosh client. Please see the Using the NetWare for Macintosh Client guide for instructions.Symptom: File idxid="w5833"book="_idx" docset="nw312" tidref="i2300"Creation idxid="w5834"book="_idx" docset="nw312" tidref="i6910"and idxid="w5835"book="_idx" docset="nw312" tidref="i2300"Modification Dates Are WrongIf Macintosh users are losing "Last Modified" and "Created" information when they copy Macintosh folders and files to the NetWare file server, check that this condition is true:The idxid="w5836"book="_idx" docset="nw312" tidref="i3610"system clock on the idxid="w5837"book="_idx" docset="nw312" tidref="i6651"Macintosh shows the same date and time as the idxid="w5838"book="_idx" docset="nw312" tidref="i2227"system clock on the idxid="w5839"book="_idx" docset="nw312" tidref="i6651"server.Open the Control Panel (in System 6) or choose the Control Panels option in the Apple menu (in System 7) and check the General icon (System 6) or General Controls icon (System 7) to see that the system clock displays the correct time.LBL="9-9"General Controls Icons for Systems 6 and 7FILE="n312r109.pbm"LBL="9-10"Macintosh System Clock for Systems 6 and 7FILE="n312r110.pbm"idxid="w5840"book="_idx" docset="nw312" tidref="i6651"If the Macintosh system clock is correct, check the time on the file idxid="w5841"book="_idx" docset="nw312" tidref="i6910"server idxid="w5842"book="_idx" docset="nw312" tidref="i6651"and, idxid="w5843"book="_idx" docset="nw312" tidref="i3610"if idxid="w5844"book="_idx" docset="nw312" tidref="i2227"necessary, idxid="w5845"book="_idx" docset="nw312" tidref="i2300"reset it. idxid="w5846"book="_idx" docset="nw312" tidref="i2300"Symptom: idxid="w5847"book="_idx" docset="nw312" tidref="i6910"Finder idxid="w5848"book="_idx" docset="nw312" tidref="i3638"Cannot idxid="w5849"book="_idx" docset="nw312" tidref="i424"Locate ApplicationsIf Macintosh users report that double-clicking an application icon produces a message stating that the application could not be found, you should clear the desktop and rebuild it from a Macintosh client. Please see IDREF="FM42369""The Desktop Database" on page 130 for details.You should also verify that the application is actually installed on the network volume; if it is not, re-install the application. Then, rebuild the desktop for that volume from a Macintosh client.Symptom: Macintosh idxid="w5850"book="_idx" docset="nw312" tidref="i2715"Icons idxid="w5851"book="_idx" docset="nw312" tidref="i3643"Do Not Appear in idxid="w5852"book="_idx" docset="nw312" tidref="i6910"Server's FoldersIf Macintosh users report that Macintosh document and application icons appear as idxid="w5853"book="_idx" docset="nw312" tidref="i2545"generic idxid="w5854"book="_idx" docset="nw312" tidref="i2715"icons, this is another indication that you should clear and rebuild the desktop folder. Please see IDREF="FM42369""The Desktop Database" on page 130 for details.If Macintosh icons appear as idxid="w5855"book="_idx" docset="nw312" tidref="i1679"DOS idxid="w5856"book="_idx" docset="nw312" tidref="i2715"file icons when copied to the server, this can be the result of an incorrect process of copying. This usually happens when Macintosh files or applications are copied to the server volume with a DOS COPY command. If the Macintosh files or applications are copied with the NetWare NCOPY command, the icons should appear as proper Macintosh icons to Macintosh clients.Macintosh files or applications copied to a server volume from a Macintosh client with the drag-copy method generally do not appear as DOS idxid="w5857"book="_idx" docset="nw312" tidref="i6910"icons. idxid="w5858"book="_idx" docset="nw312" tidref="i2263"Diagnosing idxid="w5859"book="_idx" docset="nw312" tidref="i6910"Problems idxid="w5860"book="_idx" docset="nw312" tidref="i5282"with idxid="w5861"book="_idx" docset="nw312" tidref="i5425"Print ServicesThis section describes specific symptoms you might see when using AppleTalk print services, and presents one or more solutions for the possible causes.ID="FM42283"Turning On idxid="w5862"book="_idx" docset="nw312" tidref="i7280"ATPS Verbose idxid="w5863"book="_idx" docset="nw312" tidref="i6910"ModeThe ATPS module can be made to operate in Verbose Mode for diagnosing conditions or verifying queue operations.If you have a problem with AppleTalk print services, it is a good idea to start diagnosing the problem by using Verbose Mode.You can turn on Verbose Mode at the console prompt by typing  idxid="w5864"book="_idx" docset="nw312" tidref="i542"ATPSV ON <Enter>To see ATPS messages as they are being generated, send print jobs to a queue, and then go to the system console and view the ATPS error idxid="w5865"book="_idx" docset="nw312" tidref="i324"window by pressing <Alt>+<Esc>. If there are several console windows open, you can press <Alt>+<Esc> more than once to cycle through the console windows until you see the ATPS window.In the ATPS console window, you can view messages about what is occurring when the print server attempts to communicate with the printer. You can review these messages again by viewing the system log in the ATCON utility. When you wish to turn off Verbose Mode, type ATPSV OFF<Enter>Symptom: idxid="w5866"book="_idx" docset="nw312" tidref="i3839"Macintosh idxid="w5867"book="_idx" docset="nw312" tidref="i1848"Error idxid="w5868"book="_idx" docset="nw312" tidref="i5282"Message idxid="w5869"book="_idx" docset="nw312" tidref="i6910"When Printing to a QueueMacintosh users send a print job to a queue by selecting an AppleTalk print spooler in the Chooser, and see this error message:FILE="n312r111.pbm"First, check that these conditions are true:The printer software is in the System Folder (System 6.x) or System Folder:Extensions (System 7.0).The AppleTalk print spooler is selected in the Chooser.If the spooler has been configured with the -a option, the user is logged in to the server and is a designated Queue User.The NetWare volume on which the print queues reside is not out of space.After verifying these conditions, check the SYS$LOG.ERR file for error messages related to the print spooler. Please see IDREF="FM27736""Viewing System and Volume Messages in the Log Files" on page 283 for instructions.Symptom: Print Jobs idxid="w5870"book="_idx" docset="nw312" tidref="i5210"Submitted idxid="w5871"book="_idx" docset="nw312" tidref="i5282"to a Queue idxid="w5872"book="_idx" docset="nw312" tidref="i6910"Do Not Print OutThis problem indicates that the AppleTalk print server is not working correctly. This problem can have many causes. Make sure that you set up the queue correctly in the idxid="w5873"book="_idx" docset="nw312" tidref="i516"ATPS.CFG file, and that ATPS is loaded. Then, use the ATPSV ON command to print informational messages, as well as standard error messages, to the system log and to the ATPS console window. See IDREF="FM42283""Turning On ATPS Verbose Mode" on page 230.Symptom: Print idxid="w5874"book="_idx" docset="nw312" tidref="i5282"Spoolers idxid="w5875"book="_idx" docset="nw312" tidref="i6910"Don't Show in the ChooserAfter setting up print queues in the ATPS.CFG file, make sure you reload the ATPS module on the server. Any changes to the ATPS.CFG file do not take effect until you reload the ATPS module. If you executed the LOAD ATPS command and you still don't see the Macintosh queues in the Macintosh Chooser, verify that ATPS is actually loaded. If any information is syntactically incorrect in ATPS.CFG, the ATPS module fails to load and displays error messages.For example, suppose you used the following configuration line in your ATPS.CFG file: LaserWriter1:LocalTalk1 -o MacQ1If the printer ("LaserWriter1") is the source of the font list file (that is, you did not use -f on the configuration line), check that the AppleTalk print server can find the printer on the network to obtain its list of fonts. To do so, turn on ATPS verbose mode and view messages in SYS$LOG.ERR. See IDREF="FM42283""Turning On ATPS Verbose Mode" on page 230 and IDREF="FM27736""Viewing System and Volume Messages in the Log Files" on page 283 for more information.If the printer cannot be located and queried on the AppleTalk network, make sure that these conditions are true:The printer name is LaserWriter1.Make sure that you typed the name in the ATPS.CFG file exactly as you typed it appears in the Macintosh Chooser; for example, make sure that there are no unintended spaces in the name (including trailing blanks), and so forth.The LaserWriter1 printer is located in the LocalTalk1 zone.idxid="w5876"book="_idx" docset="nw312" tidref="i396"Make idxid="w5877"book="_idx" docset="nw312" tidref="i5482"sure that the zone name is correct and that the printer actually resides in that idxid="w5878"book="_idx" docset="nw312" tidref="i7576"zone.The printer is turned on and is not in an error condition.Unless you used the -f option on the configuration line, the spooler does not appear in the Chooser if a PostScript printer is off-line, has a paper jam, is out of paper, or is in any other error condition when you load the ATPS module, until the error condition is cleared.The object name MacQ1 is not already in use in the server's internal idxid="w5879"book="_idx" docset="nw312" tidref="i6910"zone. idxid="w5880"book="_idx" docset="nw312" tidref="i5282"ID="FM10432"Symptom: Printer idxid="w5881"book="_idx" docset="nw312" tidref="i1848"Sends Multiple idxid="w5882"book="_idx" docset="nw312" tidref="i3839"Error idxid="w5883"book="_idx" docset="nw312" tidref="i5482"Messages idxid="w5884"book="_idx" docset="nw312" tidref="i6910"idxid="w5885"book="_idx" docset="nw312" tidref="i3178"Failure to select the idxid="w5886"book="_idx" docset="nw312" tidref="i5118"PostScript Binary Graphics mode when printing PostScript files that contain binary data from a DOS workstation (using NPRINT or CAPTURE) can cause the server to break the file into several sections with an error message generated in the system error log for each section. This error occurs because ATPS interprets idxid="w5887"book="_idx" docset="nw312" tidref="i1823"Control-D characters ($04) as End-Of-File (EOF) markers.You can verify that ATPS is interpreting characters as EOF by using the ATPSV ON command. When ATPS is in Verbose Mode, a message is generated for each control character interpreted as an End-Of-File.See IDREF="FM25534""PostScript Binary Graphics Mode" on page 202 for a description of how to select the PostScript Binary Graphics mode.Symptom: A idxid="w5888"book="_idx" docset="nw312" tidref="i5482"Non-Apple idxid="w5889"book="_idx" docset="nw312" tidref="i6910"Printer idxid="w5890"book="_idx" docset="nw312" tidref="i5282"Isn't WorkingOnly Apple LaserWriters and ImageWriters have been tested and certified to work with NetWare print queues. This statement does not mean that third-party printers won't work, but it does mean that there can be timing and driver issues that the vendor of the printer must resolve for the printer to work with NetWare print queues.When configuring the queue in ATPS.CFG, make sure that these conditions are true:idxid="w5891"book="_idx" docset="nw312" tidref="i5482"The printer type as specified with the-toption is correct.idxid="w5892"book="_idx" docset="nw312" tidref="i482"You can verify the printer type by using ATCON or some other type of network management software. The type listed in ATCON for the printer is the type of printer that should be listed in the ATPS.CFG file.If the printer is PostScript and its NBP type is not "LaserWriter," the idxid="w5893"book="_idx" docset="nw312" tidref="i5282"-sidxid="w5894"book="_idx" docset="nw312" tidref="i36"option is specified on the queue configuration line.The -s option instructs the AppleTalk print spooler and server that the printer will behave like a LaserWriter, even if the printer's idxid="w5895"book="_idx" docset="nw312" tidref="i6910"NBP type is idxid="w5896"book="_idx" docset="nw312" tidref="i5282"different. idxid="w5897"book="_idx" docset="nw312" tidref="i5482"Symptom: idxid="w5898"book="_idx" docset="nw312" tidref="i6910"Macintosh Print Jobs idxid="w5899"book="_idx" docset="nw312" tidref="i5210"Contain Incorrect CharactersThis problem is most likely to occur on printers that are directly connected to a serial port. It is caused by sending 8-bit data over a 7-bit channel. A serial communications channel may be configured to use only 7 bits of data per byte, which causes the high-order bit of each byte transmitted on that channel to be lost. This can change the meaning of the byte if it is in the range of 0x80-0xFF. From Macintosh clients, this can show up as incorrect characters in the printed output; for example, double-quote characters (") can be replaced by "R."The Apple LaserWriter's default mode for serial communications is 7-bit. When you connect a LaserWriter to a serial port, you should use NPRINT to download the PostScript utility SERIAL.PS, which instructs the LaserWriter to use 8-bit serial communication. See IDREF="FM41272""Technical Note about Printer Communication Channels" on page 169 for more details.ID="FM33224"Symptom: Printer idxid="w5900"book="_idx" docset="nw312" tidref="i2471"Substitutes Bitmap Fonts for Fontsidxid="w5901"book="_idx" docset="nw312" tidref="i2471"When a bitmap font is substituted for a font you know to be supported by the printer, it means that the font list maintained by the AppleTalk print spooler does not include the full set of fonts resident on the printer.To update the AppleTalk print spooler's idxid="w5902"book="_idx" docset="nw312" tidref="i2471"font idxid="w5903"book="_idx" docset="nw312" tidref="i2467"list for a spooler not using the -f option, type this command at the console prompt:  idxid="w5904"book="_idx" docset="nw312" tidref="i5477"ATPSQUERY idxid="w5905"book="_idx" docset="nw312" tidref="i534"spooler-name<Enter>To update the font list for all spoolers that derive their font list from a particular AppleTalk printer, type this command at the console prompt: ATPSQUERY printer-name<Enter>idxid="w5906"book="_idx" docset="nw312" tidref="i5282"If you want to force an update of all font lists for all spoolers not using the -f option, type ATPSQUERY ALL <Enter>If you are using the -f option, the font list file you specified may be unrepresentative of the printer. Please see IDREF="FM38361""PostScript Font Lists: *.FNT Files" on page 183 for details.Symptom: Macintosh Clients Download Fonts UnnecessarilyIf, when printing a document, a Macintosh client downloads fonts that are known to be resident on the printer, it means that the font list maintained by the AppleTalk print spooler does not include the full set of fonts resident on the printer.For corrective actions you can take in this situation, see IDREF="FM33224""Symptom: Printer Substitutes Bitmap Fonts for Fonts" on page 235.Symptom: PostScript idxid="w5907"book="_idx" docset="nw312" tidref="i6910"Jobs Use the Wrong FontIf the font list maintained by a spooler includes a font that the PostScript printer does not currently support, the spooler does not force a download of the font from the Macintosh, and the printer improvises idxid="w5908"book="_idx" docset="nw312" tidref="i5482"by idxid="w5909"book="_idx" docset="nw312" tidref="i2471"substituting a idxid="w5910"book="_idx" docset="nw312" tidref="i2471"default font, often Courier, for the missing font.For corrective actions you can take in this situation, see IDREF="FM33224""Symptom: Printer Substitutes Bitmap Fonts for Fonts" on page 235.ID="FM23294"Symptom: idxid="w5911"book="_idx" docset="nw312" tidref="i6910"ATPS Cannot Find the AppleTalk PrinterIf ATPS cannot find the AppleTalk printer associated with a queue, it prints this message: can't find printer printer-name:type@zone-name retryingIf you see this message, make sure that these conditions are true:The printer is on.First, check the printer and make sure it has not been turned off or is not in an error state (such as a paper jam).idxid="w5912"book="_idx" docset="nw312" tidref="i482"You can see the printer in the ATCON Lookup service.If you cannot see the printer name in ATCON, you should check the AppleTalk internet configuration, as described in IDREF="FM36163""Symptom: Macintosh Client Can't See Server in the Chooser" on page 210.If you can see the printer in ATCON, check for a trailing space character at the end of the printer's name. (The Apple Namer software sometimes adds a trailing blank to a printer's name.) This situation does not affect the Chooser, which displays all services of a particular type, but it does affect the ATPS module, which searches for the printer by name.For information on looking up an AppleTalk printer using ATCON, see IDREF="FM18937""Looking Up an AppleTalk Service" on page 274.The easiest way to check the printer's name for trailing blanks is to choose the printer in the Chooser and then initiate a Macintosh print job. The name of the printer idxid="w5913"book="_idx" docset="nw312" tidref="i6910"appears in idxid="w5914"book="_idx" docset="nw312" tidref="i6910"quotes idxid="w5915"book="_idx" docset="nw312" tidref="i5425"at idxid="w5916"book="_idx" docset="nw312" tidref="i5282"the idxid="w5917"book="_idx" docset="nw312" tidref="i6910"top of idxid="w5918"book="_idx" docset="nw312" tidref="i6910"the idxid="w5919"book="_idx" docset="nw312" tidref="i4280"print idxid="w5920"book="_idx" docset="nw312" tidref="i271"dialog. idxid="w5921"book="_idx" docset="nw312" tidref="i271"LBL="A"AppleTalk Configuration Concepts idxid="w5922"book="_idx" docset="nw312" tidref="i271"idxid="w5923"book="_idx" docset="nw312" tidref="i362"idxid="w5924"book="_idx" docset="nw312" tidref="i4280"This appendix provides background information about AppleTalk and about how to configure the AppleTalk router in NetWare for Macintosh.For an explanation of each step in installing and configuring the router in NetWare for Macintosh, see IDREF="FM41469""Configuring the Router in NetWare for Macintosh," below. This section describes the LOAD and BIND command lines, correlating standard AppleTalk configuration information with the requirements of the NetWare for Macintosh software.If you are unfamiliar with AppleTalk networks, see IDREF="FM25043""AppleTalk Basics" on page 250 for an introduction to the AppleTalk protocols and how they operate on a network.ID="FM41469"Configuring the idxid="w5925"book="_idx" docset="nw312" tidref="i362"Router idxid="w5926"book="_idx" docset="nw312" tidref="i362"in idxid="w5927"book="_idx" docset="nw312" tidref="i362"NetWare for Macintosh idxid="w5928"book="_idx" docset="nw312" tidref="i4280"You can specify the LOAD and BIND command lines described in this section at the console prompt, but you should include them in idxid="w5929"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF to make sure the system executes them in the proper order.The NetWare file server's AUTOEXEC.NCF file is a batch file containing commands executed each time you reboot the file server. ID="FM22523"Loading the AppleTalk idxid="w5930"book="_idx" docset="nw312" tidref="i260"ModuleWhen you load the AppleTalk module (APPLETLK.NLM), you specify flag options and parameters as follows: load appletlk [-z][-t][-c] net=number[zone={"name"}]The parameters and flag options are shown in IDREF="FM12807"Table A-1.LBL="A-1" INLINE="F"ID="FM12807"LOAD APPLETLK Parameters and Flag OptionsWIDTH="108"OptionWIDTH="312"ExplanationWIDTH="108"-z idxid="w5931"book="_idx" docset="nw312" tidref="i260"WIDTH="312"Opens and reads the idxid="w5932"book="_idx" docset="nw312" tidref="i48"ATZONES.CFG idxid="w5933"book="_idx" docset="nw312" tidref="i260"file in SYS:SYSTEM at load time. If you  specify this option, the ATZONES.CFG file must exist in SYS:SYSTEM and  must contain valid zone configuration lines; otherwise, the AppleTalk  module does not load. f you specify the -z flag, and you supply the ZONE  parameter on the LOAD APPLETLK or on a BIND command line, the name  you specify on the command line is used. Please see IDREF="FM10439""Using the  ATZONES.CFG Configuration File" on page 243.-t idxid="w5934"book="_idx" docset="nw312" tidref="i260"Turns idxid="w5935"book="_idx" docset="nw312" tidref="i38"on idxid="w5936"book="_idx" docset="nw312" tidref="i362"transition routing. You must use this option (and the other  configuration requirements for idxid="w5937"book="_idx" docset="nw312" tidref="i362"Transition idxid="w5938"book="_idx" docset="nw312" tidref="i6881"Mode) when idxid="w5939"book="_idx" docset="nw312" tidref="i5072"Phase 1 routers are  present on the internet. See Appendix B for details. This option causes the  router to check that extended networks are configured with constrained idxid="w5940"book="_idx" docset="nw312" tidref="i271"network ranges and zones lists. This option also modifies the behavior of  the router to operate with idxid="w5941"book="_idx" docset="nw312" tidref="i317"AppleTalk Phase 1 routers when a Phase 1 router  is present on one of its interfaces. If a Phase 1 router is present and you do  not use this option, multiple error messages appear in the system log.-c idxid="w5942"book="_idx" docset="nw312" tidref="i260"Turns on idxid="w5943"book="_idx" docset="nw312" tidref="i14"DDP packet checksums. idxid="w5944"book="_idx" docset="nw312" tidref="i1329"This option causes the router to calculate  checksums and compare them with checksums contained in AppleTalk  packets. It is intended for use on internets where all nodes and routers use  checksums. See IDREF="FM26076""Using DDP Checksum Verification in the Router" on page  247.net=number idxid="w5945"book="_idx" docset="nw312" tidref="i260"number is the idxid="w5946"book="_idx" docset="nw312" tidref="i4160"AppleTalk network number of idxid="w5947"book="_idx" docset="nw312" tidref="i4556"the idxid="w5948"book="_idx" docset="nw312" tidref="i2912"internal network. See IDREF="FM34323""Internal Network and Zone Configuration" on page 19 and the example  LOAD comand lines in Chapters 3 and 4 for more information.zone={"name1"[,"name2"...]}name1 is the idxid="w5949"book="_idx" docset="nw312" tidref="i7576"default zone of the idxid="w5950"book="_idx" docset="nw312" tidref="i396"internal idxid="w5951"book="_idx" docset="nw312" tidref="i2912"network, idxid="w5952"book="_idx" docset="nw312" tidref="i396"in which idxid="w5953"book="_idx" docset="nw312" tidref="i2937"AFP idxid="w5954"book="_idx" docset="nw312" tidref="i7588"file services  will be advertised. If name2 is specified, it can be used as an alternative to  the default zone of the internal network for advertising print queues. See IDREF="FM34323""Internal Network and Zone Configuration" on page 19 and IDREF="FM12141""Advertising  a Queue in a Specified Zone: -o" on page 160 for more information. idxid="w5955"book="_idx" docset="nw312" tidref="i260"ID="FM28159"Loading idxid="w5956"book="_idx" docset="nw312" tidref="i3085"LAN idxid="w5957"book="_idx" docset="nw312" tidref="i3085"Drivers idxid="w5958"book="_idx" docset="nw312" tidref="i271"with idxid="w5959"book="_idx" docset="nw312" tidref="i247"AppleTalk idxid="w5960"book="_idx" docset="nw312" tidref="i271"Frame idxid="w5961"book="_idx" docset="nw312" tidref="i3085"TypesIn NetWare v3.12, a LAN driver is a loadable module that communicates between the network board and a protocol stack, in this case, AppleTalk. When you load a LAN driver, you specify parameters that allocate a specific interrupt and port (I/O address) to the network board. These parameters uniquely identify the board to the system. For example, if there are two boards of the same type, each board must have a unique interrupt and port, as shown in these command lines: load ne2000 int=3 port=200 load ne2000 int=5 port=320The interrupt and port values indicate hardware settings on the actual board. See the documentation accompanying the network board for hardware settings, and NetWare v3.12System Administration for more information about the driver parameters that you can specify on the LAN driver LOAD command line.ID="FM12917"AppleTalk idxid="w5962"book="_idx" docset="nw312" tidref="i3085"idxid="w5963"book="_idx" docset="nw312" tidref="i2520"Packet idxid="w5964"book="_idx" docset="nw312" tidref="i311"Frames idxid="w5965"book="_idx" docset="nw312" tidref="i310"idxid="w5966"book="_idx" docset="nw312" tidref="i1874"To idxid="w5967"book="_idx" docset="nw312" tidref="i4897"allow an idxid="w5968"book="_idx" docset="nw312" tidref="i6839"Ethernet or idxid="w5969"book="_idx" docset="nw312" tidref="i6839"Token Ring LAN driver to handle AppleTalk packets, you must specify a packet frame type when you load the LAN driver. When loading the LAN driver, you must add one of these phrases to the LOAD command line: frame=token-ring_snap frame=ethernet_snap frame=ethernet_iiidxid="w5970"book="_idx" docset="nw312" tidref="i318"For example, idxid="w5971"book="_idx" docset="nw312" tidref="i318"the LOAD idxid="w5972"book="_idx" docset="nw312" tidref="i1896"command lines idxid="w5973"book="_idx" docset="nw312" tidref="i1896"for two extended networks might look like one of these:  idxid="w5974"book="_idx" docset="nw312" tidref="i3245"load token int=2 ls=32 frame=token-ring_snap load ne2000 int=5 port=320 frame=ethernet_snapThe frame parameter causes the router to add certain kinds of information to each AppleTalk packet. The first type of information is required by the IEEE 802.3 (Ethernet) or 802.5 (Token Ring) specification. The second type is required by the SubNet Access Protocol (SNAP) specification. The process of adding information results in EtherTalk 2.0 or TokenTalk packets like those shown in IDREF="FM29699"Figure A-1 on page 240.LBL="A-1"ID="FM29699"SNAP idxid="w5975"book="_idx" docset="nw312" tidref="i6839"Frames idxid="w5976"book="_idx" docset="nw312" tidref="i6839"for idxid="w5977"book="_idx" docset="nw312" tidref="i1896"Extended idxid="w5978"book="_idx" docset="nw312" tidref="i1896"NetworksFILE="n312r112.pbm"idxid="w5979"book="_idx" docset="nw312" tidref="i1881"For nonextended AppleTalk networks, idxid="w5980"book="_idx" docset="nw312" tidref="i1881"EtherTalk 1.0 requires a packet frame specification. idxid="w5981"book="_idx" docset="nw312" tidref="i3355"LocalTalk idxid="w5982"book="_idx" docset="nw312" tidref="i3355"cable (designed to support AppleTalk) uses the Link Access Protocol (LLAP) to transmit AppleTalk packets. idxid="w5983"book="_idx" docset="nw312" tidref="i458"ARCnet idxid="w5984"book="_idx" docset="nw312" tidref="i458"uses the default frame type used by IPX, so if you have loaded IPX on a LAN driver, you do not need to reload the driver for AppleTalk on ARCnet.EtherTalk 1.0 networks use the "Ethernet Type 2" frame, shown in IDREF="FM22189"Figure A-2 on page 241. For example, the LOAD command line for a nonextended Ethernet network might look like this: load ne2000 int=3 port=200 frame=ethernet_iiThis specification causes the router to add information required by the Ethernet 2.0 specification to AppleTalk packets being transmitted on the EtherTalk 1.0 interface. IDREF="FM22189"Figure A-2 on page 241 shows a LocalTalk packet (which does not require a frame) and an EtherTalk 1.0 packet with the "ETHERNET_II" frame type.LBL="A-2"ID="FM22189"Frames for Nonextended NetworksFILE="n312r113.pbm"If you are using both EtherTalk 1.0 and EtherTalk 2.0 on a single Ethernet cable, you must load the LAN driver with both types of frame; for example, the command lines might look like this: load ne2000 int=3 port=200 frame=ethernet_ii load ne2000 int=3 port=200 frame=ethernet_snapIn this case, you are binding a LAN driver with two different frames to the same NE2000 Ethernet board, because the interrupt and port values are the same. When you load a LAN driver more than once, the driver loads "re-entrantly." Later, when you use the idxid="w5985"book="_idx" docset="nw312" tidref="i3930"MODULES command, you will see only one NE2000 LAN driver loaded; idxid="w5986"book="_idx" docset="nw312" tidref="i4897"however, idxid="w5987"book="_idx" docset="nw312" tidref="i3085"both idxid="w5988"book="_idx" docset="nw312" tidref="i3085"frame idxid="w5989"book="_idx" docset="nw312" tidref="i3085"types idxid="w5990"book="_idx" docset="nw312" tidref="i2520"are idxid="w5991"book="_idx" docset="nw312" tidref="i1881"associated idxid="w5992"book="_idx" docset="nw312" tidref="i1881"with it. idxid="w5993"book="_idx" docset="nw312" tidref="i318"Please idxid="w5994"book="_idx" docset="nw312" tidref="i1874"see idxid="w5995"book="_idx" docset="nw312" tidref="i318"NetWare v3.12idxid="w5996"book="_idx" docset="nw312" tidref="i311"Installationidxid="w5997"book="_idx" docset="nw312" tidref="i310"for idxid="w5998"book="_idx" docset="nw312" tidref="i271"details. idxid="w5999"book="_idx" docset="nw312" tidref="i247"ID="FM28641"Binding idxid="w6000"book="_idx" docset="nw312" tidref="i3085"AppleTalk idxid="w6001"book="_idx" docset="nw312" tidref="i271"to a idxid="w6002"book="_idx" docset="nw312" tidref="i3085"LAN Driver idxid="w6003"book="_idx" docset="nw312" tidref="i3085"As described in NetWare v3.12System Administration, the syntax for the BIND command is: bind protocol[to]LAN_driver [driver_parameters][protocol_parameters]The first two parameters for binding AppleTalk to a LAN driver are shown in IDREF="FM15350"Table A-2.LBL="A-2" INLINE="F"BIND Command Line ParametersID="FM15350"WIDTH="108"ParameterWIDTH="312"Acceptable ValuesWIDTH="108"protocolWIDTH="312"APPLETLKLAN_driverThe name of any Ethernet, Token Ring, or LocalTalk driver that has been  certified for NetWare v3.11 or above; for example, ne2000.Driver idxid="w6004"book="_idx" docset="nw312" tidref="i673"Parameters on the BIND Command LineThe driver parameters enclosed in square brackets following the LAN_driver name on the BIND command line uniquely identify the board and/or network interface. These parameters must match one or more of the parameters supplied on the LAN driver LOAD command line.For example, an interrupt value can uniquely identify a network board, as shown in the following partial BIND command lines: bind appletlk to ne2000 int=3... bind ipx to ne2000 int=5...Because the interrupt values are different, these command lines identify two separate Ethernet boards, one supporting an AppleTalk network interface and the other supporting an IPX network interface.In the case where a single network board supports more than one network interface, an additional parameter must be supplied to identify each interface uniquely. The frame type, as a rule, uniquely identifies an interface, as shown in the following partial BIND command lines: bind appletlk to ne2000 int=3 frame=ethernet_snap ... bind appletlk to ne2000 int=3 frame=ethernet_ii ...Because the interrupt values are the same, these command lines identify two separate interfaces (EtherTalk 2.0 and EtherTalk 1.0) on the same Ethernet board. Please see IDREF="FM26030""Example 7: An EtherTalk 1.0 and EtherTalk 2.0 Network" on page 84 for more information.Please see BIND in NetWare v3.12System Administration for more information on the driver parameters that you can use. idxid="w6005"book="_idx" docset="nw312" tidref="i673"Using a idxid="w6006"book="_idx" docset="nw312" tidref="i673"Driver Name idxid="w6007"book="_idx" docset="nw312" tidref="i1735"Instead of idxid="w6008"book="_idx" docset="nw312" tidref="i3085"Specifying idxid="w6009"book="_idx" docset="nw312" tidref="i3245"Parameters idxid="w6010"book="_idx" docset="nw312" tidref="i4"NetWare v3.12 supports the NAME option that allows you to assign a name on the LAN driver LOAD command line, such as this one: load dl2000 int=2 port=320 name=ltalkAfter assigning a name with the NAME option, you can refer to the driver on the BIND command line by name, rather than by interrupt value and/or frame type, such as in this example: bind appletlk ltalk net=100 zone={"printers"}Please see NetWare v3.12System Administration for a more complete discussion of the NAME option.ID="FM27185"AppleTalk Protocol idxid="w6011"book="_idx" docset="nw312" tidref="i357"Parameters idxid="w6012"book="_idx" docset="nw312" tidref="i673"on the BIND idxid="w6013"book="_idx" docset="nw312" tidref="i1934"Command idxid="w6014"book="_idx" docset="nw312" tidref="i4661"LineThe protocol parameters required at the end of each BIND command line define the AppleTalk network configuration on that interface. This syntax is used at the end of the BIND command line: net=n1[-n2][zone={"name1" [,"name2"][,...,"nameN"]}]There is an idxid="w6015"book="_idx" docset="nw312" tidref="i673"82-character limit on BIND command lines. See IDREF="FM10439""Using the ATZONES.CFG Configuration File," below for information on configuring zones lists that would cause a BIND idxid="w6016"book="_idx" docset="nw312" tidref="i3085"command line to idxid="w6017"book="_idx" docset="nw312" tidref="i271"exceed 82 idxid="w6018"book="_idx" docset="nw312" tidref="i271"characters. idxid="w6019"book="_idx" docset="nw312" tidref="i3085"ID="FM10439"Using the idxid="w6020"book="_idx" docset="nw312" tidref="i569"ATZONES.CFG Configuration Fileidxid="w6021"book="_idx" docset="nw312" tidref="i673"NetWare imposes an idxid="w6022"book="_idx" docset="nw312" tidref="i48"82-character limit on BIND command lines. If a zones list causes the BIND command line to exceed 82 characters, idxid="w6023"book="_idx" docset="nw312" tidref="i673"you must use the idxid="w6024"book="_idx" docset="nw312" tidref="i673"-zidxid="w6025"book="_idx" docset="nw312" tidref="i260"flag when idxid="w6026"book="_idx" docset="nw312" tidref="i48"loading the idxid="w6027"book="_idx" docset="nw312" tidref="i48"AppleTalk module, and provide all zone names for the current file server in the SYS:SYSTEM\ATZONES.CFG configuration file.If you specify the -z option on the LOAD APPLETLK command line, and ATZONES.CFG does not reside in SYS:SYSTEM, the AppleTalk module fails to load. If you specify the -z flag, and you supply the ZONE parameter on the LOAD APPLETLK or on a BIND command line, the name you specify on the command line is used. (However, the ATZONES.CFG file must still exist in SYS:SYSTEM.) Entries in the ATZONES.CFG file provide a correspondence between idxid="w6028"book="_idx" docset="nw312" tidref="i396"network idxid="w6029"book="_idx" docset="nw312" tidref="i396"numbers idxid="w6030"book="_idx" docset="nw312" tidref="i4556"(or idxid="w6031"book="_idx" docset="nw312" tidref="i271"ranges) idxid="w6032"book="_idx" docset="nw312" tidref="i4569"and idxid="w6033"book="_idx" docset="nw312" tidref="i7576"zone idxid="w6034"book="_idx" docset="nw312" tidref="i7576"names. idxid="w6035"book="_idx" docset="nw312" tidref="i396"If you load the AppleTalk module with the -z flag and you do not specify zone names on the LOAD APPLETLK or BIND command lines, the installation procedure supplies the missing zone names from the ATZONES.CFG file. If the LOAD APPLETLK and/or a BIND command linedoes specify one or more zone names, the installation procedure does not access ATZONES.CFG for that network and uses any names specified on the command line.Creating or idxid="w6036"book="_idx" docset="nw312" tidref="i569"Modifying idxid="w6037"book="_idx" docset="nw312" tidref="i569"ATZONES.CFGYou can create or modify the ATZONES.CFG file while using the INSTALL program. To do so, load INSTALL and select Product Options, then press <Enter> on the line specifying NetWare for Macintosh. To create or modify ATZONES.CFG, select it in the "Editable Configuration Files" window and then press <Enter>.To configure zones, add command lines in the format shown in IDREF="FM16886"Figure A-3.LBL="A-3"ID="FM16886"Sample ATZONES.CFG FileFILE="n312r114.pbm"idxid="w6038"book="_idx" docset="nw312" tidref="i396"ATZONES.CFG ignores blank spaces and blank lines, so you can use white space to organize the file by network. The network numbers or ranges you enter in this file must match those on the LOAD and BIND command lines in AUTOEXEC.NCF.When you have configured the zones you need in ATZONES.CFG, press <Esc> and then <Enter> to save your changes and then press <Esc> as necessary to exist INSTALL.Remember that for the router in NetWare for Macintosh, the first name in a zones list is the default zone. All Macintosh clients reside in the default zone unless they choose to belong to another zone in the zones list. See IDREF="FM18089""What Is the Phase 2 Default Zone?" on page 255 if you would like more idxid="w6039"book="_idx" docset="nw312" tidref="i569"information. idxid="w6040"book="_idx" docset="nw312" tidref="i569"ATZONES.CFG idxid="w6041"book="_idx" docset="nw312" tidref="i569"Syntax idxid="w6042"book="_idx" docset="nw312" tidref="i569"The ATZONES.CFG file uses the same syntax for specifying networks and zones as that used on the LOAD APPLETLK and BIND command lines: net=n1[-n2] [zone={"name1" [,"name2"][,...,"nameN"]}]There are two keywords, NET and ZONE. Any amount of blank space and blank lines are acceptable in ATZONES.CFG. Therefore, you can organize the file as you wish, provided that the syntax arguments occur in the proper order.This sample ATZONES.CFG file contains zone configuration lines for three extended networks and two nonextended networks: net=1-10 zone={"A zone", "B zone", "C zone"} net=11-20 zone={ "X zone", "Y zone", "Z zone" } net=21-21 zone={"X zone"} net=22 zone={"A zone"} net=23 zone={"B zone"}The syntax rules are listed below:The first non-blank (non-white-space) character following the keyword NET must be an equal-sign (=), followed by a valid AppleTalk network number or a valid network range (a number followed by a hyphen and another number).If the keyword NET precedes any other characters, the system ignores the line.If the keyword NET is absent, the AppleTalk module does not load.The first non-blank (non-white-space) character following the keyword ZONE must be an equal-sign (=), followed by a left brace ({), followed by a double-quote (").The double-quote character must be followed by a string (up to 32 characters, which can include spaces) that represents the zone name. The zone name must be followed by a closing double-quote ("). If the zone name is longer than 32 characters, the system truncates it and generates an error message.After the enclosing double-quote, the syntax allows either a comma (,) or a right brace (}). If the next character is a comma, it must be followed by a double-quote, another zone name, a closing double-quote, and so forth.If the keyword ZONE precedes any other sequence of characters, the system ignores the line.If the keyword ZONE is absent, the AppleTalk module does idxid="w6043"book="_idx" docset="nw312" tidref="i569"not load. idxid="w6044"book="_idx" docset="nw312" tidref="i569"How the System idxid="w6045"book="_idx" docset="nw312" tidref="i569"Opens and Reads the ATZONES.CFG FileWhen the NetWare v3.12 operating system is loading the AppleTalk module and encounters the idxid="w6046"book="_idx" docset="nw312" tidref="i48"-z option, it looks for ATZONES.CFG in SYS:SYSTEM. If it does not find the file, it does not load the AppleTalk module. If it finds the file, it scans the file looking for the keywords NET and ZONE, and checks the syntax as specified above.If you specify the -z option and specify a zone name on the LOAD APPLETLK and/or BIND command lines, the system uses the zone name specified on the command line and not the configuration specified in ATZONES.CFG for that network.When it has checked the entire ATZONES.CFG file, NetWare v3.12 reads the file contents into memory and begins executing the LOAD APPLETLK command line. When it encounters the keyword NET on the LOAD APPLETLK command line, the operating system first checks for the keyword ZONE and a zone name on the current line. If it finds one, it uses that zone name and proceeds to the BIND command lines. If it does not find a zone name on the current command line, it checks its memory for a matching network idxid="w6047"book="_idx" docset="nw312" tidref="i4556"number and reads the corresponding idxid="w6048"book="_idx" docset="nw312" tidref="i7576"zone name (the internal zone) into the AppleTalk zones list maintained by the router.After loading the AppleTalk module, the operating system continues executing the commands in the AUTOEXEC.NCF file. When NetWare begins to execute the BIND command lines, it reads the network configuration beginning with the keyword NET, and checks for the keyword ZONE and a zone name on the current command line. If it finds one, it uses that zone name. If it doesn't find one, it compares the network number or range with the data in memory obtained from ATZONES.CFG. When NetWare finds a matching network number or range, it reads the corresponding zones list into the zones list maintained by the router. idxid="w6049"book="_idx" docset="nw312" tidref="i569"ID="FM26076"Using DDP Checksum idxid="w6050"book="_idx" docset="nw312" tidref="i271"Verification idxid="w6051"book="_idx" docset="nw312" tidref="i14"in the idxid="w6052"book="_idx" docset="nw312" tidref="i4652"Routeridxid="w6053"book="_idx" docset="nw312" tidref="i311"When you idxid="w6054"book="_idx" docset="nw312" tidref="i1329"load the idxid="w6055"book="_idx" docset="nw312" tidref="i1329"AppleTalk module, you can specify the -c (checksums) flag option:  idxid="w6056"book="_idx" docset="nw312" tidref="i260"load appletlk -c net=number zone={"name"}When you specify the -c option while loading the AppleTalk module, all AppleTalk packets that the router generates contain a idxid="w6057"book="_idx" docset="nw312" tidref="i362"DDP checksum, and all packets that the router receives containing a checksum have that checksum verified. (Examples of packets that the router generates are Echo responses and NBP responses.) This option is primarily intended for use on existing AppleTalk networks where DDP checksums are already in use by most nodes and routers.When checksums are enabled, the router fills or verifies the checksum field in all RTMP data packets, NBP LkUp and FwdReq packets, ZIP query and response packets, Echo responses, and so forth, that are sent out or received by the router as an end-point. That is, if the router is simply passing the AppleTalk packets to another node or router, the router performs no verification. For this reason, nodes (such as Macintosh workstations) must also support checksums for checksum verification to be useful.A checksum field of zero (0) indicates "no checksum."ID="FM38004"AppleTalk idxid="w6058"book="_idx" docset="nw312" tidref="i6466"Stack/Router idxid="w6059"book="_idx" docset="nw312" tidref="i362"Memory idxid="w6060"book="_idx" docset="nw312" tidref="i3794"Requirements idxid="w6061"book="_idx" docset="nw312" tidref="i2227"The AppleTalk stack/router requires 200 Kbytes of memory to load, and has a varying requirement for short-term memory and Event Control Blocks (ECBs, also called packet-receive buffers) during normal operation. The exact requirement for short-term memory and ECBs depends on the server load, the number of NLMs loaded, and the performance needs at your site. If there is insufficient short-term memory or installed memory, or if the number of ECBs available for the stack/router is too low, the router eventually starts dropping packets and closing user connections.Short-Term Memory Allocation idxid="w6062"book="_idx" docset="nw312" tidref="i2227"idxid="w6063"book="_idx" docset="nw312" tidref="i2227"If the server is in a low-memory condition, you usually see these console messages: short term allocator failed, out of memory  idxid="w6064"book="_idx" docset="nw312" tidref="i888"cache buffers getting low Out of cache buffersIf you see these messages, use the idxid="w6065"book="_idx" docset="nw312" tidref="i3945"MONITOR console utility to get more information about the server's memory condition. If MONITOR indicates that the idxid="w6066"book="_idx" docset="nw312" tidref="i2227"Cache Buffers are near zero, then you should install more memory in the server. If it indicates that the Alloc Memory Pool is near its maximum, you should increase the short-term memory allocation; for example, you might enter this command line: set maximum alloc short term memory=2500000Because short-term memory is not dynamically de-allocated, the maximum allocation is specified, with a default of 2 Mbytes. The command shown above increases the allocation from the default 2 Mbytes to 2.5 Mbytes.Of course, the server must have enough memory installed for this command to have the desired effect.Alternatively, you can reduce the number of connections you are using; for example, you might load the AFP module with the "Limit Sessions" option. idxid="w6067"book="_idx" docset="nw312" tidref="i2227"See IDREF="FM22417""Memory Issues: Limiting the Number of AFP Login Sessions" on page 141 for instructions. idxid="w6068"book="_idx" docset="nw312" tidref="i2227"Packet-Receive idxid="w6069"book="_idx" docset="nw312" tidref="i4901"Buffers idxid="w6070"book="_idx" docset="nw312" tidref="i1914"(ECBs) idxid="w6071"book="_idx" docset="nw312" tidref="i2227"You must allocate a minimum of 100 packet-receive buffers before the stack/router loads. Add this configuration line to the file server's STARTUP.NCF file: set minimum packet receive buffers=100To test that the router has sufficient ECBs allocated, use the MONITOR command to check the number of ECBs used after letting the router run for an hour or more. (The ECB number is in the upper right-hand corner of the screen in the MONITOR program.) If you see it incrementing rapidly, you should probably set the number of packet-receive buffers higher.Like short-term memory, ECBs are not dynamically de-allocated, and the maximum allocation is usually specified, for example, set maximum packet receive buffers=500Servers that run for several days under variable load conditions in which "peaks" in server load occur may often encounter situations where they will want to break the 500 ECB maximum. In these instances of unusually high demand, the error message  idxid="w6072"book="_idx" docset="nw312" tidref="i1848"Unable to allocate ECBsmay be generated in the system log. This is not a fatal condition, and it corrects itself when the "peak" has subsided. However, if the server consistently has a very high load with many IPX and AppleTalk connections, you can improve performance by increasing the maximum ECB idxid="w6073"book="_idx" docset="nw312" tidref="i2227"allocation ( idxid="w6074"book="_idx" docset="nw312" tidref="i6466"provided, idxid="w6075"book="_idx" docset="nw312" tidref="i4901"of idxid="w6076"book="_idx" docset="nw312" tidref="i3794"course, idxid="w6077"book="_idx" docset="nw312" tidref="i2227"that idxid="w6078"book="_idx" docset="nw312" tidref="i1914"the idxid="w6079"book="_idx" docset="nw312" tidref="i362"server has idxid="w6080"book="_idx" docset="nw312" tidref="i4280"sufficient idxid="w6081"book="_idx" docset="nw312" tidref="i362"memory idxid="w6082"book="_idx" docset="nw312" tidref="i362"installed). idxid="w6083"book="_idx" docset="nw312" tidref="i362"ID="FM25043"AppleTalk idxid="w6084"book="_idx" docset="nw312" tidref="i271"Basics idxid="w6085"book="_idx" docset="nw312" tidref="i271"idxid="w6086"book="_idx" docset="nw312" tidref="i4280"This section lists the AppleTalk protocols implemented in NetWare for Macintosh and provides a brief description of their basic functionality. It also provides some information about how AppleTalk zones work on an internet that will be useful to AppleTalk internet administrators.This section provides a basic introduction to the AppleTalk terms and concepts used in this guide. For a complete introduction as well as the complete technical specification for AppleTalk, please see idxid="w6087"book="_idx" docset="nw312" tidref="i2826"Inside AppleTalk, Second Edition.AppleTalk idxid="w6088"book="_idx" docset="nw312" tidref="i357"Protocol idxid="w6089"book="_idx" docset="nw312" tidref="i357"Layers idxid="w6090"book="_idx" docset="nw312" tidref="i271"idxid="w6091"book="_idx" docset="nw312" tidref="i357"IDREF="FM17119"Figure A-4 on page 251 shows the AppleTalk protocols implemented in NetWare for Macintosh. The diagram below represents the standard AppleTalk protocols as described on page I-20 of Inside AppleTalk:LBL="A-4"ID="FM17119"AppleTalk ProtocolsFILE="n312r115.pbm"IDREF="FM27567"Table A-3 explains the role of each of the AppleTalk protocols.LBL="A-3" INLINE="F"ID="FM27567"AppleTalk ProtocolsWIDTH="108"ProtocolWIDTH="312"DescriptionWIDTH="108"AFP idxid="w6092"book="_idx" docset="nw312" tidref="i229"WIDTH="312"(AppleTalk Filing Protocol). AFP allows Macintosh users to share files by  interacting directly with the NetWare file system, at the same level as NCP  interaction.PAP idxid="w6093"book="_idx" docset="nw312" tidref="i5470"(Printer Access Protocol). PAP allows Macintosh users to access printers or  print queues on the AppleTalk network.ADSP idxid="w6094"book="_idx" docset="nw312" tidref="i225"(AppleTalk Data Stream Protocol). ADSP allows two programs to  communicate via a full-duplex data stream connection in which either  program can read or write data bytes with reliable delivery.ZIP idxid="w6095"book="_idx" docset="nw312" tidref="i7575"(Zone Information Protocol). ZIP maps zone names to network numbers  and uses queries to maintain this mapping when new zones are added to  an internet. AppleTalk uses zones to logically subdivide the internet so that  the names of services are easier for users to find. All service name-searching  is done within one zone at a time. The ZIP protocol is used by routers to  request and provide zone information when a router comes up with a new  network configuration. Please see IDREF="FM27796""How Zone Information Is Maintained  on an Internet" on page 255.ASP idxid="w6096"book="_idx" docset="nw312" tidref="i394"(AppleTalk Session Protocol). ASP works with and extends ATP  functionality (described below) by allowing two processes to exchange a  sequence of transactions reliably. RTMP idxid="w6097"book="_idx" docset="nw312" tidref="i6057"(Routing Table Maintenance Protocol). RTMP is used by routers to  exchange routing information needed to build and maintain each router's  routing table. When a router receives a packet, it consults the destination  network number in the packet and compares it with the network numbers  in its routing table; it can thereby find a way to route that packet to the  destination network or to another router closer to the destination network.  All AppleTalk routers on the internet continuously maintain their routing  tables by exchanging RTMP packets. Please see IDREF="FM16049""How Routing Tables Are  Maintained" on page 288 for more information.AEP idxid="w6098"book="_idx" docset="nw312" tidref="i227"(AppleTalk Echo Protocol). AEP is a support protocol that provides a way  for a node to "bounce" a packet off another node. In NetWare for  Macintosh , both the router and the stack support the Echo protocol.  The ATCON utility provides an Echo test function.ATP idxid="w6099"book="_idx" docset="nw312" tidref="i395"(AppleTalk Transaction Protocol). ATP is a basic transport protocol that  provides loss-free transaction services. ATP detects errors and timeouts,  providing reliable packet exchange.NBP idxid="w6100"book="_idx" docset="nw312" tidref="i3978"(Name Binding Protocol). NBP maps names (user-designated character  strings) to network addresses and to services. When users request an  AppleTalk service such as a printer in the Chooser, NBP is responsible for  broadcasting the request in the selected zone and displaying the names of  responding services in the Chooser. One or more routers might forward  the request to the appropriate zone. See IDREF="FM37325""AppleTalk Zones," below, for  more information about how NBP works.DDP idxid="w6101"book="_idx" docset="nw312" tidref="i1319"(Datagram Delivery Protocol). DDP opens sockets on AppleTalk nodes and  permits datagram (packet) delivery between sockets. It provides a  mechanism to address any node on an AppleTalk internet uniquely.LLAP idxid="w6102"book="_idx" docset="nw312" tidref="i3200"(LocalTalk Link Access Protocol). LLAP is AppleTalk's data-link level protocol  for LocalTalk. At this level, AppleTalk adds hardware-specific header  information and sends packets out onto the specific hardware link. See IDREF="FM22189"Figure A-2 on page 241 for a picture of a packet with an LLAP header.ELAP(EtherTalk Link Access Protocol). ELAP is AppleTalk's data-link level protocol  for Ethernet. At this level, AppleTalk adds hardware-specific header  information and sends packets out onto the specific hardware link. See IDREF="FM29699"Figure A-1 on page 240 for information about the Ethernet 2.0 frame and  a picture of the SNAP frame used by Ethernet in NetWare for Macintosh.TLAP(Token Ring Link Access Protocol). TLAP is AppleTalk's data-link level  protocol for Token Ring. At this level, AppleTalk adds hardware-specific  address and other "packet-frame" information and sends packets out onto  the Token Ring hardware. Please see IDREF="FM29699"Figure A-1 on page 240 for a picture  the SNAP frame supported for Token Ring in NetWare for Macintosh.AARP idxid="w6103"book="_idx" docset="nw312" tidref="i223"(AppleTalk Address Resolution Protocol). This protocol maps AppleTalk  addresses (network and node numbers) into Ethernet or Token Ring  hardware addresses and is used to manage the process of each AppleTalk  node acquiring its unique node address idxid="w6104"book="_idx" docset="nw312" tidref="i357"on idxid="w6105"book="_idx" docset="nw312" tidref="i357"these idxid="w6106"book="_idx" docset="nw312" tidref="i357"media. idxid="w6107"book="_idx" docset="nw312" tidref="i271"ID="FM37325"AppleTalk Zones idxid="w6108"book="_idx" docset="nw312" tidref="i396"idxid="w6109"book="_idx" docset="nw312" tidref="i396"An AppleTalk zone is a logical grouping of devices that enables users to locate and access network services in the Chooser. A zone name is a logical name associated with some or all of the services on a network or a set of networks.idxid="w6110"book="_idx" docset="nw312" tidref="i396"When you configure AppleTalk zone names in the router, the zone names act as a top-level organizer in the Chooser. A user selects the zone name that indicates where a service is located; for example, a zone named "Building 1" or "Engineering" could indicate where a printer or file server resides. After selecting a zone name, the user clicks a service icon (such as the file server or printer icon) and these events occur:The Macintosh sends out NBP Broadcast Request packets.The router sends the NBP request to the right networks, possibly forwarding it to other routers as appropriate.The routers directly connected to the network(s) associated with the selected zone broadcast the NBP request to all nodes in the zone.AppleTalk services in the selected zone send NBP reply packets back to the Macintosh that originated the request, which displays the services' names in the Chooser.LBL="A-5"How Services Are Accessed in a idxid="w6111"book="_idx" docset="nw312" tidref="i396"ZoneFILE="n312r116.pbm"ID="FM18089"What Is the idxid="w6112"book="_idx" docset="nw312" tidref="i251"Phase 2 idxid="w6113"book="_idx" docset="nw312" tidref="i318"Default idxid="w6114"book="_idx" docset="nw312" tidref="i271"Zone? idxid="w6115"book="_idx" docset="nw312" tidref="i362"idxid="w6116"book="_idx" docset="nw312" tidref="i396"In idxid="w6117"book="_idx" docset="nw312" tidref="i396"NetWare idxid="w6118"book="_idx" docset="nw312" tidref="i1346"for Macintosh idxid="w6119"book="_idx" docset="nw312" tidref="i5074", idxid="w6120"book="_idx" docset="nw312" tidref="i5075"the default zone is always the first zone name entered in a zones list. Macintosh workstations always belong to the default zone until the Macintosh user explicitly chooses another zone in the Macintosh Control Panel.The zone in which a Macintosh workstation is registered is the zone in which its services (if any) will be advertised. It does not restrict the Macintosh user's ability to view and access network services in other AppleTalk zones by using the Macintosh Chooser.On an extended network, a Macintosh workstation is automatically registered in the default zone. To register in another zone, the Macintosh user should perform these steps:Open the Network Control Panel.On System 6.x, select the network icon at the left side of the Control Panel.Click the EtherTalk 2.0 or TokenTalk icon.This action displays the zones list configured on this network.Select another zone, and close the Control Panel.ID="FM27796"How Zone Information Is Maintained on an Internetidxid="w6121"book="_idx" docset="nw312" tidref="i251"When idxid="w6122"book="_idx" docset="nw312" tidref="i396"you idxid="w6123"book="_idx" docset="nw312" tidref="i396"bring up an idxid="w6124"book="_idx" docset="nw312" tidref="i396"AppleTalk idxid="w6125"book="_idx" docset="nw312" tidref="i7576"router on the network, it is initialized with its own zones and network numbers. It then begins to receive and send RTMP packets with every other router on the internet.When other routers receive RTMP packets informing them of a new network on the internet, those routers send a query to the router that represents the new network, asking for the zone name or zones list associated with the network. The new router responds to this query with its zone information. Eventually, all routers on the internet have an updated global list of all zones on the entire internet. This global list allows all Macintosh users on the internet to see services in all AppleTalk zones. Once one router has acquired zone information from another router, it does not query for zone information related to that particular network again. As long as the network has a good entry in the routers' RTMP tables, there is no way to force routers to query for its zone information again.idxid="w6126"book="_idx" docset="nw312" tidref="i396"One of the side-effects of this situation is that routers are not automatically informed about changes to zone configurations. For example, if you idxid="w6127"book="_idx" docset="nw312" tidref="i396"delete a zone name from a router configuration for one AppleTalk network, routers connected to other networks still have the deleted zone name in their lists, so it continues to be visible in the Chooser. In addition, those routers are now inconsistent with the reconfigured router, because they are still maintaining the old zone information. This inconsistency can cause a zone name to show up in the Macintosh Chooser for some time after you have deleted it, and can even cause users to see zone names appearing and disappearing in the Chooser.The only way to update zone information in all routers is to wait long enough for the RTMP tables in all routers to recognize that the relevant network is down. This usually takes between ten and twenty minutes, but it can take longer on a large internet. (Alternatively, you can down all routers on the internet and bring them up again --- this action forces an update of the RTMP tables.)idxid="w6128"book="_idx" docset="nw312" tidref="i396"If you must idxid="w6129"book="_idx" docset="nw312" tidref="i7592"reconfigure zones on a network, remember that all routers directly connected to that network must be reconfigured. To assure that the old zone names disappear uniformly on the internet, follow these steps:Down all AppleTalk routers directly connected to the network.To change the zone configuration in a server that already supports working AppleTalk ports, you must first bring down the AppleTalk router by unloading the AppleTalk module. To unload the AppleTalk module, type this command at the console prompt: UNLOAD APPLETLK <Enter>If there are third-party AppleTalk routers in use on the internet, bring them down following the usual procedure for that router.Note that when you unload the AppleTalk module, AppleTalk is automatically unbound from its interfaces.Create the new zones list (or name) in a idxid="w6130"book="_idx" docset="nw312" tidref="i396"global idxid="w6131"book="_idx" docset="nw312" tidref="i569"ATZONES.CFG file, and copy the global file to SYS:SYSTEM on each file server.If you are not using ATZONES.CFG, you can manually edit the zone names in each server's AUTOEXEC.NCF file.Make sure ten to twenty minutes have elapsed (or more, if your internet is very large) to allow other routers on the internet to recognize that the "old" zones are no longer there. If you are not sure that you have allowed enough time, check the RTMP table in one or more routers by using the ATCON utility, as described in IDREF="FM32085""Viewing the RTMP Routing Table" on page 287.Bring up the routers with the new configuration.The easiest way to do this is to down the server and bring it up again. However, if you cannot down the server, you can manually enter at the console prompt the LOAD APPLETLK and BIND APPLETLK command lines exactly as they appear in AUTOEXEC.NCF. Alternatively, you can create the new zones list, and then down all AppleTalk routers on the internet. When you bring the routers back up, each router will create a new global zones list that idxid="w6132"book="_idx" docset="nw312" tidref="i396"contains idxid="w6133"book="_idx" docset="nw312" tidref="i4280"only idxid="w6134"book="_idx" docset="nw312" tidref="i271"the idxid="w6135"book="_idx" docset="nw312" tidref="i271"current idxid="w6136"book="_idx" docset="nw312" tidref="i4280"zone idxid="w6137"book="_idx" docset="nw312" tidref="i362"names. idxid="w6138"book="_idx" docset="nw312" tidref="i271"LBL="B"ID="FM28649"Transition Mode Routingidxid="w6139"book="_idx" docset="nw312" tidref="i1934"This idxid="w6140"book="_idx" docset="nw312" tidref="i2898"appendix idxid="w6141"book="_idx" docset="nw312" tidref="i5072"describes how to idxid="w6142"book="_idx" docset="nw312" tidref="i4280"install idxid="w6143"book="_idx" docset="nw312" tidref="i5075"NetWare for Macintosh on an internet that includes one or more AppleTalk Phase 1 routers.If you don't know whether the internet at your site supports an AppleTalk Phase 1 router, check the network records. Phase 1 routers typically predate the introduction of AppleTalk Phase 2 and have not been upgraded to support Phase 2. idxid="w6144"book="_idx" docset="nw312" tidref="i1881"You idxid="w6145"book="_idx" docset="nw312" tidref="i4661"can connect Phase 1 routers only to idxid="w6146"book="_idx" docset="nw312" tidref="i5072"nonextended networks (EtherTalk 1.0, ARCnet, or idxid="w6147"book="_idx" docset="nw312" tidref="i3355"LocalTalk) because Phase 1 does not support extended networks. However, the fact that there are nonextended networks on an internet does not imply that a Phase 1 router is present.If the internet supports Phase 1 routers and you wish to keep them installed and configured as Phase 1 routers (rather than upgrade them to Phase 2), you must configure all idxid="w6148"book="_idx" docset="nw312" tidref="i1896"Phase 2 routers on the entire internet in Transition Mode.When you configure an AppleTalk router in Transition Mode, the Phase 2 router modifies its behavior to operate with a Phase 1 router on the internet.ID="FM36717"What Is Transition idxid="w6149"book="_idx" docset="nw312" tidref="i6881"Mode? idxid="w6150"book="_idx" docset="nw312" tidref="i1934"Transition Mode is way of configuring Phase 2 routers that enables them to operate with Phase 1 routers on an internet. In Transition Mode, all Phase 2 routers observe these addressing constraints to avoid idxid="w6151"book="_idx" docset="nw312" tidref="i1934"extended idxid="w6152"book="_idx" docset="nw312" tidref="i1934"ranges idxid="w6153"book="_idx" docset="nw312" tidref="i4569"and idxid="w6154"book="_idx" docset="nw312" tidref="i4569"zones lists that are incomprehensible to a Phase 1 router:idxid="w6155"book="_idx" docset="nw312" tidref="i6881"On extended networks, the first number in the network range is equal to the last number in the range, as in 10-10.idxid="w6156"book="_idx" docset="nw312" tidref="i1934"On extended networks, the idxid="w6157"book="_idx" docset="nw312" tidref="i7592"zones list has only one name.How Does Transition Mode Affect Extended Networks?The addressing constraints in Transition Mode mean that extended networks are limited to 253 devices. If you must support more than 253 EtherTalk 2.0 or TokenTalk devices, you cannot use Transition Mode. Your alternative is to upgrade the Phase 1 routers to AppleTalk Phase 2. idxid="w6158"book="_idx" docset="nw312" tidref="i6881"What Does the Router Do in Transition Mode?When you configure a router in Transition Mode, the router is prepared to send out Phase 1-compatible RTMP packets on its nonextended interfaces.RTMP packets contain information about all networks known to the router. idxid="w6159"book="_idx" docset="nw312" tidref="i6881"AppleTalk routers pass this information among themselves every ten seconds, updating and maintaining their view of the internet.idxid="w6160"book="_idx" docset="nw312" tidref="i6057"When the idxid="w6161"book="_idx" docset="nw312" tidref="i6057"Phase 2 idxid="w6162"book="_idx" docset="nw312" tidref="i6093"router is idxid="w6163"book="_idx" docset="nw312" tidref="i6093"not in Transition Mode, it always sends out Phase 2 RTMP packets. Phase 2 RTMP packets are different from Phase 1 RTMP packets, and can contain information about extended networks. A Phase 1 router cannot read the Phase 2 packets and cannot incorporate the Phase 2 information into its routing tables.When the Phase 2 router is in Transition Mode and it receives a Phase 1 RTMP packet on one of its nonextended interfaces, it sends out Phase 1-compatible RTMP packets on that network. The network information contained in these packets cannot include extended ranges and zones lists, which means that all extended networks (EtherTalk idxid="w6164"book="_idx" docset="nw312" tidref="i1896"2.0 or idxid="w6165"book="_idx" docset="nw312" tidref="i6839"TokenTalk) on the entire AppleTalk internet must be configured with a network range of one (for example, 10-10), and a zones list of one (for example, "My zone").An Internet That Does idxid="w6166"book="_idx" docset="nw312" tidref="i362"Not Require idxid="w6167"book="_idx" docset="nw312" tidref="i6881"Transition Mode idxid="w6168"book="_idx" docset="nw312" tidref="i251"IDREF="FM32136"Figure B-1 on page 261 shows a basic AppleTalk Phase 2 internet, in which all routers support AppleTalk Phase 2. The routers on this internet do not require Transition Mode.LBL="B-1"ID="FM32136"An Internet That Does Not Require Transition RoutingFILE="n312r117.pbm"In IDREF="FM32136"Figure B-1, two servers are running NetWare for Macintosh, and each server supports multiple idxid="w6169"book="_idx" docset="nw312" tidref="i1896"Phase 2 interfaces. The TokenTalk and EtherTalk 2.0 idxid="w6170"book="_idx" docset="nw312" tidref="i6839"networks can use extended network ranges, so they can support as many devices as you need (see IDREF="FM13830""AppleTalk Phase 2 Networks and Zones" on page 13idxid="w6171"book="_idx" docset="nw312" tidref="i6881"for idxid="w6172"book="_idx" docset="nw312" tidref="i362"details.). idxid="w6173"book="_idx" docset="nw312" tidref="i251"An Internet That idxid="w6174"book="_idx" docset="nw312" tidref="i251"Requires idxid="w6175"book="_idx" docset="nw312" tidref="i362"Transition ModeIDREF="FM25604"Figure B-2 on page 262 shows an internet similar to the one shown in IDREF="FM32136"Figure B-1, except that a Phase 1 router is present on the EtherTalk 1.0 network. The Phase 2 routers on this internet must be configured in Transition Mode.LBL="B-2"ID="FM25604"Transition Routing Required for Phase 1 RoutersFILE="n312r118.pbm"In IDREF="FM25604"Figure B-2, two servers are running NetWare for Macintosh, and each server supports multiple Phase 2 interfaces. However, there is a idxid="w6176"book="_idx" docset="nw312" tidref="i1881"Phase 1 router present on the EtherTalk 1.0 network. In this internet, both Phase 2 routers must be in Transition Mode. The TokenTalk and EtherTalk 2.0 networks cannot use extended network ranges, so they will be limited to 253 nodes on each idxid="w6177"book="_idx" docset="nw312" tidref="i362"network. idxid="w6178"book="_idx" docset="nw312" tidref="i251"An Example Transition idxid="w6179"book="_idx" docset="nw312" tidref="i6881"Mode ConfigurationWhen you are configuring the AppleTalk router in NetWare for Macintosh in Transition Mode, these conditions must be in effect:idxid="w6180"book="_idx" docset="nw312" tidref="i38"The -t option is specified on the LOAD APPLETLK command line.On idxid="w6181"book="_idx" docset="nw312" tidref="i1934"extended idxid="w6182"book="_idx" docset="nw312" tidref="i4569"networks, the first number in the network range is equal to the last number in the range, as in 10-10.On idxid="w6183"book="_idx" docset="nw312" tidref="i1934"extended networks, idxid="w6184"book="_idx" docset="nw312" tidref="i396"the idxid="w6185"book="_idx" docset="nw312" tidref="i7592"zones list has only one name.Nonextended networks are configured as usual.As with all types of AppleTalk router configuration, the network number or range you assign to an interface must be unique on the internet and consistent for all routers on that cable. The zone name you assign to an interface must also be consistent for all routers on that cable.Planning the Configuration idxid="w6186"book="_idx" docset="nw312" tidref="i6881"This example describes how to configure the two Phase 2 routers shown in IDREF="FM25604"Figure B-2 on page 262 in Transition Mode, using the configuration shown in IDREF="FM21458"Table B-1:LBL="B-1" INLINE="F"ID="FM21458"Transition Routing Internet idxid="w6187"book="_idx" docset="nw312" tidref="i362"Configurations idxid="w6188"book="_idx" docset="nw312" tidref="i362"WIDTH="96"Configurable ComponentWIDTH="156"FS-1 Example DataWIDTH="156"FS-2 Example DataWIDTH="96"Internal AppleTalk  network idxid="w6189"book="_idx" docset="nw312" tidref="i2912"WIDTH="156"idxid="w6190"book="_idx" docset="nw312" tidref="i2912"load idxid="w6191"book="_idx" docset="nw312" tidref="i6881"appletlk -t net=50050  zone={"Zone4"}WIDTH="156"load appletalk -t net=50051  zone={"Zone5"}EtherTalk 1.0 idxid="w6192"book="_idx" docset="nw312" tidref="i1881"net=2 zone={"Zone2"}net=2 zone={"Zone2"}EtherTalk 1.0 idxid="w6193"book="_idx" docset="nw312" tidref="i6881"N/Anet=1 zone={"Zone1"}EtherTalk 2.0 idxid="w6194"book="_idx" docset="nw312" tidref="i1896"idxid="w6195"book="_idx" docset="nw312" tidref="i6881"net=10-10 zone={"Zone7"}N/ATokenTalk idxid="w6196"book="_idx" docset="nw312" tidref="i6839"N/A idxid="w6197"book="_idx" docset="nw312" tidref="i6881"net=21-21 zone={"Zone6"}This example does not load print services and create print queues. Please see IDREF="FM11507"Chapter 7, "Managing AppleTalk Print Services," on page 143 for information about print services.IDREF="FM39171"Figure B-3 on page 264 shows the AppleTalk network configuration. No clients are shown, to enable you to see the actual networks more clearly:LBL="B-3"ID="FM39171"A Transition Mode ConfigurationFILE="n312r119.pbm"Note that the network ranges and zone names on the EtherTalk 2.0 and TokenTalk extended networks are constrained, and that both routers have the -t option enabled. When you specify the -t option on the LOAD APPLETLK command line, the router checks the addressing constraints on its nonextended networks and prints warning messages if you have forgotten to limit the range and zones list. idxid="w6198"book="_idx" docset="nw312" tidref="i6881"FS-1 in idxid="w6199"book="_idx" docset="nw312" tidref="i2227"Transition idxid="w6200"book="_idx" docset="nw312" tidref="i6881"Mode: idxid="w6201"book="_idx" docset="nw312" tidref="i1881"EtherTalk idxid="w6202"book="_idx" docset="nw312" tidref="i6881"1.0 and idxid="w6203"book="_idx" docset="nw312" tidref="i6839"TokenTalk idxid="w6204"book="_idx" docset="nw312" tidref="i6881"To enter a configuration that will be in effect when you bring up the server, follow these steps:Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC.When you press <Enter>, the idxid="w6205"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens:FILE="n312r120.pbm"Press <Enter> to open a text editor idxid="w6206"book="_idx" docset="nw312" tidref="i6881"window for idxid="w6207"book="_idx" docset="nw312" tidref="i6489"STARTUP.NCF.Add these commands to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100These commands are explained in IDREF="FM33358""The Macintosh Name Space" on page 128 and in IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248.Press <Esc>, then <Enter> to save your changes to STARTUP.NCF and to return to the Editable Configuration Files menu.Use the arrow keys to select idxid="w6208"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF idxid="w6209"book="_idx" docset="nw312" tidref="i6881"in the menu and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w6210"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM30363"Figure B-4 on page 266.LBL="B-4"ID="FM30363"AUTOEXEC.NCF with Transition ModeFILE="n312r121.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.Load the AppleTalk module and idxid="w6211"book="_idx" docset="nw312" tidref="i6881"configure the internal network: load appletlk -t net=50050 zone={"Zone4"}idxid="w6212"book="_idx" docset="nw312" tidref="i260"The -tidxid="w6213"book="_idx" docset="nw312" tidref="i260"option idxid="w6214"book="_idx" docset="nw312" tidref="i38"enables Transition Mode. idxid="w6215"book="_idx" docset="nw312" tidref="i2912"For more information, please see IDREF="FM22523""Loading the AppleTalk Module" on page 237.Load idxid="w6216"book="_idx" docset="nw312" tidref="i247"LAN idxid="w6217"book="_idx" docset="nw312" tidref="i1881"drivers idxid="w6218"book="_idx" docset="nw312" tidref="i1881"and idxid="w6219"book="_idx" docset="nw312" tidref="i247"AppleTalk idxid="w6220"book="_idx" docset="nw312" tidref="i3085"frame idxid="w6221"book="_idx" docset="nw312" tidref="i6839"types: idxid="w6222"book="_idx" docset="nw312" tidref="i6839"  idxid="w6223"book="_idx" docset="nw312" tidref="i6881"load ne2000 int=3 port=300 frame=ethernet_ii name=etalk1 load ne2000 int=2 port=320 frame=ethernet_snap name=etalk2The NAME option is a NetWare driver-naming feature that enables you to specify a name referring to a full driver configuration; this option is described in the NetWare v3.12idxid="w6224"book="_idx" docset="nw312" tidref="i6839"System idxid="w6225"book="_idx" docset="nw312" tidref="i4451"Administrationidxid="w6226"book="_idx" docset="nw312" tidref="i6881"manual. idxid="w6227"book="_idx" docset="nw312" tidref="i3085"For idxid="w6228"book="_idx" docset="nw312" tidref="i6839"more idxid="w6229"book="_idx" docset="nw312" tidref="i1881"information idxid="w6230"book="_idx" docset="nw312" tidref="i247", see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238. idxid="w6231"book="_idx" docset="nw312" tidref="i247"idxid="w6232"book="_idx" docset="nw312" tidref="i1881"idxid="w6233"book="_idx" docset="nw312" tidref="i271"Bind idxid="w6234"book="_idx" docset="nw312" tidref="i3085"AppleTalk idxid="w6235"book="_idx" docset="nw312" tidref="i6881"to the LAN drivers and configure AppleTalk networks: bind appletlk etalk1 net=2 zone={"Zone2"} bind appletlk etalk2 net=10-10 zone={"Zone7"}Note that the network range and zones list on the extended EtherTalk 2.0 network must be constrained, as described in IDREF="FM36717""What Is Transition Mode?" on page 259.Load services:  idxid="w6236"book="_idx" docset="nw312" tidref="i229"load idxid="w6237"book="_idx" docset="nw312" tidref="i6881"afpFor details on the AFP configuration options you can specify on the LOAD AFP command line, please see IDREF="FM12331""Setting Up a Specialized Environment" on page 137.Exit INSTALL, saving your idxid="w6238"book="_idx" docset="nw312" tidref="i6881"changes. idxid="w6239"book="_idx" docset="nw312" tidref="i595"Down the file server and bring it back up.If you don't wish to down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure.Use the idxid="w6240"book="_idx" docset="nw312" tidref="i3649"MODULES idxid="w6241"book="_idx" docset="nw312" tidref="i3930"command idxid="w6242"book="_idx" docset="nw312" tidref="i6881"to verify that the NLMs loaded.idxid="w6243"book="_idx" docset="nw312" tidref="i362"Check the router's interfaces in idxid="w6244"book="_idx" docset="nw312" tidref="i482"ATCON.Please see Appendix C, "Using ATCON," for details on using this utility to verify conditions on the AppleTalk internet. The Using the NetWare for Macintosh Client guide describes how to check the configuration from a Macintosh client.FS-2 in Transition Mode: EtherTalk 1.0 and TokenTalkTo enter a configuration that will be in effect when you bring up the server, follow these steps:Load INSTALL, select Product Options in the main INSTALL menu, and then press <Enter> on the line specifying NW-MAC.When you press <Enter>, the idxid="w6245"book="_idx" docset="nw312" tidref="i1784"Editable Configuration Files menu opens:FILE="n312r122.pbm"Press <Enter> to open a text editor window idxid="w6246"book="_idx" docset="nw312" tidref="i6489"for idxid="w6247"book="_idx" docset="nw312" tidref="i6881"STARTUP.NCF.Add these commands to the existing commands in STARTUP.NCF:  load mac set minimum packet receive buffers=100These commands are explained in IDREF="FM33358""The Macintosh Name Space" on page 128 and in IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248.Press <Esc> and then <Enter> to save your changes to STARTUP.NCF and to return to the Editable Configuration Files menu.Use the arrow keys to select idxid="w6248"book="_idx" docset="nw312" tidref="i595"AUTOEXEC.NCF idxid="w6249"book="_idx" docset="nw312" tidref="i6881"in the menu and then press <Enter>.Add the NetWare for Macintosh configuration commands to the existing commands in AUTOEXEC.NCF. The commands required for this example configuration appear in idxid="w6250"book="_idx" docset="nw312" tidref="i719"bold monospace type in IDREF="FM28645"Figure B-5 on page 269.LBL="B-5"ID="FM28645"AUTOEXEC.NCF: LocalTalk and EtherTalk 2.0FILE="n312r123.pbm"Before loading the AFP or ATPS modules, you must load the AppleTalk module and bind AppleTalk to one or more LAN drivers, as shown below.Load the AppleTalk module and idxid="w6251"book="_idx" docset="nw312" tidref="i6881"configure the internal network: load appletlk -t net=50051 zone={"Zone5"}idxid="w6252"book="_idx" docset="nw312" tidref="i260"The -tidxid="w6253"book="_idx" docset="nw312" tidref="i260"option idxid="w6254"book="_idx" docset="nw312" tidref="i38"enables Transition Mode. idxid="w6255"book="_idx" docset="nw312" tidref="i2912"For more information, please see IDREF="FM22523""Loading the AppleTalk Module" on page 237.Load idxid="w6256"book="_idx" docset="nw312" tidref="i247"LAN idxid="w6257"book="_idx" docset="nw312" tidref="i1881"drivers idxid="w6258"book="_idx" docset="nw312" tidref="i1881"and idxid="w6259"book="_idx" docset="nw312" tidref="i247"AppleTalk idxid="w6260"book="_idx" docset="nw312" tidref="i3085"frame idxid="w6261"book="_idx" docset="nw312" tidref="i6839"types: idxid="w6262"book="_idx" docset="nw312" tidref="i6839"  idxid="w6263"book="_idx" docset="nw312" tidref="i6881"load ne2000 int=3 port=300 frame=ethernet_ii name=etalk1 load ne2000 int=5 port=320 frame=ethernet_ii name=Phase1 load token int=2 frame=token-ring_snap name=ttalkThe NAME option is a NetWare driver-naming feature that enables you to specify a name referring to a full driver configuration; this option is described in the NetWare v3.12idxid="w6264"book="_idx" docset="nw312" tidref="i4451"System Administration manual. For details, see IDREF="FM28159""Loading LAN Drivers with AppleTalk Frame Types" on page 238.idxid="w6265"book="_idx" docset="nw312" tidref="i271"Bind idxid="w6266"book="_idx" docset="nw312" tidref="i3085"AppleTalk idxid="w6267"book="_idx" docset="nw312" tidref="i6881"to the LAN drivers and configure AppleTalk networks: bind appletlk Phase1 net=1 zone={"Zone1"} bind appletlk etalk1 net=2 zone={"Zone2"} bind appletlk ttalk net=21-21 zone={"Zone6"}Note that the network range and zones list on the extended TokenTalk network must be constrained as described in IDREF="FM36717""What Is Transition Mode?" on page 259.Load services:  idxid="w6268"book="_idx" docset="nw312" tidref="i229"load idxid="w6269"book="_idx" docset="nw312" tidref="i6881"afpFor details on the AFP configuration options you can specify on the LOAD command line, idxid="w6270"book="_idx" docset="nw312" tidref="i6881"please see IDREF="FM12331""Setting Up a Specialized Environment" on page 137. idxid="w6271"book="_idx" docset="nw312" tidref="i595"Exit INSTALL, saving your changes.Down the file server and bring it back up.If you cannot down the file server at this time, re-enter at the console prompt all configuration commands specified in the STARTUP.NCF and AUTOEXEC.NCF files. This action brings up NetWare for Macintosh for the current server session. The next time you down the server, the specifications in STARTUP.NCF and AUTOEXEC.NCF will apply.If you can down the server at this time, follow your usual procedure.Use the idxid="w6272"book="_idx" docset="nw312" tidref="i3649"MODULES idxid="w6273"book="_idx" docset="nw312" tidref="i3930"command idxid="w6274"book="_idx" docset="nw312" tidref="i6881"to verify that the NLMs loaded.idxid="w6275"book="_idx" docset="nw312" tidref="i362"Check the router's interfaces in idxid="w6276"book="_idx" docset="nw312" tidref="i482"ATCON.Please see Appendix C, "Using ATCON," for details on using this utility to verify conditions on the AppleTalk internet. The idxid="w6277"book="_idx" docset="nw312" tidref="i6881"Using the NetWare for Macintosh Client guide idxid="w6278"book="_idx" docset="nw312" tidref="i1881"describes idxid="w6279"book="_idx" docset="nw312" tidref="i6881"how idxid="w6280"book="_idx" docset="nw312" tidref="i2227"to idxid="w6281"book="_idx" docset="nw312" tidref="i6881"check idxid="w6282"book="_idx" docset="nw312" tidref="i6839"the idxid="w6283"book="_idx" docset="nw312" tidref="i5075"configuration idxid="w6284"book="_idx" docset="nw312" tidref="i5072"from idxid="w6285"book="_idx" docset="nw312" tidref="i6881"a idxid="w6286"book="_idx" docset="nw312" tidref="i4280"Macintosh idxid="w6287"book="_idx" docset="nw312" tidref="i6881"idxid="w6288"book="_idx" docset="nw312" tidref="i2898"client. idxid="w6289"book="_idx" docset="nw312" tidref="i1934"LBL="C"ID="FM31636"idxid="w6290"book="_idx" docset="nw312" tidref="i482"idxid="w6291"book="_idx" docset="nw312" tidref="i271"Using ATCONThis appendix describes the ATCON console utility. You can use ATCON at the server to monitor activity in the AppleTalk network portions of your LAN. ATCON's functions enable you to diagnose operational problems in the networks that support AppleTalk.At the server console, type LOAD ATCON <Enter>ATCON's main menu opens:LBL="C-1"ATCON idxid="w6292"book="_idx" docset="nw312" tidref="i482"Main MenuFILE="n312r124.pbm"The main menu contains the functions listed in IDREF="FM23249"Table C-1 on page 272.LBL="C-1" INLINE="F"ID="FM23249"ATCON Main Menu idxid="w6293"book="_idx" docset="nw312" tidref="i362"FunctionsWIDTH="108"Menu OptionWIDTH="312"Function PerformedWIDTH="108"Lookup and Echo idxid="w6294"book="_idx" docset="nw312" tidref="i482"Services idxid="w6295"book="_idx" docset="nw312" tidref="i482"WIDTH="312"With the Lookup service, you can execute an idxid="w6296"book="_idx" docset="nw312" tidref="i3565"NBP lookup test for an  AppleTalk service, such as a file server, LaserWriter, or ImageWriter. You can  use this test to verify that all services, or all services of a particular type, are  currently available. If you specify a name, such as a printer or a server  name, you can use this test to verify that the specified service is available. You can also use the Lookup service to specify the node you will use for the  Echo test. Executing an idxid="w6297"book="_idx" docset="nw312" tidref="i1765"Echo test enables you to verify node-to-node  communication on the AppleTalk network.View AppleTalk  StatisticsView idxid="w6298"book="_idx" docset="nw312" tidref="i311"statistics idxid="w6299"book="_idx" docset="nw312" tidref="i362"about the idxid="w6300"book="_idx" docset="nw312" tidref="i482"packets idxid="w6301"book="_idx" docset="nw312" tidref="i362"that idxid="w6302"book="_idx" docset="nw312" tidref="i482"the idxid="w6303"book="_idx" docset="nw312" tidref="i6035"AppleTalk idxid="w6304"book="_idx" docset="nw312" tidref="i362"router idxid="w6305"book="_idx" docset="nw312" tidref="i6466"received idxid="w6306"book="_idx" docset="nw312" tidref="i362",  dropped, or transmitted. These statistics are dynamically updated as the  router functions.View Logs idxid="w6307"book="_idx" docset="nw312" tidref="i482"View the idxid="w6308"book="_idx" docset="nw312" tidref="i6663"system and volume log files, which shows informational and idxid="w6309"book="_idx" docset="nw312" tidref="i482"error  messages received from the NetWare operating system and from the   modules.View Router  InterfacesView idxid="w6310"book="_idx" docset="nw312" tidref="i271"the AppleTalk idxid="w6311"book="_idx" docset="nw312" tidref="i271"network idxid="w6312"book="_idx" docset="nw312" tidref="i271"numbers idxid="w6313"book="_idx" docset="nw312" tidref="i482"assigned idxid="w6314"book="_idx" docset="nw312" tidref="i482"to the idxid="w6315"book="_idx" docset="nw312" tidref="i4556"internal network as  well as to external interfaces in the current file server.View RTMP idxid="w6316"book="_idx" docset="nw312" tidref="i6057"Table idxid="w6317"book="_idx" docset="nw312" tidref="i362"View information about all idxid="w6318"book="_idx" docset="nw312" tidref="i6061"AppleTalk networks accessible to the router,  either directly (on one of its own network interface boards) or remotely,  through one to fifteen other routers. The system checks the status of the  networks every 10 seconds and verifies the status as "Good," "Susp,"  (Suspect) or "Bad," depending on how long it has been since information  about the network was broadcast.View Stack InterfaceView the idxid="w6319"book="_idx" docset="nw312" tidref="i482"internal network idxid="w6320"book="_idx" docset="nw312" tidref="i2912"configuration idxid="w6321"book="_idx" docset="nw312" tidref="i2912", including the idxid="w6322"book="_idx" docset="nw312" tidref="i2912"internal idxid="w6323"book="_idx" docset="nw312" tidref="i396"zone idxid="w6324"book="_idx" docset="nw312" tidref="i482"name. idxid="w6325"book="_idx" docset="nw312" tidref="i7576"View Zones List idxid="w6326"book="_idx" docset="nw312" tidref="i396"View idxid="w6327"book="_idx" docset="nw312" tidref="i482"the idxid="w6328"book="_idx" docset="nw312" tidref="i7592"AppleTalk zones accessed by the AppleTalk stack.ID="FM37625"Using ATCON to idxid="w6329"book="_idx" docset="nw312" tidref="i271"Diagnose the idxid="w6330"book="_idx" docset="nw312" tidref="i271"AppleTalk idxid="w6331"book="_idx" docset="nw312" tidref="i482"NetworkThis section suggests how to use ATCON to check the AppleTalk network if you think it has an error condition.Check the system log and volume log for errors or informational messages by choosing View Logs in ATCON. If either log contains many messages, you can skip to the bottom of the file by pressing <Ctrl>+<PgDn>.If you suspect that the internet has a "break" in it (that is, clients cannot reach services on a remote network), select View RTMP Table in ATCON. The RTMP table (or "routing table") is dynamically updated with information from all AppleTalk routers on the internet, and you can check this table to determine whether a remote router is still up and running. Please see the sections on routing table maintenance in Inside AppleTalk, Second Edition, for a detailed understanding of how RTMP is used to inform routers about changes in internet connectivity.If you are experiencing a communication problem with a remote network, you can use the idxid="w6332"book="_idx" docset="nw312" tidref="i482"Lookup idxid="w6333"book="_idx" docset="nw312" tidref="i3565"service function in ATCON to check that the router can communicate with other services on the internet. You can also use the Lookup service to find out network or node addresses (or both) without having to consult your network records. In addition, you can use the Echo test in ATCON to verify that the router can communicate with a particular node on a network. See IDREF="FM18937""Looking Up an AppleTalk Service" on page 274 and IDREF="FM11622""Using Echo to Verify Connectivity" on page 277.If you suspect a problem with the router in the current file server, select View AppleTalk Statistics in ATCON to view the number of packets received and the number of packets dropped by the router since it began operating. These fields are described in IDREF="FM11000""Checking AppleTalk Statistics" on page 281. You can also use the idxid="w6334"book="_idx" docset="nw312" tidref="i3945"MONITOR program at the server console to view the packets received and dropped at the network board level. See NetWare v3.12 System Administration for details on MONITOR.ID="FM18937"Looking idxid="w6335"book="_idx" docset="nw312" tidref="i3565"Up idxid="w6336"book="_idx" docset="nw312" tidref="i3978"idxid="w6337"book="_idx" docset="nw312" tidref="i4037"an idxid="w6338"book="_idx" docset="nw312" tidref="i482"AppleTalk idxid="w6339"book="_idx" docset="nw312" tidref="i271"Service idxid="w6340"book="_idx" docset="nw312" tidref="i362"The Lookup function in ATCON performs similarly to looking up a service in the Macintosh Chooser. When you use the Lookup function, the router sends NBP broadcast requests to the specified zone. AppleTalk services (such as printers or file servers) respond to the request by sending NBP responses to the requester. If an NBP lookup test executes successfully, a window opens, showing the name of the service and its network address.An NBP lookup is a simple way to test that the router can communicate with services (or a specific service) in an AppleTalk zone. If the lookup succeeds, you know that both the router and the responding service are active on the AppleTalk internet. If the selected zone is one or more hops away, you also know that the routers in-between are working.To check the status of all AppleTalk services in a zone, follow these steps:Choose Lookup and Echo Services in the ATCON main menu.The Lookup Parameters window opens, with the Available Actions menu below it:FILE="n312r125.pbm"The Lookup Parameters window contains the default values that NetWare for Macintosh uses when performing the lookup.In the Available Actions menu, use the arrow keys to select Edit Lookup Parameters and then press <Enter>.The NBP Packets menu opens, showing a number of parameters for the Lookup service. LBL="C-2"NBP PacketsFILE="n312r126.pbm"The lookup parameters you can edit are described in IDREF="FM25309"Table C-2. LBL="C-2" INLINE="F"ID="FM25309"Lookup Test ParametersWIDTH="108"Parameter NameWIDTH="312"DescriptionWIDTH="108"Name idxid="w6341"book="_idx" docset="nw312" tidref="i3565"WIDTH="312"The default equals sign (=) means "all." For example, if you specify a type  of service in the next field and leave the equals sign here, t idxid="w6342"book="_idx" docset="nw312" tidref="i4"he Lookup  service test asks for the names of all services of that type within a zone. You  can enter the name of any service on your internet; for example, you  might enter the name of a  server, a printer, or a  print queue.Type idxid="w6343"book="_idx" docset="nw312" tidref="i3565"The idxid="w6344"book="_idx" docset="nw312" tidref="i7059"default equals sign (=) means "all." In this case, the Lookup service test  asks for the names of all services of all types within a zone. You can specify  a particular type, such as "LaserWriter" or "AppleShare." (The type of  service for a  server is "AppleShare.")Zone idxid="w6345"book="_idx" docset="nw312" tidref="i3565"Press idxid="w6346"book="_idx" docset="nw312" tidref="i7588"<Enter> in this field to pop up a list of available zones on the internet.  You can use the arrow keys to select a zone in this list and press <Enter> to  enter the zone name into the field.Number of Retries idxid="w6347"book="_idx" docset="nw312" tidref="i3565"&  Retry IntervalThe default number of Retries is 2, and the default interval between retries  is 1 second. The router sends out NBP requests up to two times if it  receives no re idxid="w6348"book="_idx" docset="nw312" tidref="i3565"sponses.ID="FM36579"Use the arrow keys to position the cursor on the Zone field and then press <Enter>.This action brings up a list of available zones on the internet:FILE="n312r127.pbm"Use the arrow keys to select a zone name in the list and press <Enter>.If you wish, enter a service name or type.Alternatively, you can leave the default equals sign (=) for a more general Lookup service test.Press <Esc> and answer Yes to use these settings.Use the arrow keys to select Execute Lookup Test in the Available Actions menu, and then press <Enter>.After a few seconds, you should see the results of the Lookup service. For example, IDREF="FM22842"Figure C-3 shows the results of a Lookup for a service named "LW-MAIN" of type "LaserWriter."LBL="C-3"ID="FM22842"Results of a Lookup idxid="w6349"book="_idx" docset="nw312" tidref="i3565"ServiceFILE="n312r128.pbm"The router reports the network and socket address of the service. If the Lookup fails, the name of the service won't appear. If no services are idxid="w6350"book="_idx" docset="nw312" tidref="i3978"idxid="w6351"book="_idx" docset="nw312" tidref="i4037"available, idxid="w6352"book="_idx" docset="nw312" tidref="i3565"a idxid="w6353"book="_idx" docset="nw312" tidref="i482"message is idxid="w6354"book="_idx" docset="nw312" tidref="i362"displayed. idxid="w6355"book="_idx" docset="nw312" tidref="i271"ID="FM11622"Using idxid="w6356"book="_idx" docset="nw312" tidref="i482"Echo idxid="w6357"book="_idx" docset="nw312" tidref="i4652"to idxid="w6358"book="_idx" docset="nw312" tidref="i271"Verify idxid="w6359"book="_idx" docset="nw312" tidref="i362"Connectivity idxid="w6360"book="_idx" docset="nw312" tidref="i1765"When you execute an Echo test, the router sends a specified number of packets across the network to a specified node; the node then idxid="w6361"book="_idx" docset="nw312" tidref="i4652"returns the same number of packets back. If an Echo test executes successfully, the number of packets that the router receives is equal to the number of packets it sent.Using an Echo test, you can carry out either of these tests:You can check to see whether the router can communicate with a particular node on one of its networks. If the communication is successful, you know that AppleTalk is working on that interface, and that the specified node is up and running.You can check to see whether the router can communicate with a node on a "remote" AppleTalk network (a network that is not directly connected to the file server). If the communication is successful, you know that the router can reach another AppleTalk network and that all AppleTalk routers in between must be routing correctly.To verify that the router can communicate with a node on a local or remote AppleTalk network, follow these steps:Choose Lookup and Echo Services in the ATCON main menu.The Lookup Parameters window opens, with the Available Actions menu below it:FILE="n312r129.pbm"Use the Lookup service to find the node you want use for the Echo test.Follow the steps described in IDREF="FM18937""Looking Up an AppleTalk Service" on page 274.In the NBP Service Lookup window, highlight the node to use for the Echo test. Then, press Enter.The Echo Test Parameters window opens, with the Available Actions menu below it:FILE="n312r130.pbm"The Echo Test Parameters window displays the default setting for the Echo test, as well as the network and node number of the service you highlighted in the NBP Service Lookup window. In the Available Actions menu, use the arrow keys to select Edit Echo Parameters and then press <Enter>.A menu opens, showing a number of parameters for the Echo test (IDREF="FM34370"Figure C-4).LBL="C-4"ID="FM34370"Echo Test idxid="w6362"book="_idx" docset="nw312" tidref="i1765"ParametersFILE="n312r131.pbm"The test parameters you can edit are listed in IDREF="FM42425"Table C-3.LBL="C-3" INLINE="F"ID="FM42425"Echo Test ParametersWIDTH="108"ParameterWIDTH="312"DescriptionWIDTH="108"Packets to send idxid="w6363"book="_idx" docset="nw312" tidref="i1765"WIDTH="312"The default number of Echo packets sent out is 50. idxid="w6364"book="_idx" docset="nw312" tidref="i311"You can specify the  number of packets you want to echo in the "Packets to Send" field. The  maximum number of packets allowed is 65,535. idxid="w6365"book="_idx" docset="nw312" tidref="i1765"If you wish to check  throughput speed, idxid="w6366"book="_idx" docset="nw312" tidref="i482"you can specify a relatively high number and time the  procedure.Timeout idxid="w6367"book="_idx" docset="nw312" tidref="i1765"( idxid="w6368"book="_idx" docset="nw312" tidref="i6794"seconds) idxid="w6369"book="_idx" docset="nw312" tidref="i482"The default Timeout value is two ticks (a tick is approximately 1/18 of a  second). If you wish, specify the number of ticks that ATCON waits for  response packets. The maximum number of ticks allowed is 9,999, but we  recommend that you do not set the Timeout value too high. At 9,999  ticks, ATCON waits approximately 9 minutes for an Echo reply.Number of Data  Bytes idxid="w6370"book="_idx" docset="nw312" tidref="i1763"The default Echo packets contain 10 data bytes, which are always included  in Echo packets. If you wish, specify the number of data bytes in each  packet. Each packet can contain from 0 to 581 bytesID="FM14116"Modify one or more parameters, or leave the default values.Press <Esc> and answer Yes to use these settings.Choose Execute Echo Test in the Available Actions menu.When you select Execute Echo Test, the Echo protocol in the AppleTalk stack sends out the specified number of Echo packets to the specified address. The "Number of Packets Sent" and "Number of Packets Received" fields should increment as described in IDREF="FM42509"Table C-4.LBL="C-4" INLINE="F"ID="FM42509"Incrementing Echo Test ParametersWIDTH="108"ParameterWIDTH="312"DescriptionWIDTH="108"Number of Packets  Sent idxid="w6371"book="_idx" docset="nw312" tidref="i482"WIDTH="312"As ATCON sends out idxid="w6372"book="_idx" docset="nw312" tidref="i1765"packets, the "Number of Packets Sent" field should  increment. ATCON sends out the next packet only when the response to  the previous packet has returned, or when the Timeout value has expired.Number of Packets  Received idxid="w6373"book="_idx" docset="nw312" tidref="i1765"If Echo idxid="w6374"book="_idx" docset="nw312" tidref="i482"receives a response before the Timeout value, the value in the  "Number of Packets Received" field increases. If the "Number of Packets  Received" field does not increase, the router did not receive any Echo  packets.If the "Number of Packets Received" field does not increment, the AppleTalk connection may still be functioning properly. The problem might be as simple as an AppleTalk router accidentally switched off, or a cable connection worked loose. If the value in the "Number of Packets Received" field does not increase, carry out these tasks:Check that there are other AppleTalk nodes on the network you specified.Make sure that the routers (if any) between the local Macintosh and the target network are plugged in and switched on.Check the network board in the file server to make sure it is idxid="w6375"book="_idx" docset="nw312" tidref="i1765"connected idxid="w6376"book="_idx" docset="nw312" tidref="i482"properly idxid="w6377"book="_idx" docset="nw312" tidref="i4652"to the idxid="w6378"book="_idx" docset="nw312" tidref="i362"network. idxid="w6379"book="_idx" docset="nw312" tidref="i271"ID="FM11000"Checking idxid="w6380"book="_idx" docset="nw312" tidref="i482"idxid="w6381"book="_idx" docset="nw312" tidref="i6035"AppleTalk idxid="w6382"book="_idx" docset="nw312" tidref="i311"idxid="w6383"book="_idx" docset="nw312" tidref="i482"Statistics idxid="w6384"book="_idx" docset="nw312" tidref="i362"idxid="w6385"book="_idx" docset="nw312" tidref="i482"The AppleTalk router keeps track of the number of packets it receives, forwards, and transmits, as well as the number of packets dropped due to some network or server condition. To view these statistics, use the arrow keys to select View AppleTalk Statistics in the main ATCON menu, and then press <Enter>. A window opens, listing the current values for packet statistics maintained by the router (IDREF="FM14692"Figure C-5 on page 282).LBL="C-5"ID="FM14692"AppleTalk StatisticsFILE="n312r132.pbm"These router statistics are described in IDREF="FM11306"Table C-5.LBL="C-5" INLINE="F"ID="FM11306"AppleTalk StatisticsWIDTH="108"Field NameWIDTH="312"DescriptionWIDTH="108"Packets receivedWIDTH="312"This field indicates the total number of packets received by the router since  it began operating.Packets to be  forwardedThis field indicates the number of packets that were received by the router  and destined for another node. These are the packets that the router  forwards to a node or to another router closer to the destination node  address.Packets addressed to  the routerSome packets are destined for the router itself; for example, broadcast  packets, Echo packets that specify the router's node address, RTMP  packets, and so forth. This field shows the number of such packets that the  router has received.Packets dropped due  to too many hopsA "hop" represents a packet being received and forwarded by a router. If  a packet must go through three routers to reach its destination, then the  destination is three hops away from the source node. If the router receives  a packet with a destination address more than 15 hops away, it drops the  packet. In most cases, the value of this field is zero.Packets dropped due  to DDP Length errorThis field indicates the number of packets received and dropped with an  error in the DDP header. Specifically, the DDP header length did not match  the actual length of the packet. Such an error could indicate a hardware  problem somewhere on the internet, or an application that is creating  packets incorrectly. In most cases, the value of this field is zero.Packets dropped due  to DDP Checksum  errorThis field indicates the number of packets received and dropped because  the checksum calculated by the router did not match the checksum in the  packet. The value of this field increases only if you specify the -c option  on the LOAD APPLETLK command line as an active router option.Packets transmittedThis field indicates the number of packets transmitted by the router.Packets dropped due  to no routeThis field increases when the router fails to transmit packets because it  does not find a route to the destination address. This means that the router  checked its RTMP tables and did not find an entry for the packet's  destination address. In most cases, this indicates that a network is down or  has been removed from an internet, but that nodes on some networks  continue to see it. (This situation idxid="w6386"book="_idx" docset="nw312" tidref="i311"will idxid="w6387"book="_idx" docset="nw312" tidref="i482"correct idxid="w6388"book="_idx" docset="nw312" tidref="i482"itself idxid="w6389"book="_idx" docset="nw312" tidref="i6035"with idxid="w6390"book="_idx" docset="nw312" tidref="i362"time.) idxid="w6391"book="_idx" docset="nw312" tidref="i482"ID="FM24429"ID="FM27736"Viewing idxid="w6392"book="_idx" docset="nw312" tidref="i6667"System idxid="w6393"book="_idx" docset="nw312" tidref="i1843"idxid="w6394"book="_idx" docset="nw312" tidref="i482"and idxid="w6395"book="_idx" docset="nw312" tidref="i3839"Volume idxid="w6396"book="_idx" docset="nw312" tidref="i6663"Messages idxid="w6397"book="_idx" docset="nw312" tidref="i482"in idxid="w6398"book="_idx" docset="nw312" tidref="i3839"the idxid="w6399"book="_idx" docset="nw312" tidref="i1848"Log FilesThe system log file contains system error and informational messages. You can use the system messages to help you diagnose and troubleshoot system problems. Messages generated by the NetWare operating system are documented in the NetWare System Messages manual. The error messages generated by the AppleTalk stack/router and the AFP module are listed with explanations in Appendix D.The volume log file reports volume events, such as the date and time the volume was mounted and dismounted. A separate volume log is maintained for each server volume. To view the log files, select View Logs from the main ATCON menu. The View Logs window appears (IDREF="FM34808"Figure C-6).LBL="C-6"ID="FM34808"The View Logs WindowFILE="n312r133.pbm"When you select View System Log, the system log file (SYS:SYSTEM\SYS$LOG) appears (IDREF="FM32423"Figure C-7).LBL="C-7"ID="FM32423"The System Log FileFILE="n312r134.pbm"The system log file contains all error messages generated by the server itself and all of its NLMs. If there are many messages in the file, you can skip to the bottom of the file to view the most recent messages by pressing <Ctrl>+<PgDn>. idxid="w6400"book="_idx" docset="nw312" tidref="i6663"idxid="w6401"book="_idx" docset="nw312" tidref="i3839"idxid="w6402"book="_idx" docset="nw312" tidref="i6667"idxid="w6403"book="_idx" docset="nw312" tidref="i3839"idxid="w6404"book="_idx" docset="nw312" tidref="i1848"idxid="w6405"book="_idx" docset="nw312" tidref="i1843"idxid="w6406"book="_idx" docset="nw312" tidref="i482"idxid="w6407"book="_idx" docset="nw312" tidref="i482"When you select View Volume Log, the volume log file appears (IDREF="FM35830"Figure C-8).LBL="C-8"ID="FM35830"The Volume Log FileFILE="n312r135.pbm"If either the system log idxid="w6408"book="_idx" docset="nw312" tidref="i6663"idxid="w6409"book="_idx" docset="nw312" tidref="i7359"idxid="w6410"book="_idx" docset="nw312" tidref="i3385"or volume log is empty, a message informs you that the file does not exist. When you exit a log file, you are asked whether you wish to clear it. If you select Yes, the file is cleared and remains empty until an event occurs that generates a message and writes it to the file.ID="FM29117"Checking the idxid="w6411"book="_idx" docset="nw312" tidref="i4547"Router's idxid="w6412"book="_idx" docset="nw312" tidref="i271"Configuration idxid="w6413"book="_idx" docset="nw312" tidref="i482"and idxid="w6414"book="_idx" docset="nw312" tidref="i482"FunctionAfter you configure the router, you should use ATCON to check that the configuration is the one you expect. To check the network interfaces configured in the router, use the arrow keys to select View Router Interfaces in the main ATCON menu, and then press <Enter>.LBL="C-9"Router Interfaces WindowFILE="n312r136.pbm"The fields in the window show the information in IDREF="FM24344"Table C-6.LBL="C-6" INLINE="F"ID="FM24344"Information about Router InterfacesWIDTH="108"Field NameWIDTH="312"DescriptionWIDTH="108"Network idxid="w6415"book="_idx" docset="nw312" tidref="i271"& Address idxid="w6416"book="_idx" docset="nw312" tidref="i168"WIDTH="312"These idxid="w6417"book="_idx" docset="nw312" tidref="i4556"two fields idxid="w6418"book="_idx" docset="nw312" tidref="i4649"show the AppleTalk idxid="w6419"book="_idx" docset="nw312" tidref="i482"network number and the node  address of the router on a given network idxid="w6420"book="_idx" docset="nw312" tidref="i4652"interface. On the internal  network, the router's node number is always 2. It is possible for the router's  address on external interfaces to change when you bring up the file server,  because the router acquires the address dynamically.Port idxid="w6421"book="_idx" docset="nw312" tidref="i322"The idxid="w6422"book="_idx" docset="nw312" tidref="i5110"AppleTalk port number is the interface between the router and an  AppleTalk network. Port 0 is associated with the internal network. The first  AppleTalk BIND command line in the router's configuration is associated  with Port 1, the second AppleTalk BIND command line is associated with  Port 2, and so forth.Type idxid="w6423"book="_idx" docset="nw312" tidref="i271"The Type field indicates the type of AppleTalk network associated with a  given port. The possible values for Type include:ETalk1 (EtherTalk 1.0)ETalk2 (EtherTalk 2.0)TTalk (TokenTalk)LTalk (LocalTalk)Internal (the internal network).Zone(s) idxid="w6424"book="_idx" docset="nw312" tidref="i396"The Zone(s) field indicates the zone configuration for a given interface. If  you configured more than one zone on a Phase 2 network, the zones list  is arranged vertically in line with the network number. The first zone in the  list is the default zone. (See IDREF="FM18089""What Is the Phase 2 Default Zone?" on page  255 for the implications idxid="w6425"book="_idx" docset="nw312" tidref="i482"of a idxid="w6426"book="_idx" docset="nw312" tidref="i271"default idxid="w6427"book="_idx" docset="nw312" tidref="i482"zone.) idxid="w6428"book="_idx" docset="nw312" tidref="i4547"Viewing the idxid="w6429"book="_idx" docset="nw312" tidref="i482"Stack's idxid="w6430"book="_idx" docset="nw312" tidref="i6466"Interface idxid="w6431"book="_idx" docset="nw312" tidref="i6466"The View Stack Interface option in the ATCON main menu provides a way to check the configuration of the internal network. The stack has only one interface, which is always to the internal network.To check the internal network configuration, use the arrow keys to select View Stack Interface in the main menu, and then press <Enter>.FILE="n312r137.pbm"This window shows the internal network address and zone name. Note that the stack will always be node 1 on the internal network.ID="FM31838"ID="FM32085"Viewing idxid="w6432"book="_idx" docset="nw312" tidref="i6061"the idxid="w6433"book="_idx" docset="nw312" tidref="i6057"RTMP idxid="w6434"book="_idx" docset="nw312" tidref="i362"Routing idxid="w6435"book="_idx" docset="nw312" tidref="i482"Table idxid="w6436"book="_idx" docset="nw312" tidref="i271"Viewing the router's RTMP table in ATCON is one of the easiest ways to get a global picture of the AppleTalk internet as the router perceives it. The RTMP table contains entries for all networks and zones that the router can see. To view the RTMP table, use the arrow keys to select View RTMP Table in the main ATCON menu, and then press <Enter>. A text version of the actual RTMP table maintained by the router appears (IDREF="FM30254"Figure C-10 on page 288).LBL="C-10"ID="FM30254"Example RTMP TableFILE="n312r138.pbm"ID="FM16049"How Routing Tables Are Maintained idxid="w6437"book="_idx" docset="nw312" tidref="i6061"All AppleTalk routers on an internet maintain complete routing tables (RTMP tables), which show all networks on the AppleTalk internet.When a router comes up on the internet, it broadcasts packets containing entries for its own networks and receives broadcasts from other routers showing all networks they can reach. From these packets, each router builds a table, adding entries for new networks as it finds out about them, and broadcasts this information every ten seconds.When the tables have stabilized to show an accurate picture of all networks on the internet, they contain a single entry for each network that AppleTalk routers can reach. Each entry in an RTMP table contains this information about a network, as listed in IDREF="FM30339"Table C-7 on page 289.LBL="C-7" INLINE="F"ID="FM30339"Fields in the RTMP TableWIDTH="108"Field NameWIDTH="312"DescriptionWIDTH="108"NetworkWIDTH="312"This field indicates the AppleTalk number or range associated with a  destination network (a network that can be reached on the internet).HopsThe system measures distance to the network in terms of "hops." Each hop  represents one AppleTalk router that lies between the current router and  the destination network (that is, a router that must forward a packet from  the current router to the destination network). A router always chooses the  shortest path to its destination. In some cases, depending on the  configuration of the internet, a router can use alternate routes to a  network if one router goes down. In this case, the hop count to that  network increments in the RTMP table.StateEach routing table entry has a state associated with it: "Good," indicating  that the network continues to appear in all RTMP packets, "Susp"  (Suspect), indicating that the network has not appeared in RTMP packets  for some time, or "Bad," indicating that the network (or the router  connecting to it) is down. In ATCON you see the State field in the RTMP  table constantly going to "Susp," then back to "Good" on an internet  where all routers are functioning normally. If a router goes down or is  switched off, this field will go from "Susp" to "Bad."Next RouterThis field indicates the node address of the closest router between the  current router and the destination network.Zone(s)This field indicates the AppleTalk zones configured on the network.In addition, the router in  keeps track of its own  interfaces with the following fields, which also appear in the RTMP tables  viewed in ATCON:PortThis field indicates the AppleTalk port number in the current router  through which a packet must be transmitted to reach the destination  network. The AppleTalk port number is the interface between the router  and an AppleTalk network. Port 0 is associated with the internal network.  The first AppleTalk BIND command line in the router's configuration is  associated with Port 1, the second AppleTalk BIND command line is  associated with Port 2, and so forth.Type idxid="w6438"book="_idx" docset="nw312" tidref="i271"This field indicates the type of AppleTalk network associated with a given  interface. The possible values for Type include these: idxid="w6439"book="_idx" docset="nw312" tidref="i6061"ETlk idxid="w6440"book="_idx" docset="nw312" tidref="i6061"(EtherTalk 1.0 or 2.0) idxid="w6441"book="_idx" docset="nw312" tidref="i6057"TTlk (TokenTalk) idxid="w6442"book="_idx" docset="nw312" tidref="i482"LTlk idxid="w6443"book="_idx" docset="nw312" tidref="i362"(LocalTalk) idxid="w6444"book="_idx" docset="nw312" tidref="i271"Viewing the idxid="w6445"book="_idx" docset="nw312" tidref="i7592"idxid="w6446"book="_idx" docset="nw312" tidref="i482"Zones List idxid="w6447"book="_idx" docset="nw312" tidref="i396"ATCON allows you to check the global list of all AppleTalk zones in the internet by choosing View Zones List in the main ATCON menu. This list should be identical to the zones list that appears in the Macintosh Chooser.To view the zones list known to the router, select View Zones List in the ATCON main menu. This action opens the Zones List window (IDREF="FM24362"Figure C-11).LBL="C-11"ID="FM24362"Global Zones ListFILE="n312r139.pbm"Viewing the zones list in ATCON is a useful way to verify that the router is receiving zone information from other routers and that it can "see" zones configured in other areas of the idxid="w6448"book="_idx" docset="nw312" tidref="i482"internet. idxid="w6449"book="_idx" docset="nw312" tidref="i271"LBL="D"idxid="w6450"book="_idx" docset="nw312" tidref="i3839"idxid="w6451"book="_idx" docset="nw312" tidref="i6667"System Messagesidxid="w6452"book="_idx" docset="nw312" tidref="i223"This idxid="w6453"book="_idx" docset="nw312" tidref="i79"appendix idxid="w6454"book="_idx" docset="nw312" tidref="i225"lists idxid="w6455"book="_idx" docset="nw312" tidref="i227"the idxid="w6456"book="_idx" docset="nw312" tidref="i229"system idxid="w6457"book="_idx" docset="nw312" tidref="i2772"messages idxid="w6458"book="_idx" docset="nw312" tidref="i3178"that idxid="w6459"book="_idx" docset="nw312" tidref="i219"can be idxid="w6460"book="_idx" docset="nw312" tidref="i482"generated idxid="w6461"book="_idx" docset="nw312" tidref="i229"idxid="w6462"book="_idx" docset="nw312" tidref="i229"by idxid="w6463"book="_idx" docset="nw312" tidref="i229"NetWare idxid="w6464"book="_idx" docset="nw312" tidref="i247"for idxid="w6465"book="_idx" docset="nw312" tidref="i251"Macintosh idxid="w6466"book="_idx" docset="nw312" tidref="i260".idxid="w6467"book="_idx" docset="nw312" tidref="i271"If a idxid="w6468"book="_idx" docset="nw312" tidref="i4652"message idxid="w6469"book="_idx" docset="nw312" tidref="i310"has a idxid="w6470"book="_idx" docset="nw312" tidref="i311"status idxid="w6471"book="_idx" docset="nw312" tidref="i317"of idxid="w6472"book="_idx" docset="nw312" tidref="i318"FATAL idxid="w6473"book="_idx" docset="nw312" tidref="i324"idxid="w6474"book="_idx" docset="nw312" tidref="i324"or idxid="w6475"book="_idx" docset="nw312" tidref="i324"ERROR idxid="w6476"book="_idx" docset="nw312" tidref="i6466"(CRITICAL), idxid="w6477"book="_idx" docset="nw312" tidref="i362"it idxid="w6478"book="_idx" docset="nw312" tidref="i396"is idxid="w6479"book="_idx" docset="nw312" tidref="i423"displayed idxid="w6480"book="_idx" docset="nw312" tidref="i394"on idxid="w6481"book="_idx" docset="nw312" tidref="i395"the idxid="w6482"book="_idx" docset="nw312" tidref="i324"idxid="w6483"book="_idx" docset="nw312" tidref="i324"console idxid="w6484"book="_idx" docset="nw312" tidref="i516"as idxid="w6485"book="_idx" docset="nw312" tidref="i324"idxid="w6486"book="_idx" docset="nw312" tidref="i324"well as logged idxid="w6487"book="_idx" docset="nw312" tidref="i552"in idxid="w6488"book="_idx" docset="nw312" tidref="i569"the system idxid="w6489"book="_idx" docset="nw312" tidref="i702"log idxid="w6490"book="_idx" docset="nw312" tidref="i703"file. idxid="w6491"book="_idx" docset="nw312" tidref="i1329"Most idxid="w6492"book="_idx" docset="nw312" tidref="i14"messages idxid="w6493"book="_idx" docset="nw312" tidref="i3610"that idxid="w6494"book="_idx" docset="nw312" tidref="i1319"are idxid="w6495"book="_idx" docset="nw312" tidref="i1346"not idxid="w6496"book="_idx" docset="nw312" tidref="i18"considered idxid="w6497"book="_idx" docset="nw312" tidref="i1691"FATAL idxid="w6498"book="_idx" docset="nw312" tidref="i1914"idxid="w6499"book="_idx" docset="nw312" tidref="i1914"appear idxid="w6500"book="_idx" docset="nw312" tidref="i1735"only idxid="w6501"book="_idx" docset="nw312" tidref="i1747"in idxid="w6502"book="_idx" docset="nw312" tidref="i1765"the idxid="w6503"book="_idx" docset="nw312" tidref="i1791"system idxid="w6504"book="_idx" docset="nw312" tidref="i1843"log idxid="w6505"book="_idx" docset="nw312" tidref="i1934"file, idxid="w6506"book="_idx" docset="nw312" tidref="i2263"unless idxid="w6507"book="_idx" docset="nw312" tidref="i2436"you idxid="w6508"book="_idx" docset="nw312" tidref="i2772"are idxid="w6509"book="_idx" docset="nw312" tidref="i2467"using idxid="w6510"book="_idx" docset="nw312" tidref="i2545"the idxid="w6511"book="_idx" docset="nw312" tidref="i2520"ATPS idxid="w6512"book="_idx" docset="nw312" tidref="i2564"module idxid="w6513"book="_idx" docset="nw312" tidref="i2574"in idxid="w6514"book="_idx" docset="nw312" tidref="i2667"Verbose idxid="w6515"book="_idx" docset="nw312" tidref="i2766"idxid="w6516"book="_idx" docset="nw312" tidref="i2818"idxid="w6517"book="_idx" docset="nw312" tidref="i2937"idxid="w6518"book="_idx" docset="nw312" tidref="i251"Mode; then idxid="w6519"book="_idx" docset="nw312" tidref="i3067"these idxid="w6520"book="_idx" docset="nw312" tidref="i3200"messages idxid="w6521"book="_idx" docset="nw312" tidref="i3172"also idxid="w6522"book="_idx" docset="nw312" tidref="i3178"appear idxid="w6523"book="_idx" docset="nw312" tidref="i3067"in the idxid="w6524"book="_idx" docset="nw312" tidref="i3565"ATPS idxid="w6525"book="_idx" docset="nw312" tidref="i3626"console idxid="w6526"book="_idx" docset="nw312" tidref="i3645"window. idxid="w6527"book="_idx" docset="nw312" tidref="i1691"idxid="w6528"book="_idx" docset="nw312" tidref="i1691"When idxid="w6529"book="_idx" docset="nw312" tidref="i4004"these idxid="w6530"book="_idx" docset="nw312" tidref="i4033"messages idxid="w6531"book="_idx" docset="nw312" tidref="i3978"are idxid="w6532"book="_idx" docset="nw312" tidref="i4037"displayed idxid="w6533"book="_idx" docset="nw312" tidref="i4235"in idxid="w6534"book="_idx" docset="nw312" tidref="i4039"the idxid="w6535"book="_idx" docset="nw312" tidref="i4089"system idxid="w6536"book="_idx" docset="nw312" tidref="i4237"log idxid="w6537"book="_idx" docset="nw312" tidref="i2227"file, idxid="w6538"book="_idx" docset="nw312" tidref="i4280"they idxid="w6539"book="_idx" docset="nw312" tidref="i4338"use idxid="w6540"book="_idx" docset="nw312" tidref="i5282"this format:LBL="D-1"NetWare Server Error Message FormatFILE="n312r140.pbm"idxid="w6541"book="_idx" docset="nw312" tidref="i4360"The idxid="w6542"book="_idx" docset="nw312" tidref="i2227"messages idxid="w6543"book="_idx" docset="nw312" tidref="i4424"in idxid="w6544"book="_idx" docset="nw312" tidref="i7372"this idxid="w6545"book="_idx" docset="nw312" tidref="i168"appendix idxid="w6546"book="_idx" docset="nw312" tidref="i4518"are idxid="w6547"book="_idx" docset="nw312" tidref="i271"listed idxid="w6548"book="_idx" docset="nw312" tidref="i3649"alphabetically. idxid="w6549"book="_idx" docset="nw312" tidref="i4314"idxid="w6550"book="_idx" docset="nw312" tidref="i4661"idxid="w6551"book="_idx" docset="nw312" tidref="i7280"idxid="w6552"book="_idx" docset="nw312" tidref="i4669"idxid="w6553"book="_idx" docset="nw312" tidref="i311"idxid="w6554"book="_idx" docset="nw312" tidref="i5470"idxid="w6555"book="_idx" docset="nw312" tidref="i5072"idxid="w6556"book="_idx" docset="nw312" tidref="i5074"idxid="w6557"book="_idx" docset="nw312" tidref="i5075"idxid="w6558"book="_idx" docset="nw312" tidref="i5089"idxid="w6559"book="_idx" docset="nw312" tidref="i5123"idxid="w6560"book="_idx" docset="nw312" tidref="i5147"idxid="w6561"book="_idx" docset="nw312" tidref="i42"idxid="w6562"book="_idx" docset="nw312" tidref="i5482"idxid="w6563"book="_idx" docset="nw312" tidref="i324"idxid="w6564"book="_idx" docset="nw312" tidref="i324"idxid="w6565"book="_idx" docset="nw312" tidref="i5210"idxid="w6566"book="_idx" docset="nw312" tidref="i5282"idxid="w6567"book="_idx" docset="nw312" tidref="i5425"idxid="w6568"book="_idx" docset="nw312" tidref="i6466"idxid="w6569"book="_idx" docset="nw312" tidref="i4360"idxid="w6570"book="_idx" docset="nw312" tidref="i6033"idxid="w6571"book="_idx" docset="nw312" tidref="i7312"idxid="w6572"book="_idx" docset="nw312" tidref="i7360"idxid="w6573"book="_idx" docset="nw312" tidref="i7575"idxid="w6574"book="_idx" docset="nw312" tidref="i362"idxid="w6575"book="_idx" docset="nw312" tidref="i6057"idxid="w6576"book="_idx" docset="nw312" tidref="i6057"idxid="w6577"book="_idx" docset="nw312" tidref="i6093"A idxid="w6578"book="_idx" docset="nw312" tidref="i2227"page number idxid="w6579"book="_idx" docset="nw312" tidref="i6596"reference idxid="w6580"book="_idx" docset="nw312" tidref="i6628"appears idxid="w6581"book="_idx" docset="nw312" tidref="i6667"after idxid="w6582"book="_idx" docset="nw312" tidref="i6606"each idxid="w6583"book="_idx" docset="nw312" tidref="i7575"idxid="w6584"book="_idx" docset="nw312" tidref="i38"message, idxid="w6585"book="_idx" docset="nw312" tidref="i6881"indicating idxid="w6586"book="_idx" docset="nw312" tidref="i6986"where to idxid="w6587"book="_idx" docset="nw312" tidref="i6991"look idxid="w6588"book="_idx" docset="nw312" tidref="i7017"for idxid="w6589"book="_idx" docset="nw312" tidref="i4424"a idxid="w6590"book="_idx" docset="nw312" tidref="i7062"detailed idxid="w6591"book="_idx" docset="nw312" tidref="i7128"explanation. idxid="w6592"book="_idx" docset="nw312" tidref="i4452"idxid="w6593"book="_idx" docset="nw312" tidref="i6667"Alphabetic Listing of MessagesThe following table lists the messages related to NetWare for Macintosh print services that can appear at the console or in the system logs. You can use this table as an index to text about each of these messages. idxid="w6594"book="_idx" docset="nw312" tidref="i3839"LBL="D-1" INLINE="F"NetWare for Macintosh MessagesWIDTH="348"Error MessageWIDTH="72"Page NumberWIDTH="348"AFP idxid="w6595"book="_idx" docset="nw312" tidref="i7592"registered with NBP after volume SYS was mountedWIDTH="72"IDREF="FM14775"page 317AFP idxid="w6596"book="_idx" docset="nw312" tidref="i7586"unregistered with NBP because SYS volume was dismountedIDREF="FM31893"page 319AFP idxid="w6597"book="_idx" docset="nw312" tidref="i7576"registered with NBP during AFP initializationIDREF="FM34547"page 317All idxid="w6598"book="_idx" docset="nw312" tidref="i396"responses may not be able to be displayedIDREF="FM38837"page 334Already bound to board NIDREF="FM40713"page 303Attaching print server to queue queue-nameIDREF="FM27916"page 331AppleTalk Stack/Router v3.01 is runningIDREF="FM20459"page 302ASP initialization failure. Error: NIDREF="FM11097"page 315ATPS: create config failed, out of memoryIDREF="FM24136"page 326ATPS: create directory failed, out of memoryIDREF="FM24136"page 326ATPS: create spooler name failed, out of memoryIDREF="FM24136"page 326ATPS: parse printer name failed, out of memoryIDREF="FM24136"page 326ATPS console-command: no parameter specifiedIDREF="FM22978"page 326ATPS: invalid printer/spooler name nameIDREF="FM17266"page 326ATPSHide: a spooler name is not a valid parameterIDREF="FM42489"page 326ATPSHide: printer printer-name has been hiddenIDREF="FM15734"page 327ATPSHide: printer printer-name is a type that can't be hiddenIDREF="FM15734"page 327ATPSHide: printer printer-name could not be foundIDREF="FM14873"page 327ATPSHide: lost connection with printer printer-nameIDREF="FM14873"page 327ATPSHide: printer printer-name busy, try again laterIDREF="FM26255"page 327ATPSQuery: printer printer-name font query OKIDREF="FM42391"page 327ATPSQuery: printer-name is not a PostScript printerIDREF="FM38982"page 327ATPSQuery: can't find printer printer-name, query failedIDREF="FM38982"page 327ATPSQuery: couldn't connect to printer printer-name, query failedIDREF="FM38982"page 327ATPSQuery: printer printer-name: couldn't get font list, query failedIDREF="FM38982"page 327ATPSQuery: printer printer-name busyIDREF="FM18485"page 328ATPSQuery: queue spooler-name does not support a printerIDREF="FM39642"page 328ATPSQuery: printer printer-name's font list is not usedIDREF="FM40580"page 328ATPSQuery: invalid printer name printer-nameIDREF="FM21333"page 328ATPSRem: a printer name is not a valid parameterIDREF="FM37677"page 328ATPSRem: spooler spooler-name has already been removedIDREF="FM36617"page 328ATPSRem: Error: stringIDREF="FM15071"page 328ATPSRem: removed spooler spooler-nameIDREF="FM18506"page 329ATPSRes: a printer name is not a valid parameterIDREF="FM26223"page 329ATPSRes: spooler spooler-name is not removedIDREF="FM26223"page 329ATPSRes: Error: stringIDREF="FM10368"page 329ATPSRes: restored spooler spooler-nameIDREF="FM22069"page 329ATPSShow: a spooler name is not a valid parameterIDREF="FM27964"page 329ATPSShow: printer printer-name is not hiddenIDREF="FM38290"page 329ATPSShow: printer printer-name is a type that can't be hiddenIDREF="FM30292"page 329ATPSShow: printer printer-name could not be foundIDREF="FM41852"page 330ATPSShow: lost connection with printer printer-nameIDREF="FM41852"page 330ATPSShow: printer printer-name busy, try again laterIDREF="FM25634"page 330ATPSV: no parameter specifiedIDREF="FM14398"page 330ATPSV: invalid parameterIDREF="FM14398"page 330ATPSV: verbose mode is already OFFIDREF="FM31948"page 330Attaching print server to queue spooler-nameIDREF="FM27916"page 331Attempt to create AFP process failedIDREF="FM29341"page 315string: bad config parameter: string legal parameters are:IDREF="FM41522"page 311Bad RTMP format, port NIDREF="FM17465"page 310Begin job NIDREF="FM37873"page 331Board N does frame-type framesIDREF="FM35405"page 302Can't log in as numberIDREF="FM29842"page 324Can't create ATPS directory dir-nameIDREF="FM25265"page 324Can't find printer printer-name:type@zone-name retryingIDREF="FM14845"page 324Can't open query file file-nameIDREF="FM21878"page 325Can't service halted queueIDREF="FM34667"page 325Checking job for EOF charactersIDREF="FM28424"page 331Conflicting information: local net=N; N reported on port NIDREF="FM29295"page 310Conflicting information: local default zone = zone-name; zone-name reported  on port NIDREF="FM41522"page 311Couldn't allocate packet buffersIDREF="FM13483"page 315Could not create desktop file (file-name) on volume #N (vol-name)IDREF="FM12963"page 319Could not create directory DESKTOP.AFP on volume #N (vol-name)IDREF="FM16190"page 319Could not initialize AFP support on volume #NIDREF="FM32572"page 315Could not open file (file-name) on volume #N (vol-name)IDREF="FM10312"page 319Could not properly initialize desktop file (file-name) on volume #N (vol- name)IDREF="FM11211"page 320Could not read volume icon definition file (SYS:SYSTEM\VOLICON.AFP) File does  not exist or icon data format is invalid. Using internal default iconIDREF="FM23173"page 318Create queue spooler-name's AppleTalk interface failedIDREF="FM20196"page 324Created directory DESKTOP.AFP on volume #N (vol-name)IDREF="FM21347"page 318Created file file-name on volume #N (vol-name)IDREF="FM21315"page 318Creating queue queue-nameIDREF="FM21819"page 331Deleting desktop file file-name on volume #N (vol-name) because  CLEARDESKTOP is in effectIDREF="FM16231"page 318Desktop files are invalid or damaged on volume #N (vol-name)IDREF="FM28523"page 320Dictionary file-name not presentIDREF="FM33559"page 331Error binding APPLETALK to board N (ERR=N)IDREF="FM17126"page 303Error updating APPL record in desktop file APPLDATA.AFPIDREF="FM26057"page 321Error updating ICON in desktop file ICONDATA.AFPIDREF="FM35744"page 321Error updating ICON INDEX in desktop file ICONINDX.AFPIDREF="FM42503"page 321Extended net range (N-N) is in the Startup RangeIDREF="FM27644"page 304Failure making NBP entityIDREF="FM34011"page 321Failure registering with NBPIDREF="FM10322"page 321Font list query of printer printer-name failed, retryingIDREF="FM26499"page 325Getting an initial spooler font list from printer printer-nameIDREF="FM30294"page 331Initializing existing queue queue-nameIDREF="FM29673"page 331Invalid character in zone name converted to ?IDREF="FM34604"page 312Insufficient memory to allocate a sessionIDREF="FM17298"page 316Legal parameters are: [-v] [-dpathname]IDREF="FM38424"page 323Mismatched net numbers: local=N; N reported on port NIDREF="FM41522"page 311Mismatched range numbers: local=N-N; N reported on port NIDREF="FM41522"page 311More than N zone name(s) given with ZONE parameterIDREF="FM38484"page 304NBP lookup errorIDREF="FM14845"page 324NBP registering spooler spooler-name:type@zone-nameIDREF="FM22297"page 332No entities were foundIDREF="FM27996"page 334No memory when entering range N-NIDREF="FM26544"page 308No zone file entry found for net NIDREF="FM23903"page 305No zone file entry found for net range N-NIDREF="FM23903"page 305Nonextended net number (N) is in the Startup RangeIDREF="FM30368"page 304Option "-z" (use zone file) is in effect, but ZONE parameter was given ---  OVERRIDING zone fileIDREF="FM25674"page 303Printer printer-name Hardware Error: stringIDREF="FM12496"page 325Printer printer-name illegal NBP nameIDREF="FM31965"page 325Printed job N on printer printer-nameIDREF="FM20352"page 332Printer printer-name busy - statusIDREF="FM24005"page 332Range start is greater than range end (N-N)IDREF="FM16527"page 305Received job NIDREF="FM15767"page 332Received zip reply with invalid character in zone nameIDREF="FM30152"page 312RTMP packet shows range N-N, which is in the startup range Ignoring RTMP packetIDREF="FM29298"page 312Sending LaserPrep file (file-name)...IDREF="FM32263"page 332Sending PAP EOF because EOF marker seenIDREF="FM28424"page 331Sent N bytes to printerIDREF="FM20616"page 333Servicing print job NIDREF="FM30188"page 332SYS:SYTEM\ATPS.NLM: bad config parameter: stringlegal parameters are: [printer-name:zone] [-pprinter-name] [-zzone-name][-ospooler-name] [-ttype] [-s] [-c] [-n[maxconnect]] [-b] [-e] [-a]  [-ffilename][-h] [-l] [-wb] [-wf]IDREF="FM21828"page 323SYS:SYSTEM\ATPS.NLM: bad config parameter: stringlegal parameters are: [-v] [-dpathname]IDREF="FM38424"page 323System log file does not existIDREF="FM34694"page 334System log file is emptyIDREF="FM10310"page 334There are no nodes on this AppleTalk networkIDREF="FM32987"page 333There are too many possible volumes to use this version of AFP NLMIDREF="FM27744"page 321Too many zone names given in zone file entryIDREF="FM42195"page 306Transition routing option is on and Phase-1 router present on port NIDREF="FM39041"page 303Transition routing option is ON but found range N-NIDREF="FM31925"page 306Transition routing option is ON, but there is more than one zone nameIDREF="FM19411"page 306Transition-router option is on and there is more than one zone nameIDREF="FM30406"page 313Unable to allocate ECBIDREF="FM34428"page 309Unable to allocate stringIDREF="FM26360"page 316Unable to allocate memory (DTVPTR).FATAL ERROR!IDREF="FM10589"page 316Unable to allocate SessionTableIDREF="FM29660"page 316Unable to create default volume icon file:SYS:SYSTEM\VOLICON.AFPIDREF="FM39456"page 321Unable to create default volume mapping file SYS:SYSTEM\VOLNAMES.AFPIDREF="FM42385"page 321Unable to delete desktop file file-name on volume #N (vol-name)IDREF="FM24427"page 322Unable to get memory for AFP callbackIDREF="FM36081"page 316Unable to get memory for AFP polling processIDREF="FM18149"page 316Unable to get memory for AFP service ProcessIDREF="FM39719"page 316Unable to get memory for compression processIDREF="FM11303"page 316Unable to get session from ASP. Error: NIDREF="FM16403"page 317Unable to initialize ASP. Error NIDREF="FM20669"page 317Unable to open server listening socket. Error NIDREF="FM33602"page 317Unbind of AARP from board N failed (ERR=N)IDREF="FM14630"page 314Unbind of APPLETALK from board N failed (ERR=N)IDREF="FM15783"page 314Using directory dir-nameIDREF="FM20616"page 333Using font list file file-nameIDREF="FM41127"page 333Volume icon file (SYS:SYSTEM\VOLICON.AFP) did not exist and was createdIDREF="FM29363"page 322Volume mapping file (SYS:SYSTEM\VOLNAMES.AFP) did not exist and was createdIDREF="FM42095"page 322Volume #N (vol-name) is unavailable to AFP clients. The desktop files could not  be openedIDREF="FM18620"page 322Warning! printer printer-name unexpectedly hiddenIDREF="FM42027"page 333Warning! printer printer-name unexpectedly not hiddenIDREF="FM42027"page 333You must first edit the test parameters to select a node numberIDREF="FM35311"page 334Zone names can have a maximum of 32 charactersIDREF="FM23128"page 307Zone names must have at least one characteridxid="w6599"book="_idx" docset="nw312" tidref="i3839"IDREF="FM34622"page 307idxid="w6600"book="_idx" docset="nw312" tidref="i6667"AppleTalk Stack/ idxid="w6601"book="_idx" docset="nw312" tidref="i6667"idxid="w6602"book="_idx" docset="nw312" tidref="i6667"Router idxid="w6603"book="_idx" docset="nw312" tidref="i6466"System idxid="w6604"book="_idx" docset="nw312" tidref="i362"MessagesThese messages refer to the AppleTalk stack and router in NetWare for Macintosh. You can view these messages in the ATCON utility by selecting the View Logs option from the main menu and choosing View System Log.Informational Messages from the idxid="w6605"book="_idx" docset="nw312" tidref="i6667"AppleTalk StackThese messages appear in response to dropped or severely corrupted packets, or both. Packets can be severely corrupted in transit or at their source. Packets corrupted in transit will degrade network performance because the node expecting the corrupted packet will request a retry, causing delays of as much as two seconds per corrupted packet. Packets corrupted at their source and sent out at random on the network can degrade performance generally, by crowding the wire with unproductive, incomprehensible data. In either case, the source of the corrupted packets should be identified and corrected as quickly as possible.ID="FM18438"ATALK Warning: [xx] Req with unknown session id yy on SCB zzzzzzA packet from an existing AFP connection with Session ID xx, being maintained by Session Control Block zzzzzz, was received with a Session ID of yy.Action: The packet will be ignored. The session ID is the ASP session ID, which is part of the ASP "header"; the ASP header can aid in finding the network fault.ATALK Warning: ATP returned error xx on idxid="w6606"book="_idx" docset="nw312" tidref="i3610"OpenConn replyxx is a standard NetWare error. This error indicates that ATPS has dropped the connection from a Macintosh client to an ATPS queue; xx indicates the error code returned.ATALK Warning: Bad ConnID, got xx, expect yyThis message indicates that a packet from an idxid="w6607"book="_idx" docset="nw312" tidref="i311"existing PAP connection, using Connection ID yy, was received with a Connection ID of xx.Action: The packet will be ignored, and the originator should re-send the packet with its original contents. For a similar condition, see message IDREF="FM18438""ATALK Warning: [xx] Req with unknown session id yy on SCB zzzzzz" on page 301.ATALK Warning: ASP - Dropped getreq type xx from wrong sourceThis message normally appears because a Macintosh client determines a session to be active while the server determines the session to be closed. Another possible cause for this message to appear is a network fault.xx is the ASP request type, for example, 6 (write).ASP keeps track of which remote workstation nodes are attached to which sockets. When ASP receives a packet from a different node, it rejects the packet. Note that ATP rejects the packet if the ATP header is incorrect.ATALK Warning: PAP connection 0xYY died due to tickle timeoutThe connection that was established between an ATPS idxid="w6608"book="_idx" docset="nw312" tidref="i5282"idxid="w6609"book="_idx" docset="nw312" tidref="i5482"print queue and the AppleTalk printer has failed. YY indicates the connection ID that was lost. This could indicate a hardware problem with the printer, the server, or a cable problem. In any case, the print job that established the connection will be retried.ATALK LAPGetNet Type - Board does ETHERNET_SNAP frames. Attempt to bind APPLETLK LAN protocol to driver name failed. (error=FFFFFFFF)The idxid="w6610"book="_idx" docset="nw312" tidref="i673"BIND line that was entered has a syntax error. Usually, this message indicates that a network range for a Phase II network has been specified incorrectly.Informational Messages from the AppleTalk RouterID="FM20459"AppleTalk Stack/Router v3.12 is runningidxid="w6611"book="_idx" docset="nw312" tidref="i260"When the router is coming up on the AppleTalk network, the system generates this message to indicate that APPLETLK.NLM is loaded and running.ID="FM35405"Board N does frame-type framesThe system generates this informational message when the router is coming up on the AppleTalk network. N is a device ID that the system assigns, and frame-type is an abbreviation for the AppleTalk frame type bound to the board. For example, E_SNAP stands for ETHERNET_SNAP. You can use this message to verify that you specified the correct frame type for the board's LAN driver.ID="FM39041"Transition routing option is on and Phase-1 router present on port Nidxid="w6612"book="_idx" docset="nw312" tidref="i6881"This message indicates that you correctly configured the router in Transition Mode, and that the router has detected a Phase 1 router on the specified port. portN is the AppleTalk port number. The system assigns the port number in the same order as the BIND command lines. For example, if you have two BIND APPLETLK command lines in AUTOEXEC.NCF, there will be two AppleTalk ports; port 1 is associated with the network created by the first BIND command line, and port 2 is associated with the network created by the second BIND command line.ID="FM25674"Option "-z" (use zone file) is in effect, but ZONE parameter was given --- OVERRIDING zone fileidxid="w6613"book="_idx" docset="nw312" tidref="i7576"This message indicates that you specified the -z option on the LOAD APPLETLK command line, and that you also specified a zone name on the LOAD APPLETLK or a BIND APPLETLK command line in AUTOEXEC.NCF. Usually the zone name is specified in only one of these ways, so check the actual configuration. The zone name in AUTOEXEC.NCF takes idxid="w6614"book="_idx" docset="nw312" tidref="i7576"precedence. idxid="w6615"book="_idx" docset="nw312" tidref="i6667"Configuration ProblemsID="FM40713"Already bound to board N.N is a device ID idxid="w6616"book="_idx" docset="nw312" tidref="i673"that the system assigned to the board. This error message indicates that you have a redundant BIND APPLETLK command line for the specified network board, causing the second BIND to fail.Action: To fix this condition, follow these steps:Edit SYS:SYSTEM\AUTOEXEC.NCF to remove the redundancy; the redundant BIND APPLETALK command is specified there.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.ID="FM17126"Error binding APPLETALK to board N1 (ERR=N2)N1 is a device ID assigned by the system, and N2 is a standard NetWare error code; consult the NetWare 3.12 System Messages manual for explanations of NetWare errors. This message indicates that AppleTalk failed to idxid="w6617"book="_idx" docset="nw312" tidref="i673"BIND to one of the boards.Action: Make sure that the board is firmly seated in its slot, that the connectors are secure, and that the board has been verified to work with AppleTalk.ID="FM27644"Extended net range (N-N) is in the idxid="w6618"book="_idx" docset="nw312" tidref="i4556"Startup RangeID="FM30368"Nonextended net number (N) is in the Startup idxid="w6619"book="_idx" docset="nw312" tidref="i4569"RangeEither of these errors will cause the LOAD APPLETLK or BIND APPLETLK command line for that network to fail. The first message indicates that you configured an extended network (an EtherTalk 2.0 or TokenTalk network) with a range contained in the startup range. The second message indicates that you configured a nonextended network (EtherTalk 1.0 or LocalTalk) with a number contained in this range.N-N is a range, or N is a number, between 65280 and 65534. AppleTalk Phase 2 reserves the network numbers 65280---65534 as a default "startup range" for nodes that boot up on the network when no router is available.Action: To fix this condition, follow these steps:Edit SYS:SYSTEM\AUTOEXEC.NCF, if this is where the network range has been assigned, to assign a different network range to that network.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish idxid="w6620"book="_idx" docset="nw312" tidref="i4556"this. idxid="w6621"book="_idx" docset="nw312" tidref="i4569"ID="FM38484"More than N zone name(s) given with ZONE parameteridxid="w6622"book="_idx" docset="nw312" tidref="i7576"This message indicates that you entered more than one zone name for a nonextended network or more than 255 zone names for an extended network on the LOAD APPLETLK or BIND APPLETLK command line in AUTOEXEC.NCF. This condition causes the LOAD or BIND command line for that network to fail. N can be "1" for nonextended networks or "16" for extended networks.Action: To fix this condition, follow these steps:Edit SYS:SYSTEM\AUTOEXEC.NCF, if this is where the zone names are specified, to reduce the number of zone names on the appropriate network.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.ID="FM23903"No zone file entry found for net NNo zone file entry found for net range N-Nidxid="w6623"book="_idx" docset="nw312" tidref="i569"N is a network number configured on either the LOAD APPLETLK or a BIND APPLETLK command line, or N-N is a network range configured on a BIND APPLETLK command line, in AUTOEXEC.NCF. This message indicates that you specified the -z option on the LOAD APPLETLK command line, but the ATZONES.CFG file did not contain an entry for the specified network. Therefore, the LOAD or BIND command will fail. If the LOAD command fails, AppleTalk will not be loaded. If the BIND command fails, AppleTalk will not be active on that interface.Action: To fix this condition, follow these steps:Edit the ATZONES.CFG file and add a zone configuration for the specified network number, using the syntax net=n1 zone={"Zone1"}or net=n1-n2 zone={"Zone1", "Zone2", ..., "ZoneN"}When you have entered the zone configuration, unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.ID="FM16527"Range start is greater than range end (N-N)N-N is an invalid network range because the first number is greater than the second one. An extended network range must be a contiguous range of decimal numbers, such as 1-10. If the first number is greater than the second one, the BIND command will fail.Action: To fix this condition, follow these steps:Edit SYS:SYSTEM\AUTOEXEC.NCF, if this is where the network range is configured, to reconfigure the network range correctly.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this. idxid="w6624"book="_idx" docset="nw312" tidref="i569"ID="FM42195"Too many zone names idxid="w6625"book="_idx" docset="nw312" tidref="i7576"given in zone file entryThis message indicates that you entered more than one zone name for a nonextended network, or more than 255 zone names for an extended network, in the ATZONES.CFG file. This condition causes the LOAD APPLETLK or BIND APPLETLK command for that network to fail.Action: To fix this condition, follow these steps:Edit SYS:SYSTEM\ATZONES.CFG, if this is where zone names are given, to reduce the number of zone names for the appropriate network.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.ID="FM31925"Transition routing option is ON, idxid="w6626"book="_idx" docset="nw312" tidref="i4569"but the range is more than one (N-N)N-N is an extended network range where the first number is less than the second one. When you specify the -t option on the LOAD command line, the router is in Transition Mode and will check range constraints on all extended interfaces. If it finds a BIND command line with a network range where the range start is less than the range end, the BIND command will fail.Action: If you did not intend to use Transition Mode, modify AUTOEXEC.NCF to remove the -t option from the LOAD APPLETLK command line; then, down the file server and bring it up again.If you need Transition Mode, modify AUTOEXEC.NCF (and ATZONES.CFG, if you are also using the -z option) to constrain the network range on all BIND command lines; then, unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this. idxid="w6627"book="_idx" docset="nw312" tidref="i4569"ID="FM19411"Transition routing option is ON, idxid="w6628"book="_idx" docset="nw312" tidref="i7597"but there is more than one zone nameWhen you specify the -t option on the LOAD APPLETLK command line, the router is in Transition Mode and will limit zones lists to a single zone name on all extended interfaces. If the router finds a BIND command line with a zones list containing more than one name, the BIND command will fail.Action: If you did not intend to use Transition Mode, modify AUTOEXEC.NCF to remove the -t option from the LOAD APPLETLK command line; then, down the file server and bring it up again.If you need Transition Mode, modify AUTOEXEC.NCF (or ATZONES.CFG) to make sure that no networks have a zones list with more than one name; then, unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.ID="FM23128"Zone names can have a maximum of idxid="w6629"book="_idx" docset="nw312" tidref="i7576"32 charactersThis message indicates that you entered a zone name longer than 32 characters, or that you used an incorrect syntax when specifying zone names, causing the stack/router to interpret a string longer than 32 characters as a zone name. In either case, the LOAD APPLETLK or BIND APPLETLK command line will fail.For example, suppose you neglect to enter closing quotes in a zones list, and enter a command line such as zone={"Zone1, Zone2, Zone3, Zone4, Zone5, Zone6"}The entire string contained within double-quotes is interpreted as a single zone name.Action: To fix this condition, follow these steps:Check AUTOEXEC.NCF (or ATZONES.CFG) for zone names that are too long, or that are entered with incorrect syntax.Correct the error.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this. idxid="w6630"book="_idx" docset="nw312" tidref="i7576"ID="FM34622"Zone names must have at least one characterThis message indicates that you entered the string zone={""}in a network specification, causing the LOAD APPLETLK or BIND APPLETLK command line to fail.Action: To fix this condition, follow these steps:Check AUTOEXEC.NCF or ATZONES.CFG for a null zone name.Correct the error.Unload and reload APPLETLK.NLM. For convenience, you can use a custom NCF file to accomplish this.Memory Shortages idxid="w6631"book="_idx" docset="nw312" tidref="i3572"The messages in this section indicate a low-memory condition in the file server. Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 if you would like recommendations about server memory.ID="FM26544"No memory when entering range N-NThis message indicates that the router was unable to create an entry for the specified network range in its RTMP table.If N-N is a network range configured on a BIND APPLETLK command line in AUTOEXEC.NCF, that BIND command will fail.Action: To fix this condition, you need to increase the short-term memory allocation, or increase the amount of memory installed in the file server, or both. For example, to increase the short-term memory allocation to 2.5 Mbytes, you can use the command set maximum alloc short term memory=2500000at the console prompt, or in AUTOEXEC.NCF. If you enter this command in a startup file, you must down the server and bring it up again before the command has an effect.If N-N is a network range configured in another router, the current router is unaware of that network. This condition could correct itself within a few minutes if the server's demand for short-term memory was uncharacteristically high when the message was generated, and the high demand for this memory subsides. Otherwise, you need to increase the memory as described above.ID="FM34428"Unable to allocate idxid="w6632"book="_idx" docset="nw312" tidref="i1914"ECBThis message can occur at any time after you bring up the router. It indicates that the router was unable to acquire sufficient packet-receive buffers (also called Event Control Blocks or ECBs). Running out of ECBs is not a fatal condition.If you see this message after the server has been running for some time, here is how to interpret the message: Servers that run for several days under conditions where high loads occur in "peaks" may exceed the default 500 ECB maximum, causing the system to generate this message. If these situations are caused by peaks in the memory demand, it is a good idea to keep the 500 ECB maximum limitation and allow the message to be generated at those times.In some situations, however, such as a server load that is consistently very high, with many IPX and AppleTalk routines, 500 ECBs might not be enough as a maximum. In any case, the decision to raise the maximum is a performance/memory trade-off.If you see this message repeated quickly when the router is initially brought up, this guide recommends that you specify at least 100 packet-receive buffers in the file server's STARTUP.NCF file: set minimum packet receive buffers=100If the number is consistently too low for the server's needs, the router could start dropping packets and closing AFP connections (although the latter is unlikely), and you will notice performance problems on the file server.Action: To check the memory conditions on the server, follow these steps:Use the MONITOR command to check the number of ECBs used after the router has run for an hour or more. (The ECB number is in the upper right-hand corner of the screen in the MONITOR program.)If you see the ECB number incrementing rapidly, set the initial number of packet-receive buffers higher. You set this value in the STARTUP.NCF file; for example, you might specify this command line: set minimum packet receive buffers=300Of course, you must have sufficient memory installed in the file server to allocate the packet-receive buffers, each of which requires approximately 1 idxid="w6633"book="_idx" docset="nw312" tidref="i1914"Kbyte. idxid="w6634"book="_idx" docset="nw312" tidref="i3572"Inconsistent Configurations on the InternetID="FM17465"Bad RTMP format, idxid="w6635"book="_idx" docset="nw312" tidref="i6093"port NThis message indicates that at least one router or bridge on the internet is sending RTMP packets that use a format that is not supported. For example, there could be a bridge running software that predates Apple's introduction of EtherTalk. N is the AppleTalk port number, assigned in the same order as the BIND command lines.Action: In this case, you should update the software on the host that is sending RTMP packets in an unsupported format. (For example, if two BIND APPLETLK command lines appear in AUTOEXEC.NCF, there will be two AppleTalk ports; port 1 will be associated with the network created by the first BIND command line, and port 2 will be associated with the network created by the second BIND command line. Port 0 is always associated with the internal network.)ID="FM29295"Conflicting information: local net=N; N reported on port NID="FM21412"Conflicting information: local range=N-N; N-N reported on port NMismatched net numbers: local=N; N reported on port NMismatched range numbers: local=N-N; N reported on port NThese messages indicate that an inconsistency in the network number or range has been found among routers connected to the cable associated with the specified port number. N is the AppleTalk port number, assigned in the same order as the BIND command lines. (For example, if you have two BIND APPLETLK command lines in AUTOEXEC.NCF, there will be two AppleTalk ports; port 1 will be associated with the network created by the first BIND command line, and port 2 will be associated with the network created by the second BIND command line. Port 0 is always associated with the internal network.)Action: It is very important that you correct this type of inconsistency by reconfiguring one of the routers. Inconsistent network numbers will cause confusion on the entire internet. To fix the situation, follow these steps:Check the router configurations in all routers connected to the cable identified by the port number. Port numbers are assigned dynamically at BIND time, so other routers might have different port numbers assigned to that cable.If you have a packet analyzer, you can use it to acquire this information.Bring down the inconsistent router.Correct the configuration in the inconsistent router.Bring up the router with its new configuration.Please see IDREF="FM13387""Changing the AppleTalk Network Number or Range" on page 120 if you would like more details. idxid="w6636"book="_idx" docset="nw312" tidref="i6093"ID="FM41522"Conflicting information: idxid="w6637"book="_idx" docset="nw312" tidref="i7592"local default zone = zone-name; zone-name reported on port NThis message indicates that an inconsistency in the zones list has been found among routers connected to the cable associated with the specified port number. Specifically, this message indicates that the first zone name in the list (the default zone) differs between routers. N is the AppleTalk port number, assigned in the same order as the BIND command lines. (For example, if you have two BIND APPLETLK command lines in AUTOEXEC.NCF, there will be two AppleTalk ports; port 1 will be associated with the network created by the first BIND command line, and port 2 will be associated with the network created by the second BIND command line. Port 0 is always associated with the internal network.)Action: It is very important that you correct this type of inconsistency by reconfiguring one of the routers. To fix this condition, follow these steps:Check the router configurations in all routers connected to the cable identified by the port number. (Remember that port numbers are assigned dynamically at BIND time, so other routers might have different port numbers assigned to that cable.)Bring down the inconsistent router.Correct the configuration in the inconsistent router.Bring up the router with its new configuration.Please see IDREF="FM18960""Changing the AppleTalk Zone Name or Zones List" on page 122 if you would like more details.ID="FM34604"Invalid character in zone name converted to ?The router considers a character invalid in a zone name if its ASCII value is less than hex 20 or equal to hex 7F. This message indicates that the router has detected an illegal character in a zone name and converted it to ASCII 3F (a question mark).ID="FM30152"Received zip reply with idxid="w6638"book="_idx" docset="nw312" tidref="i7576"invalid character in zone name  [The router considers a character invalid in a zone name if its ASCII value is less than hex 20 or equal to hex 7F. This message indicates that another router has sent a ZIP packet with an illegal character in the zone name.]Action: To fix this condition, you should locate the incorrectly configured router and replace the invalid character in the zone name. See IDREF="FM10750""Symptom: Zone Names Do Not Match Existing Zone Names" on page 220 for information on how to enter legal control characters in a zone name, and IDREF="FM18960""Changing the AppleTalk Zone Name or Zones List" on page 122 for more details on modifying zone configurations. idxid="w6639"book="_idx" docset="nw312" tidref="i7576"ID="FM29298"RTMP packet shows range N-N, which is idxid="w6640"book="_idx" docset="nw312" tidref="i4569"in the startup range. Ignoring RTMP packetN-N is a range between 65,280 and 65,534. AppleTalk Phase 2 reserves the network numbers 65,280-65,534 as a default "startup range" for nodes that boot up on the network when no router is available. This message indicates that a remote EtherTalk 2.0 or TokenTalk network (a network not directly connected to the router in the current file server) has been configured with a network range contained in the startup range.Action: To fix this condition, follow these steps:Check the RTMP table in ATCON and try to locate the misconfigured network.Bring down the misconfigured router.Correct the router's network range.Bring up the router with its new configuration.Please see IDREF="FM13387""Changing the AppleTalk Network Number or Range" on page 120 for more details.ID="FM41632"Transition routing option is idxid="w6641"book="_idx" docset="nw312" tidref="i4569"ON but found range N-NWhen you specify the -t option on the LOAD APPLETLK command line, the router is in Transition Mode. This mode requires that all extended network ranges on the entire internet be constrained to only one element, where the range start is equal to the range end. This message indicates that a remote network (a network not directly connected to the router in the current file server) was configured with an extended range. This condition prevents full internet connectivity, and may cause unpredictable results (such as device names appearing and disappearing rapidly in the Chooser). However, some services may continue to function if the disconnection is only partial.Action: To fix this condition, follow these steps:Check the RTMP table in ATCON and try to locate the misconfigured network.Bring down the incorrectly configured router(s).Correct the router's network range. (If other routers are connected to the same cable with the same configuration, they must also be reconfigured before you bring up any of the routers on the network.)Bring up the router with its new configuration.Please see IDREF="FM13387""Changing the AppleTalk Network Number or Range" on page 120 for more details. idxid="w6642"book="_idx" docset="nw312" tidref="i4569"ID="FM30406"Transition-router option is on and idxid="w6643"book="_idx" docset="nw312" tidref="i7576"there is more than one zone nameWhen you specify the-t option on the LOAD APPLETLK command line, the router is in Transition Mode. This mode requires that the zones list on all extended networks on the entire internet be limited to only one name. This message indicates that a remote network (which is not directly connected to the router in the current file server) was configured with more than one zone name. This condition will prevent full internet connectivity, and may cause unpredictable results (such as device names appearing and disappearing rapidly in the Chooser). However, some services may continue to function if the disconnection is only partial.Action: To fix this condition, follow these steps:Check the RTMP table in ATCON and try to locate the misconfigured network.Bring down the incorrectly configured router(s).Correct the router's zones list, and wait ten to twenty minutes for the old zone information to stop propagating among routers. (If other routers are connected to the same cable with the same configuration, they must also be reconfigured before you bring up any of the routers on the network.)Bring up the router with its new configuration.Please see IDREF="FM18960""Changing the AppleTalk Zone Name or Zones List" on page 122 for more details. idxid="w6644"book="_idx" docset="nw312" tidref="i7576"ID="FM15783"Unbind of APPLETALK from board N1 failed (ERR=N2)ID="FM14630"Unbind of AARP from board N1 failed (ERR=N2)N1 is a device ID assigned by the system, and N2 is a standard NetWare error code. These messages indicate that an internal error occurred when you unbound AppleTalk from a board or unloaded the AppleTalk module. (Unloading the AppleTalk module automatically does an UNBIND).AFP System idxid="w6645"book="_idx" docset="nw312" tidref="i6667"MessagesThese messages are related to the AFP file services module in NetWare for Macintosh. You can view these messages in the ATCON utility by selecting the View Logs option from the main menu and choosing View System Log.Memory or idxid="w6646"book="_idx" docset="nw312" tidref="i3572"Socket ShortagesID="FM29341"Attempt to create AFP process failedThis message indicates that the AFP module will not load, or will not function correctly if it does load, because a required resource was unavailable. The most probable cause is insufficient memory in the file server.Action: If you see this message, try to load AFP again from the console prompt. If the message is displayed again, run memory diagnostics and, if necessary, add more memory to the file server.ID="FM11097"ASP initialization failure. Error: NThe AppleTalk Session Protocol (ASP) provides the basic level of transport services for AFP file requests and responses between the Macintosh workstation and the file server. This message indicates that ASP failed to initialize; the AppleTalk stack might need more memory or the number of available sockets may be used up.Action: Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for more information on memory usage.ID="FM13483"Couldn't allocate packet buffersThis message is displayed when a call to allocate memory fails. It indicates that the system buffers used to store information received from the AppleTalk stack have been over-utilized.Action: Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for more information on memory usage.ID="FM32572"Could not initialize AFP support on volume #N#N is the volume number. The SYS volume number is always 0.This message indicates that an internal call to allocate memory failed. It is unlikely that this condition will cause AFP to fail; however, volume N will be inaccessible to Macintosh clients. If this condition occurs, unload the AFP module and load it again from the console prompt.Action: Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for more information on memory usage.ID="FM35122"Insufficient memory to allocate a sessionThis message indicates that a login attempt failed because the AFP module could not access enough system memory. This condition usually means that the file server needs more memory.ID="FM17298"Insufficient memory to complete initialization of AFP!This message indicates that the AFP module could not access enough system memory to complete its own initialization process. This condition usually means that the file server needs more memory.ID="FM26360"Unable to allocate stringID="FM10589"Unable to allocate memory (DTVPTR). FATAL ERROR!ID="FM29660"Unable to allocate SessionTablestring can be "short term memory," "packet-receive buffers," or other strings indicating memory shortages.These messages indicate that the AFP module was unable to allocate enough resources to complete its initialization process, and therefore the AFP module cannot load. This condition is most likely due to low memory in the file server.Action: Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for recommendations on memory usage.ID="FM36081"Unable to get memory for AFP callbackID="FM39719"Unable to get memory for AFP service ProcessID="FM18149"Unable to get memory for AFP polling processID="FM11303"Unable to get memory for compression processThese messages indicate that the AFP module was unable to obtain enough memory for its internal processes. This condition usually results from low memory.Action: To remedy the problem, increase the memory in the file server. Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248 for more information. ID="FM16403"Unable to get session from ASP. Error: NID="FM20669"Unable to initialize ASP. Error NThe AppleTalk Session Protocol (ASP) provides the basic level of transport services for AFP file requests and responses between the Macintosh workstation and the file server. This message indicates that ASP failed to initialize, which could mean that the AppleTalk stack needs more memory or that the number of available connections are used up. Both of these messages are FATAL and indicate a condition that prevents AFP from loading.Action: Please see IDREF="FM38004""AppleTalk Stack/Router Memory Requirements" on page 248.ID="FM33602"Unable to open server listening socket. Error NAt this release, this message indicates that the 127 sockets available for dynamic allocation in the AppleTalk stack are all being used. The server was unable to allocate the Server Listening Socket (SLS) required to establish AFP login connections.Action: To remedy this problem, you need to limit other uses of the AppleTalk stack; for example, you might need to limit the number of AppleTalk print queues or other applications that access the AppleTalk stack. idxid="w6647"book="_idx" docset="nw312" tidref="i3572"Informational MessagesID="FM14775"AFP registered with NBP after volume SYS was mountedThe AFP module generates this message if you dismount the SYS volume and mount it again while the AFP module is loaded. Because SYS is required for users to log in to the file server, the AFP module does not advertise on the AppleTalk network if the SYS volume is unavailable. Otherwise, Macintosh users could attempt to log in, but would receive a "password incorrect" message when AFP fails to find the bindery on SYS. The AFP module registers with NBP and begins advertising as soon as the SYS volume is mounted again.ID="FM34547"AFP registered with NBP during AFP initializationThis informational message indicates that the AFP module is advertising on the AppleTalk network.ID="FM23173"Could not read volume icon definition file (SYS:SYSTEM\VOLICON.AFP). File does not exist or icon data format is invalid. Using internal default iconIf you use a text editor to modify the volume icon data contained in SYS:SYSTEM\VOLICON.AFP, you might see this informational message. It indicates that the changes you made resulted in an invalid data format. The system will use the standard NetWare file cabinet icon.ID="FM21347"Created directory DESKTOP.AFP on volume #N (vol-name)This informational message indicates that the system mounted a volume that supports the Macintosh name space and created the idxid="w6648"book="_idx" docset="nw312" tidref="i1389"DESKTOP.AFP idxid="w6649"book="_idx" docset="nw312" tidref="i2453"folder. ID="FM21315"Created file file-name on volume #N (vol-name)file-name is ICONDATA.AFP, ICONINDX.AFP, APPLDATA.AFP, VOLNAMES.AFP, or VOLICON.AFP. #N is the volume number, and vol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, then vol-name is the alias name.This informational message indicates that the specified system file was created on the specified volume.ID="FM16231"Deleting desktop file file-name on volume #N (vol-name) because CLEARDESKTOP is in effectfile-name is ICONDATA.AFP, ICONINDX.AFP, or APPLDATA.AFP. #N is the volume number, and vol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.This informational message indicates that the AFP module deleted the DESKTOP.AFP files because you used the CDT option. This message will display for each volume that supports the Macintosh name space and is currently mounted.General Error MessagesID="FM31893"AFP unregistered with NBP because SYS volume was dismountedThe AFP module generates this message if you dismount the SYS volume after loading the AFP module. It indicates that AFP has stopped advertising on the AppleTalk network. Because SYS is required for users to log in to the file server, the AFP module does not advertise on the AppleTalk network if the SYS volume is unavailable. Otherwise, Macintosh users could attempt to log in, but would receive a "password incorrect" message when AFP fails to find the bindery on SYS.Action: To fix this condition, you must mount the SYS volume.ID="FM12963"Could not create desktop file (file-name) on volume #N (vol-name)file-name is ICONDATA.AFP, ICONINDX.AFP, or APPLDATA.AFP. #N is the volume number, and vol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.This message could mean that a basic system resource, such as disk space, was unobtainable when the call to create file-name was executed, causing the call to fail. It could also mean that a directory exists with the same file-name.ID="FM16190"Could not create directory DESKTOP.AFP on volume #N (vol-name)#N is the volume number, andvol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.This message could mean that basic system resources, such as disk space, were unobtainable when the system tried to create the DESKTOP.AFP folder.ID="FM10312"Could not open file (file-name) on volume #N (vol-name)file-name is ICONDATA.AFP, ICONINDX.AFP, or APPLDATA.AFP. #N is the volume number, andvol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.The message indicates that AFP could not open the file. The file may not exist, and could not be created, due to the unavailability of a basic system resource, such as disk space. Or, there may be an existing directory by the same name.ID="FM11211"Could not properly initialize desktop file (file-name) on volume #N (vol-name)When the AFP module creates DESKTOP.AFP, the files it contains must be initialized with basic data structures. This message indicates that the initialization process failed.Action: If you see this message, unload AFP from the console prompt and load it with the CDT option: UNLOAD AFP <Enter> LOAD AFP CDT <Enter>The CDT option deletes the current DESKTOP.AFP folder and creates a new one on each volume that is currently mounted and that supports the Macintosh name space. You must rebuild the new desktop files from a Macintosh client, as described in IDREF="FM17320""Maintenance Issues: Clearing and Rebuilding the Desktop" on page 134.ID="FM28523"Desktop files are invalid or damaged on volume #N (vol-name)This message can display during AFP initialization or while the system is running. It indicates that internal consistency checks in the AFP module show that the information in the DESKTOP.AFP files is invalid. The problem might have occurred because of a system crash or because you brought down the system without using the DOWN command.Action: If you see this message, unload AFP from the console prompt and load it with the CDT option: UNLOAD AFP <Enter> LOAD AFP CDT <Enter>The CDT option deletes the current DESKTOP.AFP folder and creates a new one on each volume that is currently mounted and supports the Macintosh name space. You must rebuild the new desktop files from a Macintosh client, as described in IDREF="FM17320""Maintenance Issues: Clearing and Rebuilding the Desktop" on page 134.ID="FM26057"Error updating APPL record in desktop file APPLDATA.AFP.Error code=NID="FM35744"Error updating ICON in desktop file ICONDATA.AFP. Error code=NID="FM42503"Error updating ICON INDEX in desktop file ICONINDX.AFP. Error code=NThese messages indicate that a change being written by the Macintosh Finder to the DESKTOP.AFP files was not completed successfully. This condition can be caused by a lack of disk space, or by a system error condition.Action: Because the file(s) are invalid after the incomplete write attempt, you should clear the desktop and rebuild it from a Macintosh client.ID="FM34011"Failure making NBP entityID="FM10322"Failure registering with NBPThe AppleTalk Name Binding Protocol (NBP) layer of the AppleTalk stack was unable to create a visible entity for the AFP module. Therefore, the NetWare file server is not registered as a service on the AppleTalk network, and Macintosh users cannot log in via the Chooser.Action: If you see either of these messages, you should unload AFP and load it again from the console prompt. ID="FM27744"There are too many possible volumes to use this version of the AFP NLMBoth NetWare 3.12 and the AFP module limit the number of volumes that you can create on a single file server to 64. This message indicates that more than 64 volumes are connected to the server.ID="FM39456"Unable to create default volume icon file: SYS:SYSTEM\VOLICON.AFPID="FM42385"Unable to create default volume mapping file SYS:SYSTEM\VOLNAMES.AFPThese messages mean that the CREATE call failed when the AFP module tried to create the named files. AFP will work without these files, so these messages are informational; however, you should investigate the cause of the message.Action: Check the amount of disk space on the volume and check SYS:SYSTEM to make sure that a directory does not exist with a file name used by AFP.ID="FM24427"Unable to delete desktop filefile-name on volume #N (vol-name). Error code=Nfile-name is ICONDATA.AFP, ICONINDX.AFP, or APPLDATA.AFP. #N is the volume number, and vol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.This message appears if you load the AFP module with the CDT option and the system could not delete the desktop files. Inadequate NetWare rights cannot cause this condition.Action: You should manually go into DESKTOP.AFP and delete the file.ID="FM29363"Volume icon file (SYS:SYSTEM\VOLICON.AFP) did not exist and was createdID="FM42095"Volume mapping file (SYS:SYSTEM\VOLNAMES.AFP) did not exist and was createdThese messages are likely to appear when you load the AFP module for the first time, and the AFP module creates the VOLICON.AFP and VOLNAMES.AFP files in SYS:SYSTEM. These messages also appear if the files were deleted and AFP must create them again.ID="FM18620"Volume #N (vol-name) is unavailable to AFP clients. The desktop files could not be opened#N is the volume number, and vol-name is the volume name that Macintosh clients see. The SYS volume number is always 0. If you have assigned an AFP alias, vol-name is the alias name.If the AFP module is unable to open the files contained in DESKTOP.AFP, AFP will not advertise on the AppleTalk network, and Macintosh clients cannot log in to the file server via the Macintosh Chooser.Action: If you see this message, unload AFP from the console prompt and load it with the CDT option: UNLOAD AFP <Enter> LOAD AFP CDT <Enter>The CDT option deletes the current DESKTOP.AFP folder and creates a new one on each volume that is currently mounted and supports the Macintosh name space. You must rebuild the new idxid="w6650"book="_idx" docset="nw312" tidref="i362"desktop idxid="w6651"book="_idx" docset="nw312" tidref="i6667"idxid="w6652"book="_idx" docset="nw312" tidref="i6667"files idxid="w6653"book="_idx" docset="nw312" tidref="i6667"from a Macintosh client, as described in IDREF="FM17320""Maintenance Issues: Clearing and Rebuilding the Desktop" on page 134. idxid="w6654"book="_idx" docset="nw312" tidref="i6466"ATPS System idxid="w6655"book="_idx" docset="nw312" tidref="i324"MessagesThese messages are generated by the ATPS module. You can view these messages in the ATCON utility by selecting the View Logs option from the main menu and choosing View System Log, or in the ATPS Console Window when you have loaded ATPS in Verbose Mode. See IDREF="FM20159""Verbose Mode: Viewing Troubleshooting Messages" on page 190 for more information.Error MessagesID="FM21828"SYS:SYTEM\ATPS.NLM: bad config parameter: stringlegal parameters are: [printername:zone] [-p printername] [-z zone-name][-o spoolername] [-t type] [-s] [-c] [-n[maxconnect]] [-b] [-e] [-a] [-f filename][-h] [-l] [-wb] [-wf]This message indicates that ATPS found an invalid idxid="w6656"book="_idx" docset="nw312" tidref="i5282"idxid="w6657"book="_idx" docset="nw312" tidref="i516"queue configuration line in the ATPS.CFG file and did not load.Action: You need to open the ATPS.CFG file and check all configuration command lines for invalid parameters. When you have finished editing the file, load the ATPS module at the console by typing LOAD ATPS <Enter>Please see IDREF="FM25504""Print Services Configuration" on page 147 for details.ID="FM38424"SYS:SYSTEM\ATPS.NLM: bad config parameter: stringlegal parameters are: [-v] [-d pathname]This message indicates that ATPS found an invalid option on its idxid="w6658"book="_idx" docset="nw312" tidref="i3245"LOAD command line and did not load.Action: To fix this condition, you can load the ATPS module at the console, making sure that if you specify any options, they are valid options as shown in the error message. To load the ATPS module with no options, type LOAD ATPS <Enter>Please see IDREF="FM17711""Loading the ATPS Module" on page 146 for more information. idxid="w6659"book="_idx" docset="nw312" tidref="i3245"ID="FM20196"Create queue spooler-name's AppleTalk interface failedThis message indicates that ATPS was unable to register the specified AppleTalk print spooler. This could be result from an invalid spooler name, type, or zone having been specified in the ATPS.CFG file, or because there is a previously existing NBP object of the specified name and type in the specified zone. For more information, see IDREF="FM29796""Assigning a Descriptive Name: -o" on page 159.ID="FM29842"Can't log in as numberidxid="w6660"book="_idx" docset="nw312" tidref="i324"This message means that ATPS is unable to log in to the server as ATPS_QUSER or ATPS_PSRVR. This may mean that the bindery is closed or that logins are otherwise disabled. It may also mean that the password of the ATPS_PSRVR has been changed in PCONSOLE.Action: If this last condition is the case, delete ATPS_PSRVR from the Print Server Information window in PCONSOLE and reload ATPS. Otherwise, run BINDFIX and reload ATPS.ID="FM25265"Can't create idxid="w6661"book="_idx" docset="nw312" tidref="i324"ATPS directory dir-nameThis message means that ATPS could not create the specified directory, probably because ATPS could not create the pathname you specified with the -d option. ATPS creates only one directory, not a hierarchy, so the command LOAD ATPS -D PROJ:\NW\PRINT <Enter>presumes that the NW directory on the PROJ volume already exists. This message can also mean that a volume does not exist or is out of disk space.Action: Check your pathname and make sure that all directories except the last one already exist.ID="FM14845"ID="FM10742"Can't find printer printer-name:type@zone-name retrying idxid="w6662"book="_idx" docset="nw312" tidref="i324"This message means that ATPS could not find the printer on the AppleTalk network. This condition could be caused by a configuration problem in an AppleTalk router or by an error in the printer's name.Action: See IDREF="FM23294""Symptom: ATPS Cannot Find the AppleTalk Printer" on page 236 for more information.ID="FM21878"Can't open query file file-nameidxid="w6663"book="_idx" docset="nw312" tidref="i324"A query file is a PostScript file containing PostScript shorthand commands and the PostScript Procedure Set (ProcSet) comments. Apple's dictionary file is called the Laser Prep file; third-party applications sometimes use their own dictionary files with different file names.This message indicates that an ATPS queue could not find or open the specified query file. This condition could occur if the query file was inadvertently removed or had its NetWare rights changed in the ATPS directory.Action: Please see IDREF="FM21863""Files and Directories Used by ATPS" on page 182 for more details.ID="FM34667"Can't service halted queueThis message indicates that someone invoked PCONSOLE and entered "No" in the field "Servers can service entries in queue."Action: To fix this condition, invoke PCONSOLE from a DOS client and change the value of this field to "Yes."ID="FM26499"Font list query of printer printer-name failed, retryingThis message indicates that ATPS has not received a reply to its initial font list query of the specified printer, probably because the printer is turned off or in an error state. ATPS will continue attempting to get the font list until the module is unloaded.Action: To fix this condition, try turning idxid="w6664"book="_idx" docset="nw312" tidref="i324"the printer off and on.ID="FM12496"Printer printer-name Hardware Error: stringidxid="w6665"book="_idx" docset="nw312" tidref="i5482"This message means that the printer is in an error state. string can be "off line," "out of paper," "paper jam," or other indications of the hardware state.ID="FM31965"Printer printer-name:type@zone illegal NBP name idxid="w6666"book="_idx" docset="nw312" tidref="i5482"This message indicates that the name, type, and zone you used to specify the printer in the ATPS.CFG file do not constitute a legal NBP name. This condition usually means that either you used illegal characters in these parameters (an at-sign (@) or a colon character (:)), or else one of the parameters is too long (greater than 31 characters).ATPS Console Messages idxid="w6667"book="_idx" docset="nw312" tidref="i324"ID="FM24136"ATPS: create config failed, out of memoryID="FM11499"ATPS: create directory failed, out of memoryID="FM22726"ATPS: create spooler name failed, out of memoryID="FM19876"ATPS: parse printer name failed, out of memoryidxid="w6668"book="_idx" docset="nw312" tidref="i324"These messages are generated when ATPS is unable to complete the process of loading because the server is out of memory.Action: To fix this problem, install more memory in the server, or decrease the number of modules that are loaded in the server.ID="FM22978"ATPS: no parameter specifiedYou used one of the ATPS console commands and did not specify the required parameter.Action: Please see IDREF="FM13509""ATPS Console Commands" on page 191 for an explanation of the console commands.ID="FM17266"ATPS: invalid printer/spooler name nameThis message is generated when you enter a console command requiring a printer or spooler name as a parameter, and the argument was not a valid name from the ATPS.CFG file.ID="FM42489"idxid="w6669"book="_idx" docset="nw312" tidref="i531"ATPSHide: a spooler name is not a valid parameterYou specified the name of an AppleTalk print spooler instead of an AppleTalk printer.Action: Try the command again, specifying a printer name.ATPSHide: printer printer-name has been hiddenYou specified the name of a printer that has been successfully hidden.Action: If you wish to make it visible, use ATPSSHOW.ID="FM15734"ATPSHide: printer printer-name is a type that can't be hiddenATPSHIDE instructs a LaserWriter or ImageWriter to change its NBP type, so the printer will not respond to requests for type LaserWriter or type ImageWriter. If the printer does not use one of these types, ATPSHIDE does not instruct the printer to change its type.ID="FM14873"ATPSHide: printer printer-name could not be foundidxid="w6670"book="_idx" docset="nw312" tidref="i531"ATPSHide: lost connection with printer printer-nameThis message could mean that the AppleTalk network is down between the server and the specified printer, or that the printer has been turned off or disconnected.ID="FM26255"ATPSHide: printer printer-name busy, try again laterThis message means that ATPSHIDE could not "hide" the printer because the printer was either already in use or was in an error state.Action: Check the printer; if the printer is OK, try the command again in a few minutes.ID="FM42391"ATPSQuery: printer printer-name font query OKThis message means that ATPSQUERY obtained the font list from the printer and that the relevant spoolers' font lists are now up to date.ID="FM38982"idxid="w6671"book="_idx" docset="nw312" tidref="i534"ATPSQuery: can't find printer printer-name, query failedATPSQuery: couldn't connect to printer printer-name, query failedATPSQuery: printer printer-name: couldn't get font list, query failedThese messages mean that ATPSQUERY had difficulty communicating with a PostScript printer to obtain its font list. If ATPSQUERY was unable to obtain the font list from a PostScript printer, it usually means that the printer is off-line or is in an error state.Action: To remedy this problem, try turning the printer off and on again.ATPSQuery: printer-name is not a PostScript printerIf this message appears, it means that the printer is not defined as a PostScript printer, and hence a query for a font list makes no sense.ID="FM18485"ATPSQuery: printer printer-name busyThis message means that ATPSQUERY could not obtain the printer's font list because the printer was already in use.Action: Try the command again in a few minutes.ID="FM39642"ATPSQuery: queue spooler-name does not support a printerThis message means that you specified the name of a spooler and that queue is not being serviced by any AppleTalk printers.Action: In this case, you need to specify the font list explicitly on the configuration line in ATPS.CFG. See IDREF="FM35138""Specifying a PostScript Font List: -f" on page 156.ID="FM40580"ATPSQuery: printer printer-name's font list is not usedThis message means that no spooler is using the font list obtained by querying the specified printer. This can be a result of having multiple printers per queue.ID="FM21333"ATPSQuery: invalid printer/spooler name nameThis message means that the printer or spooler name you specified on the ATPSQUERY command line is not a valid printer or spooler name from the ATPS.CFG file.Action: Check the spelling of the printer name and try again. idxid="w6672"book="_idx" docset="nw312" tidref="i534"ID="FM37677"idxid="w6673"book="_idx" docset="nw312" tidref="i536"ATPSRem: a printer name is not a valid parameterYou specified a printer name instead of an AppleTalk spooler name.Action: Try the command again, specifying an AppleTalk spooler.ID="FM36617"ATPSRem: spooler spooler-name has already been removedYou specified the name of a spooler that has already been removed.Action: If you wish to restore the spooler, use ATPSRES.ID="FM15071"ATPSRem: Error: stringThe ATPSREM command was not able to complete. More information is provided by string.ID="FM18506"ATPSRem: removed spooler spooler-nameThe specified spooler has been successfully made invisible to Macintosh clients. idxid="w6674"book="_idx" docset="nw312" tidref="i536"ID="FM26223"idxid="w6675"book="_idx" docset="nw312" tidref="i538"ATPSRes: a printer name is not a valid parameterYou specified a printer name instead of an AppleTalk spooler name.Action: Try the command again, specifying an AppleTalk spooler.ATPSRes: spooler spooler-name is not removedYou specified the name of a spooler that was not "removed," so it cannot be restored.Action: If you wish to remove the spooler, use ATPSREM.ID="FM10368"ATPSRes: Error: stringThe ATPSRES command was not able to complete. More information is provided by string.ID="FM22069"ATPSRes: restored spooler spooler-nameThe specified spooler has been successfully made visible to Macintosh clients again.ID="FM27964"idxid="w6676"book="_idx" docset="nw312" tidref="i540"ATPSShow: a spooler name is not a valid parameterYou specified the name of an AppleTalk print spooler instead of an AppleTalk printer.Action: Try the command again, specifying a printer name.ID="FM38290"ATPSShow: printer printer-name is not hiddenYou specified the name of a printer that is not hidden.Action: If you wish to hide it, use ATPSHIDE.ID="FM30292"ATPSShow: printer printer-name is a type that can't be hiddenYou used the ATPSSHOW command on a printer type that is not "LaserWriter" or "ImageWriter."ID="FM41852"ATPSShow: printer printer-name could not be foundATPSShow: lost connection with printer printer-nameThis message could mean that the AppleTalk network is down between the server and the specified printer, or that the printer has been turned off or is in an error state.ID="FM25634"ATPSShow: printer printer-name busy, try again laterThis message means that ATPSShow could not make the printer visible on the AppleTalk network again, because the printer was either already in use or was in some error state.Action: Check the printer; if the printer is OK, try the command again in a few minutes. idxid="w6677"book="_idx" docset="nw312" tidref="i540"ID="FM14398"ID="FM31502"idxid="w6678"book="_idx" docset="nw312" tidref="i542"ATPSV: no parameter specifiedID="FM41092"ATPSV: invalid parameterThese messages mean that you used the ATPSV command incorrectly. The proper syntax to turn on Verbose Mode is ATPSV ON <Enter>The syntax to turn off Verbose Mode is ATPSV OFF <Enter>Action: See IDREF="FM20159""Verbose Mode: Viewing Troubleshooting Messages" on page 190 for more information on Verbose Mode.ID="FM31948"ATPSV: verbose mode is already OFFThis message is displayed when you enter "ATPS OFF" and Verbose Mode is already turned off. idxid="w6679"book="_idx" docset="nw312" tidref="i324"Informational MessagesThe messages in this section appear only if ATPS is in Verbose Mode. Please see IDREF="FM20159""Verbose Mode: Viewing Troubleshooting Messages" on page 190 for details on Verbose Mode.ID="FM27916"Attaching print server to queue queue-nameidxid="w6680"book="_idx" docset="nw312" tidref="i5421"This message indicates that the ATPS print server is beginning to service the specified queue.ID="FM37873"Begin job NN is the job number in PCONSOLE or the Print Queue module in the NetWare DA. This message indicates that the specified print job is being sent across the network to an ATPS print spooler.ID="FM28424"Checking job for EOF charactersSending PAP EOF because EOF marker seenThe first message indicates that ATPS is going to check this print job for the presence of Control-D characters. The second message appears whenever the printer recognizes a Control-D in a non-binary PostScript job and replaces it with a PAP EOF sequence.Action: Please see IDREF="FM41272""Technical Note about Printer Communication Channels" on page 169 and IDREF="FM42682""DOS PostScript Applications" on page 171 for more information.ID="FM21819"Creating queue idxid="w6681"book="_idx" docset="nw312" tidref="i5282"queue-nameThis message indicates that the specified queue is being created.ID="FM33559"Dictionary file-name not presentThe message indicates that the queue does not have a particular version of the idxid="w6682"book="_idx" docset="nw312" tidref="i3172"Laser Prep file (or other dictionary file) and will request the Macintosh application to download it.ID="FM30294"Getting an initial spooler font list from printer printer-nameidxid="w6683"book="_idx" docset="nw312" tidref="i2467"ATPS is obtaining a font list for the AppleTalk spooler by querying the specified AppleTalk printer.ID="FM29673"Initializing existing queue idxid="w6684"book="_idx" docset="nw312" tidref="i5282"queue-nameThis message means that the specified queue already exists and is being modified for use by ATPS.ID="FM22297"NBP registering spooler spooler-name:type@zone-nameThis message indicates that the AppleTalk spooler is being registered on the network as a printer. spooler-name is the name you specified by using the -o option on the configuration line, or "NW printer-name." type is the printer type, and zone-name is the zone in which the printer resides.ID="FM20352"Printed job N on printer printer-nameN is the job number in PCONSOLE or in the Print Queue module of the NetWare DA. This message means that the printer has finished printing the specified print job.ID="FM24005"Printer printer-name busy - statusstatus is a status string returned by the named printer; it can be "Printing job file-name," "Out of paper," "Paper jam," or "Waiting," among others. If you check the printer and the status printed here is inaccurate, try turning the printer off and on again. The status "Waiting" can indicate an error condition caused by PostScript jobs that do not contain the proper PostScript commands.ID="FM15767"Received job NN is the job number in PCONSOLE or the Print Queue module of the NetWare DA. This message means that the AppleTalk print spooler has received the specified print job.ID="FM32263"Sending Laser Prep file (file-name)... This message indicates that the queue is reinitializing the idxid="w6685"book="_idx" docset="nw312" tidref="i5482"printer with the specified Laser Prep file.ID="FM30188"Servicing print job Nidxid="w6686"book="_idx" docset="nw312" tidref="i5282"N is the job number in PCONSOLE or the Print Queue module of the NetWare DA. This message means that queue has begun sending the specified print job to the printer.ID="FM20616"Using directory dir-nameThis message prints as ATPS is loading. dir-name is the name of the directory being used to contain print queues and other files used by ATPS.Action: Please see IDREF="FM36084""Specifying an Alternative Location for Queue Directories" on page 190 for more information.ID="FM41127"Using font list file file-nameThe AppleTalk print spooler is using the specified font list file instead of querying an AppleTalk printer for its font list.Action: See IDREF="FM35138""Specifying a PostScript Font List: -f" on page 156 for more information.ID="FM42027"Warning! printer printer-name unexpectedly hiddenWarning! printer printer-name unexpectedly not hiddenThese messages indicate that the specified printers are not in the state ATPS expects. ATPS will try to hide visible printers that it expects to be hidden, but not vice versa. idxid="w6687"book="_idx" docset="nw312" tidref="i324"ATCON System Messages idxid="w6688"book="_idx" docset="nw312" tidref="i482"These messages refer to the ATCON utility in NetWare for Macintosh. You can view these messages in the ATCON utility by selecting the View Logs option from the main menu and choosing View System Log.Echo Test messages idxid="w6689"book="_idx" docset="nw312" tidref="i6667"ID="FM32987"There are no nodes on this AppleTalk networkThis message is displayed in these situations:The AppleTalk network number you specified in Edit Echo Parameters does not exist. Select Edit Echo Parameters again and check the number against your network records.The Echo packets reached the specified network but no nodes responded. This situation probably means that the router connected to the specified network doesn't support the Echo protocol, and there are no nodes on the specified network. (The router itself is a node on each of its networks, but some third-party routers might not support the AppleTalk Echo Protocol, in which case the Echo Test would not see the router as a node.)ID="FM35311"You must first edit the test parameters to select a node numberThis message indicates that you chose "Execute Echo Test" before specifying the network and node number of the device you wish to test using Echo. idxid="w6690"book="_idx" docset="nw312" tidref="i6667"Lookup Service Messages idxid="w6691"book="_idx" docset="nw312" tidref="i6667"ID="FM27996"No entities were foundThis message indicates that no AppleTalk services responded to the Lookup Service. It could mean that there are no AppleTalk services located in the zone you selected, or that services or routers, or both, are down.ID="FM38837"All responses may not be able to be displayedThe Lookup service function can display a maximum of 400 devices. This message indicates that there may be more than 400 AppleTalk devices responding to the Lookup.Action: To fix this condition, narrow the scope of the Lookup service in ATCON by specifying a certain type of service or the name of a particular server or printer.Errors When Viewing the System Log idxid="w6692"book="_idx" docset="nw312" tidref="i6654"ID="FM34694"System log file does not existID="FM10310"System log file is emptyThe system log file (SYS:SYSTEM\SYS$LOG) does not exist until a message is generated. If you clear the log file and then immediately attempt to access it in ATCON, you might see this message at the console.Action: As soon as there is a message to view in the system log, you can access it without generating this idxid="w6693"book="_idx" docset="nw312" tidref="i482"message idxid="w6694"book="_idx" docset="nw312" tidref="i3839"idxid="w6695"book="_idx" docset="nw312" tidref="i6667".LBL=""GlossaryadministratorThe person who sets up a file server, creates user login accounts and passwords, creates groups, sets security, and maintains the server. AppleTalkApple Computer's suite of protocols that enables the hardware and software on an AppleTalk network to interact and to route data.AppleTalk module(APPLETLK.NLM) The AppleTalk protocol stack and router, which is included as a NetWare Loadable Module in NetWare for Macintosh v3.x and in the NetWare AppleTalk Support Package.AppleTalk routerSee router.AFP(AppleTalk Filing Protocol) A protocol that provides communication and data transmission between file servers and clients in an AppleShare network.AFP module(AFP.NLM) A NetWare Loadable Module that processes AFP file requests from Macintosh workstations.ATPS module(ATPS.NLM) A NetWare Loadable Module that processes print requests from Macintosh and DOS workstations to an Apple printer.ATCON utilityA diagnostic tool for use at the file server. ATCON provides information about the file server's AppleTalk stack and router, and about other AppleTalk networks on the internet.CDEVA program module accessed by a clicking an icon in the Control Panel.ChooserA desk accessory that lets you choose devices, such as file servers and printers, on the AppleTalk network.Control PanelA desk accessory that lets you change the speaker volume, mouse tracking, color display, network connection software, and other features.clientA computer that has access to services on a network. The computers that provide services are called servers. A user at a client may request file access, remote login, file transfer, printing, or other available services from servers. See also server.default zoneThe first zone name in a zones list. See also zone, zones list.desk accessoryA "mini-application" available from the Apple (€) menu, regardless of which application you are using---for example, the Macintosh Calculator, Scrapbook, Key Caps, and Chooser. NetWare provides a desk accessory for users to set security, view and manage jobs in print queues, and send messages. See also NetWare desk accessory.EthernetA system of high-performance coaxial cables widely used in the communications industry. Ethernet cables can be part of an AppleTalk network. See also EtherTalk.EtherTalkAn AppleTalk network on Ethernet. An EtherTalk network can be either "nonextended" (EtherTalk 1.0) or "extended" (EtherTalk 2.0). See also Ethernet.extended networkAn AppleTalk Phase 2 network on high-speed media, such as Ethernet or Token Ring. An extended network is capable of supporting the Phase 2 addressing extensions of a network range and zones list. See also network range, zones list.file serverA combination of controller software and mass-storage devices that allows computer users to share common files and applications on a network. A file server on an AppleTalk network may be a Macintosh computer running AppleShare software or an IBM PC (or a compatible computer) running NetWare for Macintosh software.FinderThe application that maintains the Macintosh desktop and starts up other programs at the request of the user. You use the Finder to manage documents and applications, and to get information to and from disks. You see the desktop upon starting up your computer, unless you have specified a different startup application.folderA holder of documents, applications, and other folders on the desktop. Folders act as subdirectories, allowing you to organize information. A folder is the secondary organizing unit on the file server. See also volume.frameA set of information added to a packet to ensure its proper transmission across the network. A frame consists of information in a format that is dependent upon the physical medium on which the data travels.groupA named collection of one or more file server users. Groups are created for users who usually have common interests and share information.internal networkA virtual network that consists of two software nodes: the AppleTalk protocol stack and the AppleTalk router. See also network.internetAny interconnected group of networks, such as an interconnected group of AppleTalk networks. Network users in an internet can share information and network devices. See also network.LocalTalkA system of cables, cable extenders, and connector boxes that connect computers and network devices as part of the AppleTalk network system. LocalTalk kits are manufactured by Apple Computer. Generally, where this manual refers to a LocalTalk connection, you can use any system of cable and connectors that supports AppleTalk protocols at 230.4 kbits/second to interconnect Macintosh computers and other AppleTalk devices.MultiFinderA first-generation multitasking operating system for Macintosh computers that makes it possible to have several applications open at the same time, including background applications that let you perform one task while the computer performs another.NamerAn application on theLaserWriter Installation Disk or ImageWriter Installation Disk that you use to name and rename printers. NetWare Control Center(NCC) An administrative utility included with NetWare for Macintosh for managing users, groups, and security on a NetWare file server from a Macintosh client.NetWare desk accessory(NetWare DA) A Macintosh desk accessory that accesses four program modules; those four program modules enable a user at a Macintosh workstation to send a message to another user, to view or administer print jobs in a NetWare print queue, and to view or set NetWare access rights.NetWare User Authentication Method(NetWare UAM) Macintosh software that uses NetWare password encryption to encrypt users' passwords on the client before transmitting the passwords across a network to the server.networkA collection of interconnected, individually controlled computers, together with the hardware and software used to connect them. See also internal network, internet.network addressA unique number that represents a device on a network. See also network number, node number.network administrationManagement of the software and hardware that connects computers in a network. This task includes assigning addresses to devices, maintaining network data files across the network, and setting up internet routing. Network administration can also include system tasks on a file server, such as starting up and shutting down the system, adding and removing user accounts, and backing up and restoring data.network numberAn AppleTalk network number is a decimal integer between 1 and 65,279. You assign a network number to each nonextended network supporting AppleTalk. See also network range.network rangeAn AppleTalk network range is a contiguous range of decimal integers between 1 and 65,279, such as 1-10. You assign a network range to each extended network supporting AppleTalk. See also network number.nodeOn a network, a point where a device is connected; often used to refer to the device itself. Some examples of AppleTalk nodes are Macintosh computers, LaserWriter or ImageWriter printers, and NetWare file servers.node addressA number that is dynamically acquired by each node when it comes up on a network. You cannot explicitly assign an AppleTalk node address. A device's node address is combined with the network number to form its unique network address. See also node.packetA unit of information that has been formatted for transmission on a network.packet frameSee frame.passwordA unique word or set of characters a user must enter before he or she can access a volume on a file server. port(1) The logical point of contact between a LAN driver and a protocol that you bind to it. (2) Hardware that enables a component to communicate with a peripheral, such as a parallel port. (3) A unique server I/O address assigned to a LAN driver in NetWare v3.11.print queueA file containing documents awaiting printing.protocolA set of rules for transmitting data within a network or internet. A protocol specifies the format, timing, and sequence in which the network transmits data. Common protocols include AFP, ALAP, RTMP, NCP, and IPX. See also protocol stack.protocol stackA complete suite of protocols that includes all layers required to handle transmission and receipt of packets. See also protocol.routerA router connects multiple networks so that all the nodes on each network can access services and nodes on any other network. An AppleTalk router receives and forwards AppleTalk packets on the networks to which it is directly connected.startup diskA disk with all the necessary program files---such as the Finder and System files contained in the System Folder for the Macintosh---to set the computer into operation. A startup disk is sometimes called a boot disk. TokenTalkAn AppleTalk network on Token Ring. volumeA general term referring to a storage device or to part of a storage medium formatted to contain files; a source of or a destination for information. A volume can be an entire disk or only part of a disk. It is the primary organizing unit on the file server. See also folder.workstationA node through which a user can access a server or other nodes. zoneA logical grouping of devices physically located on one or more networks. Each nonextended network must have exactly one zone name assigned to it. Each extended network must have at least one zone name, and may have up to 255 zone names, assigned to it. See also default zone, zones list.zones listA list of up to 255 zone names. See also default zone, zone.