generation differences in the output file. This option is only applicable if two generations are being compared in the differences transaction. 4 D_go_tb =TITLE Output File Field Fill in the Output File field with the name of a file to which CMS should write the differences output. If you do not specify a file name in the Output File field, CMS creates a file with the Primary Input Element/File name and the file type .DIF in your default directory. You can also choose the Appended option; this option appends the output to the existing file. 4 D_ab =TITLE Appended Button Click on the Appended button to control whether CMS appends the differences output to an existing file or creates a new file. If you choose Appended and the output file does not exist, CMS creates a new file. If you do not provide an output file specification, CMS searches your default directory for a file with the Primary Input Element/File name and the file type .DIF. 4 D_op_pb =TITLE Options Button Click on the Options button to bring up a dialog box, allowing you to specify the following options in the library: o Characters to be ignored during the comparison o Lines of text to be ignored during the comparison o Whether the output is formatted, and the type of formatting 5 D_odi =TITLE Ignore Options The Ignore options allow you to choose a keyword that specifies the type of character to be ignored during the comparison. You can choose one or more of the following keywords: o Case o Formfeeds o Spacing o Leading blanks o Trailing blanks o History o Notes 6 D_ic =TITLE Case Button Click on the Case button to direct CMS to ignore case-sensitivity (A through Z, a through z) during the differences comparison. 6 D_ifo =TITLE Formfeeds Button Click on the Formfeeds button to direct CMS to ignore formfeed characters as it compares records from the two files. The formfeeds remain in the output file, but are disregarded for the differences comparison. 6 D_is =TITLE Spacing Button Click on the Spacing button to direct CMS to compress multiple blanks and tabs into a single space as it compares records from the two files. The blanks and tabs remain in the output file, but are disregarded for the differences comparison. 6 D_ilb =TITLE Leading Blanks Button Click on the Leading Blanks button to direct CMS to ignore leading blanks and tabs as it compares records from the two files. The blanks and tabs remain in the output file, but are disregarded for the differences comparison. 6 D_itb =TITLE Trailing Blanks Button Click on the Trailing Blanks button to direct CMS to ignore trailing blanks and tabs as it compares records from the two files. The blanks and tabs remain in the output file, but are disregarded for the differences comparison. 6 D_iho =TITLE History Button Click on the History button to direct CMS to ignore element generation history as it compares a file with a generation. At least one of the files must be an element generation with the History attribute enabled. The history text is ignored for the differences comparison and is removed from the output file. 6 D_ino =TITLE Notes Button Click on the Notes button to direct CMS to ignore notes as it compares a file with a generation. At least one of the files must be an element generation with the notes attribute enabled. The notes text is ignored for the differences comparison and is removed from the output file. 5 D_sk =TITLE Skip Lines Button Click on the Skip lines button to indicate the number of lines at the beginning of each file (or generation) that are to be ignored during the comparison of both files. You must specify a nonnegative integer value indicating the number of lines to be ignored. 5 D_skt =TITLE Skip Text Delimited By Option The Skip text delimited by option allows you to specify a pair of strings used to delimit a section of text to be ignored during the comparison of both files. The delimiters cannot exceed 256 characters each, and must be unique. Any text between and including the delimiters is treated as if it did not exist. Sentinel strings may contain any characters, but if you include spaces or tabs, the entire string must be enclosed in quotation marks. 5 Dof =TITLE Output Format The Output Format options control whether the history and source file listing is formatted. You must specify the type of formatting and data partition. The formatting types include: o ASCII o Decimal o Hexadecimal o Octal 6 Das =TITLE ASCII Button Click on the ASCII button to specify that each byte of data be displayed as an ASCII character. ASCII is most useful when files contain textual data. 6 Dcf =TITLE Decimal Button Click on the Decimal button to specify that each value be displayed as a decimal numeral. If you specify decimal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 6 Dhf =TITLE Hexadecimal Button Click on the Hexadecimal button to specify that each value be displayed as a hexadecimal numeral. If you specify hexadecimal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 6 Doff =TITLE Octal Button Click on the Octal button to specify that each value be displayed as an octal numeral. If you specify Octal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 5 Dop =TITLE Output Partition The Output Partition options control whether the history and source file listing is formatted. You must specify the type of formatting and data partition. The data partition types include: o Records o Byte o Word o Long 6 Dro =TITLE Records Button Click on the Records button to specify that no further partitioning of data is to occur beyond the record partitioning already in the file. This partitioning is most useful when the files contain textual data. You can only specify Records by itself or in conjunction with the ASCII Output Format. 6 Dpo =TITLE Byte Button Click on the Byte button to specify that the data displayed is to be partitioned into bytes. 6 Dwp =TITLE Word Button Click on the Word button to specify that the data displayed is to be partitioned into word values. 6 Dlp =TITLE Long Button Click on the Long button to specify that the data displayed is to be partitioned into longword values. This is the default partitioning for Decimal, Hexadecimal, and Octal Output Formats. 3 D_cmi =TITLE Class Differences... Menu Item Choose the Class Differences... menu item to compare the contents of two classes. If CMS finds differences, it creates a file that contains the generations that differ between them, and delivers a copy of the file to your current default directory. If the contents of the classes are the same, CMS issues a message to that effect and does not create a differences file. If you have turned off the Differences Only button, CMS still creates a file, even if there are no differences. 4 D_p =TITLE Primary Input The Primary Input region includes a Selected field, and a Class field. The Primary Input region is associated with information about the first class to be compared. 4 D_sf =TITLE Selected Field If you click on an object or objects before choosing the Class Differences... menu item, the Selected field contains those objects. CMS performs the differences transaction on the selected objects. 4 D_pi =TITLE Primary Input Class Field Fill in the Primary Input Class field with the name of the first class to be compared. 4 D_sis =TITLE Secondary Input The Secondary Input region includes a Class field. The Secondary Input region is associated with information about the second class to be compared. You must supply an object name in the Class field. 4 D_si =TITLE Secondary Input Class Field The Secondary Input Class field specifies the second class to be compared. 4 D_op =TITLE Output Options You can specify the following options on the differences transaction: o Whether the differing generation names from the two classes are formatted vertically (side by side) instead of horizontally (line by line) o Whether just the differences are listed or not o The width of the differences report 5 D_po =TITLE Parallel Button Click on the Parallel button to control whether the differing generation names from the two classes are formatted side by side. The differences from the first class are displayed on the left and the differences from the second class are displayed on the right. 5 D_w =TITLE Width Option Click on the Width button to control the limit for the width of the differences report. The value can be from 48 to 511, inclusive. If you do not supply a width in the Width field, CMS uses 80 by default. 5 D_od =TITLE Differences Only Option When this button is activated, CMS creates a file that contains only the generation names that differ between the two classes. 4 D_go_tb =TITLE Output File Field Fill in the Output File field with the name of a file to which CMS should write the differences output. If you do not specify a file name in the Output File field, CMS creates a file with the Primary Input Class name and the file type .DIF in your default directory. You can also choose the Appended option; this option appends the output to the existing file. 4 D_ab =TITLE Appended Button Click on the Appended button to control whether CMS appends the differences output to an existing file or creates a new file. If you choose Appended and the output file does not exist, CMS creates a new file. If you do not provide an output file specification, CMS searches your default directory for a file with the Primary Input Class name and the file type .DIF. 4 D_op_pb =TITLE Options Button Click on the Options button to bring up a dialog box, allowing you to specify the following options in the library: o Generation name differences to be shown during the comparision o Generation name differences to be ignored during the comparison 5 D_ods =TITLE Show Options The Show options allow you to choose what sort of generation name differences should be shown during the comparison. You can choose one or more of the following options: o Element Differences o Generation Differences o Variant Differences 6 D_ed =TITLE Element Differences Click on the Element Differences button to direct CMS to show the difference if there is a generation of an element in one class but no generation of that element in the other class. 6 D_gd =TITLE Generation Differences Click on the Generation Differences button to direct CMS to show the difference if the generation in one class differs from the generation in the other class but one generation isn't a variant of the other generation. 6 D_vd =TITLE Variant Differences Click on the Variant Differences button to direct CMS to show the difference if the generation in one class differs from the generation in the other class and one generation is a variant of the other. One generation will be a variant of the other if at some point in the path between one generation and the other a generation is reserved and replaced with a variant specified. 5 D_ig =TITLE Ignore Options The Ignore options allow you to choose what sort of generation name differences should be ignored during the comparison. Currently the only option possible is the following: o First Variant 6 D_fv =TITLE First Variant Click on the First Variant button to direct CMS to ignore any differences where the generation in one class is the first variant of the generation in the other class. For example generation 2C1 is a first variant of generation 2 and generation 4B6D1 is a first variant of generation 4B6. 3 A_mi =TITLE Annotate... Menu Item Choose the Annotate... menu item to create a line-by-line file listing of the changes made to each specified element generation; CMS places this file in your current default directory or a directory you specify. The annotate transaction documents the development of an element, and creates an output file that contains an annotated listing; unless you specify a different name, CMS names the file name the same as the element name and the file type is .ANN. The annotated listing file contains two parts: o A history o A source file listing The history includes the following: o Generation number o Date, time, user, and remark associated with each generation of the element The source file listing includes the following: o All lines inserted or modified from generation 1 to the specified generation. 4 A_sf =TITLE Selected Box If you click on an object or objects before choosing the Annotate... menu item, the Selected box contains those objects. CMS performs the annotate transaction on the selected objects. 4 A_ef =TITLE Element Field =INCLUDE Overview Using_Elements Fill in the Element field with the name of the object or objects you want annotated. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas. If you specify a group name, CMS annotates each element in the group. If you use wildcards, CMS produces one annotated listing file for each matching element. By default, CMS annotates the most recent generation on the main line of descent of each element. If you want to annotate a specific generation of the element, you must also specify the generation number in the Generation field. 4 A_gf =TITLE Generation Field =INCLUDE Overview Using_Elements Fill in the Generation field with the number of the generation you want annotated. For example, 3B2. If you omit this field, CMS by default annotates the most recent generation on the main line of descent. 4 A_mg =TITLE Merge Generation Field Fill in the Merge Generation field with the number of the generation to be merged into the retrieved generation. The merge transaction combines two generations of an element and creates a single file that contains the annotated listing. The file contains text common to both generations. When changes that are not identical are made in the same position of the common ancestor, the changes from both generations are included in the resulting file and are marked as a conflict. 4 A_fa =TITLE Full Annotation Button Click on the Full Annotation button to direct CMS to include all of the following information about the file used to create each generation: o Creation time o Revision time o Revision number o Record format o Record attributes o Deleted lines 4 A_of =TITLE Output Format Options The Output Format options control whether the history and source file listing is formatted. You must specify the type of formatting and data partition. The formatting types include: o ASCII o Decimal o Hexadecimal o Octal 5 A_ii =TITLE ASCII Button Click on the ASCII button to specify that each byte of data be displayed as an ASCII character. ASCII is most useful when files contain textual data. 5 A_dc =TITLE Decimal Button Click on the Decimal button to specify that each value be displayed as a decimal numeral. If you specify decimal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 5 A_hx =TITLE Hexadecimal Button Click on the Hexadecimal button to specify that each value be displayed as a hexadecimal numeral. If you specify hexadecimal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 5 A_oc =TITLE Octal Button Click on the Octal button to specify that each value be displayed as an octal numeral. If you specify octal output, you cannot also specify Records as an Output Partition. By default, data is partitioned into longwords. 4 A_op =TITLE Output Partition Options The Output Partition options control whether the history and source file listing is formatted. You must specify the type of formatting and data partition. The data partition types include: o Records o Byte o Word o Long 5 A_rc =TITLE Records Button Click on the Records button to specify that no further partitioning of data is to occur beyond the record partitioning already in the file. This partitioning is most useful when the files contain textual data. You can only specify Records by itself or in conjunction with the ASCII Output Format. 5 A_bp =TITLE Byte Button Click on the Byte button to specify that the data displayed is to be partitioned into bytes. 5 A_wp =TITLE Word Button Click on the Word button to specify that the data displayed is to be partitioned into word values. 5 A_lg =TITLE Long Button Click on the Long button to specify that the data displayed is to be partitioned into longword values. This is the default partitioning for Decimal, Hexadecimal, and Octal Output Formats. 4 A_dfn =TITLE Output File Field Fill in the Output File field with the name of a file to which CMS should write the annotated output. If you do not specify a file name in the Output File field, CMS creates a file with the element name and the file type .ANN in your default directory. You can also choose the Appended option, which appends the output to the existing file. You may annotate multiple elements by using wildcards, a comma list, or a group name; however, if you do not specify wildcards in the output file, CMS creates successive versions of the file. 4 A_atb =TITLE Appended Button Click on the Appended button to control whether CMS appends the history and source file listing to an existing file or creates a new file. If you choose Appended and the output file does not exist, CMS creates a new file. If you do not provide an output file specification, CMS searches your default directory for a file with the element file name and the file type .ANN. 2 C_m =TITLE Options Menu The Options menu allows you to tailor the CMS session by performing the following: o Enter CMS command-line mode o Specify options for the display of messages o Open a specific library (or libraries) each time you invoke CMS o Set up a list of known libraries for easy reference o Set a default view to be displayed each time you invoke CMS o Set default occlusion information o Specify default restrictions for each view type o Save and restore customized options Note that some customizations will take effect immediately, while others may take effect the next time you invoke the associated view, and still others take effect the next time you invoke the CMS DECwindows interface (for example, the Initial Library menu item). To save options, choose the Save Options menu item. 3 Sh_cm =TITLE Show Command... Menu Item Choose the Show Command... menu item to enter CMS command-line commands at the CMS prompt. The output appears in the CMS Command window. When you choose the Show Command... menu item, a dialog box appears with a display window, a smaller input window containing the CMS prompt (CMS>), and the Clear Command Window and Cancel buttons. 4 Sh_co =TITLE CMS Command Output Window The CMS Command output window displays the output when you enter CMS commands at the CMS prompt (CMS>). 4 Sh_iw =TITLE CMS Command Input Window Enter commands in the CMS command-line interface by typing them at the CMS prompt (CMS>). Command output is displayed in the main window. 4 Sh_cl =TITLE Clear Command Window Button Click on the Clear Command Window button to clear the contents of the output window. 3 Ml_mi =TITLE Message Logging... Menu Item =INCLUDE msg_box Choose the Message Logging... menu item to direct CMS to display error, success, and informational messages using the options you choose. 4 Ml_wipb =TITLE Operation Status Box Button =INCLUDE msg_box Choose the Operation Status Box button to direct CMS to display all messages in a operation status box during your CMS session. 4 Ml_cmwb =TITLE Command Window Button =INCLUDE msg_box Choose the Command Window button to direct CMS to display all informational messages interactively in the Show Command... window. CMS automatically pops up the Show Command... window when you choose this option. 4 Ml_cm_ifv =TITLE Command Window if Visible Button =INCLUDE msg_box Choose the Command Window if Visible button to direct CMS to display all informational messages in the Show Command... window only when you have the Show Command... window currently opened. 4 Ml_nne =TITLE None Button =INCLUDE msg_box Choose the None button to prevent CMS from displaying any informational messages. 3 Cm_il_mi =TITLE Initial Library... Menu Item =INCLUDE M L_m Ol_mi Choose the Initial Library... menu item to specify a library or libraries to be automatically opened each time you invoke CMS. When you choose Initial Library..., a dialog box appears, allowing you to specify one or more library specifications. 4 Il_lsf =TITLE Library Specification Field Fill in the Library Specification field with the name of the library (or libraries) that you want automatically opened each time you invoke CMS. You can specify multiple libraries to be opened; separate each library name with a comma. 3 Kl_mi =TITLE Known Libraries... Menu Item =INCLUDE M L_m Ol_mi =INCLUDE M L_m Ol_mi Ol_db =INCLUDE M L_m Ol_mi Ol_db Ol_klf Choose the Known Libraries... menu item to specify multiple library names that CMS stores and displays each time you enter CMS. When you enter CMS, the libraries you specified are shown in the Open Library dialog box. To open one of the known libraries, do the following: 1. Pull down the Library menu. 2. Pull down the Open... submenu; the Open Library dialog box appears. 3. Double click on the desired library displayed in the Known Libraries box. 4 Kl_f =TITLE Known Libraries Box =INCLUDE M C_m Kl_mi Kl_lsf =INCLUDE M L_m Ol_mi =INCLUDE M L_m Ol_mi Ol_db =INCLUDE M L_m Ol_mi Ol_db Ol_klf The Known Libraries box displays all the known libraries that you specified in the Library Specification(s) field. The libraries you specify are then displayed in the Open Library dialog box each time you enter CMS. Double click on one or more of the known libraries to open the library. Double click on the Library Specification(s) field from the additional topics below for more information on entering library specifications. 4 Kl_lsf =TITLE Library Specification(s) Field =INCLUDE M C_m Kl_mi Kl_f Fill in the Library Specification(s) field with one or more library specifications. To specify a library search list, enter the library specifications on one line, separating each specification with a comma. When you double click on the search list from the Known Libraries box in the Open Library dialog box, CMS opens the entire search list. To specify individual library names, enter a single library specification, then choose the Add button. Do this for each library specification. Each time you choose the Add button, CMS adds each name in list form to the Known Libraries box. You can specify up to ten libraries in the Known Libraries field. 4 Kl_apb =TITLE Known Libraries Add Button Click on the Add button to add the specified library or libraries to the Known Libraries box. CMS automatically adds the new library (or libraries) to the beginning of the library list. 4 Kl_re_pb =TITLE Known Libraries Remove Button Click on the Remove button to remove one or more libraries from the Known Libraries box. First choose the library or libraries to be removed; then choose the Remove button. The remove transaction does not delete the library; however, it removes the library from the immediate list of known libraries. 3 Vw_mi =TITLE View... Menu Item =INCLUDE M V_m Choose the View... menu item to specify the default view you want displayed each time you invoke CMS. You can specify one of the following views: o Element o Group o Class o Reservation o History o Review o Command You can also specify the style in which CMS should display the view: o Textual o Outline o Tree You can also specify a preference for LSE to display (or not display) each file fetched or reserved. 4 Vw_cv_ef =TITLE Element View Button =INCLUDE M V_m Vev_mi Click on the Element button to direct CMS to display an element view each time you enter CMS or open a new view. CMS displays the element view by default. To further tailor the element view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the element view. 4 Vw_cv_gf =TITLE Group View Button =INCLUDE M V_m Vgv_mi Click on the Group button to direct CMS to display a group view each time you enter CMS or open a new view. To further tailor the group view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the group view. 4 Vw_cf =TITLE Class View Button =INCLUDE M V_m Vcv_mi Click on the Class button to direct CMS to display a class view each time you enter CMS or open a new view. To further tailor the class view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the class view. 4 Vw_rf =TITLE Reservation View Button =INCLUDE M V_m Vrv_mi Click on the Reservation button to direct CMS to display a view of current reservations each time you enter CMS or open a new view. To further tailor the reservations view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the reservation view. 4 Vw_hf =TITLE History View Button =INCLUDE M V_m Vhv_mi Click on the History button to direct CMS to display a view of the library history each time you enter CMS or open a new view. To further tailor the history view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the history view. 4 Vw_rrf =TITLE Review View Button =INCLUDE M M_M Rw_mi =INCLUDE M V_m Vrev_mi Click on the Review button to direct CMS to display a view of generations currently on the review pending list each time you enter CMS or open a new view. To further tailor the review view, do the following: 1. Pull down the View menu. 2. Pull down the Restrict... menu item. 3. Choose the desired options for the review view. 4 Vw_cof =TITLE Command View Button =INCLUDE M V_m Vcc_mi Click on the Command button to direct CMS to display a list of CMS commands each time you enter CMS or open a new view. The list contains the commands on which access control lists (ACLs) can be placed. Double click on a command name to display any ACLs on the command. 4 Vw_text =TITLE Display Style Options =INCLUDE M V_m The Display Style options direct CMS to display the startup view using the method you specify. You can choose one of the following buttons: o Textual--directs CMS to display the startup view in textual-outline form. This is the default. o Outline--directs CMS to display the startup view in vertical-outline form. Click on the navigational icon to pop up the CMS Navigation Window. The navigational icon is located in the lower right-hand corner of the view window. o Tree--directs CMS to display the startup view in a tree structure. Click on the navigational icon to pop up the CMS Navigation Window. The navigational icon is located in the lower right-hand corner of the view window. 4 Vw_lse =TITLE LSE Views Options =INCLUDE M V_m The LSE Views Options give the CMS user the option of having LSE open a new buffer for each file fetched or reserved. LSE must already be running in order for these buffers to be opened. You can choose one or more of the following buttons: o Fetch--directs LSE to open a new buffer for each file fetched. This is the default. o Reserve-- directs LSE to open a new buffer for each file reserved. This is the default. 3 Cust_rest_opt =TITLE Restrict Submenu =INCLUDE M V_m Rv_mi Choose the Restrict submenu to customize the display of options for the view type you specify. Using the Restrict submenu is equivalent to using command-line interface SHOW commands. Use the Restrict submenu to restrict the display of options *before* you display a view. 3 Cu_sa_mi =TITLE Save Options Menu Item Choose the Save Options menu item to store your current customizations. 3 Cu_sa =TITLE Restore Options Menu Item Choose the Restore Options menu item to restore customizations that have been previously stored with the Save Options menu item. Choose this button to restore your original customizations if you have temporarily changed (overridden) customizations in the current session. 3 Cu_sy_a =TITLE Restore System Options Menu Item Choose the Restore System Options menu item to enable system-wide defaults, thus overriding any current customizations.