CONTENTS Title Page Copyright Page Preface 1 Overview of DECintact System Management 1.1 DECintact System Manager 1.2 DECintact Environment 1.2.1 Terminal Manager 1.2.2 Dispatcher 1.2.3 File Manager 1.2.4 Queue Manager 1.2.5 Server Manager 1.2.6 DECdtm 1.2.7 Software Event Logging 1.2.8 DECtrace 1.2.9 Applications 1.3 Responsibilities of a DECintact System Manager 1.3.1 Managing the DECintact System 1.3.2 Managing DECintact Applications 2 Managing DECintact Copies 2.1 Checking the Setup of DECdtm Services 2.2 Privileges Required to Manage the DECintact System 2.3 DECintact Copy Configurations 2.4 Creating a DECintact Copy 2.5 Setting Up DECintact VAXcluster Copies 2.5.1 Setting Up the Common Copy 2.5.2 Setting Up the Node-Specific Copies 2.5.3 Enabling VAXcluster Node Failure Rollback 2.6 Using the INTACT$COPY_CONTROL Procedure 2.6.1 Using the STARTUP Function 2.6.2 Using the SHUTDOWN Function 2.6.3 Using the LOGICAL_NAMES_ONLY Function 2.6.4 Using the CHECK_STARTUP_FILES Function 2.6.5 Modifying COPY_CONTROL Parameters 2.7 Using the DECintact Manage Utility 2.7.1 Using INTACT MANAGE STARTUP 2.7.2 Using INTACT MANAGE SHUTDOWN 2.8 Forcing a Component to Shut Down 2.9 Starting and Stopping Copies for Other Groups 2.10 Removing a DECintact Copy 3 Managing DECintact Security 3.1 Managing Terminal Security 3.1.1 Setting Device Protection 3.1.2 Attaching Terminals 3.1.3 Detaching Terminals 3.1.4 Controlling the Number of Logins 3.1.5 Preventing Access to the VMS System 3.1.6 Using LAT Terminal Servers 3.2 DECintact System Security 3.2.1 DECintact Security Database 3.2.2 DECintact Security Database Files 3.2.3 Security Profile Contents 3.3 Managing Security Profiles 3.3.1 INTACT SECURITY Command 3.3.2 Using Predefined Security Profiles 3.3.3 Enabling and Disabling Menu Functions 3.3.4 Using Geographic Entitlement 3.3.5 Using Terminal-Manager-based Security Functions 3.3.5.1 SECA - Add a Security Profile 3.3.5.2 SECD - Delete a Security Profile 3.3.5.3 SECI - View a Security Profile 3.3.5.4 SECS - Summary Profile Report 3.3.5.5 SECU - Update Security Profile 3.3.5.6 AUTH - Authorization Function 3.3.5.7 PSWD - Password Change Function 3.4 INTACT$PSWDVAL - Password Validation Utility 3.4.1 Writing a Password Validation Routine 3.4.2 Sample INTACT$$PSWDVAL Routine 3.4.3 Linking INTACT$PSWDVAL 3.4.4 Debugging INTACT$$PSWDVAL 4 Managing DECintact Queues 4.1 Queue System Database 4.2 Overview of Queue Management 4.3 Managing Queues 4.3.1 Creating a Queue 4.3.2 Starting a Queue 4.3.3 Stopping a Queue 4.3.4 Modifying a Queue 4.3.5 Deleting a Queue 4.3.6 Flushing a Queue 4.3.7 Redirecting a Queue 4.3.8 Changing Queues from Disk-Based to Memory-Based 4.4 Managing Queue Sets 4.4.1 Defining a Queue Set 4.4.2 Redefining a Queue Set 4.4.3 Undefining a Queue Set 4.5 Setting Up Remote Queues 4.5.1 Remote Queue Item Transmission 4.5.1.1 Sending Remote Queue Items 4.5.1.2 Receiving Remote Queue Items 4.5.2 Creating a Remote Queue 4.6 Performing Syncpoints 4.7 Monitoring Queues 4.7.1 Showing Queue Statistics 4.7.2 Showing Full Queue Information 4.7.3 Showing Queue System Statistics 5 Managing Server Pools 5.1 Overview of Server Pools 5.1.1 Controlling Server Pools 5.1.2 Server Manager Functions 5.1.3 Server Manager Control Files 5.1.4 Server Manager Logging 5.1.5 Server Pool Definition Utility 5.1.6 Configuring the PDU Database on VAXcluster Systems 5.2 Setting Up the Server Manager Service 5.2.1 Defining the Server Pool Database 5.2.2 Configuring the MSS Global Section 5.3 Maintaining Server Pools 5.3.1 Starting the Server Manager Service 5.3.2 Stopping the Server Manager Service 5.3.3 Viewing the Server Pool Database 5.3.4 Modifying Server Pool Characteristics 5.3.5 Starting a Defined Server Pool 5.3.6 Stopping an Active Server Pool 5.3.7 Undefining a Server Pool 5.4 Tuning Server Pools 6 Managing Application Data Files 6.1 Physical File Table 6.2 Defining Application Files 6.3 Rebuilding the File Manager Database 6.4 Managing Hash Files 6.4.1 Creating Hash Files 6.4.2 Converting Hash Files 6.4.3 Enabling Hash File Caching 6.4.4 Enabling Hash Files in a DECintact VAXcluster System 6.4.5 Listing Hash File Attributes 6.4.6 Sizing Hash Files 7 Managing Data Recovery 7.1 Managing the Transaction Rollback Recovery-Unit Journal 7.1.1 Creating and Initializing the Recovery-Unit Journal 7.1.2 Creating the RUJ in a VAXcluster System 7.1.3 Sizing the RUJ 7.2 Managing the Transaction Rollforward After-Image Journal 7.2.1 Sharing Databases and the After-Image Journal 7.2.2 Creating and Initializing the After-Image Journal 7.2.3 Performing a Syncpoint 7.2.4 Starting a Syncpoint 7.2.5 Writing a Syncpoint Backup Procedure 7.2.6 Writing an After-Image Restore Procedure 7.2.7 Performing a Rollforward Recovery 7.2.8 Performing Syncpoints on a VAXcluster System 7.3 Managing Data Recovery for Alternate Resource Managers 8 Managing Application Menu Functions 8.1 DECintact System Menu Structure 8.2 Managing Menu Functions 8.2.1 FNCGEN Statement 8.2.2 NODBLK Statement 8.2.3 TSKBLK Statement 8.2.4 FNB Statement 8.2.4.1 Using the AUTH Function 8.2.5 RESBIT Statement 8.2.6 FNCEND Statement 8.3 Adding AVERTZ Application Functions-an Example 8.4 Rebuilding the Menu 9 Managing Forms 9.1 DECforms Run-Time Processing 9.2 Managing DECforms Servers 9.2.1 Modifying DSPLCL for DECforms Server Control 9.2.1.1 Specifying Maximum Servers 9.2.1.2 Specifying Minimum Servers 9.2.1.3 Specifying Users Per Server 9.2.1.4 Specifying Server Initialization Time 9.2.2 Sizing the Global Section 9.2.3 Starting and Stopping DECforms Servers 9.3 Using DECforms Escape Routines 9.4 Using DECforms Session Caching 9.5 Modifying DECforms Key Bindings and the Blank Form 9.5.1 Modifying Key Bindings 9.5.2 Modifying the Blank Form 9.6 Distributing DECforms Files 9.6.1 DECforms File Directories 9.6.2 Copying DECforms Files Manually 9.6.3 Enabling and Disabling DECforms Form Distribution 9.7 Managing TFE Forms 9.7.1 Distributing TFE Forms 9.7.2 Incorporating User Edit Routines into TFE Forms 10 Distributing Terminal-Manager-Based Applications 10.1 Implicit and Explicit Remote Access 10.2 Enabling Communications Between DECintact Systems 10.2.1 Setting Up Network Links 10.2.2 Authorizing Application Users 10.2.3 Enabling Automatic Host Rollover 10.3 Defining the Application Menu Functions 10.4 Distributing Application Forms 10.5 Setting Up a Sample Distributed DECintact System 10.5.1 Setting Up the Application Node 10.5.2 Setting Up the Submitter Node 11 Managing the Calendar Management Utility 11.1 DECintact Calendars 11.2 Using Calendar Management Utility Commands 11.2.1 DELETE Command 11.2.2 INITIALIZE Command 11.2.3 LOAD Command 11.2.4 ROLL Command 11.2.5 SET Command 11.2.6 SHOW Command 11.3 CALSET Function 12 Using DECtrace with DECintact Applications 12.1 Purpose of Using DECtrace 12.2 Overview of Concepts, Using Commands, and System Management 12.2.1 DECtrace Concepts 12.2.2 Using DECtrace Commands 12.2.3 DECtrace System Management 12.2.3.1 Registrar Process 12.2.3.2 Administration Database 12.3 Collecting Event Data for the DECintact System 12.3.1 Creating a Facility Selection 12.3.2 Scheduling Data Collection 12.3.2.1 Specifying Scheduling Information 12.3.2.2 Specifying Registration Identifiers 12.3.3 DECintact Events 12.3.3.1 Details about DECforms Events 12.3.3.2 Details About Queue Events 12.3.4 DECintact Items 12.3.5 DECintact Collection Classes 12.3.5.1 ALL Collection Class 12.3.5.2 PERFORMANCE Collection Class 12.3.5.3 FORMS Collection Class 12.3.5.4 QUEUE Collection Class 12.3.5.5 WORKLOAD Collection Class 12.4 Creating a Report Based on Collected Data 12.4.1 Formatting and Merging Data Files 12.4.2 Generating a Report 12.4.3 Creating a Customized Report 13 INTACT$SWLUP Event Logging 13.1 INTACT$SWL Software Event Logging 13.2 Invoking INTACT$SWLUP 13.3 SWLUP Commands 13.3.1 Indirect ( @ ) Command 13.3.2 EDIT 13.3.3 EXIT 13.3.4 HELP 13.3.5 LIST 13.3.6 RENEW 13.3.7 SAVE 13.3.8 SET LOG 13.3.9 SET VERIFY 13.3.10 SHOW CURRENT 13.3.11 SHOW LOG 13.3.12 SHOW VERSION 13.3.13 STOP 14 Monitoring the System 14.1 INTACT MANAGE SHOW Commands 14.2 INTACT MONITOR Panels 14.2.1 ALL Command 14.2.2 NETWORK Panel 14.2.3 POOLS Panel 14.2.4 QUEUES Panel 14.2.5 STREAMS Panel 14.2.6 SYSTEM Panel 14.2.7 USERS Panel 14.3 Modifying INTACT MONITOR Panel Display 14.3.1 ADD Command 14.3.2 ADVANCE Command 14.3.3 BACKUP Command 14.3.4 MOVE Command 14.3.5 PASTE Command 14.3.6 REMOVE Command 14.3.7 SET INTERVAL Command 14.3.8 TOP Command 14.3.9 UNPASTE Command 14.4 Response-Time Logging Commands 15 Tuning the DECintact System 15.1 Optimizing File Distribution 15.2 Configuring the Global Sections 15.2.1 Queue Section 15.2.2 Transaction Section 15.2.3 MSS Section 15.2.4 Using the INTACT$INIGSD Program 15.2.4.1 Deleting the Global Sections 15.2.4.2 Configuring the Queue Global Section 15.2.4.3 Configuring the Transaction Global Section 15.2.4.4 Creating the Global Sections 15.2.4.5 Using the SHOW_GLOBAL_SECTION Option 15.2.4.6 Configuring the MSS Global Section 15.2.4.7 Using the EXIT Option 15.3 Using After-Image Journal Group Commit 15.3.1 Enabling and Disabling Group Commit 15.3.2 Global Section and Page Requirements of Group Commit 15.3.3 Tuning Group Commit Performance 15.3.4 Group Commit Error Messages 15.4 Using Physical Memory 15.5 Additional Performance Considerations A DECintact Parameter Files A.1 BAKINI.PRM A.2 CPYTSK.PRM A.3 DSPLCL.PRM A.4 LCKINT.PRM Parameters A.5 QUESRV.PRM Parameters A.6 QUESRVXMT.PRM Parameters A.7 SRVMGR.PRM Parameters B Creating Transaction Logs for DECdtm Services B.1 Prerequisites B.2 Planning B.2.1 Log Location B.2.2 Sizing Logs B.3 Creating and Setting Up the Logs B.3.1 Identifying Where the Logs are Placed B.3.2 Creating the Logs B.4 Example of Setting Up Transaction Logs EXAMPLES 3-1 INTACT MANAGE ATTACH 3-2 INTACT MANAGE DETACH 3-3 INTACT MANAGE LOGINS 3-4 User-Written Password Validation Routine 5-1 Defining a Server Pool 5-2 Brief Server Pool Information 5-3 Full Server Pool Information 5-4 Modifying a Server Pool 5-5 Starting a Server Pool 5-6 Shutting Down a Server Pool 5-7 Undefining a Server Pool 7-1 Sample INTACT$SYNC_POINT_BACKUP.COM 7-2 Sample of INTACT$RESTORE.COM 8-1 AUTH Function Added to the SAMPLE Menu 8-2 AVERTZ_INTACT$MENU_USR.MAR 12-1 Summary Report for DECintact Queuing Events 12-2 Summary Report for DECintact TRANSACTION Event 12-3 Summary Report for DECintact HASH and THREAD_WAIT Events 14-1 INTACT MANAGE REPORT Functions 15-1 Sample INTACT$INIGSD Command File 15-2 DELETE_GLOBAL_SECTION 15-3 SET_QUEUE_SECTION 15-4 SET_TRANSACTION_SECTION 15-5 CREATE_GLOBAL_SECTION 15-6 SHOW_GLOBAL_SECTION FIGURES 3-1 DECintact System Menu Screen 3-2 Revalidation Screen 3-3 SECA Form One 3-4 SECA Form Two 3-5 SECA Form Three 3-6 SECD Example Screen 3-7 SECS Summary Report Form 3-8 AUTH Function Placement 3-9 First AUTH Form 3-10 Second AUTH Form 3-11 PASSWORD Example Screen 5-1 Server Pool Run-Time Control 8-1 Menu Hierarchy 8-2 Menu Structure with AUTH 9-1 DECforms Server Control 9-2 Distributed DECforms Run-Time Processing 11-1 Calendar Screen 14-1 Monitor Screen with All Panels 14-2 NETWORK Panel 14-3 POOLS Panel Using the FULL Qualifier 14-4 QUEUES Panel 14-5 STREAMS Panel 14-6 SYSTEM Panel 14-7 USERS Panel 14-8 Adding the Queue Panel 14-9 Moving Panels 14-10 Pasting a Panel TABLES 2-1 Privileges Needed to Manage DECintact 2-2 INTACT MANAGE Commands 3-1 DSPLCL Security Parameters 3-2 Qualifiers to INTACT SECURITY Functions 3-3 SECA Form One Field Description 3-4 SECA Second Form Fields 3-5 SECS Summary Information 5-1 INTACT POOL Commands 8-1 Bit Associations in INTACT$MENU_USR.MAR 8-2 New Bit Associations in INTACT$MENU_USR.MAR 9-1 DSPLCL Parameters for DECforms Servers 10-1 Implicit and Explicit Remote Access Requirements 10-2 Setting Up a Distributed DECintact System 12-1 Summary of DECtrace Commands 12-2 Predefined DECintact Events 12-3 Predefined DECtrace and DECintact Data Items 12-4 Item Groups Defined for the DECintact System 12-5 ALL Class - DECintact Events and Items 12-6 PERFORMANCE Class - DECintact Events and Items 12-7 FORMS Class - DECintact Events and Items 12-8 QUEUE Class - DECintact Events and Items 12-9 WORKLOAD Class - DECintact Events and Items 12-10 DECtrace Reports 12-11 DECtrace REPORT Command Qualifiers 13-1 Summary of SWLUP Commands 14-1 System Panel Statistics 15-1 Group Commit Parameters A-1 DECintact Parameter Files A-2 BAKINI.PRM Parameters A-3 CPYTSK.PRM Parameters A-4 DSPLCL.PRM Parameters A-5 LKCINT.PRM Parameters A-6 QUESRV.PRM Parameters A-7 QUESRVXMT.PRM Parameters A-8 SRVMGR.PRM Parameters B-1 Sample Transaction Logs