CONTENTS Title Page Copyright Page Preface 1 Introduction to Gateway Management for ACMS 1.1 Overview 1.2 System Management with ACMS Desktop Software 1.3 Network Software 2 Managing an ACMS Desktop System 2.1 Downloading Application Information 2.1.1 Software Version Synchronization 2.1.2 File Server Access for Applications 2.2 Authorizing Users 2.2.1 Providing OpenVMS Authorization on the Submitter Node 2.2.2 Authorizing ACMS Users 2.2.3 Authorizing Desktop Systems Terminals 2.2.4 Authorizing Task Access on the Application Node 2.2.4.1 Task Authorization on Submitter Nodes 2.2.4.2 Task Authorization on Distributed Applications 2.3 Controlling the ACMS Desktop System 2.3.1 Starting the System and Applications 2.3.2 Displaying System Information 2.3.3 Canceling Desktop Users and Tasks 2.4 Controlling the ACMS Desktop Gateway 2.4.1 Starting the ACMS Desktop Gateway 2.4.2 ACMS Desktop Gateway Startup Parameter File 2.4.3 Specifying Network Transports 2.4.4 Specifying the TCP/IP Port Number on the Gateway 2.4.5 Specifying the TCP/IP Port Number on the Client 2.4.6 Enabling Password Expiration 2.4.7 Cyclic Redundancy Checking 2.4.8 Stopping the ACMS Desktop Gateway Process 2.5 Tuning the ACMS Desktop System 2.5.1 Setting ACMS System Parameters 2.5.2 Tuning the ACMS Desktop Gateway 2.5.3 Overriding Default Process Quotas 2.5.3.1 General Tuning Guidelines 2.5.3.2 AST Limit 2.5.3.3 Buffered I/O Limit 2.5.3.4 Open File Limit 2.5.3.5 Buffered I/O Operations Limit 2.5.3.6 Page File 2.5.3.7 Working Set and Maximum Working Set 2.5.4 Tuning the Desktop Client Program Buffer Size 2.5.4.1 Setting ACMSDI_MAXBUF on DOS 2.5.4.2 Setting ACMSDI_MAXBUF for OpenVMS Desktop Client Programs 2.5.4.3 Setting ACMSDI_MAXBUF for SCO UNIX 2.5.4.4 Setting the Buffer Size on Macintosh Systems 2.5.5 Running Applications Simultaneously 2.6 Configuring for the Direct Client 2.6.1 Known Problems and Restrictions 2.6.2 A Note on Performance 2.7 Troubleshooting 3 Using Transports 3.1 ACMS Desktop Transport Methodology 3.1.1 Using Static-Link Libraries 3.1.2 Default Network Transports for Client API Libraries 3.1.3 Using Microsoft Windows Dynamic-Link Libraries 3.2 Macintosh Communications Toolbox 3.2.1 AppleTalk-DECnet Tool 3.2.2 DECnet Tool 3.2.3 MacTCP Tool 3.2.4 AppleTalk ADSP Tool 3.2.5 XPC Tool 3.3 Using the DECnet Transport 3.3.1 Preparing the Gateway for DECnet 3.3.1.1 Activating the Gateway for DECnet 3.3.2 Preparing the Client for DECnet 3.3.2.1 Configuring Libraries for DECnet 3.3.2.2 Using Network DLLs for Windows Applications 3.3.2.3 Building the Client for DECnet Using Static-link Libraries 3.3.2.4 Controlling the Number of Concurrent Users 3.3.3 Troubleshooting the DECnet Transport 3.4 Using the Novell NetWare Transport 3.4.1 Preparing the Gateway for the NetWare Transport 3.4.1.1 Activating the Gateway for the NetWare Transport 3.4.1.2 ACMS Desktop Service Advertising Protocol (SAP) Services 3.4.1.3 IPX/SPX Stack from InterConnections 3.4.2 Preparing the Client for the NetWare Transport 3.4.2.1 Installation Requirements for Novell NetWare Transport 3.4.2.2 Configuring DOS Desktop Systems for NetWare 3.4.2.3 Additional Novell SDK files required for NetWare clients 3.4.2.4 Configuring Libraries for NetWare - DOS Implementation 3.4.2.5 Configuring Libraries for NetWare - Microsoft Windows Implementation 3.4.2.6 Comparing NetWare to DECnet 3.4.2.7 Configuring DOS and Windows Systems for NetWare 3.4.3 Building Client Applications for NetWare 3.4.3.1 Building DOS Client Applications for NetWare 3.4.3.2 Building Windows Client Applications for NetWare 3.4.4 Troubleshooting for the NetWare Transport 3.4.4.1 Troubleshooting IPX/SPX Stack from InterConnections 3.4.4.2 Troubleshooting the ACMS Desktop Gateway 3.4.4.3 Quotas 3.4.5 NetWare Transport Installation Checklist 3.5 Using the TCP/IP Transport 3.5.1 Preparing the Gateway for the TCP/IP Transport 3.5.1.1 Installation Requirements for the Gateway Using TCP/IP 3.5.1.2 Activating the ACMS Desktop Gateway on TCP/IP 3.5.1.3 Setting an Alternate ACMS Desktop Gateway TCP/IP Port Number 3.5.2 Preparing the Client for the TCP/IP Transport 3.5.2.1 Configuring the Libraries for TCP/IP 3.5.2.2 Using the TCP/IP Transport on DOS and Static-Link Libraries 3.5.2.3 Using the TCP/IP Transport on Microsoft Windows 3.5.2.4 Building a UNIX ACMS Desktop Client that Uses TCP/IP 3.5.2.5 Setting Up the Environment for TCP/IP 3.5.2.5.1 Specifying the Gateway TCP/IP Port Number on the Client 3.5.2.5.2 Setting an Alternate TCP/IP Port Number on DOS 3.5.2.5.3 Setting an Alternate TCP/IP Port on UNIX 3.5.2.5.4 Setting the TCP/IP Transport on Macintosh 3.5.2.5.5 Setting an Alternate TCP/IP Port Number on Macintosh 3.5.3 Troubleshooting the TCP/IP Transport 3.6 Using Serial Communications as a Transport 3.6.1 Preparing the Gateway for Serial Communications 3.6.1.1 Installation Requirements for Serial Communications 3.6.1.2 Activating the Gateway for Serial Communications 3.6.1.3 Attaching Devices to the Serial-DECnet Gateway 3.6.1.4 Maintaining Permanent Connections 3.6.1.5 Switching the Current Device to ACMS Desktop Serial Mode 3.6.2 Preparing the Client for Serial Communications 3.6.2.1 Installation Requirements for Serial Communications 3.6.2.2 Using the Serial Communications Scripting Language 3.6.3 DOS and Microsoft Windows Applications 3.6.3.1 Configuring Libraries for Serial Communications 3.6.3.2 Setting Up the Environment for Serial Communications 3.6.3.3 Script Commands for DOS and Windows Serial Communications 3.6.3.4 Setting Up the Environment Using the Serial Transport for DOS 3.6.3.5 Setting Up the Environment Using the Serial Transport for Windows 3.6.4 Macintosh Client Applications 3.6.4.1 CCL Scripts 3.6.4.2 CCL Scripting Language 3.6.5 Troubleshooting DOS and Windows Serial Communications Scripts 3.6.6 Error Recovery Using Serial Communications Script Files 3.6.6.1 Recovering from Failure to Connect 3.6.6.2 Recovering from Failure During Transmission 3.6.6.3 Sample Serial Communications Script File 3.6.7 Serial Transport Installation Checklist