Mercurial > public > html2wiki
comparison test/resources/sysman_handbook.html @ 4:22ed6d93442c
Start modifying transformers to Confluence wiki syntax
author | smith@nwoca.org |
---|---|
date | Tue, 25 Jan 2011 21:59:31 -0500 |
parents | 5da2e67620f9 |
children |
comparison
equal
deleted
inserted
replaced
3:4417b025157e | 4:22ed6d93442c |
---|---|
1 <html> | 1 <html> |
2 <a name="first_page"></a> | 2 <a name="first_page"></a> |
3 | 3 |
4 <!-- This file created using DECdocument Version V3.3h on 25-JAN-2011 16:09:07.97 --> | 4 <!-- This file created using DECdocument Version V3.3h on 25-JAN-2011 20:18:10.51 --> |
5 <!-- TAG definitions version: V3.3h --> | 5 <!-- TAG definitions version: V3.3h --> |
6 <!-- The SDML doctype is: SOFTWARE.REFERENCE --> | 6 <!-- The SDML doctype is: SOFTWARE.REFERENCE --> |
7 <!-- The output destination was: HTML --> | 7 <!-- The output destination was: HTML --> |
8 <!-- SDML file is: NWB:[SMITH.DEV.SDML]OECN10_SYSMAN_HANDBOOK.SDML --> | 8 <!-- SDML file is: NWB:[SMITH.DEV.SDML]OECN10_SYSMAN_HANDBOOK.SDML --> |
9 | 9 |
66 <br> | 66 <br> |
67 Customizing Menus from the Distribution | 67 Customizing Menus from the Distribution |
68 | 68 |
69 <p> | 69 <p> |
70 <hr size=5> | 70 <hr size=5> |
71 <a name="menu_intro"><h1>Chapter 1<br>Introduction</h1></a> | 71 <a name="menu_intro"><h1>Introduction</h1></a> |
72 | 72 |
73 <p> | 73 <p> |
74 The OECN Menu processor provides a flexible user menu interface to | 74 The OECN Menu processor provides a flexible user menu interface to |
75 State Software programs. It also can be used to create menus for DCL | 75 State Software programs. It also can be used to create menus for DCL |
76 commands, and other layered products. Menu definitions will be provided | 76 commands, and other layered products. Menu definitions will be provided |
77 for all state software programs. Individual A-sites will be able to add | 77 for all state software programs. Individual A-sites will be able to add |
78 customized menus to the default menu system provided. | 78 customized menus to the default menu system provided. |
79 | 79 |
80 <a name="menu_features_head"><h1>1.1 Features</h1></a> | 80 <a name="menu_features_head"><h1>Features</h1></a> |
81 | 81 |
82 <p> | 82 <p> |
83 The Menu processor provides the following features: | 83 The Menu processor provides the following features: |
84 | 84 |
85 <ul> | 85 <ul> |
116 if the user remains inactive for a specified period. | 116 if the user remains inactive for a specified period. |
117 </ul> | 117 </ul> |
118 | 118 |
119 <p> | 119 <p> |
120 <hr size=5> | 120 <hr size=5> |
121 <a name="menu_theory"><h1>Chapter 2<br>Theory</h1></a> | 121 <a name="menu_theory"><h1>Theory</h1></a> |
122 | 122 |
123 <p> | 123 <p> |
124 The basic theory behind the Menu processor is fairly simple. The menu | 124 The basic theory behind the Menu processor is fairly simple. The menu |
125 definitions are stored in an RMS indexed file. The menu definitions are | 125 definitions are stored in an RMS indexed file. The menu definitions are |
126 flexible enough to allow creation of menus containing any combination | 126 flexible enough to allow creation of menus containing any combination |
127 of DCL commands, programs and information. | 127 of DCL commands, programs and information. |
128 | 128 |
129 <a name="menu_terms_head"><h1>2.1 Definition of Terms</h1></a> | 129 <a name="menu_terms_head"><h1>Definition of Terms</h1></a> |
130 | 130 |
131 <p> | 131 <p> |
132 First, it will be helpful to define some terms that will be used | 132 First, it will be helpful to define some terms that will be used |
133 throughout the rest of this document. <p> | 133 throughout the rest of this document. <p> |
134 | 134 |
135 <table border=3> | 135 <table border=3> |
136 <caption><a name="menu_terms_tab"><strong>Table 2-1 Menu System Terms</strong></a></caption> | 136 <caption><a name="menu_terms_tab"><strong> Menu System Terms</strong></a></caption> |
137 <tr> | 137 <tr> |
138 <th align=center>Term </th> | 138 <th align=center>Term </th> |
139 <th align=center>Meaning </th> | 139 <th align=center>Meaning </th> |
140 </tr> | 140 </tr> |
141 <tr> | 141 <tr> |
220 unique within each menu system. | 220 unique within each menu system. |
221 </td> | 221 </td> |
222 </tr> | 222 </tr> |
223 </table> | 223 </table> |
224 | 224 |
225 <a name="menu_files_theory"><h1>2.2 How Menu Files Create a Menu System</h1></a> | 225 <a name="menu_files_theory"><h1>How Menu Files Create a Menu System</h1></a> |
226 | 226 |
227 <p> | 227 <p> |
228 <a href="oecn10_sysman_handbook_full.html#menu_system_fig">Figure 2-1</a> displays a graphical representation of a possible menu | 228 <a href="oecn10_sysman_handbook_full.html#menu_system_fig">Figure 2-1</a> displays a graphical representation of a possible menu |
229 system. | 229 system. |
230 <a name="menu_system_fig"></a> | 230 <a name="menu_system_fig"></a> |
231 <p> | 231 <p> |
232 <strong>Figure 2-1 Conceptual View of a Menu system</strong> | 232 <strong>Conceptual View of a Menu system</strong> |
233 <hr> | 233 <hr> |
234 | 234 |
235 <p> | 235 <p> |
236 <table border=0> | 236 <table border=0> |
237 <tr> | 237 <tr> |
289 Also, the menu system may have one local security file. This file is | 289 Also, the menu system may have one local security file. This file is |
290 optional and created by the OSA utility. See the OECN Software Security | 290 optional and created by the OSA utility. See the OECN Software Security |
291 for VAX/VMS System Manager manual for more information about security | 291 for VAX/VMS System Manager manual for more information about security |
292 and the OSA utility. | 292 and the OSA utility. |
293 | 293 |
294 <a name="menu_specs_head"><h1>2.3 Menu Specifications</h1></a> | 294 <a name="menu_specs_head"><h1>Menu Specifications</h1></a> |
295 | 295 |
296 <p> | 296 <p> |
297 Throughout this document there are references to <strong>menu | 297 Throughout this document there are references to <strong>menu |
298 specifications</strong>. Wherever a menu specification is required the | 298 specifications</strong>. Wherever a menu specification is required the |
299 following syntax is allowed: | 299 following syntax is allowed: |
381 Goes to the LOCAL menu of the current file. | 381 Goes to the LOCAL menu of the current file. |
382 </td> | 382 </td> |
383 </tr> | 383 </tr> |
384 </table> | 384 </table> |
385 | 385 |
386 <a name="alias_file_head"><h1>2.4 The Alias File</h1></a> | 386 <a name="alias_file_head"><h1>The Alias File</h1></a> |
387 | 387 |
388 <p> | 388 <p> |
389 Each menu system may have exactly one <strong>alias file</strong>. An | 389 Each menu system may have exactly one <strong>alias file</strong>. An |
390 alias file contains a record for each menu item in the menu system. | 390 alias file contains a record for each menu item in the menu system. |
391 This alias record contains a pointer to the proper menu file that | 391 This alias record contains a pointer to the proper menu file that |
400 | 400 |
401 <p> | 401 <p> |
402 The alias file is built automatically by the MENUUTL program. See | 402 The alias file is built automatically by the MENUUTL program. See |
403 <a href="oecn10_sysman_handbook_full.html#build_alias_head">Section 5.2.1, Building the Alias File</a> for more information about creating the alias file. | 403 <a href="oecn10_sysman_handbook_full.html#build_alias_head">Section 5.2.1, Building the Alias File</a> for more information about creating the alias file. |
404 | 404 |
405 <a name="option_exec_sect"><h1>2.5 Option execution</h1></a> | 405 <a name="option_exec_sect"><h1>Option execution</h1></a> |
406 | 406 |
407 <p> | 407 <p> |
408 By default, the menu processor does <em>not</em> spawn subprocesses to | 408 By default, the menu processor does <em>not</em> spawn subprocesses to |
409 execute user options. All commands are executed in the user's current | 409 execute user options. All commands are executed in the user's current |
410 process. This implies that menu processor image must exit and restart | 410 process. This implies that menu processor image must exit and restart |
411 (activate) after each option has completed. This is called | 411 (activate) after each option has completed. This is called |
412 <strong>"terminate and execute"</strong> mode. This mode may provided | 412 <strong>"terminate and execute"</strong> mode. This mode may provided |
413 optimal response time for smaller VAX processors, particularly machines | 413 optimal response time for smaller VAX processors, particularly machines |
414 with small memory configurations. | 414 with small memory configurations. |
415 | 415 |
416 <a name="heading_2.5.1"><h2>2.5.1 Spawning Options</h2></a> | 416 <a name="heading_2.5.1"><h2>Spawning Options</h2></a> |
417 | 417 |
418 <p> | 418 <p> |
419 Another mode that may be chosen by the system manager is "spawn and | 419 Another mode that may be chosen by the system manager is "spawn and |
420 execute". In this mode, <em>most</em> commands are executed in a | 420 execute". In this mode, <em>most</em> commands are executed in a |
421 subprocess. The menu processor remains running in the main process and | 421 subprocess. The menu processor remains running in the main process and |
465 subprocess. These types of items should be used sparingly and will | 465 subprocess. These types of items should be used sparingly and will |
466 seldom be necessary. The only item in the menu files distributed by | 466 seldom be necessary. The only item in the menu files distributed by |
467 SSDT that need the "DP" item type was the DETPRT option of the LOCAL | 467 SSDT that need the "DP" item type was the DETPRT option of the LOCAL |
468 menu. All other SSDT menu items may be executed in a subprocess. | 468 menu. All other SSDT menu items may be executed in a subprocess. |
469 | 469 |
470 <a name="heading_2.5.2"><h2>2.5.2 Selecting Execution Mode</h2></a> | 470 <a name="heading_2.5.2"><h2>Selecting Execution Mode</h2></a> |
471 | 471 |
472 <p> | 472 <p> |
473 To select either "terminate and execute" or "spawn and execute" mode, | 473 To select either "terminate and execute" or "spawn and execute" mode, |
474 the system manager needs only define a single logical. The logical name | 474 the system manager needs only define a single logical. The logical name |
475 is OECN$MENU_BEHAVIOR and may be defined in the SYSTARTUP procedure. | 475 is OECN$MENU_BEHAVIOR and may be defined in the SYSTARTUP procedure. |
488 | 488 |
489 <p> | 489 <p> |
490 This logical also can be defined at the group or process level. If the | 490 This logical also can be defined at the group or process level. If the |
491 logical is not defined, the default is "TERMINATE". | 491 logical is not defined, the default is "TERMINATE". |
492 | 492 |
493 <a name="timeout_head"><h1>2.6 Inactivity Timeout</h1></a> | 493 <a name="timeout_head"><h1>Inactivity Timeout</h1></a> |
494 | 494 |
495 <p> | 495 <p> |
496 The menu processor has an optional feature that will cause it to | 496 The menu processor has an optional feature that will cause it to |
497 automatically exit if the user does not enter a command after a | 497 automatically exit if the user does not enter a command after a |
498 specified period of time. This might be a useful security feature for | 498 specified period of time. This might be a useful security feature for |
531 </table> | 531 </table> |
532 </center> | 532 </center> |
533 | 533 |
534 <p> | 534 <p> |
535 <hr size=5> | 535 <hr size=5> |
536 <a name="menu_implentation_chap"><h1>Chapter 3<br>Implementation</h1></a> | 536 <a name="menu_implentation_chap"><h1>Implementation</h1></a> |
537 | 537 |
538 <p> | 538 <p> |
539 Several steps are required in order to implement the Menu Processor on | 539 Several steps are required in order to implement the Menu Processor on |
540 your system. The steps are briefly outlined below, detailed | 540 your system. The steps are briefly outlined below, detailed |
541 explanations follow: | 541 explanations follow: |
549 <li> Create the OECN_MENU symbol. | 549 <li> Create the OECN_MENU symbol. |
550 <li> Use the VMS Install utility to make the Menu Processor a known, | 550 <li> Use the VMS Install utility to make the Menu Processor a known, |
551 shared image. | 551 shared image. |
552 </ol> | 552 </ol> |
553 | 553 |
554 <a name="installation_head"><h1>3.1 Installation</h1></a> | 554 <a name="installation_head"><h1>Installation</h1></a> |
555 | 555 |
556 <p> | 556 <p> |
557 The Menu Processor uses files from the OECN, MENU and HELP packages. | 557 The Menu Processor uses files from the OECN, MENU and HELP packages. |
558 Install these packages as usual using OECN_INSTALL. For further | 558 Install these packages as usual using OECN_INSTALL. For further |
559 information about OECN_INSTALL see OECN_INSTALL.DOC in the VAX manager | 559 information about OECN_INSTALL see OECN_INSTALL.DOC in the VAX manager |
560 documentation directory. | 560 documentation directory. |
561 | 561 |
562 <a name="logicals_head"><h1>3.2 Establish OECN Logicals</h1></a> | 562 <a name="logicals_head"><h1>Establish OECN Logicals</h1></a> |
563 | 563 |
564 <p> | 564 <p> |
565 Several logicals are used by the Menu Processor to locate the menu | 565 Several logicals are used by the Menu Processor to locate the menu |
566 files and VMS Help libraries. <p> | 566 files and VMS Help libraries. <p> |
567 | 567 |
568 <table border=3> | 568 <table border=3> |
569 <caption><a name="logicals_tab"><strong>Table 3-1 Menu Logicals</strong></a></caption> | 569 <caption><a name="logicals_tab"><strong> Menu Logicals</strong></a></caption> |
570 <tr> | 570 <tr> |
571 <th align=center>Logical </th> | 571 <th align=center>Logical </th> |
572 <th align=center>Purpose </th> | 572 <th align=center>Purpose </th> |
573 </tr> | 573 </tr> |
574 <tr> | 574 <tr> |
668 OECN$MENU$FILES and OECN$HELP must be defined in either the SYSTARTUP | 668 OECN$MENU$FILES and OECN$HELP must be defined in either the SYSTARTUP |
669 or individual LOGIN.COM files. These logicals may be defined at the | 669 or individual LOGIN.COM files. These logicals may be defined at the |
670 system, group or process level. For example, the OECN$MENU logical may | 670 system, group or process level. For example, the OECN$MENU logical may |
671 be defined for each user to provide a different default menu. | 671 be defined for each user to provide a different default menu. |
672 | 672 |
673 <a name="behavior_logical"><h2>3.2.1 Specifying options with OECN$MENU_BEHAVIOR logical</h2></a> | 673 <a name="behavior_logical"><h2>Specifying options with OECN$MENU_BEHAVIOR logical</h2></a> |
674 | 674 |
675 <p> | 675 <p> |
676 This section describes the commands that may be placed in the | 676 This section describes the commands that may be placed in the |
677 OECN$BEHAVIOR logical. The syntax for the logical definition is: | 677 OECN$BEHAVIOR logical. The syntax for the logical definition is: |
678 | 678 |
692 multiple commands are specified they must be separated by commas (,). | 692 multiple commands are specified they must be separated by commas (,). |
693 This logical can be defined at the system, group, job or process level. | 693 This logical can be defined at the system, group, job or process level. |
694 <p> | 694 <p> |
695 | 695 |
696 <table border=3> | 696 <table border=3> |
697 <caption><a name="Table_3-2"><strong>Table 3-2 Behavior Options</strong></a></caption> | 697 <caption><a name="Table_3-2"><strong> Behavior Options</strong></a></caption> |
698 <tr> | 698 <tr> |
699 <th align=center>Command </th> | 699 <th align=center>Command </th> |
700 <th align=center>Description </th> | 700 <th align=center>Description </th> |
701 </tr> | 701 </tr> |
702 <tr> | 702 <tr> |
747 <pre> | 747 <pre> |
748 $ DEFINE/SYSTEM OECN$MENU_BEHAVIOR "SPAWN,TIMEOUT=30" | 748 $ DEFINE/SYSTEM OECN$MENU_BEHAVIOR "SPAWN,TIMEOUT=30" |
749 </pre> | 749 </pre> |
750 </table> | 750 </table> |
751 | 751 |
752 <a name="move_files_head"><h1>3.3 Move Files to Appropriate Directories</h1></a> | 752 <a name="move_files_head"><h1>Move Files to Appropriate Directories</h1></a> |
753 | 753 |
754 <p> | 754 <p> |
755 Move the menu files (OECN$ROOT:[MENU.DIST]*.DAT) to the directory | 755 Move the menu files (OECN$ROOT:[MENU.DIST]*.DAT) to the directory |
756 referenced by OECN$MENU$FILES. | 756 referenced by OECN$MENU$FILES. |
757 | 757 |
772 </blockquote> | 772 </blockquote> |
773 | 773 |
774 <p> | 774 <p> |
775 The users must have execute access to these files. | 775 The users must have execute access to these files. |
776 | 776 |
777 <a name="add_symbol_head"><h1>3.4 Add Global Symbol</h1></a> | 777 <a name="add_symbol_head"><h1>Add Global Symbol</h1></a> |
778 | 778 |
779 <p> | 779 <p> |
780 Add the following symbol to either your SYLOGIN.COM or each user's | 780 Add the following symbol to either your SYLOGIN.COM or each user's |
781 LOGIN.COM who will be using the system: | 781 LOGIN.COM who will be using the system: |
782 | 782 |
794 This creates a foreign command that the OECN_MENU.COM procedure uses to | 794 This creates a foreign command that the OECN_MENU.COM procedure uses to |
795 invoke the Menu Processor. Other symbols may be necessary to make it | 795 invoke the Menu Processor. Other symbols may be necessary to make it |
796 easier for your users to invoke a menu. These symbols will be discussed | 796 easier for your users to invoke a menu. These symbols will be discussed |
797 in the <a href="oecn10_sysman_handbook_full.html#invoking_chap">Chapter 4, Invoking the Menu Processor</a>. The OECN_MENU symbol is the only required symbol. | 797 in the <a href="oecn10_sysman_handbook_full.html#invoking_chap">Chapter 4, Invoking the Menu Processor</a>. The OECN_MENU symbol is the only required symbol. |
798 | 798 |
799 <a name="install_head"><h1>3.5 Install the Menu Processor</h1></a> | 799 <a name="install_head"><h1>Install the Menu Processor</h1></a> |
800 | 800 |
801 <p> | 801 <p> |
802 Although it is not necessary for proper execution of the Menu | 802 Although it is not necessary for proper execution of the Menu |
803 Processor, it is <strong>strongly</strong> recommended that you install | 803 Processor, it is <strong>strongly</strong> recommended that you install |
804 the Menu Processor as a known image. | 804 the Menu Processor as a known image. |
824 </pre> | 824 </pre> |
825 </table> | 825 </table> |
826 | 826 |
827 <p> | 827 <p> |
828 <hr size=5> | 828 <hr size=5> |
829 <a name="invoking_chap"><h1>Chapter 4<br>Invoking the Menu Processor</h1></a> | 829 <a name="invoking_chap"><h1>Invoking the Menu Processor</h1></a> |
830 | 830 |
831 <p> | 831 <p> |
832 The Menu Processor must be invoked via a command procedure that is | 832 The Menu Processor must be invoked via a command procedure that is |
833 provided as part of the OECN package. The Menu Processor depends on | 833 provided as part of the OECN package. The Menu Processor depends on |
834 this command procedure to perform several vital functions and to | 834 this command procedure to perform several vital functions and to |
902 <p> | 902 <p> |
903 This command may be defined in a global symbol, invoked from a captive | 903 This command may be defined in a global symbol, invoked from a captive |
904 login procedure or from inside another procedure. No restrictions are | 904 login procedure or from inside another procedure. No restrictions are |
905 placed on the method of invoking the Menu Processor. | 905 placed on the method of invoking the Menu Processor. |
906 | 906 |
907 <a name="invoke_example_head"><h1>4.1 Examples</h1></a> | 907 <a name="invoke_example_head"><h1>Examples</h1></a> |
908 | 908 |
909 <p> | 909 <p> |
910 For most users the following symbol definition is sufficient: | 910 For most users the following symbol definition is sufficient: |
911 | 911 |
912 <p> | 912 <p> |
963 not restrict the user to the PAY_MENU, it just starts them out in that | 963 not restrict the user to the PAY_MENU, it just starts them out in that |
964 menu. | 964 menu. |
965 | 965 |
966 <p> | 966 <p> |
967 <hr size=5> | 967 <hr size=5> |
968 <a name="modifying_menus_chap"><h1>Chapter 5<br>Modifying and Creating Menu Systems</h1></a> | 968 <a name="modifying_menus_chap"><h1>Modifying and Creating Menu Systems</h1></a> |
969 | 969 |
970 <p> | 970 <p> |
971 The MENUEDT program is a fully functional maintenance program for | 971 The MENUEDT program is a fully functional maintenance program for |
972 modifying and creating menu files. Another program, MENUUTL, provides | 972 modifying and creating menu files. Another program, MENUUTL, provides |
973 several necessary and useful utilities when manipulating the files, | 973 several necessary and useful utilities when manipulating the files, |
974 such as building the alias file and reporting functions. <p> | 974 such as building the alias file and reporting functions. <p> |
975 | 975 |
976 <table border=3> | 976 <table border=3> |
977 <caption><a name="menu_type_tab"><strong>Table 5-1 Menu Record Types</strong></a></caption> | 977 <caption><a name="menu_type_tab"><strong> Menu Record Types</strong></a></caption> |
978 <tr> | 978 <tr> |
979 <th align=center>Record Type </th> | 979 <th align=center>Record Type </th> |
980 <th align=center>Function </th> | 980 <th align=center>Function </th> |
981 </tr> | 981 </tr> |
982 <tr> | 982 <tr> |
1018 what the runtime environment will be for the menu file. Thus, very | 1018 what the runtime environment will be for the menu file. Thus, very |
1019 little error checking is performed or even attempted. This means that | 1019 little error checking is performed or even attempted. This means that |
1020 menus that you modify or create should be tested thoroughly before | 1020 menus that you modify or create should be tested thoroughly before |
1021 being made available to your users. | 1021 being made available to your users. |
1022 | 1022 |
1023 <a name="using_edt_head"><h1>5.1 Using MENUEDT</h1></a> | 1023 <a name="using_edt_head"><h1>Using MENUEDT</h1></a> |
1024 | 1024 |
1025 <p> | 1025 <p> |
1026 When you first run the MENUEDT program it will prompt you for the name | 1026 When you first run the MENUEDT program it will prompt you for the name |
1027 of the menu file to modify. If the file does not exist it will be | 1027 of the menu file to modify. If the file does not exist it will be |
1028 created. <p> | 1028 created. <p> |
1029 | 1029 |
1030 <table border=3> | 1030 <table border=3> |
1031 <caption><a name="edt_options_tab"><strong>Table 5-2 MENUEDT Main Menu Options</strong></a></caption> | 1031 <caption><a name="edt_options_tab"><strong> MENUEDT Main Menu Options</strong></a></caption> |
1032 <tr> | 1032 <tr> |
1033 <th align=center>Option </th> | 1033 <th align=center>Option </th> |
1034 <th align=center>Function </th> | 1034 <th align=center>Function </th> |
1035 </tr> | 1035 </tr> |
1036 <tr> | 1036 <tr> |
1107 Exits MENUEDT. | 1107 Exits MENUEDT. |
1108 </td> | 1108 </td> |
1109 </tr> | 1109 </tr> |
1110 </table> | 1110 </table> |
1111 | 1111 |
1112 <a name="menu_type_head"><h2>5.1.1 Menu File Record Types</h2></a> | 1112 <a name="menu_type_head"><h2>Menu File Record Types</h2></a> |
1113 | 1113 |
1114 <p> | 1114 <p> |
1115 This section and the following sections show sample screens that are | 1115 This section and the following sections show sample screens that are |
1116 used by MENUEDT to modify the various record types. After each screen | 1116 used by MENUEDT to modify the various record types. After each screen |
1117 is a detailed explanation of each field and its purpose. | 1117 is a detailed explanation of each field and its purpose. |
1118 | 1118 |
1119 <a name="file_header_head"><h2>5.1.2 File Header Record</h2></a> | 1119 <a name="file_header_head"><h2>File Header Record</h2></a> |
1120 | 1120 |
1121 <p> | 1121 <p> |
1122 The first record in each menu file must be a File Header record and | 1122 The first record in each menu file must be a File Header record and |
1123 each file must contain exactly one Header record. | 1123 each file must contain exactly one Header record. |
1124 | 1124 |
1139 </table> | 1139 </table> |
1140 | 1140 |
1141 <p> | 1141 <p> |
1142 | 1142 |
1143 <table border=3> | 1143 <table border=3> |
1144 <caption><a name="file_header_fld_tab"><strong>Table 5-3 File Header Record Fields</strong></a></caption> | 1144 <caption><a name="file_header_fld_tab"><strong> File Header Record Fields</strong></a></caption> |
1145 <tr> | 1145 <tr> |
1146 <th align=center>Field </th> | 1146 <th align=center>Field </th> |
1147 <th align=center>Description </th> | 1147 <th align=center>Description </th> |
1148 </tr> | 1148 </tr> |
1149 <tr> | 1149 <tr> |
1175 information about security identifiers. | 1175 information about security identifiers. |
1176 </td> | 1176 </td> |
1177 </tr> | 1177 </tr> |
1178 </table> | 1178 </table> |
1179 | 1179 |
1180 <a name="menu_header_head"><h2>5.1.3 Menu Header Record</h2></a> | 1180 <a name="menu_header_head"><h2>Menu Header Record</h2></a> |
1181 | 1181 |
1182 <p> | 1182 <p> |
1183 The Menu Header record contains information about each menu in the | 1183 The Menu Header record contains information about each menu in the |
1184 file. There must be exactly one Header record for each menu contained | 1184 file. There must be exactly one Header record for each menu contained |
1185 in the file. | 1185 in the file. |
1205 </table> | 1205 </table> |
1206 | 1206 |
1207 <p> | 1207 <p> |
1208 | 1208 |
1209 <table border=3> | 1209 <table border=3> |
1210 <caption><a name="menu_header_fld_tab"><strong>Table 5-4 Menu Header Fields</strong></a></caption> | 1210 <caption><a name="menu_header_fld_tab"><strong> Menu Header Fields</strong></a></caption> |
1211 <tr> | 1211 <tr> |
1212 <th align=center>field </th> | 1212 <th align=center>field </th> |
1213 <th align=center>Description </th> | 1213 <th align=center>Description </th> |
1214 </tr> | 1214 </tr> |
1215 <tr> | 1215 <tr> |
1294 security identifiers. | 1294 security identifiers. |
1295 </td> | 1295 </td> |
1296 </tr> | 1296 </tr> |
1297 </table> | 1297 </table> |
1298 | 1298 |
1299 <a name="menu_item_head"><h2>5.1.4 Menu Item Record</h2></a> | 1299 <a name="menu_item_head"><h2>Menu Item Record</h2></a> |
1300 | 1300 |
1301 <p> | 1301 <p> |
1302 One menu item record must be specified for each desired item on a menu. | 1302 One menu item record must be specified for each desired item on a menu. |
1303 A menu can contain a maximum of 50 item records. If there are less than | 1303 A menu can contain a maximum of 50 item records. If there are less than |
1304 8 items then the menu will be double spaced, otherwise the menu will be | 1304 8 items then the menu will be double spaced, otherwise the menu will be |
1310 Action field is determined by the Item Type field. The four possible | 1310 Action field is determined by the Item Type field. The four possible |
1311 types and the meaning of the Action field are defined in <a href="oecn10_sysman_handbook_full.html#item_types_tab">Table 5-5</a>. | 1311 types and the meaning of the Action field are defined in <a href="oecn10_sysman_handbook_full.html#item_types_tab">Table 5-5</a>. |
1312 <p> | 1312 <p> |
1313 | 1313 |
1314 <table border=3> | 1314 <table border=3> |
1315 <caption><a name="item_types_tab"><strong>Table 5-5 Menu Item Types</strong></a></caption> | 1315 <caption><a name="item_types_tab"><strong> Menu Item Types</strong></a></caption> |
1316 <tr> | 1316 <tr> |
1317 <th align=center>Item Type </th> | 1317 <th align=center>Item Type </th> |
1318 <th align=center>Interpretation of Action Field </th> | 1318 <th align=center>Interpretation of Action Field </th> |
1319 </tr> | 1319 </tr> |
1320 <tr> | 1320 <tr> |
1381 </table> | 1381 </table> |
1382 | 1382 |
1383 <p> | 1383 <p> |
1384 | 1384 |
1385 <table border=3> | 1385 <table border=3> |
1386 <caption><a name="menu_item_tab"><strong>Table 5-6 Menu Item Fields</strong></a></caption> | 1386 <caption><a name="menu_item_tab"><strong> Menu Item Fields</strong></a></caption> |
1387 <tr> | 1387 <tr> |
1388 <th align=center>Field </th> | 1388 <th align=center>Field </th> |
1389 <th align=center>Description </th> | 1389 <th align=center>Description </th> |
1390 </tr> | 1390 </tr> |
1391 <tr> | 1391 <tr> |
1501 <sup>1</sup>Key fields of the menu file. However the MENUEDT program | 1501 <sup>1</sup>Key fields of the menu file. However the MENUEDT program |
1502 allows these fields to be changed. | 1502 allows these fields to be changed. |
1503 <br> | 1503 <br> |
1504 <hr> | 1504 <hr> |
1505 | 1505 |
1506 <a name="action_values_head"><h3>5.1.4.1 Values for Action Field</h3></a> | 1506 <a name="action_values_head"><h3>Values for Action Field</h3></a> |
1507 | 1507 |
1508 <p> | 1508 <p> |
1509 Much of the Menu Processor's flexibility is provided by the values that | 1509 Much of the Menu Processor's flexibility is provided by the values that |
1510 may be placed in the Action field. The Action field and the Item Type | 1510 may be placed in the Action field. The Action field and the Item Type |
1511 field together determine what will happen when the user chooses an item | 1511 field together determine what will happen when the user chooses an item |
1631 If Type = "T" then the action line is ignored. Text items are used to | 1631 If Type = "T" then the action line is ignored. Text items are used to |
1632 put information or subheadings on a menu. For text items, the | 1632 put information or subheadings on a menu. For text items, the |
1633 Description field is simply displayed on the menu without a label or an | 1633 Description field is simply displayed on the menu without a label or an |
1634 option number. | 1634 option number. |
1635 | 1635 |
1636 <a name="secur_id_screen_head"><h2>5.1.5 Menu Security Screen</h2></a> | 1636 <a name="secur_id_screen_head"><h2>Menu Security Screen</h2></a> |
1637 | 1637 |
1638 <p> | 1638 <p> |
1639 The <strong>Modify Security Identifier</strong> screen allows you to | 1639 The <strong>Modify Security Identifier</strong> screen allows you to |
1640 require that the user has specific VMS identifiers before they are | 1640 require that the user has specific VMS identifiers before they are |
1641 allowed access to certain menu elements. | 1641 allowed access to certain menu elements. |
1708 <p> | 1708 <p> |
1709 If four identifiers are not enough for your site, you may add new ones. | 1709 If four identifiers are not enough for your site, you may add new ones. |
1710 Up to 16 identifier positions have been reserved for use at the A-site | 1710 Up to 16 identifier positions have been reserved for use at the A-site |
1711 level. See OECN_IDS.LIB in OECN$LIB: for instructions. | 1711 level. See OECN_IDS.LIB in OECN$LIB: for instructions. |
1712 | 1712 |
1713 <a name="security_ids"><h3>5.1.5.1 Security Identifiers</h3></a> | 1713 <a name="security_ids"><h3>Security Identifiers</h3></a> |
1714 | 1714 |
1715 <p> | 1715 <p> |
1716 The security identifiers that appear on the Security Identifier screen | 1716 The security identifiers that appear on the Security Identifier screen |
1717 are the "standard" identifiers. Three possible identifiers | 1717 are the "standard" identifiers. Three possible identifiers |
1718 exist for each standard identifier, which are used to specify three | 1718 exist for each standard identifier, which are used to specify three |
1722 <p> | 1722 <p> |
1723 The following table lists the three access levels, in order of lowest | 1723 The following table lists the three access levels, in order of lowest |
1724 level access to the highest. <p> | 1724 level access to the highest. <p> |
1725 | 1725 |
1726 <table border=3> | 1726 <table border=3> |
1727 <caption><a name="security_level_tbl"><strong>Table 5-7 Security Access Levels</strong></a></caption> | 1727 <caption><a name="security_level_tbl"><strong> Security Access Levels</strong></a></caption> |
1728 <tr> | 1728 <tr> |
1729 <th align=center>Access Level </th> | 1729 <th align=center>Access Level </th> |
1730 <th align=center>Suffix </th> | 1730 <th align=center>Suffix </th> |
1731 <th align=center>Description </th> | 1731 <th align=center>Description </th> |
1732 </tr> | 1732 </tr> |
1790 <p> | 1790 <p> |
1791 It also should be noted that the access levels will be applied to the | 1791 It also should be noted that the access levels will be applied to the |
1792 A-site specific identifiers. That is, there will also be OECN_USER1_RO | 1792 A-site specific identifiers. That is, there will also be OECN_USER1_RO |
1793 and OECN_USER1_GM identifiers available for use at the A-site level. | 1793 and OECN_USER1_GM identifiers available for use at the A-site level. |
1794 | 1794 |
1795 <a name="menuutl_head"><h1>5.2 Using MENUUTL</h1></a> | 1795 <a name="menuutl_head"><h1>Using MENUUTL</h1></a> |
1796 | 1796 |
1797 <p> | 1797 <p> |
1798 The MENUUTL program provides some necessary functions for building, | 1798 The MENUUTL program provides some necessary functions for building, |
1799 maintaining and documenting a menu system. The options provided are: | 1799 maintaining and documenting a menu system. The options provided are: |
1800 | 1800 |
1803 <li>Simulated Menu Listing | 1803 <li>Simulated Menu Listing |
1804 <li>Detailed Menu Report | 1804 <li>Detailed Menu Report |
1805 <li>Hierarchical Menu Listing | 1805 <li>Hierarchical Menu Listing |
1806 </ol> | 1806 </ol> |
1807 | 1807 |
1808 <a name="build_alias_head"><h2>5.2.1 Building the Alias File</h2></a> | 1808 <a name="build_alias_head"><h2>Building the Alias File</h2></a> |
1809 | 1809 |
1810 <p> | 1810 <p> |
1811 The first and the most important option of MENUUTL is the alias file | 1811 The first and the most important option of MENUUTL is the alias file |
1812 build option. The alias file contains a pointer for each menu item in | 1812 build option. The alias file contains a pointer for each menu item in |
1813 the system. Therefore, whenever you add or remove menu items from a | 1813 the system. Therefore, whenever you add or remove menu items from a |
1914 that the alias file is always up-to-date. </td> | 1914 that the alias file is always up-to-date. </td> |
1915 </tr> | 1915 </tr> |
1916 </table> | 1916 </table> |
1917 </center> | 1917 </center> |
1918 | 1918 |
1919 <a name="simulate_list_head"><h2>5.2.2 Simulated Menu Listing</h2></a> | 1919 <a name="simulate_list_head"><h2>Simulated Menu Listing</h2></a> |
1920 | 1920 |
1921 <p> | 1921 <p> |
1922 This option will read through the specified menu file and create a | 1922 This option will read through the specified menu file and create a |
1923 simulated menu listing. The listing will display the menu in as close | 1923 simulated menu listing. The listing will display the menu in as close |
1924 an approximation as possible on a hardcopy printer. The option will | 1924 an approximation as possible on a hardcopy printer. The option will |
1925 only report on one menu file at a time and will be sorted in | 1925 only report on one menu file at a time and will be sorted in |
1926 alphabetical order by menu name. | 1926 alphabetical order by menu name. |
1927 | 1927 |
1928 <a name="detailed_list_head"><h2>5.2.3 Detailed Menu Listing</h2></a> | 1928 <a name="detailed_list_head"><h2>Detailed Menu Listing</h2></a> |
1929 | 1929 |
1930 <p> | 1930 <p> |
1931 The detailed menu report lists all available information about the | 1931 The detailed menu report lists all available information about the |
1932 specified menu file. This report is particularly useful for double | 1932 specified menu file. This report is particularly useful for double |
1933 checking the action fields and security. | 1933 checking the action fields and security. |
1934 | 1934 |
1935 <a name="hier_list_head"><h2>5.2.4 Hierarchical Listing</h2></a> | 1935 <a name="hier_list_head"><h2>Hierarchical Listing</h2></a> |
1936 | 1936 |
1937 <p> | 1937 <p> |
1938 This report will display the structure of the menu system. The menus | 1938 This report will display the structure of the menu system. The menus |
1939 are listed in the proper order as they appear on the menu. This option | 1939 are listed in the proper order as they appear on the menu. This option |
1940 will prompt for the top level menu file and menu where the listing is | 1940 will prompt for the top level menu file and menu where the listing is |
1941 to start. You need not necessarily start at the top of the entire menu | 1941 to start. You need not necessarily start at the top of the entire menu |
1942 system. | 1942 system. |
1943 | 1943 |
1944 <a name="osa_head"><h1>5.3 OSA</h1></a> | 1944 <a name="osa_head"><h1>OSA</h1></a> |
1945 | 1945 |
1946 <p> | 1946 <p> |
1947 The OSA, OECN Security Authorization, Utility may be used in | 1947 The OSA, OECN Security Authorization, Utility may be used in |
1948 conjunction with the OECN Menu Processor to fine tune security access. | 1948 conjunction with the OECN Menu Processor to fine tune security access. |
1949 OSA can be used to enable user's access to individual programs to be | 1949 OSA can be used to enable user's access to individual programs to be |
1951 A-site and is maintained separately from the menu system included on | 1951 A-site and is maintained separately from the menu system included on |
1952 the OECN distribution. (See also VMS Manager's Guide) | 1952 the OECN distribution. (See also VMS Manager's Guide) |
1953 | 1953 |
1954 <p> | 1954 <p> |
1955 <hr size=5> | 1955 <hr size=5> |
1956 <a name="custom_chap"><h1>Chapter 6<br>Customizing Menus from the Distribution</h1></a> | 1956 <a name="custom_chap"><h1>Customizing Menus from the Distribution</h1></a> |
1957 | 1957 |
1958 <p> | 1958 <p> |
1959 This chapter describes the recommended procedure for customizing the | 1959 This chapter describes the recommended procedure for customizing the |
1960 menu files from the distribution. Following this procedure will ensure | 1960 menu files from the distribution. Following this procedure will ensure |
1961 that you can install future releases with minimum effort and maintain a | 1961 that you can install future releases with minimum effort and maintain a |
1989 manual for information about the OSA utility and local security. </td> | 1989 manual for information about the OSA utility and local security. </td> |
1990 </tr> | 1990 </tr> |
1991 </table> | 1991 </table> |
1992 </center> | 1992 </center> |
1993 | 1993 |
1994 <a name="local_head"><h1>6.1 Modifying a Local Menu File</h1></a> | 1994 <a name="local_head"><h1>Modifying a Local Menu File</h1></a> |
1995 | 1995 |
1996 <p> | 1996 <p> |
1997 Following is the recommend procedure for modifying one or more menu | 1997 Following is the recommend procedure for modifying one or more menu |
1998 files. | 1998 files. |
1999 | 1999 |
2002 <li>Modify the Menu Files | 2002 <li>Modify the Menu Files |
2003 <li>Build a New Alias File | 2003 <li>Build a New Alias File |
2004 <li>Redefine OECN$MENU$FILES permanently | 2004 <li>Redefine OECN$MENU$FILES permanently |
2005 </ol> | 2005 </ol> |
2006 | 2006 |
2007 <a name="redefine_logical_head"><h2>6.1.1 Redefine the OECN$MENU$FILES logical</h2></a> | 2007 <a name="redefine_logical_head"><h2>Redefine the OECN$MENU$FILES logical</h2></a> |
2008 | 2008 |
2009 <p> | 2009 <p> |
2010 The first step is to redefine OECN$MENU$FILES as a search list. For | 2010 The first step is to redefine OECN$MENU$FILES as a search list. For |
2011 consistency with other customized files, it is recommended that you use | 2011 consistency with other customized files, it is recommended that you use |
2012 OECN$CUSTOM. However, you may use any directory that you wish. The rest | 2012 OECN$CUSTOM. However, you may use any directory that you wish. The rest |
2039 will prevent any users from getting into a half completed menu. </td> | 2039 will prevent any users from getting into a half completed menu. </td> |
2040 </tr> | 2040 </tr> |
2041 </table> | 2041 </table> |
2042 </center> | 2042 </center> |
2043 | 2043 |
2044 <a name="heading_6.1.2"><h2>6.1.2 Modify the Menu Files</h2></a> | 2044 <a name="heading_6.1.2"><h2>Modify the Menu Files</h2></a> |
2045 | 2045 |
2046 <p> | 2046 <p> |
2047 Copy the *_LCL.DAT menu files that you want to modify from the | 2047 Copy the *_LCL.DAT menu files that you want to modify from the |
2048 distribution into OECN$CUSTOM. Then use MENUEDT to make the desired | 2048 distribution into OECN$CUSTOM. Then use MENUEDT to make the desired |
2049 modifications. By making all modifications in OECN$CUSTOM: will insure | 2049 modifications. By making all modifications in OECN$CUSTOM: will insure |
2053 <p> | 2053 <p> |
2054 Use the Menu Processor and MENUUTL to test the new menus as needed. If | 2054 Use the Menu Processor and MENUUTL to test the new menus as needed. If |
2055 you're creating new menus, be sure that the users have read access to | 2055 you're creating new menus, be sure that the users have read access to |
2056 the new files. | 2056 the new files. |
2057 | 2057 |
2058 <a name="heading_6.1.3"><h2>6.1.3 Build a New Alias File</h2></a> | 2058 <a name="heading_6.1.3"><h2>Build a New Alias File</h2></a> |
2059 | 2059 |
2060 <p> | 2060 <p> |
2061 After all desired changes have been made, use MENUUTL to rebuild the | 2061 After all desired changes have been made, use MENUUTL to rebuild the |
2062 alias file. You may put the alias file in OECN$CUSTOM or simply replace | 2062 alias file. You may put the alias file in OECN$CUSTOM or simply replace |
2063 the current alias file in OECN$ALIAS. If you change the location of the | 2063 the current alias file in OECN$ALIAS. If you change the location of the |
2065 | 2065 |
2066 <p> | 2066 <p> |
2067 You may build the alias file manually by running MENUUTL, or you may | 2067 You may build the alias file manually by running MENUUTL, or you may |
2068 use the BUILD_ALIAS.COM procedure in the OECN$ directory. | 2068 use the BUILD_ALIAS.COM procedure in the OECN$ directory. |
2069 | 2069 |
2070 <a name="heading_6.1.4"><h2>6.1.4 Redefine OECN$MENU$FILES Permanently</h2></a> | 2070 <a name="heading_6.1.4"><h2>Redefine OECN$MENU$FILES Permanently</h2></a> |
2071 | 2071 |
2072 <p> | 2072 <p> |
2073 If you have not already done so, define the logical OECN$MENU$FILES to | 2073 If you have not already done so, define the logical OECN$MENU$FILES to |
2074 be a search list as above at the SYSTEM level. | 2074 be a search list as above at the SYSTEM level. |
2075 | 2075 |
2076 <p> | 2076 <p> |
2077 At this point your users should have access to the customized menus. | 2077 At this point your users should have access to the customized menus. |
2078 | 2078 |
2079 <a name="heading_6.2"><h1>6.2 After a Distribution</h1></a> | 2079 <a name="heading_6.2"><h1>After a Distribution</h1></a> |
2080 | 2080 |
2081 <p> | 2081 <p> |
2082 If you modify the local menu files in this way, your changes will not | 2082 If you modify the local menu files in this way, your changes will not |
2083 be affected by any future releases. Changes made by SSDT will | 2083 be affected by any future releases. Changes made by SSDT will |
2084 automatically be installed when you copy the distribution menu files to | 2084 automatically be installed when you copy the distribution menu files to |
2113 have other menu systems on your system, you can pass parameters to | 2113 have other menu systems on your system, you can pass parameters to |
2114 BUILD_ALIAS to indicate the location and names of the menu and alias | 2114 BUILD_ALIAS to indicate the location and names of the menu and alias |
2115 files. See the comments in BUILD_ALIAS.COM for more information about | 2115 files. See the comments in BUILD_ALIAS.COM for more information about |
2116 using this procedure. | 2116 using this procedure. |
2117 | 2117 |
2118 <a name="intercept_head"><h1>6.3 Intercepting Menu Actions</h1></a> | 2118 <a name="intercept_head"><h1>Intercepting Menu Actions</h1></a> |
2119 | 2119 |
2120 <p> | 2120 <p> |
2121 Sometimes it is desirable, or necessary, to redefine the action | 2121 Sometimes it is desirable, or necessary, to redefine the action |
2122 associated with a menu item. For instance, you may want to force | 2122 associated with a menu item. For instance, you may want to force |
2123 certain actions prior to running a particular program or force certain | 2123 certain actions prior to running a particular program or force certain |
2242 </pre> | 2242 </pre> |
2243 </table> | 2243 </table> |
2244 | 2244 |
2245 <p> | 2245 <p> |
2246 <hr size=5> | 2246 <hr size=5> |
2247 <a name="batch_mail_chap"><h1>Chapter 7<br>Batch Mail Message System Manager Guide</h1></a> | 2247 <a name="batch_mail_chap"><h1>Batch Mail Message System Manager Guide</h1></a> |
2248 | 2248 |
2249 <a name="heading_7.1"><h1>7.1 Overview</h1></a> | 2249 <a name="heading_7.1"><h1>Overview</h1></a> |
2250 | 2250 |
2251 <p> | 2251 <p> |
2252 The command procedure BATCH_MAIL_MESSAGE.COM can be used to send a VMS | 2252 The command procedure BATCH_MAIL_MESSAGE.COM can be used to send a VMS |
2253 mail message via a batch job. This is useful for messages with large | 2253 mail message via a batch job. This is useful for messages with large |
2254 audiences where the user does not wish to tie up their terminal for an | 2254 audiences where the user does not wish to tie up their terminal for an |
2255 extended period of time. | 2255 extended period of time. |
2256 | 2256 |
2257 <a name="heading_7.2"><h1>7.2 Sending a Mail Message via Batch</h1></a> | 2257 <a name="heading_7.2"><h1>Sending a Mail Message via Batch</h1></a> |
2258 | 2258 |
2259 <p> | 2259 <p> |
2260 To use the command procedure for generic mail messages: | 2260 To use the command procedure for generic mail messages: |
2261 | 2261 |
2262 <p> | 2262 <p> |
2289 </ul> | 2289 </ul> |
2290 | 2290 |
2291 <p> | 2291 <p> |
2292 | 2292 |
2293 <hr size=5> | 2293 <hr size=5> |
2294 <a name="oecn_view_chap"><h1>Chapter 8<br>OECN VIEW Utility</h1></a> | 2294 <a name="oecn_view_chap"><h1>OECN VIEW Utility</h1></a> |
2295 | 2295 |
2296 <a name="heading_8.1"><h1>8.1 Overview</h1></a> | 2296 <a name="heading_8.1"><h1>Overview</h1></a> |
2297 | 2297 |
2298 <p> | 2298 <p> |
2299 The OECN_VIEW utility allows users to view text files on the screen. It | 2299 The OECN_VIEW utility allows users to view text files on the screen. It |
2300 can be used for report files produced by OECN state software or other | 2300 can be used for report files produced by OECN state software or other |
2301 text documents. OECN_VIEW is a TPU based product, layered on DEC/EVE. | 2301 text documents. OECN_VIEW is a TPU based product, layered on DEC/EVE. |
2318 Each entry in the search list must refer to OECN_VIEW_DIRECTORY. | 2318 Each entry in the search list must refer to OECN_VIEW_DIRECTORY. |
2319 | 2319 |
2320 <p> | 2320 <p> |
2321 Examples of the logicals are given below: | 2321 Examples of the logicals are given below: |
2322 | 2322 |
2323 <a name="heading_8.2"><h1>8.2 OECN_VIEW.COM</h1></a> | 2323 <a name="heading_8.2"><h1>OECN_VIEW.COM</h1></a> |
2324 | 2324 |
2325 <p> | 2325 <p> |
2326 The OECN_VIEW.COM command procedure is found in OECN$. It is used to | 2326 The OECN_VIEW.COM command procedure is found in OECN$. It is used to |
2327 define the two logicals, OECN_VIEW_DIRECTORY and OECN_VIEW_FILES. | 2327 define the two logicals, OECN_VIEW_DIRECTORY and OECN_VIEW_FILES. |
2328 Observe the following notes from this procedure. | 2328 Observe the following notes from this procedure. |
2360 | 2360 |
2361 | 2361 |
2362 </pre> | 2362 </pre> |
2363 </table> | 2363 </table> |
2364 | 2364 |
2365 <a name="heading_8.2.1"><h2>8.2.1 Customizing OECN VIEW</h2></a> | 2365 <a name="heading_8.2.1"><h2>Customizing OECN VIEW</h2></a> |
2366 | 2366 |
2367 <p> | 2367 <p> |
2368 The following sample command file shows how to customize the | 2368 The following sample command file shows how to customize the |
2369 directories and the file extensions to be viewed. | 2369 directories and the file extensions to be viewed. |
2370 | 2370 |
2403 | 2403 |
2404 | 2404 |
2405 </pre> | 2405 </pre> |
2406 </table> | 2406 </table> |
2407 | 2407 |
2408 <a name="heading_8.2.2"><h2>8.2.2 Creating a DCL Command</h2></a> | 2408 <a name="heading_8.2.2"><h2>Creating a DCL Command</h2></a> |
2409 | 2409 |
2410 <p> | 2410 <p> |
2411 The VIEW utility works automatically from the MENU. However, you could | 2411 The VIEW utility works automatically from the MENU. However, you could |
2412 define a symbol to execute VIEW from DCL. | 2412 define a symbol to execute VIEW from DCL. |
2413 | 2413 |
2427 </table> | 2427 </table> |
2428 | 2428 |
2429 <p> | 2429 <p> |
2430 Then use the LOOK command from the $ prompt. | 2430 Then use the LOOK command from the $ prompt. |
2431 | 2431 |
2432 <a name="heading_8.2.3"><h2>8.2.3 OECN_EDIT</h2></a> | 2432 <a name="heading_8.2.3"><h2>OECN_EDIT</h2></a> |
2433 | 2433 |
2434 <p> | 2434 <p> |
2435 The OECN_VIEW utility uses a special editor called OECN_EDIT. Its | 2435 The OECN_VIEW utility uses a special editor called OECN_EDIT. Its |
2436 purpose is to provide I/O routines to allow TPU to automatically read | 2436 purpose is to provide I/O routines to allow TPU to automatically read |
2437 and translate VFC files into text. Please see <a href="oecn10_sysman_handbook_full.html#oecn_edit_chap">Chapter 9, OECN EDIT Utility</a>, for more | 2437 and translate VFC files into text. Please see <a href="oecn10_sysman_handbook_full.html#oecn_edit_chap">Chapter 9, OECN EDIT Utility</a>, for more |
2438 details. | 2438 details. |
2439 <p> | 2439 <p> |
2440 | 2440 |
2441 <hr size=5> | 2441 <hr size=5> |
2442 <a name="oecn_edit_chap"><h1>Chapter 9<br>OECN EDIT Utility</h1></a> | 2442 <a name="oecn_edit_chap"><h1>OECN EDIT Utility</h1></a> |
2443 | 2443 |
2444 <a name="heading_9.1"><h1>9.1 Overview</h1></a> | 2444 <a name="heading_9.1"><h1>Overview</h1></a> |
2445 | 2445 |
2446 <p> | 2446 <p> |
2447 OECN_EDIT is a foreign command replacement for the EDIT/TPU DCL | 2447 OECN_EDIT is a foreign command replacement for the EDIT/TPU DCL |
2448 command. It is completely command line (qualifier and parameter) | 2448 command. It is completely command line (qualifier and parameter) |
2449 compatible with EDIT/TPU. Its purpose is to provide I/O routines to | 2449 compatible with EDIT/TPU. Its purpose is to provide I/O routines to |
2454 This is different from the default TPU editor, which ignores VFC | 2454 This is different from the default TPU editor, which ignores VFC |
2455 formatting. OECN_EDIT is used by the OECN_VIEW.COM procedure to allow | 2455 formatting. OECN_EDIT is used by the OECN_VIEW.COM procedure to allow |
2456 VFC files to be viewed correctly. However, it may also be used with any | 2456 VFC files to be viewed correctly. However, it may also be used with any |
2457 TPU section file as an editor. | 2457 TPU section file as an editor. |
2458 | 2458 |
2459 <a name="heading_9.2"><h1>9.2 Using OECN_EDIT</h1></a> | 2459 <a name="heading_9.2"><h1>Using OECN_EDIT</h1></a> |
2460 | 2460 |
2461 <p> | 2461 <p> |
2462 In order to use OECN_EDIT as your interface to TPU, define the | 2462 In order to use OECN_EDIT as your interface to TPU, define the |
2463 following symbol: | 2463 following symbol: |
2464 | 2464 |
2482 EDIT/TPU, such as /SECTION, /UNIT, etc. OECN_EDIT will use the normal | 2482 EDIT/TPU, such as /SECTION, /UNIT, etc. OECN_EDIT will use the normal |
2483 EVE section and initialization files by default. | 2483 EVE section and initialization files by default. |
2484 <p> | 2484 <p> |
2485 | 2485 |
2486 <hr size=5> | 2486 <hr size=5> |
2487 <a name="oecn_keymap_chap"><h1>Chapter 10<br>OECN KEYMAP Utility</h1></a> | 2487 <a name="oecn_keymap_chap"><h1>OECN KEYMAP Utility</h1></a> |
2488 | 2488 |
2489 <a name="heading_10.1"><h1>10.1 Overview</h1></a> | 2489 <a name="heading_10.1"><h1>Overview</h1></a> |
2490 | 2490 |
2491 <p> | 2491 <p> |
2492 The OECN_KEYMAP utility allows users to select a terminal emulator, | 2492 The OECN_KEYMAP utility allows users to select a terminal emulator, |
2493 such as REFLECTIONS, EXCURSIONS, or PERSONA. Using this utility defines | 2493 such as REFLECTIONS, EXCURSIONS, or PERSONA. Using this utility defines |
2494 the logical OECN$KEY_MAP to point to a .INI file containing the desired | 2494 the logical OECN$KEY_MAP to point to a .INI file containing the desired |
2497 keys. That is, from the programs point of view, the user is required to | 2497 keys. That is, from the programs point of view, the user is required to |
2498 press a VT200 F11 for the "Find" function. However, you can assign F11 | 2498 press a VT200 F11 for the "Find" function. However, you can assign F11 |
2499 to any PC key you wish in the emulator and then relabel F11 on the | 2499 to any PC key you wish in the emulator and then relabel F11 on the |
2500 screen to match the PC keyboard. | 2500 screen to match the PC keyboard. |
2501 | 2501 |
2502 <a name="heading_10.2"><h1>10.2 Using KEYMAP</h1></a> | 2502 <a name="heading_10.2"><h1>Using KEYMAP</h1></a> |
2503 | 2503 |
2504 <p> | 2504 <p> |
2505 Upon selecting the KEYMAP option from the OECN menu the user is given a | 2505 Upon selecting the KEYMAP option from the OECN menu the user is given a |
2506 list of keymapping options to select from. This menu of options is | 2506 list of keymapping options to select from. This menu of options is |
2507 built by searching for all files named OECN$KEYMAP*.INI in either the | 2507 built by searching for all files named OECN$KEYMAP*.INI in either the |
2549 to something meaningful to the user as this is what they will see in | 2549 to something meaningful to the user as this is what they will see in |
2550 the KEYMAP menu. | 2550 the KEYMAP menu. |
2551 <p> | 2551 <p> |
2552 | 2552 |
2553 <hr size=5> | 2553 <hr size=5> |
2554 <a name="oecn_setupenv_chap"><h1>Chapter 11<br>OECN SETUPENV Utility</h1></a> | 2554 <a name="oecn_setupenv_chap"><h1>OECN SETUPENV Utility</h1></a> |
2555 | 2555 |
2556 <a name="heading_11.1"><h1>11.1 Overview</h1></a> | 2556 <a name="heading_11.1"><h1>Overview</h1></a> |
2557 | 2557 |
2558 <p> | 2558 <p> |
2559 SETUPENV is a general purpose utility for establishing or switching to | 2559 SETUPENV is a general purpose utility for establishing or switching to |
2560 user environments. The goal of the utility is to provide a single place | 2560 user environments. The goal of the utility is to provide a single place |
2561 to configure the software environment (primarily logicals) for given | 2561 to configure the software environment (primarily logicals) for given |
2587 ability to find and establish contexts. | 2587 ability to find and establish contexts. |
2588 <li>To provide support for common OpenVMS configuration methods in use | 2588 <li>To provide support for common OpenVMS configuration methods in use |
2589 by DA Sites, including group tables and shared logical tables. | 2589 by DA Sites, including group tables and shared logical tables. |
2590 </ol> | 2590 </ol> |
2591 | 2591 |
2592 <a name="heading_11.2"><h1>11.2 Getting Started</h1></a> | 2592 <a name="heading_11.2"><h1>Getting Started</h1></a> |
2593 | 2593 |
2594 <p> | 2594 <p> |
2595 The SETUPENV utility is very flexible allowing the capability to deal | 2595 The SETUPENV utility is very flexible allowing the capability to deal |
2596 with the variety of possible setups in use at the OECN DA Sites. This | 2596 with the variety of possible setups in use at the OECN DA Sites. This |
2597 flexibility leads to a significant number of options in both the DCL | 2597 flexibility leads to a significant number of options in both the DCL |
2604 To get started with SETUPENV it is recommended that a simple OECN$SETUP | 2604 To get started with SETUPENV it is recommended that a simple OECN$SETUP |
2605 file with a minimal set of options for just a few entities be created. | 2605 file with a minimal set of options for just a few entities be created. |
2606 Starting small will give the opportunity to experiment with the utility | 2606 Starting small will give the opportunity to experiment with the utility |
2607 to see how, or if, it can fit into your environment. | 2607 to see how, or if, it can fit into your environment. |
2608 | 2608 |
2609 <a name="heading_11.2.1"><h2>11.2.1 Entity Types</h2></a> | 2609 <a name="heading_11.2.1"><h2>Entity Types</h2></a> |
2610 | 2610 |
2611 <p> | 2611 <p> |
2612 SETUPENV manages a user's context by assuming that any given process | 2612 SETUPENV manages a user's context by assuming that any given process |
2613 will have one context in each of the four entity "types". The current | 2613 will have one context in each of the four entity "types". The current |
2614 types of entities are: | 2614 types of entities are: |
2637 switched automatically. SETUPENV can handle these relationships using | 2637 switched automatically. SETUPENV can handle these relationships using |
2638 the PARENT attribute in the OECN$SETUP file. Please refer to the PARENT | 2638 the PARENT attribute in the OECN$SETUP file. Please refer to the PARENT |
2639 attribute for more information. | 2639 attribute for more information. |
2640 <p> | 2640 <p> |
2641 | 2641 |
2642 <a name="heading_11.2.2"><h2>11.2.2 DCL Command Syntax</h2></a> | 2642 <a name="heading_11.2.2"><h2>DCL Command Syntax</h2></a> |
2643 <br> | 2643 <br> |
2644 | 2644 |
2645 <p> | 2645 <p> |
2646 SETUPENV must be defined as a foreign command: | 2646 SETUPENV must be defined as a foreign command: |
2647 <br> | 2647 <br> |
2851 | 2851 |
2852 <p> | 2852 <p> |
2853 Likewise, when /EMIS is specified, EMIS_SELECT_EPILOGUE and | 2853 Likewise, when /EMIS is specified, EMIS_SELECT_EPILOGUE and |
2854 EMIS_SWITCH_FY will be invoked after successfully selecting a database. | 2854 EMIS_SWITCH_FY will be invoked after successfully selecting a database. |
2855 | 2855 |
2856 <a name="heading_11.3"><h1>11.3 Logicals Created By SETUPENV</h1></a> | 2856 <a name="heading_11.3"><h1>Logicals Created By SETUPENV</h1></a> |
2857 | 2857 |
2858 <p> | 2858 <p> |
2859 After successfully selecting an entry, SETUPENV establishes a series of | 2859 After successfully selecting an entry, SETUPENV establishes a series of |
2860 logicals (OECN$SETUP_*) to describe the current context and to maintain | 2860 logicals (OECN$SETUP_*) to describe the current context and to maintain |
2861 it's own context for subsequent invocations of SETUPENV. These logicals | 2861 it's own context for subsequent invocations of SETUPENV. These logicals |
2931 | 2931 |
2932 <p> | 2932 <p> |
2933 Any of the logicals that do not apply to an entry will not be defined | 2933 Any of the logicals that do not apply to an entry will not be defined |
2934 (e.g. for a parent entry, the siblings logical will not be defined). | 2934 (e.g. for a parent entry, the siblings logical will not be defined). |
2935 | 2935 |
2936 <a name="heading_11.4"><h1>11.4 OECN$SETUP.INI</h1></a> | 2936 <a name="heading_11.4"><h1>OECN$SETUP.INI</h1></a> |
2937 | 2937 |
2938 <p> | 2938 <p> |
2939 The OECN$SETUP initialization file defines the environment for various | 2939 The OECN$SETUP initialization file defines the environment for various |
2940 entities which use OECN (or other) software products. The default | 2940 entities which use OECN (or other) software products. The default |
2941 filename is OECN$CUSTOM:OECN$SETUP.INI. OECN$SETUP may be defined as a | 2941 filename is OECN$CUSTOM:OECN$SETUP.INI. OECN$SETUP may be defined as a |
3119 </tr> | 3119 </tr> |
3120 </table> | 3120 </table> |
3121 </center> | 3121 </center> |
3122 </ul> | 3122 </ul> |
3123 | 3123 |
3124 <a name="heading_11.4.1"><h2>11.4.1 Special "Reset" Entries</h2></a> | 3124 <a name="heading_11.4.1"><h2>Special "Reset" Entries</h2></a> |
3125 | 3125 |
3126 <p> | 3126 <p> |
3127 Prior to setting any given entry, SETUPENV will attempt to process | 3127 Prior to setting any given entry, SETUPENV will attempt to process |
3128 special sections named "$RESET_type". If a $RESET section of the | 3128 special sections named "$RESET_type". If a $RESET section of the |
3129 appropriate type exists in the INI file, it will be processed prior to | 3129 appropriate type exists in the INI file, it will be processed prior to |
3169 The above entry would cause SETUPENV to deassign OECN$DTA and define | 3169 The above entry would cause SETUPENV to deassign OECN$DTA and define |
3170 OECN$OUT to the default directory prior to setting any valid entry. In | 3170 OECN$OUT to the default directory prior to setting any valid entry. In |
3171 general, you should explicitly deassign any logicals in the reset | 3171 general, you should explicitly deassign any logicals in the reset |
3172 section that are defined in any entry of the same type. | 3172 section that are defined in any entry of the same type. |
3173 | 3173 |
3174 <a name="heading_11.4.2"><h2>11.4.2 Sample OECN$SETUP File</h2></a> | 3174 <a name="heading_11.4.2"><h2>Sample OECN$SETUP File</h2></a> |
3175 | 3175 |
3176 <p> | 3176 <p> |
3177 Below is a very simple OECN$SETUP.INI file which defines entries for | 3177 Below is a very simple OECN$SETUP.INI file which defines entries for |
3178 one district and two buildings. The setup file can contain many such | 3178 one district and two buildings. The setup file can contain many such |
3179 entries for as many districts and buildings provided that the entry | 3179 entries for as many districts and buildings provided that the entry |
3227 | 3227 |
3228 <p> | 3228 <p> |
3229 The special $RESET_DISTRICT section is provided to ensure that the | 3229 The special $RESET_DISTRICT section is provided to ensure that the |
3230 district logical get reset appropriately prior to setting an entry. | 3230 district logical get reset appropriately prior to setting an entry. |
3231 | 3231 |
3232 <a name="heading_11.4.3"><h2>11.4.3 Special "APPLICATION" Entries</h2></a> | 3232 <a name="heading_11.4.3"><h2>Special "APPLICATION" Entries</h2></a> |
3233 | 3233 |
3234 <p> | 3234 <p> |
3235 If an entry is defined with one or more APPLICATION attributes, then | 3235 If an entry is defined with one or more APPLICATION attributes, then |
3236 SETUPENV will search for an entry named "$APP_app", where "app" is the | 3236 SETUPENV will search for an entry named "$APP_app", where "app" is the |
3237 application code. This allows logicals, symbols or tables that are | 3237 application code. This allows logicals, symbols or tables that are |
3285 <p> | 3285 <p> |
3286 Application entries do not have a corresponding "reset" section. | 3286 Application entries do not have a corresponding "reset" section. |
3287 Logicals defined in this manner may need to be included in the | 3287 Logicals defined in this manner may need to be included in the |
3288 appropriate "$RESET_type" section to ensure they are reset. | 3288 appropriate "$RESET_type" section to ensure they are reset. |
3289 | 3289 |
3290 <a name="heading_11.4.4"><h2>11.4.4 Special "INCLUDE" Section</h2></a> | 3290 <a name="heading_11.4.4"><h2>Special "INCLUDE" Section</h2></a> |
3291 | 3291 |
3292 <p> | 3292 <p> |
3293 A special section may be specified in any INI file called $INCLUDE. | 3293 A special section may be specified in any INI file called $INCLUDE. |
3294 This section may specify other INI files to be included and processed | 3294 This section may specify other INI files to be included and processed |
3295 with the primary INI file. The $INCLUDE section may only contain "FILE" | 3295 with the primary INI file. The $INCLUDE section may only contain "FILE" |
3349 processing the next file. Therefore, included INI files will always be | 3349 processing the next file. Therefore, included INI files will always be |
3350 processed after the file that included it (although perhaps not | 3350 processed after the file that included it (although perhaps not |
3351 immediately after). In general, you should not depend on files being | 3351 immediately after). In general, you should not depend on files being |
3352 processed in any particular order. | 3352 processed in any particular order. |
3353 | 3353 |
3354 <a name="heading_11.4.5"><h2>11.4.5 Limits</h2></a> | 3354 <a name="heading_11.4.5"><h2>Limits</h2></a> |
3355 | 3355 |
3356 <p> | 3356 <p> |
3357 Certain limits which apply to the OECN$SETUP.INI file are shown in the | 3357 Certain limits which apply to the OECN$SETUP.INI file are shown in the |
3358 table below. Limits are 'per entry' unless otherwise noted. <p> | 3358 table below. Limits are 'per entry' unless otherwise noted. <p> |
3359 | 3359 |
3360 <table border=3> | 3360 <table border=3> |
3361 <caption><a name="Table_11-1"><strong>Table 11-1 wide</strong></a></caption> | 3361 <caption><a name="Table_11-1"><strong> wide</strong></a></caption> |
3362 <tr> | 3362 <tr> |
3363 <th align=center>Attribute </th> | 3363 <th align=center>Attribute </th> |
3364 <th align=center>Maximum Length </th> | 3364 <th align=center>Maximum Length </th> |
3365 <th align=center>Limit </th> | 3365 <th align=center>Limit </th> |
3366 </tr> | 3366 </tr> |
3575 logicals or symbols may exhaust virtual memory. </td> | 3575 logicals or symbols may exhaust virtual memory. </td> |
3576 </tr> | 3576 </tr> |
3577 </table> | 3577 </table> |
3578 </center> | 3578 </center> |
3579 | 3579 |
3580 <a name="heading_11.5"><h1>11.5 EMIS_SELECT Compatibility</h1></a> | 3580 <a name="heading_11.5"><h1>EMIS_SELECT Compatibility</h1></a> |
3581 | 3581 |
3582 <p> | 3582 <p> |
3583 The /EMIS qualifier provides functional compatibility with the | 3583 The /EMIS qualifier provides functional compatibility with the |
3584 EMIS_SELECT.COM procedure. In this mode, SETUPENV will read the | 3584 EMIS_SELECT.COM procedure. In this mode, SETUPENV will read the |
3585 existing OECN$EMIS_DBS file and convert it to equivalent setup entries. | 3585 existing OECN$EMIS_DBS file and convert it to equivalent setup entries. |
3655 work around. </td> | 3655 work around. </td> |
3656 </tr> | 3656 </tr> |
3657 </table> | 3657 </table> |
3658 </center> | 3658 </center> |
3659 | 3659 |
3660 <a name="heading_11.5.1"><h2>11.5.1 Converting OECN$EMIS_DBS to OECN$SETUP</h2></a> | 3660 <a name="heading_11.5.1"><h2>Converting OECN$EMIS_DBS to OECN$SETUP</h2></a> |
3661 | 3661 |
3662 <p> | 3662 <p> |
3663 It is possible to completely convert from using the OECN$EMIS_DBS file | 3663 It is possible to completely convert from using the OECN$EMIS_DBS file |
3664 to corresponding entries in OECN$SETUP.INI. To do so, simply create | 3664 to corresponding entries in OECN$SETUP.INI. To do so, simply create |
3665 sections in the OECN$SETUP file as shown in the previous section. The | 3665 sections in the OECN$SETUP file as shown in the previous section. The |
3694 instead of the current DCL procedure. </td> | 3694 instead of the current DCL procedure. </td> |
3695 </tr> | 3695 </tr> |
3696 </table> | 3696 </table> |
3697 </center> | 3697 </center> |
3698 | 3698 |
3699 <a name="heading_11.6"><h1>11.6 NOACSC Compatiblity</h1></a> | 3699 <a name="heading_11.6"><h1>NOACSC Compatiblity</h1></a> |
3700 | 3700 |
3701 <p> | 3701 <p> |
3702 SETUPENV is similar to the USE, BUNNY, and FROG utilities provided by | 3702 SETUPENV is similar to the USE, BUNNY, and FROG utilities provided by |
3703 NOACSC. In some respects SETUPENV is based on these utilities. While | 3703 NOACSC. In some respects SETUPENV is based on these utilities. While |
3704 SETUPENV is not 100% compatible with these utilities, it does attempt | 3704 SETUPENV is not 100% compatible with these utilities, it does attempt |
3729 | 3729 |
3730 <p> | 3730 <p> |
3731 This should allow SETUPENV to be used without modifying any existing | 3731 This should allow SETUPENV to be used without modifying any existing |
3732 command procedures. | 3732 command procedures. |
3733 | 3733 |
3734 <a name="heading_11.6.1"><h2>11.6.1 USE Compatibliity</h2></a> | 3734 <a name="heading_11.6.1"><h2>USE Compatibliity</h2></a> |
3735 | 3735 |
3736 <p> | 3736 <p> |
3737 If /USE is specified as the first qualifier to SETUPENV, then the | 3737 If /USE is specified as the first qualifier to SETUPENV, then the |
3738 original USE qualifiers are accepted. The table below lists the USE | 3738 original USE qualifiers are accepted. The table below lists the USE |
3739 qualifiers and the corresponding qualifier/behavor for SETUPENV. | 3739 qualifiers and the corresponding qualifier/behavor for SETUPENV. |
3811 </pre> | 3811 </pre> |
3812 </table> | 3812 </table> |
3813 | 3813 |
3814 </ul> | 3814 </ul> |
3815 | 3815 |
3816 <a name="heading_11.6.2"><h2>11.6.2 BUNNY Compatibility</h2></a> | 3816 <a name="heading_11.6.2"><h2>BUNNY Compatibility</h2></a> |
3817 | 3817 |
3818 <p> | 3818 <p> |
3819 If /BUNNY is specified as the first qualifier to SETUPENV, then the | 3819 If /BUNNY is specified as the first qualifier to SETUPENV, then the |
3820 original BUNNY qualifiers are accepted. | 3820 original BUNNY qualifiers are accepted. |
3821 | 3821 |
3924 to set an entry based on the value of an existing logical. | 3924 to set an entry based on the value of an existing logical. |
3925 <li>If /ARCHIVE is specified without a value, the default is the first | 3925 <li>If /ARCHIVE is specified without a value, the default is the first |
3926 ARCHIVE attribute for the selected entry. | 3926 ARCHIVE attribute for the selected entry. |
3927 </ul> | 3927 </ul> |
3928 | 3928 |
3929 <a name="heading_11.6.3"><h2>11.6.3 FROG Compatibility</h2></a> | 3929 <a name="heading_11.6.3"><h2>FROG Compatibility</h2></a> |
3930 | 3930 |
3931 <p> | 3931 <p> |
3932 If /FROG is specified as the first qualifier to SETUPENV, then the | 3932 If /FROG is specified as the first qualifier to SETUPENV, then the |
3933 original FROG qualifiers are accepted. | 3933 original FROG qualifiers are accepted. |
3934 | 3934 |
4026 global procedure. | 4026 global procedure. |
4027 </ul> | 4027 </ul> |
4028 | 4028 |
4029 <p> | 4029 <p> |
4030 | 4030 |
4031 <a name="heading_11.7"><h1>11.7 OECN$SETUPENV API</h1></a> | 4031 <a name="heading_11.7"><h1>OECN$SETUPENV API</h1></a> |
4032 SETUPENV provides a callable API which can be used by programs to | 4032 SETUPENV provides a callable API which can be used by programs to |
4033 select entries. The API parallels the qualifier functions and syntax. | 4033 select entries. The API parallels the qualifier functions and syntax. |
4034 | 4034 |
4035 <a name="heading_11.7.1"><h2>11.7.1 Working Storage Field(s)</h2></a> | 4035 <a name="heading_11.7.1"><h2>Working Storage Field(s)</h2></a> |
4036 | 4036 |
4037 <p> | 4037 <p> |
4038 <center> | 4038 <center> |
4039 <table border=0 width=75%> | 4039 <table border=0 width=75%> |
4040 <tr> | 4040 <tr> |
4098 </pre> | 4098 </pre> |
4099 </table> | 4099 </table> |
4100 | 4100 |
4101 <p> | 4101 <p> |
4102 | 4102 |
4103 <a name="heading_11.7.2"><h2>11.7.2 COBOL Call Arguments</h2></a> | 4103 <a name="heading_11.7.2"><h2>COBOL Call Arguments</h2></a> |
4104 | 4104 |
4105 <table border=0> | 4105 <table border=0> |
4106 <tr> | 4106 <tr> |
4107 <td> | 4107 <td> |
4108 <br> | 4108 <br> |
4139 is, the caller should explictly include the OMITTED keyword. </td> | 4139 is, the caller should explictly include the OMITTED keyword. </td> |
4140 </tr> | 4140 </tr> |
4141 </table> | 4141 </table> |
4142 </center> | 4142 </center> |
4143 | 4143 |
4144 <a name="heading_11.7.3"><h2>11.7.3 Argument Descriptions:</h2></a> | 4144 <a name="heading_11.7.3"><h2>Argument Descriptions:</h2></a> |
4145 | 4145 |
4146 <blockquote> | 4146 <blockquote> |
4147 <strong>WS-FUNCTION (read)</strong> | 4147 <strong>WS-FUNCTION (read)</strong> |
4148 | 4148 |
4149 <blockquote> | 4149 <blockquote> |
4265 <blockquote> | 4265 <blockquote> |
4266 Contains code of archive if one was selected. | 4266 Contains code of archive if one was selected. |
4267 </blockquote> | 4267 </blockquote> |
4268 </blockquote> | 4268 </blockquote> |
4269 | 4269 |
4270 <a name="heading_11.7.4"><h2>11.7.4 Return Status</h2></a> | 4270 <a name="heading_11.7.4"><h2>Return Status</h2></a> |
4271 | 4271 |
4272 <p> | 4272 <p> |
4273 OECN$SETUP returns one of the following conditions: | 4273 OECN$SETUP returns one of the following conditions: |
4274 | 4274 |
4275 <table border=3> | 4275 <table border=3> |
4318 specify a starting entry or valid select type. | 4318 specify a starting entry or valid select type. |
4319 </td> | 4319 </td> |
4320 </tr> | 4320 </tr> |
4321 </table> | 4321 </table> |
4322 | 4322 |
4323 <a name="heading_11.7.5"><h2>11.7.5 Description</h2></a> | 4323 <a name="heading_11.7.5"><h2>Description</h2></a> |
4324 | 4324 |
4325 <p> | 4325 <p> |
4326 The OECN$SETUPENV routine does basically everything that the SETUPENV | 4326 The OECN$SETUPENV routine does basically everything that the SETUPENV |
4327 DCL interface does; however, there are some notable exceptions. Here is | 4327 DCL interface does; however, there are some notable exceptions. Here is |
4328 a list that the callable interface does NOT provide: | 4328 a list that the callable interface does NOT provide: |
4342 </ol> | 4342 </ol> |
4343 | 4343 |
4344 <p> | 4344 <p> |
4345 | 4345 |
4346 <hr size=5> | 4346 <hr size=5> |
4347 <a name="sysman_ump_chap"><h1>Chapter 12<br>Installing and Using UMP - User Mail Profile System</h1></a> | 4347 <a name="sysman_ump_chap"><h1>Installing and Using UMP - User Mail Profile System</h1></a> |
4348 | 4348 |
4349 <a name="heading_12.1"><h1>12.1 Overview</h1></a> | 4349 <a name="heading_12.1"><h1>Overview</h1></a> |
4350 | 4350 |
4351 <p> | 4351 <p> |
4352 The UMP package provides a means for DA-sites to maintain user e-mail | 4352 The UMP package provides a means for DA-sites to maintain user e-mail |
4353 profiles in a standard way. This will provides an efficient means of | 4353 profiles in a standard way. This will provides an efficient means of |
4354 sending mail to a large variety of users across the state. It will also | 4354 sending mail to a large variety of users across the state. It will also |
4355 allows for the creation of an electronic "white pages phone directory" | 4355 allows for the creation of an electronic "white pages phone directory" |
4356 which permits an easy way to lookup an e-mail address for any user on | 4356 which permits an easy way to lookup an e-mail address for any user on |
4357 the OECN network. | 4357 the OECN network. |
4358 | 4358 |
4359 <a name="heading_12.1.1"><h2>12.1.1 Feature List</h2></a> | 4359 <a name="heading_12.1.1"><h2>Feature List</h2></a> |
4360 | 4360 |
4361 <p> | 4361 <p> |
4362 UMP provides the following features: | 4362 UMP provides the following features: |
4363 | 4363 |
4364 <ul> | 4364 <ul> |
4390 <li>Tracks whether the user has modified/updated their own profile. | 4390 <li>Tracks whether the user has modified/updated their own profile. |
4391 Optionally, users who have not updated their own profile will be asked | 4391 Optionally, users who have not updated their own profile will be asked |
4392 if they wish to update their user mail profile during login. | 4392 if they wish to update their user mail profile during login. |
4393 </ul> | 4393 </ul> |
4394 | 4394 |
4395 <a name="heading_12.1.2"><h2>12.1.2 Web Attachments for OECN state-wide mail</h2></a> | 4395 <a name="heading_12.1.2"><h2>Web Attachments for OECN state-wide mail</h2></a> |
4396 | 4396 |
4397 <p> | 4397 <p> |
4398 A special feature of the OECN state-wide lists is the ability to | 4398 A special feature of the OECN state-wide lists is the ability to |
4399 "web-ify" attachments send to the OECN lists. As messages addressed to | 4399 "web-ify" attachments send to the OECN lists. As messages addressed to |
4400 the OECN lists pass through the central OECN mail server, they are | 4400 the OECN lists pass through the central OECN mail server, they are |
4424 attachments for their users. Converting existing users to web | 4424 attachments for their users. Converting existing users to web |
4425 attachments may cause confusion or concerns. Therefore, DA Sites are | 4425 attachments may cause confusion or concerns. Therefore, DA Sites are |
4426 encouraged not to switch existing users to web attachments without | 4426 encouraged not to switch existing users to web attachments without |
4427 training or notification. | 4427 training or notification. |
4428 | 4428 |
4429 <a name="heading_12.1.2.1"><h3>12.1.2.1 Enabling Web Attachments</h3></a> | 4429 <a name="heading_12.1.2.1"><h3>Enabling Web Attachments</h3></a> |
4430 | 4430 |
4431 <p> | 4431 <p> |
4432 Web attachments are only enabled for each DA Site upon request. If you | 4432 Web attachments are only enabled for each DA Site upon request. If you |
4433 wish your users to have the ability to request web attachments, you | 4433 wish your users to have the ability to request web attachments, you |
4434 must set ENABLE_OECN_WEBATTACH to "YES" and send mail to | 4434 must set ENABLE_OECN_WEBATTACH to "YES" and send mail to |
4444 set for your domain. If this parameter is set, then web attachments are | 4444 set for your domain. If this parameter is set, then web attachments are |
4445 already enabled. Note: You can not change OECN$UMP_STANDARD.INI | 4445 already enabled. Note: You can not change OECN$UMP_STANDARD.INI |
4446 yourself. Only the OECN listmaster can make the change that affects the | 4446 yourself. Only the OECN listmaster can make the change that affects the |
4447 OECN mail server. | 4447 OECN mail server. |
4448 | 4448 |
4449 <a name="heading_12.1.3"><h2>12.1.3 Files</h2></a> | 4449 <a name="heading_12.1.3"><h2>Files</h2></a> |
4450 | 4450 |
4451 <p> | 4451 <p> |
4452 The following sections describe the files used and produced by the UMP | 4452 The following sections describe the files used and produced by the UMP |
4453 system. | 4453 system. |
4454 <p> | 4454 <p> |
4581 database. | 4581 database. |
4582 </td> | 4582 </td> |
4583 </tr> | 4583 </tr> |
4584 </table> | 4584 </table> |
4585 | 4585 |
4586 <a name="heading_12.2"><h1>12.2 UMP Menu and Profile Screen</h1></a> | 4586 <a name="heading_12.2"><h1>UMP Menu and Profile Screen</h1></a> |
4587 | 4587 |
4588 <p> | 4588 <p> |
4589 The program may be executed by typing: | 4589 The program may be executed by typing: |
4590 | 4590 |
4591 <p> | 4591 <p> |
4804 | 4804 |
4805 | 4805 |
4806 </pre> | 4806 </pre> |
4807 </table> | 4807 </table> |
4808 | 4808 |
4809 <a name="heading_12.3"><h1>12.3 Startup Procedure</h1></a> | 4809 <a name="heading_12.3"><h1>Startup Procedure</h1></a> |
4810 | 4810 |
4811 <p> | 4811 <p> |
4812 Follow the steps below to install UMP on your system: | 4812 Follow the steps below to install UMP on your system: |
4813 | 4813 |
4814 <ol start=1 > | 4814 <ol start=1 > |
4829 protections on the *.IDX files to W:RW. | 4829 protections on the *.IDX files to W:RW. |
4830 </ol> | 4830 </ol> |
4831 | 4831 |
4832 <p> | 4832 <p> |
4833 | 4833 |
4834 <a name="heading_12.4"><h1>12.4 Loading Initial Data</h1></a> | 4834 <a name="heading_12.4"><h1>Loading Initial Data</h1></a> |
4835 Load existing distribution lists. If using NM style distribution lists, | 4835 Load existing distribution lists. If using NM style distribution lists, |
4836 then use: | 4836 then use: |
4837 <br> | 4837 <br> |
4838 $ @OECN$:IMPORT_NM_LISTS | 4838 $ @OECN$:IMPORT_NM_LISTS |
4839 | 4839 |
4859 Unique usernames will only be added once, and a user will not be | 4859 Unique usernames will only be added once, and a user will not be |
4860 assigned to the same list more than once. Running both imports | 4860 assigned to the same list more than once. Running both imports |
4861 essentially "merges" the NM and PMDF lists. This might be useful if you | 4861 essentially "merges" the NM and PMDF lists. This might be useful if you |
4862 are uncertain which of your lists is more correct. | 4862 are uncertain which of your lists is more correct. |
4863 | 4863 |
4864 <a name="heading_12.5"><h1>12.5 Importing Other Lists</h1></a> | 4864 <a name="heading_12.5"><h1>Importing Other Lists</h1></a> |
4865 | 4865 |
4866 <p> | 4866 <p> |
4867 The IMPORT_NM_LISTS.COM and IMPORT_PMDF_LISTS.COM only import the | 4867 The IMPORT_NM_LISTS.COM and IMPORT_PMDF_LISTS.COM only import the |
4868 standard NM lists or lists created by SWOCA's OECN$MAIL utilities. If | 4868 standard NM lists or lists created by SWOCA's OECN$MAIL utilities. If |
4869 you have other local lists which contain users you want to assign to a | 4869 you have other local lists which contain users you want to assign to a |
4896 OECN$UMP_LOCAL.INI. The final parameter is the file to import. See | 4896 OECN$UMP_LOCAL.INI. The final parameter is the file to import. See |
4897 either IMPORT_NM_LISTS.COM or IMPORT_PMDF_LISTS.COM for examples of | 4897 either IMPORT_NM_LISTS.COM or IMPORT_PMDF_LISTS.COM for examples of |
4898 using UMPIMPORT.EXE. | 4898 using UMPIMPORT.EXE. |
4899 <p> | 4899 <p> |
4900 | 4900 |
4901 <a name="heading_12.6"><h1>12.6 INI File Commands</h1></a> | 4901 <a name="heading_12.6"><h1>INI File Commands</h1></a> |
4902 The following INI commands are used in either the OECN$UMP_LOCAL.INI or | 4902 The following INI commands are used in either the OECN$UMP_LOCAL.INI or |
4903 the OECN$UMP_STANDARD.INI files. The following is a summary of these | 4903 the OECN$UMP_STANDARD.INI files. The following is a summary of these |
4904 commands. See either of these files for more examples of their use. <p> | 4904 commands. See either of these files for more examples of their use. <p> |
4905 | 4905 |
4906 <table border=3> | 4906 <table border=3> |
4907 <caption><a name="Table_12-1"><strong>Table 12-1 Table of INI File Commands</strong></a></caption> | 4907 <caption><a name="Table_12-1"><strong> Table of INI File Commands</strong></a></caption> |
4908 <tr> | 4908 <tr> |
4909 <th align=center> </th> | 4909 <th align=center> </th> |
4910 <th align=center>Command </th> | 4910 <th align=center>Command </th> |
4911 <th align=center> </th> | 4911 <th align=center> </th> |
4912 <th align=center>Fields </th> | 4912 <th align=center>Fields </th> |
5388 * This command can appear at most one time in the Local INI file. | 5388 * This command can appear at most one time in the Local INI file. |
5389 </blockquote> | 5389 </blockquote> |
5390 <hr> | 5390 <hr> |
5391 <p> | 5391 <p> |
5392 | 5392 |
5393 <a name="heading_12.7"><h1>12.7 Export NM and PMDF Style Lists</h1></a> | 5393 <a name="heading_12.7"><h1>Export NM and PMDF Style Lists</h1></a> |
5394 A procedure called OECN$:EXPORT_LISTS.COM to is used to create the NM | 5394 A procedure called OECN$:EXPORT_LISTS.COM to is used to create the NM |
5395 and PMDF style distribution lists and associated aliases. It is | 5395 and PMDF style distribution lists and associated aliases. It is |
5396 recommended that each DAS write a custom DCL procedure which invokes | 5396 recommended that each DAS write a custom DCL procedure which invokes |
5397 EXPORT_LIST.COM which also contains any local commands to add aliases, | 5397 EXPORT_LIST.COM which also contains any local commands to add aliases, |
5398 etc. This procedure should be scheduled to run nightly to keep the | 5398 etc. This procedure should be scheduled to run nightly to keep the |
5508 Alternatively, you can specify the DEFER option in EXPORT_LIST and | 5508 Alternatively, you can specify the DEFER option in EXPORT_LIST and |
5509 write procedure which adds additional aliases prior to moving the | 5509 write procedure which adds additional aliases prior to moving the |
5510 databases into PMDF_TABLE:. | 5510 databases into PMDF_TABLE:. |
5511 </ul> | 5511 </ul> |
5512 | 5512 |
5513 <a name="heading_12.7.1"><h2>12.7.1 Centralized Naming</h2></a> | 5513 <a name="heading_12.7.1"><h2>Centralized Naming</h2></a> |
5514 | 5514 |
5515 <p> | 5515 <p> |
5516 This section describes several ways in which UMP can be used to provide | 5516 This section describes several ways in which UMP can be used to provide |
5517 centrialized naming in a PMDF configuration. Centralized naming | 5517 centrialized naming in a PMDF configuration. Centralized naming |
5518 provides means to provide stable user email addresses regardless of | 5518 provides means to provide stable user email addresses regardless of |
5519 where the users mail is actually being delivered. This section assumes | 5519 where the users mail is actually being delivered. This section assumes |
5520 you are already familar with the basic concepts of centralized naming | 5520 you are already familar with the basic concepts of centralized naming |
5521 in PMDF. | 5521 in PMDF. |
5522 | 5522 |
5523 <a name="heading_12.7.1.1"><h3>12.7.1.1 Remote Mail Boxes</h3></a> | 5523 <a name="heading_12.7.1.1"><h3>Remote Mail Boxes</h3></a> |
5524 | 5524 |
5525 <p> | 5525 <p> |
5526 UMP can provide centralized naming for users who have "remote" | 5526 UMP can provide centralized naming for users who have "remote" |
5527 mailboxes. Using UMP's centralized naming, a user can have an address | 5527 mailboxes. Using UMP's centralized naming, a user can have an address |
5528 such as USER@das.org even if thier mail is being delivered to a | 5528 such as USER@das.org even if thier mail is being delivered to a |
5588 the appropriate file into either PMDF_ALIAS_DATABASE or your directory | 5588 the appropriate file into either PMDF_ALIAS_DATABASE or your directory |
5589 channel. An address rewritten in this manner will be rewritten back to | 5589 channel. An address rewritten in this manner will be rewritten back to |
5590 the username or alias on the UMP profile (not the username in the | 5590 the username or alias on the UMP profile (not the username in the |
5591 mailbox field). | 5591 mailbox field). |
5592 | 5592 |
5593 <a name="heading_12.7.1.2"><h3>12.7.1.2 User Aliases</h3></a> | 5593 <a name="heading_12.7.1.2"><h3>User Aliases</h3></a> |
5594 | 5594 |
5595 <p> | 5595 <p> |
5596 UMP provides the ability to create a user-specific alias independent of | 5596 UMP provides the ability to create a user-specific alias independent of |
5597 the username or actual mailbox. For example, a username of | 5597 the username or actual mailbox. For example, a username of |
5598 "SMITH@nwoca.org" could have an alias of "dave.smith@nwoca.org". | 5598 "SMITH@nwoca.org" could have an alias of "dave.smith@nwoca.org". |
5633 Since the DAS must take additional configuration steps in PMDF to | 5633 Since the DAS must take additional configuration steps in PMDF to |
5634 implement aliases and address reversal, the 'Alias' and 'From' fields | 5634 implement aliases and address reversal, the 'Alias' and 'From' fields |
5635 are disabled by default. The DAS must take explicit action (see below) | 5635 are disabled by default. The DAS must take explicit action (see below) |
5636 to implement this feature. | 5636 to implement this feature. |
5637 | 5637 |
5638 <a name="heading_12.7.1.2.1"><h4>12.7.1.2.1 Implementing User Aliases</h4></a> | 5638 <a name="heading_12.7.1.2.1"><h4>Implementing User Aliases</h4></a> |
5639 | 5639 |
5640 <p> | 5640 <p> |
5641 The following steps must be performed in order to activate the user | 5641 The following steps must be performed in order to activate the user |
5642 alias and address reversal using UMP: | 5642 alias and address reversal using UMP: |
5643 | 5643 |
5651 USER_ALIASES.TXT and USER_REVERSE.TXT files to be loaded into the | 5651 USER_ALIASES.TXT and USER_REVERSE.TXT files to be loaded into the |
5652 appropriate database. See <a href="oecn10_sysman_handbook_full.html#exam_build_proc">Section 12.18, Example Procedure for Periodic Rebuilds</a> for an example procedure which | 5652 appropriate database. See <a href="oecn10_sysman_handbook_full.html#exam_build_proc">Section 12.18, Example Procedure for Periodic Rebuilds</a> for an example procedure which |
5653 invokes EXPORT_LISTS.COM. | 5653 invokes EXPORT_LISTS.COM. |
5654 </ol> | 5654 </ol> |
5655 | 5655 |
5656 <a name="heading_12.8"><h1>12.8 Distribution List Codes</h1></a> | 5656 <a name="heading_12.8"><h1>Distribution List Codes</h1></a> |
5657 | 5657 |
5658 <p> | 5658 <p> |
5659 Each distribution list code has a "type" prefix. The type value allows | 5659 Each distribution list code has a "type" prefix. The type value allows |
5660 distribution lists to be organized into subsets independent of the | 5660 distribution lists to be organized into subsets independent of the |
5661 list's name and allows restrictions to be placed on lists so users only | 5661 list's name and allows restrictions to be placed on lists so users only |
5834 | 5834 |
5835 <p> | 5835 <p> |
5836 This will restrict all type 11 lists to users who are also subscribed | 5836 This will restrict all type 11 lists to users who are also subscribed |
5837 to the standard DAS staff list. | 5837 to the standard DAS staff list. |
5838 | 5838 |
5839 <a name="heading_12.9"><h1>12.9 Auto Conversion of Distribution List Codes (Optional)</h1></a> | 5839 <a name="heading_12.9"><h1>Auto Conversion of Distribution List Codes (Optional)</h1></a> |
5840 | 5840 |
5841 <p> | 5841 <p> |
5842 Because of the features provided by the distribution list types, it may | 5842 Because of the features provided by the distribution list types, it may |
5843 be desirable for DAS's to change their existing distribution list | 5843 be desirable for DAS's to change their existing distribution list |
5844 codes. By default, during the conversion, all distribution list codes | 5844 codes. By default, during the conversion, all distribution list codes |
5885 If you are creating locally written programs to update or report on | 5885 If you are creating locally written programs to update or report on |
5886 user's distribution list codes, it may be confusing to have both the | 5886 user's distribution list codes, it may be confusing to have both the |
5887 old and new codes on file. In this case, you may run the UMPUPDATE | 5887 old and new codes on file. In this case, you may run the UMPUPDATE |
5888 program to force the conversion on all records. | 5888 program to force the conversion on all records. |
5889 | 5889 |
5890 <a name="heading_12.10"><h1>12.10 Defining Local Distribution Lists</h1></a> | 5890 <a name="heading_12.10"><h1>Defining Local Distribution Lists</h1></a> |
5891 | 5891 |
5892 <p> | 5892 <p> |
5893 To define a local distribution list, you need to add several additional | 5893 To define a local distribution list, you need to add several additional |
5894 lines to the OECN$UMP_LOCAL.INI file. | 5894 lines to the OECN$UMP_LOCAL.INI file. |
5895 | 5895 |
5979 one of these sublists will be delivered to anyone on this list and | 5979 one of these sublists will be delivered to anyone on this list and |
5980 anyone on the master list, but not to users on any of the other | 5980 anyone on the master list, but not to users on any of the other |
5981 sublists. Also, mail addressed to the master list will be delivered to | 5981 sublists. Also, mail addressed to the master list will be delivered to |
5982 everyone on any of the sublists. | 5982 everyone on any of the sublists. |
5983 | 5983 |
5984 <a name="heading_12.11"><h1>12.11 Profile Group Management</h1></a> | 5984 <a name="heading_12.11"><h1>Profile Group Management</h1></a> |
5985 | 5985 |
5986 <p> | 5986 <p> |
5987 UMP provides the ability to segregate profiles into <strong>management | 5987 UMP provides the ability to segregate profiles into <strong>management |
5988 groups</strong> and delegate responsibility for the groups to selected | 5988 groups</strong> and delegate responsibility for the groups to selected |
5989 individuals. Once delegated, the group manager has nearly complete | 5989 individuals. Once delegated, the group manager has nearly complete |
6078 of the UMP 'Internet Host/Mailbox' field is critical to ensure proper | 6078 of the UMP 'Internet Host/Mailbox' field is critical to ensure proper |
6079 mail delivery. Likewise, if the DAS uses the 'User Type' field to | 6079 mail delivery. Likewise, if the DAS uses the 'User Type' field to |
6080 control which profiles are sent to the OECN White Pages, then the | 6080 control which profiles are sent to the OECN White Pages, then the |
6081 correct values must be provided to the group manager. | 6081 correct values must be provided to the group manager. |
6082 | 6082 |
6083 <a name="heading_12.12"><h1>12.12 Export DIRECTORY DAEMON File (optional)</h1></a> | 6083 <a name="heading_12.12"><h1>Export DIRECTORY DAEMON File (optional)</h1></a> |
6084 | 6084 |
6085 <p> | 6085 <p> |
6086 You have the option of exporting to a DIRECTORY DAEMON database. | 6086 You have the option of exporting to a DIRECTORY DAEMON database. |
6087 Executing the EXPORT_DD.COM file will produce a file suitable for | 6087 Executing the EXPORT_DD.COM file will produce a file suitable for |
6088 loading into a PMDF DIRECTORY-DAEMON data file. The procedure only | 6088 loading into a PMDF DIRECTORY-DAEMON data file. The procedure only |
6161 | 6161 |
6162 <p> | 6162 <p> |
6163 See the PMDF System Adminstrators Guide for more information about the | 6163 See the PMDF System Adminstrators Guide for more information about the |
6164 directory daemon, channels and pseudo-domains. | 6164 directory daemon, channels and pseudo-domains. |
6165 | 6165 |
6166 <a name="heading_12.13"><h1>12.13 Submit UMP Data to OECN CSO Database</h1></a> | 6166 <a name="heading_12.13"><h1>Submit UMP Data to OECN CSO Database</h1></a> |
6167 | 6167 |
6168 <p> | 6168 <p> |
6169 The CSO nameserver is a public domain software system which allows a | 6169 The CSO nameserver is a public domain software system which allows a |
6170 single database to be built containing name and address information. | 6170 single database to be built containing name and address information. |
6171 The CSO is much flexible and allows client/server access to the | 6171 The CSO is much flexible and allows client/server access to the |
6229 <p> | 6229 <p> |
6230 This line would cause all of NWOCA's users to have an email address of | 6230 This line would cause all of NWOCA's users to have an email address of |
6231 username@po.nwoca.org regardless of their real host. In this way, | 6231 username@po.nwoca.org regardless of their real host. In this way, |
6232 remote users will not learn the real host name (which may change). | 6232 remote users will not learn the real host name (which may change). |
6233 | 6233 |
6234 <a name="heading_12.14"><h1>12.14 Master List/Sub-list Handling</h1></a> | 6234 <a name="heading_12.14"><h1>Master List/Sub-list Handling</h1></a> |
6235 | 6235 |
6236 <p> | 6236 <p> |
6237 Starting with the 29-Aug-95 version of UMPEXPORT, the master lists are | 6237 Starting with the 29-Aug-95 version of UMPEXPORT, the master lists are |
6238 handled differently than in the past. Previously, there were master | 6238 handled differently than in the past. Previously, there were master |
6239 lists which pointed to the respective sub-lists. But this caused | 6239 lists which pointed to the respective sub-lists. But this caused |
6287 will be received by all users who are on the SPT or SJV lists. </td> | 6287 will be received by all users who are on the SPT or SJV lists. </td> |
6288 </tr> | 6288 </tr> |
6289 </table> | 6289 </table> |
6290 </center> | 6290 </center> |
6291 | 6291 |
6292 <a name="heading_12.15"><h1>12.15 UMPCHECK - Verifying UMP Profiles against SYSUAF (Optional)</h1></a> | 6292 <a name="heading_12.15"><h1>UMPCHECK - Verifying UMP Profiles against SYSUAF (Optional)</h1></a> |
6293 | 6293 |
6294 <p> | 6294 <p> |
6295 UMPCHECK is a utility which reads the UMP profiles and compares the | 6295 UMPCHECK is a utility which reads the UMP profiles and compares the |
6296 usernames to the SYSUAF file. It reports usernames which do not exist, | 6296 usernames to the SYSUAF file. It reports usernames which do not exist, |
6297 have been disusered or dismailed. Optionally, UMPCHECK can delete | 6297 have been disusered or dismailed. Optionally, UMPCHECK can delete |
6363 The second parameter indicates the node names of the users to be | 6363 The second parameter indicates the node names of the users to be |
6364 validated against the current SYSUAF. By default, the node names used | 6364 validated against the current SYSUAF. By default, the node names used |
6365 are the current values of the SYS$NODE and SYS$CLUSTER_NODE logicals. | 6365 are the current values of the SYS$NODE and SYS$CLUSTER_NODE logicals. |
6366 <p> | 6366 <p> |
6367 | 6367 |
6368 <a name="heading_12.16"><h1>12.16 UMP_LOGIN - To Prompt Users to Enter Profiles During Login (Optional)</h1></a> | 6368 <a name="heading_12.16"><h1>UMP_LOGIN - To Prompt Users to Enter Profiles During Login (Optional)</h1></a> |
6369 UMP_LOGIN.COM may be run during login to determine if the user has ever | 6369 UMP_LOGIN.COM may be run during login to determine if the user has ever |
6370 modified their own profile. If they have not entered their profile, | 6370 modified their own profile. If they have not entered their profile, |
6371 UMP_LOGIN will ask them if they would like to do so immediately and | 6371 UMP_LOGIN will ask them if they would like to do so immediately and |
6372 place them in the UMP profile. | 6372 place them in the UMP profile. |
6373 | 6373 |
6381 <p> | 6381 <p> |
6382 If you use UMP_LOGIN.COM you may wish to use the VMS INSTALL utility to | 6382 If you use UMP_LOGIN.COM you may wish to use the VMS INSTALL utility to |
6383 install OECN$:UMPMODIFIED.EXE as a known image to speed up the login | 6383 install OECN$:UMPMODIFIED.EXE as a known image to speed up the login |
6384 process. | 6384 process. |
6385 | 6385 |
6386 <a name="heading_12.17"><h1>12.17 UMPID2DIS - Creating Distribution Lists from VMS Identifiers (Optional)</h1></a> | 6386 <a name="heading_12.17"><h1>UMPID2DIS - Creating Distribution Lists from VMS Identifiers (Optional)</h1></a> |
6387 | 6387 |
6388 <p> | 6388 <p> |
6389 UMPID2DIS.EXE is an optional utility which builds PMDF style | 6389 UMPID2DIS.EXE is an optional utility which builds PMDF style |
6390 distribution lists containing all users who hold a specified | 6390 distribution lists containing all users who hold a specified |
6391 identifier. This may be used by sites who wish to build distribution | 6391 identifier. This may be used by sites who wish to build distribution |
6485 add "nwoca_usps-list" "<oecn$ump:nwoca_usps.dis,*,*,postmaster,*, | 6485 add "nwoca_usps-list" "<oecn$ump:nwoca_usps.dis,*,*,postmaster,*, |
6486 USPS" | 6486 USPS" |
6487 <br> | 6487 <br> |
6488 $ EXIT | 6488 $ EXIT |
6489 | 6489 |
6490 <a name="exam_build_proc"><h1>12.18 Example Procedure for Periodic Rebuilds</h1></a> | 6490 <a name="exam_build_proc"><h1>Example Procedure for Periodic Rebuilds</h1></a> |
6491 | 6491 |
6492 <p> | 6492 <p> |
6493 Periodically, each site should run EXPORT_LISTS.COM to update the | 6493 Periodically, each site should run EXPORT_LISTS.COM to update the |
6494 distribution lists from the UMP data. Most likely you will want to run | 6494 distribution lists from the UMP data. Most likely you will want to run |
6495 EXPORT_LISTS nightly. You should also run it anytime that you recreate | 6495 EXPORT_LISTS nightly. You should also run it anytime that you recreate |
6663 </pre> | 6663 </pre> |
6664 </table> | 6664 </table> |
6665 | 6665 |
6666 <p> | 6666 <p> |
6667 | 6667 |
6668 <a name="heading_12.19"><h1>12.19 Multiple Non-Clustered Systems</h1></a> | 6668 <a name="heading_12.19"><h1>Multiple Non-Clustered Systems</h1></a> |
6669 DAS's with a single VMS system, or a single VMS cluster, need not be | 6669 DAS's with a single VMS system, or a single VMS cluster, need not be |
6670 concerned with this section. | 6670 concerned with this section. |
6671 | 6671 |
6672 <p> | 6672 <p> |
6673 The UMP system is currently designed assuming that each A-site will | 6673 The UMP system is currently designed assuming that each A-site will |
6728 UMP files, and you will end up with a central DAS-wide database to | 6728 UMP files, and you will end up with a central DAS-wide database to |
6729 build your distribution lists from. The server node will be the only | 6729 build your distribution lists from. The server node will be the only |
6730 one that needs to run the EXPORT_LISTS.COM to produce the mail_ and | 6730 one that needs to run the EXPORT_LISTS.COM to produce the mail_ and |
6731 oecn_ for your DAS. | 6731 oecn_ for your DAS. |
6732 | 6732 |
6733 <a name="heading_12.20"><h1>12.20 Programming Considerations</h1></a> | 6733 <a name="heading_12.20"><h1>Programming Considerations</h1></a> |
6734 | 6734 |
6735 <p> | 6735 <p> |
6736 DAS programmers may wish to use DTR, COBOL or other high level language | 6736 DAS programmers may wish to use DTR, COBOL or other high level language |
6737 to query or manipulate the UMP data files. This section contains a | 6737 to query or manipulate the UMP data files. This section contains a |
6738 brief description of the UMP data files and special considerations. DTR | 6738 brief description of the UMP data files and special considerations. DTR |
6771 Distribution_list_code | 6771 Distribution_list_code |
6772 </td> | 6772 </td> |
6773 </tr> | 6773 </tr> |
6774 </table> | 6774 </table> |
6775 | 6775 |
6776 <a name="heading_12.20.1"><h2>12.20.1 Field Requirements</h2></a> | 6776 <a name="heading_12.20.1"><h2>Field Requirements</h2></a> |
6777 | 6777 |
6778 <p> | 6778 <p> |
6779 Some fields in UMP may display to the user differently than is | 6779 Some fields in UMP may display to the user differently than is |
6780 physically stored in the file. Other fields have specific requirements. | 6780 physically stored in the file. Other fields have specific requirements. |
6781 Please note the following: | 6781 Please note the following: |
6802 </ul> | 6802 </ul> |
6803 | 6803 |
6804 <p> | 6804 <p> |
6805 | 6805 |
6806 <hr size=5> | 6806 <hr size=5> |
6807 <a name="vfc2pdf_chap"><h1>Chapter 13<br>VFC2PDF - Converting Text Files to PDF Format</h1></a> | 6807 <a name="vfc2pdf_chap"><h1>VFC2PDF - Converting Text Files to PDF Format</h1></a> |
6808 | 6808 |
6809 <p> | 6809 <p> |
6810 VFC2PDF converts VFC or plain text files into PDF (Portable Document | 6810 VFC2PDF converts VFC or plain text files into PDF (Portable Document |
6811 Format) files. After a report is converted to PDF format, it can be | 6811 Format) files. After a report is converted to PDF format, it can be |
6812 transferred to a PC or a MAC. It can also be viewed or printed using | 6812 transferred to a PC or a MAC. It can also be viewed or printed using |