.! DSRTOC version V2.1-09 .! RUNO/CONT/REQ=NL: SETUP.BRN .SAVE .NO FLAGS ALL .NO FLAGS BREAK .NO FLAGS CAPITALIZE .NO FLAGS ENDFOOTNOTE .NO FLAGS HYPHENATE .NO FLAGS INDEX .NO FLAGS PERIOD .NO FLAGS SPACE .NO FLAGS SUBSTITUTE .FLAGS ACCEPT _ .FLAGS BOLD * .FLAGS COMMENT ! .FLAGS LOWERCASE \ .FLAGS OVERSTRIKE % .FLAGS UNDERLINE & .FLAGS UPPERCASE ^ .FLAGS ALL .NO FILL .NO JUSTIFY .LEFT MARGIN 8 .RIGHT MARGIN 70 .PAGE SIZE , 70 .CENTER;^*^&Table \of Contents\&\* .FIGURE 3 0_.1 Table of Contents . . . . . . . . . . . . . . . . i 0_.2 Introduction . . . . . . . . . . . . . . . . . . iii 0_.3 Format of this Manual . . . . . . . . . . . . . iii .FIGURE 3 .CENTER;^*^&PART I\&\* .TEST PAGE 5 .SK2 .I-8 CHAPTER 1 Overview .BLANK 1_.1 Program Distribution and Build Instructions . . . 1-1 1_.2 Basic Functions Description . . . . . . . . . . . 1-1 1_.3 Modification Prerequisites . . . . . . . . . . . . 1-2 1_.3_.1 Classes, Collections, and Nodes . . . . . . . . 1-2 1_.3_.2 List Structures . . . . . . . . . . . . . . . . 1-3 .TEST PAGE 5 .SK2 .I-8 CHAPTER 2 Guide to SETUP_.MAR Macros .BLANK 2_.1 _.COLL . . . . . . . . . . . . . . . . . . . . . . 2-1 2_.2 DEFINE__CLASS . . . . . . . . . . . . . . . . . . . 2-1 2_.3 DEFINE__COLLECTION . . . . . . . . . . . . . . . . 2-2 2_.4 DEFINE__NODE . . . . . . . . . . . . . . . . . . . 2-2 2_.5 _.EOLIST . . . . . . . . . . . . . . . . . . . . . 2-2 2_.6 _.ITM . . . . . . . . . . . . . . . . . . . . . . . 2-3 2_.7 _.ITMVAL . . . . . . . . . . . . . . . . . . . . . 2-3 2_.8 __MSGBITDEF . . . . . . . . . . . . . . . . . . . . 2-3 2_.9 __PRTDEF . . . . . . . . . . . . . . . . . . . . . 2-4 .TEST PAGE 5 .SK2 .I-8 CHAPTER 3 Guide to SETUP_.MAR Customization .BLANK 3_.1 Code Generation Flags . . . . . . . . . . . . . . 3-1 3_.1_.1 DISABLE__BOOST . . . . . . . . . . . . . . . . . 3-1 3_.1_.2 DISABLE__CMKRNL . . . . . . . . . . . . . . . . . 3-1 3_.1_.3 DISABLE__CMEXEC . . . . . . . . . . . . . . . . . 3-2 3_.1_.4 DISABLE__CMSUPER . . . . . . . . . . . . . . . . 3-2 3_.2 Class, Collection, And Node Definitions . . . . . 3-2 3_.3 List Definitions . . . . . . . . . . . . . . . . . 3-2 3_.3_.1 Automatic Symbol Deletion . . . . . . . . . . . 3-3 3_.3_.2 Symbol Definition . . . . . . . . . . . . . . . 3-3 3_.3_.3 Logical Name Definition . . . . . . . . . . . . 3-3 3_.3_.4 DCL Key Definitions . . . . . . . . . . . . . . 3-4 3_.3_.5 Default Process Names . . . . . . . . . . . . . 3-4 3_.3_.6 Default Protection . . . . . . . . . . . . . . . 3-4 3_.3_.7 Default Message Flags . . . . . . . . . . . . . 3-5 3_.3_.8 Default Privileges . . . . . . . . . . . . . . . 3-5 3_.3_.9 Default Drives _& Directories . . . . . . . . . . 3-5 3_.3_.10 Broadcast Classes . . . . . . . . . . . . . . . 3-5 3_.3_.11 Terminal Characteristics . . . . . . . . . . . . 3-5 3_.3_.12 Operator Console Enable . . . . . . . . . . . . 3-6 3_.3_.13 Set DCL Prompt . . . . . . . . . . . . . . . . . 3-6 3_.3_.14 Set DCL Verify State . . . . . . . . . . . . . . 3-6 3_.3_.15 Execute Final Command On Exit . . . . . . . . . 3-6 .FIGURE 3 .CENTER;^*^&PART II\&\* .TEST PAGE 5 .SK2 .I-8 CHAPTER 4 Implementation _& Data Structures .BLANK 4_.1 General SETUP Architecture . . . . . . . . . . . . 4-1 4_.1_.1 User Data Section . . . . . . . . . . . . . . . 4-1 4_.1_.2 Internal Data Section . . . . . . . . . . . . . 4-1 4_.1_.3 List Driver Routines . . . . . . . . . . . . . . 4-2 4_.1_.4 Class Matching Routines . . . . . . . . . . . . 4-2 4_.1_.5 Class Execution Routines . . . . . . . . . . . . 4-2 4_.1_.6 Main Function Subroutines . . . . . . . . . . . 4-2 4_.1_.7 Main Execution Module . . . . . . . . . . . . . 4-2 4_.2 List Types . . . . . . . . . . . . . . . . . . . . 4-3 4_.2_.1 Type 1 List . . . . . . . . . . . . . . . . . . 4-3 4_.2_.2 Type 2 List . . . . . . . . . . . . . . . . . . 4-3 4_.2_.3 Type 3 List . . . . . . . . . . . . . . . . . . 4-3 4_.3 Example Of A Type 2 List . . . . . . . . . . . . . 4-4 4_.4 Selected Specific List Structure Descriptions . . 4-4 4_.4_.1 General Description Of Mode Specific Lists . . . 4-4 4_.4_.2 Default Directory And Device Lists . . . . . . . 4-5 4_.4_.3 Terminal Characteristics List . . . . . . . . . 4-5 4_.4_.4 Prompt List . . . . . . . . . . . . . . . . . . 4-5 4_.4_.5 Processname List . . . . . . . . . . . . . . . . 4-6 4_.5 List Traversal Routines . . . . . . . . . . . . . 4-6 4_.5_.1 TRVSL2 . . . . . . . . . . . . . . . . . . . . . 4-6 4_.5_.2 TRVSL1 . . . . . . . . . . . . . . . . . . . . . 4-6 4_.5_.3 TRVSL0 . . . . . . . . . . . . . . . . . . . . . 4-7 4_.6 Class Matching Routines . . . . . . . . . . . . . 4-7 4_.6_.1 GETOPT__DEFAULT . . . . . . . . . . . . . . . . . 4-7 4_.6_.2 GETOPT__MEMBER . . . . . . . . . . . . . . . . . 4-7 4_.6_.3 GETOPT__INHIBIT . . . . . . . . . . . . . . . . . 4-8 4_.6_.4 GETOPT__PROTECTED . . . . . . . . . . . . . . . . 4-8 4_.7 Class Execution Routines . . . . . . . . . . . . . 4-8 4_.8 Good Luck _& Best Wishes . . . . . . . . . . . . . 4-8 .RESTORE