The :ABSTRACT section tag is processed by the DSlVIABSTR APF. The abstract is part of the front matter of the document. Page layout and heading defmitions do not need to be changed because these are governed by the front matter section macro. All the DSlVIABSTR APF needs to do is to generate a new page with a level one heading of "ABSTRACT" on it. It also resets the &@shead symbol which is used in the running footing. The DSI\tlABSTR APF performs the following processing:
1. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"Miscellaneous" on page 163.)
2. Calls the DSM#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
3. Resets &@shead to the value of &LL@Abstr which is "Abstract." The &LL@Abstr symbol is defined in DSl\1#SETS. The &@shead symbol is used in the running footing.
4. Creates a level one heading for the abstract using the &LL@Abstr symbol defmed ill
DSM#SETS to "Abstract" and the .Hl [I-lead Levell] control word.
S. Remaps the paragraph tag to the DSMP ARAI APF. This is because paragraphs following level one headings have a slightly different fonnat than other paragraphs. See "Paragraphs"
on page 87 for a complete explanation on why the :P tag is remapped.
58 DCF: Gi\'lL Starter Set Implementation Guide
DSMPREF
The DSMPREF APF processes the :PREFACE tag. The preface is part of the front rnatter of the document. Page layout and heading deflllitions do not need to be changed because these are governed by the front matter section macro. All this macro needs to do is generate a new page with a level one heading of "PREFACE" on it. It also resets the short heading symbol (&@shead) that is used in the running footing.
The DSMPREF APF performs the following processing:
1. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"Miscellaneous" on page 163.)
2. Calls the DS1'vl#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
3. Resets the &@shead symbol to &LL@Pref which is deftned in the DSM#SETS macro to
"Preface." &@shead is used in the running footing.
4. Creates a level one heading for the preface using the &LL@Pref symbol which is "Preface"
and the .H1 [Head Levell] control word.
5. Remaps the paragraph tag to the DSl\tlPARAl APF. This is because paragraphs following level one headings may have a slightly different format than other paragraphs. See
"Paragraphs" on page 87 for an explanation on why the :P tag is renlapped.
DSMTOC
The DSMTOC APF processes the :TOC tag and produces the table of contents section by per-forming the following processing:
1. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"lvliscellaneous" on page 163.)
2. Calls the DSM#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
3. Resets the &@shead symbol to &LL@ToC symbol which is defined in the DSlYl#SETS macro to "Table of Contents." This synlbol is used in the running footing and is defmed in DSM#SETS
4. Uses the .TC [Table of Contents] control ,vord to format the table of contents. &LL@ToC is used as the title parameter on the .TC [Table of Contents] control word.
DSMFLIST
The :FIGLIST tag is processed by the DSMFLIST APF which produces the List of Illustrations section. The entries for the List of Illustrations are collected in the #FIGLIST macro by the DSl\lFCAP APF.
On the first pass the List of Illustration section will normally be empty because no figures will have been processed yet. On the second pass the #FIGLIST macro which has been created dur-ing the frrst pass is printed out.
The DSI\1FLIST performs the following processing:
1. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"1'vliscellaneous" on page 163.)
2. Calls the DSM#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
3. Resets the &@shead symbol to &LL@LstIl symbol which is defmed in the DSM#SETS Inacro "List of Illustrations." The &@shead symbol is used in the running footing.
4. Prepares to call the #FIGLIST macro. The #FIGLIST macro is defmed one line at a tinle
b. Saves the formatting environment because the #FIGLIST macro changes the formatting environment and we want to be able to completely restore it.
c. Restores the control word separator to the default setting (;) with the .DC [Defme
3. Sets up a local synlbol if &SYSVARH is not "no" (it means that we're numbering headings).
We'll use the symbol on the .DH [Defme Head Level] control words that defme the headings.
60 DCF: Gl\1L Starter Set Implementation Guide
The following line tests for the existence of the &@headl syrnbol
.an &E'&@headl eq 0 .dh 1 num
The line shown above, is still logically part of the .IF [If] control word line that is 6 lines above it in the DSMBODY APF. \-Ve'll adjust the .DB [Defme Head Level] control word for HI to be numbered only if we're numbering headings (&SYSVARH isn't "no") and we're not prefixing them (&@headl doesn't exist). In this case, we'll change the HI back to be numbered and let SCRIPT /VS do the numbering.
6. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"Miscellaneous" on page 163.)
7. Calls the DSM#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
8. Calls DSM#STYL to reset page layout to the value of &SYSVARS. This may be one-column, two-column or offset. See "Starter Set Initialization" on page 19 for details on the DSM#STYL macro.
9. Sets page numbering to arabic and resets the page number to 1.
DSMAPPD
The :APPENDIX section tag is processed by the DS~1APPD APF. Aside from starting a new document section, the primary purpose of this macro is to establish serial lettering and prefixing for level one headings. The DSMAPPD APF performs the following processing:
1. Resets the heading counter symbol, using the .GS [GML Services] HCTR control word to start with A.O. This causes the level one heading numbers in the appendix to be letters-A, B, C, and so on.
2. Sets the &@headl symbol to the value of &LL@Appdx which is "Appendix." This symbol is used as a prefix for level one headings and is defined in DSM#SETS.
3. Adjusts the heading defmitions to tum numbering off for level one headings. This is done because the numbering is handled by the DSMHEADI APF when headings are prefixed as well as numbered.
4. Resets the definitions for level zero and level two through four headings to ensure that all of these headings go into the table of contents and are numbered or not numbered according to the value of &S YSV ARH. If the appendix section follows the body, these redefinitions are not really necessary.
If heading numbering is on (&SYSVARH isn't "no"), the level two headings \vill be num-bered A.I, A.2, and so on. Level three and four headings will also be lettered and numnum-bered.
5. Calls the DSM#RSET macro to end any open lists, footnotes, and so on. (See
"Miscellaneous" on page 163.)
6. Calls the DSlVl#DUPL macro to get to the beginning of the next odd page if duple xing is active. (See "Miscellaneous" on page 163.)
7. Calls DSM#STYL to reset page layout to the value of &SYSVARS. This may be one-column, two-column or offset. See "Starter Set Initialization" on page 19 for details on the DSM#STYL macro.
8. Resets page numbering to arabic style. If the appendix section follows the body section, this isn't necessary because page numbers will already be arabic numerals.
DSMBACKM
The DSl'vlDACKM APF processes the :DACKM tag. The primary characteristics of the back matter section are that headings are not numbered and a two column layout is always used re-gardless of the value of &SYSVARS. The DSMBACKM APF pelforms the following functions:
1. Calls the DSl\1#RSET macro to end any open lists, footnotes, and so on. (See
"l\tliscellaneous" on page 163.)
2. Sets the &@headl symbol off. This symbol is used as a prefix for level one headings. Pre-fixes may be in effect for either the body of the document or the appendix section, if there is one. In either case, we want to get rid of the prefix.
3. Turns off head level numbering by redefining the headings.
4. Redefmes head levels to place level 0 through 4 headings in the table of contents. This is done just in case the previous document section heading defmitions did not Inake entries into the table of contents.
5. Calls the DSM#DUPL macro to get to the beginning of the next odd page if duplexing is active. (See "Miscellaneous" on page 163.)
6. Calls the DSM#STYL macro to get a two-column layout regardless of the value of
&SYSVARS. See "Starter Set Initialization" on page 19 for details on the DSM#STYL macro.
DSIVIEGDOC
The :EGDOC tag is processed by the DSl\tlEGDOC APF. This APF produces the cross refer-ence listing and writes out the SYSV AR \V file of IDs.
1. It calls the DSM#XLST macro if this is the last pass (&@lastpass = "yes") and a cross reference listing has been requested (&SYSVARX = "yes"). See "Cross-References" on page 147 for details on how the cross reference listing is produced.
2. If &SYSVAR\V has been sct and this is the last pass, this macro calls DSM#\VRIT to write out the file with the cross reference IDs in it. See "Cross-References" on page 147 for details on how the IDs are collected, used, and written out.