CONTENTS Title Page Copyright Page Preface 1 Introduction The DECmcc Toolkit The Sample Access Module 2 MSL Translator The MSL Translator Produces the DAP Input File Running the MSL Translator On VMS Running the MSL Translator On ULTRIX MSL Error Messages 3 Dictionary Administrator Program DAP Populates the Dictionary and Builds the Parse Table How DAP Knows Which Dictionary Files to Use DAP Can Prevent Other Users from Running DECmcc Entering DAP Commands on VMS Entering DAP Commands on ULTRIX Using DAP's Online Help Entering Dictionary Information Deleting Dictionary Information Rebuilding the Parse Table Setting and Showing the Command Context Showing Hierarchy Data Showing Definition Data Saving Dictionary Information In a Text File Displaying Dictionary Information with the Dictionary Browser DAP Error Messages 4 Test Bed Driver Testing a Management Module Entering TBD Commands Using the Test Bed Driver's Auxiliary Functions Using a TBD Command File Enrolling A Management Module Depositing Verb and Attribute Partition Values Depositing Entity Values Depositing Values to Schedule Execution Depositing Parameter and Qualifier Values Using ILV Encodings ILV Encoding an Entity Specification Depositing Handle and Time Stamp Values Examining mcc_call Arguments and Making the Call Displaying Dispatch Table Information Displaying Thread Information on VMS Modifying the Input Entity and Output Entity Arguments TBD Error Messages 5 Help File Builder Using the Help File Builder on VMS Command Syntax for the Help File Builder on VMS Using the Help File Builder on ULTRIX Command Syntax for the Help File Builder on ULTRIX HFB Error Messages A Using VAXLSE with the MSL Template The VAX Language-Sensitive Editor Invoking VAXLSE Writing a Management Specification using Tokens and Placeholders Context-Sensitive Help Examples Datatype Definition Global Entity Definition Defining an Attribute Defining a Directive Defining a Directive Request Response Definition Defining a Directive Exception Listing MSL Tokens and Placeholders B Combining the Tools in a Command Procedure or Shell Script Tools Command Procedure on VMS Tools Shell Script on ULTRIX C Special ULTRIX Utilities Maintaining Dispatch Table Compatibility Between VMS and ULTRIX: mcc_dispcomp Shutting Down DECmcc Processes: mcc_kill Copying Dictionary Files: mcc_ndbm D Condition Values Returned (CVRs) FIGURES 1-1 DECmcc Management Module Development Environment 1-2 The Sample Access Module Entity Hierarchy 1-3 Attributes and Directives Supported by the Sample Access Module 2-1 MSL Translator Data Flow 2-2 MSL Reserved Keywords 2-3 Sample Successful Run of the MSL Translator 2-4 Filetypes for MSL Translator 2-5 Sample MSL Constants File for C Language 2-6 Sample Successful Run of the MSL Translator 2-7 Sample MSL Constants File 3-1 Data Flow for the Dictionary Administrator Program 3-2 Dictionary Hierarchy Model 3-3 How DAP Finds Your Dictionary Files 3-4 Running DAP with Read-only Access to the Dictionary 3-5 Running DAP with Read-Write Access to the Dictionary 3-6 Dictionary Read-Locked Message 3-7 Sample Command from the DAP Prompt 3-8 Sample DAP Command from the DCL Prompt 3-9 Executing a Command File of DAP Commands 3-10 Contents of Sample DCL Command Procedure 3-11 Sample DAP Session 3-12 Sample DAP Command from the Shell Prompt 3-13 Executing a Script at the DAP Prompt 3-14 Redirecting Input from DAP Command Script 3-15 Contents of DAP Command Shell Script 3-16 Sample DAP HELP Interaction on VMS 3-17 Sample DAP HELP Interaction on ULTRIX 3-18 LOAD, UPDATE, and AUGMENT Commands Compared 3-19 Sample LOAD, UPDATE, and AUGMENT Commands 3-20 Sample DELETE Commands 3-21 Sample Output from REBUILD Command 3-22 Sample DAP Session: USE, PREVIOUS and SHOW CONTEXT 3-23 Sample Commands Showing Hierarchy Data 3-24 Sample SHOW Command for Definition Data 3-25 Sample Output From DUMP Command 3-26 Dictionary Browser 4-1 How the Test Bed Driver Interfaces with a Management Module 4-2 Summary of TBD DEPOSIT Commands 4-3 Sample TBD Session 4-4 Sample Help Interaction 4-5 Sample TBD Command File 4-6 Enrolling the Management Module's Executable File 4-7 Sample ENROLL Command 4-8 Sample DEPOSIT VERB and DEPOSIT ATTRIBUTE Commands 4-9 Effect of the /LINK Qualifier in DEPOSIT INENTITY Command 4-10 Sample Commands Using the /WILD Parameter 4-11 Sample DEPOSIT AT Command 4-12 Sample DEPOSIT FOR Command 4-13 Sample DEPOSIT AT and FOR in a Single Command 4-14 Sample DEPOSIT INP Command 4-15 Sample DEPOSIT INQ Command 4-16 Sample ILV Values 4-17 ILV Input Formats By Data Type 4-18 Sample ILV Encoding for an Entity Specification 4-19 Sample DEPOSIT HANDLE Commands 4-20 Sample DEPOSIT TSTAMP Command 4-21 Sample EXAMINE Command 4-22 Sample Output from DUMP /ACCESS Command When VERB and ATTRIBUTE are Non-Zero 4-23 Sample Output from DUMP /ACCESS Command When VERB and ATTRIBUTE are Zero 4-24 Sample Output from DUMP /FUNCTION Command 4-25 Sample Output from DUMP /THREAD Commands 4-26 Sample MODIFY Commands 5-1 Help File Builder Data Flow 5-2 Sample Help File Builder Interaction 5-3 Help File Builder Data Flow 5-4 Sample Help File Builder Interaction TABLES 1 Conventions