CONTENTS Title Page Copyright Page Preface Part I Designing and Implementing a VTX Service 1 Introduction 1.1 VTX Concepts 1.1.1 Who Are the Participants? 1.1.2 Pages 1.1.2.1 Menu Pages 1.1.2.2 Display Pages 1.1.2.3 Template Pages 1.1.2.4 Form Pages 1.1.2.5 Remote Pages 1.1.2.6 Help Pages 1.1.2.7 CBR Query Pages 1.1.3 Keywords 1.1.4 Navigation 1.1.5 Personal Magazines 1.1.6 Closed User Groups 1.1.7 Content-Based Retrieval 1.2 VTX Components 1.2.1 Infobase 1.2.2 Server 1.2.2.1 Local and Remote Servers 1.2.3 Update Server 1.2.4 Workbench Server 1.2.5 Subscriber Client 1.2.6 Concentrator 1.2.7 VTX Utilities 1.2.8 Print Queue Services 1.3 VTX Platforms 1.4 Licensing 1.4.1 Server Activity Licensing 1.4.1.1 Grace Activity Unit 1.4.1.2 Activity Licensing in a Distributed Environment 1.4.2 Server Availability Licenses 1.4.3 Licensing of Non-Server Components 1.4.3.1 Licensing of ELK Applications 2 Setting up a VTX System 2.1 Designing an Infobase 2.2 Deciding on a Strategy 2.3 Establishing a Page Hierarchy 2.4 Establishing a Page Numbering Scheme 2.4.1 Relationship Between Page Ranges, Prefixes, and the Structure of the Information 2.5 Establishing a Keyword Strategy 2.6 Designing Menu and Display Pages 2.6.1 Sketching the Main Menu Page 2.7 Implementing a VTX Infobase 2.7.1 Creating the VTU Files 2.7.2 Constructing the Infobase 2.7.3 Creating a Guest Account 2.7.4 Establishing a Base Page 2.7.5 Making the New Pages Operational 2.7.6 Testing the Infobase 2.8 Planning and Assigning Tools 2.8.1 The Workbench 2.8.1.1 Workbench Components 2.8.1.2 Workbench Concepts 2.8.1.3 Workbench Design Guidelines 2.8.1.3.1 Workbench Prefixes and Page Numbering 2.8.1.3.2 How the Workbench Assigns Prefixes 2.8.1.3.3 Prefix Suggestions 2.8.1.3.4 Prefixes and Page Access 2.8.1.4 Infobase Design Walkthrough 2.8.1.4.1 Organize by Common Theme 2.8.1.4.2 Create Infobase Section Files 2.8.1.4.3 Assign Prefixes to Structure 2.8.1.4.4 Match Workbench IPs with Subjects and Prefixes 2.8.1.4.5 Determine a Group Code Strategy 2.8.2 Coexistence of Infobase Pages 2.8.3 The Update Server 2.8.3.1 Update Server Methods for Updating Infobase Files 2.8.3.2 Update Server Modes of Operation 2.8.4 The VTX Automatic Page Management System (VTXAPMS) Utility 3 Enhancing the Infobase 3.1 Creating a Corporate DEC VTX Service 3.1.1 Infobase Standards 3.2 Exchanging Data 3.2.1 Identifying the Servers for DECnet 3.2.2 Deciding on an Infobase Keyword Strategy 3.2.3 Adding the Remote Page 3.2.4 Adding Other Terminal Types 3.2.5 Designing the Menu and Page Hierarchy 3.2.6 Designing the NAPLPS Pages 3.2.7 Creating a VTU File 3.2.8 Creating a VTD File 3.2.9 Pointing to the First Page 3.2.10 Testing the Pages 3.2.11 Summary of Adding Other Terminal Types or Desktops 3.3 Providing VTX System Security 3.3.1 Choosing a Numbering Strategy 3.3.2 Modifying the Main Menu Page 3.3.3 Returning the Page to the Infobase 3.3.4 Adding the Group Number 3.3.5 Adding Accounts to the Account File Part II Operating a VTX Service 4 Introduction to Operating a VTX Service 4.1 Overview of VTX 4.2 VTX Operator Utilities 4.2.1 VTX Control Utility (VTXCTL) 4.2.2 VTX Account Control Utility (VTXACU) 4.2.3 VTX Infobase Verification Utility (VTXIVU) 4.2.4 Getting Help 4.3 VTX Information Provider Tools 4.4 System Planning 4.5 Selecting DECnet Object Numbers 4.6 VTX Logicals 4.6.1 Server Logicals 4.7 Server Account Determination 4.7.1 Receiving a Connect Request 4.7.2 Responding to the Request 4.7.3 Determining the Account 4.7.4 Account Determination Algorithm 4.8 Sample VTX System Configurations 4.9 Local and Routed Sessions 4.10 Commands for Starting VTX 4.10.1 Starting VTX on VMS clients 4.10.1.1 Format 4.10.1.2 Parameter 4.10.1.3 Qualifiers 4.10.2 Starting VTX on ULTRIX clients 4.10.2.1 Format 4.10.3 Starting VTX on DOS clients 4.10.3.1 Format 4.11 Using DECtalk 5 VTX Control Utility 5.1 Managing VTX Communications 5.2 Preliminary Tasks 5.2.1 Preliminary Server Tasks 5.2.1.1 Privileges and Quotas 5.2.1.2 Considerations for CHANNELCNT 5.2.1.3 Required Files 5.2.1.4 Failover Local Servers 5.2.2 Preliminary Concentrator Tasks 5.2.2.1 Protection for Terminal Ports 5.2.2.2 LAT Support Tasks 5.2.2.3 Timeout 5.2.3 Preliminary Update Server Tasks 5.2.4 Preliminary Workbench Server Tasks 5.2.5 Defining Logical File Names 5.2.5.1 Defining a Logical Name for the Account File 5.2.5.2 Defining a Logical Name for the Base Page Determination File 5.3 Workbench Server Considerations 5.4 DECnet Node Numbers in SHOW SESSION Commands 5.5 VTXCTL Utility Flow 5.6 Starting the VTXCTL Utility 5.7 Control Mode CONNECT CONCENTRATOR CONNECT SERVER CONNECT UPDATE_SERVER CONNECT WORKBENCH_SERVER EXIT HELP SHOW CONCENTRATOR SHOW SERVER SHOW UPDATE_SERVER SHOW WORKBENCH_SERVER START CONCENTRATOR START SERVER START UPDATE_SERVER START WORKBENCH_SERVER STOP CONCENTRATOR STOP SERVER STOP UPDATE_SERVER STOP WORKBENCH_SERVER 5.8 Server Mode CLOSE/ALL CLOSE/INDEX CLOSE/KEYWORD CLOSE/PAGE EXIT HELP LOAD BASE MODIFY CBR MODIFY/INDEX OPEN/INDEX OPEN/KEYWORD OPEN/PAGE REMOTE SHOW CBR SHOW COMMUNICATION SHOW FILE SHOW REMOTE SHOW SESSION START CBR START COMMUNICATION START LOG STOP CBR STOP COMMUNICATION STOP LOG STOP SESSION 5.9 Concentrator Mode ASSIGN ASSIGN/X29 ASSIGN/SNA3270DS DEASSIGN EXIT HELP SHOW COMMUNICATION SHOW SESSION START COMMUNICATION START COMMUNICATION/X29 STOP COMMUNICATION STOP SESSION 5.10 Update Server Mode CLOSE/ALL CLOSE/KEYWORD CLOSE/PAGE EXIT HELP OPEN/KEYWORD OPEN/PAGE SHOW COMMUNICATION SHOW FILE SHOW SESSION START COMMUNICATION STOP COMMUNICATION STOP SESSION 5.11 Workbench Server Mode CLOSE/ALL CLOSE/KEYWORD CLOSE/LIBRARY CLOSE/PAGE EXIT HELP OPEN/KEYWORD OPEN/LIBRARY OPEN/PAGE SHOW COMMUNICATION SHOW FILE SHOW LIBRARY SHOW SESSION START COMMUNICATION STOP COMMUNICATION STOP SESSION 6 VTX Account Control Utility 6.1 Managing VTX Accounts 6.2 Preliminary Subscriber Account Tasks 6.3 Preliminary IP Account Tasks 6.4 Preliminary Workbench IP Account Tasks 6.5 Starting the VTX Account Control Utility EXIT HELP 6.6 Subscriber Account Commands ADD DELETE MODIFY RESET SHOW 6.7 VTXUPD IP Account Commands ADD/IP DELETE/IP MODIFY/IP RESET/IP SHOW/IP 6.8 Workbench IP Account Commands ADD/IP=WORKBENCH DELETE/IP=WORKBENCH MODIFY/IP=WORKBENCH RESET/IP=WORKBENCH SHOW/IP=WORKBENCH 6.9 VTXACU Workbench Prefix File Commands ADD/PREFIX CLOSE/PREFIX DELETE/PREFIX MODIFY/PREFIX OPEN/PREFIX SHOW/PREFIX 6.10 Maintaining a Base Page Determination File 6.10.1 Creating the Source File 6.10.2 Base Page Determination Algorithm 6.11 Account Usage Record Format 7 Infobase Verification Utility 7.1 Verifying the Integrity of an Infobase 7.2 Starting the VTXIVU Utility EXIT HELP VERIFY 7.3 Infobase Verification Report A Generic Industries' VTU Files B Server Log Record Format B.1 Format of the Page Number Field C VAX VTX Workbench Library Files D File Conversion D.1 Page File Conversion D.2 Workbench Library File Conversion D.3 APMS Index Assignment File Conversion E Problem Solving E.1 DEC VTX Subscriber Problems E.1.1 Subscriber Cannot Access a Specified Page E.1.2 Subscriber Cannot Connect to Remote Server or Application E.1.3 Subscriber Cannot Connect to VTX-No Base Page E.1.4 Subscriber Cannot Connect to VTX-Object Does Not Exist E.2 DEC VTX Operator Problems E.2.1 Operator Cannot Access the VTXCTL Utility-Insufficient Privileges E.2.2 Operator Cannot Specify a Workbench Page in the BPDF E.2.3 Operator Cannot Start VTX Server-Unable to Access Startup Command Procedure E.2.4 Operator Cannot Start VTX Server-VTX Times Out, but Creates the Error Log File E.2.5 Operator Cannot Start VTX Server-VTX Times Out, but Does Not Create Error Log File E.3 DEC VTX Information Provider (IP) Problems E.3.1 All Keywords Are Not Deleted When a Page Is Deleted with VTXUPD E.3.2 All Keywords Are Not Extracted When a Page Is Extracted with VTXUPD E.3.3 IP Added Page Help on a Form Page, but Subscriber Cannot Access It E.3.4 IP Added Pages with VTXUPD, but Subscriber Cannot Access Them E.3.5 IP Cannot Connect to the Update Server-Object Does Not Exist E.3.6 IP Cannot Connect to the Workbench Server-Object Does Not Exist E.3.7 IP Cannot Remove a Page Using the APMS REMOVE Command E.3.8 Workbench IP Added Pages, but Subscriber Cannot Access Them E.3.9 Workbench IP Deleted Pages, but Subscriber Can Still Access Them E.3.10 Page Control Information on Menu, Form, or Display Pages Is Displayed to Subscriber E.4 DEC VTX TCP Command Procedure Problems E.4.1 Message "Undefined Symbol" Is Displayed After LINKPAD.COM and LINKCON.COM Are Run E.4.2 Object Files Not Found by LINKPAD.COM and LINKCON.COM E.5 Enhancing Infobase Performance F VTXCTL Error Messages G VTXACU Error Messages H VTXIVU Error Messages Glossary EXAMPLES 2-1 Sample VTU File-Main Menu Page 2-2 Sample VTU File-Company News Section 2-3 Sample Startup Command File 2-4 Creating Infobase Files 2-5 Sample Commands for Establishing Prefix Strategy 3-1 Sample VTU File-Adding NAPLPS Pages 5-1 Sample VTXCTL Workbench Server Mode Command Sequence 6-1 Sample Base Page Determination File 1 6-2 Sample Base Page Determination File 2 7-1 Infobase Verification Report FIGURES 2-1 A Menu Page Points to Other Pages 2-2 Menus Can Point to the Same Page 2-3 Page Hierarchy Sketch 2-4 Assigning Page Numbers to the Hierarchy 2-5 Main Menu Sketch 2-6 Company News Menu Sketch 2-7 Text of First News Story 2-8 Sample Base Page Determination File 2-9 General Infobase Organization 2-10 High-Level Prefix Scheme 2-11 Detailed Prefix Scheme 2-12 Workbench IPs Matched with Infobase Sections 2-13 Workbench Group Codes Assigned 3-1 Distributing Keywords 3-2 LONDON Main Menu Sketch 3-3 Sample Hierarchy for NAPLPS Pages 3-4 Base Page Determination File 4-1 Basic VTX System Configuration 4-2 Distributed VTX System Configuration 4-3 Concentrator Linked to Remote Server 4-4 Local Session for Terminal TTA2: 4-5 Routed Session for Terminal TTA2: TABLES 1-1 Database Versus Infobase 2-1 Relationship Between Page Ranges, Prefixes, and Information 4-1 VTXCTL Utility Mode Prompts 4-2 DEC VTX DECnet Objects 4-3 VTX Logical Name Reference 5-1 Formulas to Determine Required Quotas 5-2 VTXCTL Utility-Control Mode Commands 5-3 VTXCTL Utility-Server Mode Commands 5-4 VTXCTL Utility-Concentrator Mode Commands 5-5 Supported Device Types and Protocols 5-6 VTXCTL Utility-Update Server Mode Commands 5-7 VTXCTL Utility-Workbench Server Mode Commands 6-1 VTXACU Utility-General Commands 6-2 VTXACU Utility-Subscriber Account Commands 6-3 VTXACU Utility-VTXUPD IP Account Commands 6-4 VTXACU Utility-Workbench IP Account Commands 6-5 VTXACU Utility-Workbench Prefix File Commands 6-6 Fields in the Account Usage Record B-1 Server Log Record Format for NEWSESS, CONNIN, CONNOUT, DISCON, and PAGE B-2 Server Log Record Format for DELSESS B-3 Server Log Record Format for DBSECT B-4 Server Log Record Format for LOG