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 &quot;standard&quot; identifiers. Three possible identifiers 1717 are the &quot;standard&quot; 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>&nbsp;</th> 4909 <th align=center>&nbsp;</th>
4910 <th align=center>Command </th> 4910 <th align=center>Command </th>
4911 <th align=center>&nbsp;</th> 4911 <th align=center>&nbsp;</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" "&lt;oecn$ump:nwoca_usps.dis,*,*,postmaster,*, 6485 add "nwoca_usps-list" "&lt;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