Choose the Fetch... menu item to retrieve a copy of the specified object or objects from the CMS library. The object can be an element name, a group name (CMS will fetch the most recent generations of elements in the group), a wildcard expression, or a list of these separated by commas. CMS fetches the most recent generation on the main line of descent unless you fill in the Generation field. Fetch delivers a copy of the specified generations to your current default directory. The generation is not reserved, and CMS does not allow you to replace it. CMS allows you to fetch a generation that is already reserved, and notifies you of any current generation reservations for the element. If a version of a file with the same name as the element already exists in your current default directory when you execute the fetch transaction, CMS notifies you. A new version is then created with the next higher version number.
1 – F sf
If you click on an object or objects before choosing the Fetch... menu item, the Selected box contains those objects. CMS performs the fetch transaction on the selected objects.
2 – F ef
Fill in the Element field with the name of the object or objects you want retrieved. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas. By default, CMS retrieves the most recent generation on the main line of descent of each element. If you want to fetch a specific generation of the element, you must specify the generation number in the Fetch Generation field.
3 – F gf
Fill in the Generation field with the number of the generation you want retrieved. For example, 3B2. If you omit this field, CMS by default fetches the most recent generation on the main line of descent.
4 – F rf
Fill in the Remark field with text to be associated with the transaction and logged in the history file with this fetch transaction.
5 – F opb
Click on the Options button to bring up a dialog box, allowing you to specify the following options in the library: o Whether to write the element out to a differently named file o Whether to merge generations of an element o Whether to include notes and history information when the element is fetched
5.1 – F of
Click on the Output File button to direct CMS to write output to a specified file; you must supply a file specification in the Output File field. If you omit the file specification in the Output File field, CMS creates a file in your default directory with the same name as the element. If you specify multiple elements (by using wildcards, a comma list, or a group name) and you do not specify wildcards in the Output File field, CMS creates successive versions of the file and places the files in your default directory.
5.2 – F mg
Click on the Merge Generation button to specify that another generation of the element (called the merge generation) is to be merged with the generation being fetched (called the retrieved generation). Fill in the Merge Generation field with the number of the merge generation. CMS merges the lines of the two generations and delivers a single copy of the file to your default directory. The merge generation cannot be on the same line of descent as the retrieved generation. When there is a conflict between blocks of one or more lines, CMS includes the conflicting lines and flags the conflict.
5.3 – F na
The Notes attribute controls the inclusion of notes in the output file when you fetch the element (or generation). Specifying options for the Notes attribute for this fetch transaction temporarily establishes the Notes attribute for the element, regardless of whether the element previously had the Notes attribute enabled. To display the current default notes attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
5.3.1 – F nd
Click on the Default button to direct CMS to append notes to the output file as it is retrieved by the fetch transaction, depending on the default you have set up for the element using the New Element... menu item under the File menu, or the Modify Element... menu item under the Maintenance menu.
5.3.2 – F nn
Click on the None button to prevent CMS from embedding any notes in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or the Modify Element... menu item under the Maintenance menu.
5.3.3 – F nfo
Click on the Format button to direct CMS to append notes to the lines of the file. You may also specify a format field string. If you specify a format field string, CMS temporarily overrides any default format field string you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu. The format string specifies the format of the note. The string can contain text or the character #G (lowercase is allowed). To include a quotation mark in the notes string, type it twice (""). To include a number sign in the notes string, type it twice (##). If you click on the Format button and the element you are fetching was not created or modified with the Notes attribute on, then you must also specify a number in the Position field.
5.3.4 – F c
Fill in the Position field with the column number in which the note is to be placed. If you specify the Format option, then you must also specify a Position number. The Position number can be any integer in the range 1 to 511. By default, CMS places notes in column 80.
5.4 – F hd
Choose the History attribute to control the inclusion of the history records in the output file when you fetch the element (or generation). Specifying options for the History attribute for this fetch transaction temporarily establishes the history attribute for the element, regardless of whether the element previously had the Notes attribute enabled. To display the current default History attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
5.4.1 – F hd pb
Click on the Default button to specify that history should be included in the output file as it is retrieved, depending on the default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
5.4.2 – F hn tb
Click on the None button to prevent CMS from including the element history in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
5.4.3 – F hf f
Click on the Format button to specify that history is to be included in the output file. You may also specify a format field string. If you specify a format field string, CMS temporarily overrides any default format field string you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu. The format string specifies the format of the history. The string must contain the characters #H or #B (lowercase is allowed), and can contain other printing characters. To include a quotation mark in the history string, type it twice (""). To include a number sign in the history string, type it twice (##).