DTSEG (Definition Term Segment)

The DTSEG tag defines a segment of the definition term. It is used to provide vertical separation of the DT tag text.

Syntax


>>-<DTSEG>--+----------+---------------------------------------><
            '-</DTSEG>-'

Comments

The DTSEG tag is used to create a vertical separation within the definition term. The text following the DTSEG tag is formatted directly under any previous definition term tag text. Multiple DTSEG tags create additional DT text lines.

Use of the DTSEG tag affects the DL tag BREAK attribute. The first (or only) line of DT tag text is processed according to the BREAK attribute of the DL tag. For additional lines, when TSIZE is large enough to accommodate the text segments, the DTSEG text is formatted in front of the associated DD tag text. When TSIZE is not large enough to accommodate the largest segment, all of the DT and DTSEG text is formatted above the associated DD tag text.

Restrictions

The DTSEG tag can be coded within the text following a DT tag.
When a DTSEG tag is coded, then all remaining DT tag text for the current DT tag set must follow a DTSEG tag.
The DT nested tags RP and PS are not supported within DT tag text following any DTSEG tag in a DT/DD tag set.

Processing

Table 1. The tag you can code within a DTSEG definition
Tag	Reference	Usage	Required
HP	HP (Highlighted Phrase)	Multiple	No

Examples

Here is an example that shows the use of the DTSEG tag in combination with a multiple DT tag set. The last DT tag includes the SPLIT=yes attribute to format the dash in front of the DD tag text. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM()>

<PANEL NAME=dtseg KEYLIST=ISRHELP APPLID=ISR WINDOW=no PADC=user
       TUTOR ZUP=ISP7R000>Traces - Primary Commands

<CMDAREA CAPS=on>
<AREA DEPTH=1 EXTEND=on>

  <INFO WIDTH=*>
    <P>
       Enter a <hp>Primary Command</hp> in the command input field.
       It is processed after all row modifications and all line commands
       are processed. The following primary commands are valid for the
       Traces options:

    <DL TSIZE="8 1" BREAK=fit INDENT=2>
      <DT>
          LOCATE
          function-name
          (Function Traces) or variable name (Variable Traces)
        <DTSEG>
          LOC or
        <DTSEG>
          L
      <DT SPLIT=yes>-
      <DD>The LOCATE command positions the scrollable display at the
          first (or next) row containing the function name (Function
          Traces option) or the variable name (Variable Traces option).
    </DL>
  </INFO>
</AREA>
</PANEL>

Figure 1. Definition term segment

 Tutorial  ---------------  Traces - Primary Commands  --------------  Tutorial
 Command ===> _________________________________________________________________

 Enter a Primary Command in the command input field. It is processed after all
 row modifications and all line commands are processed. The following primary
 commands are valid for the Traces options:

   LOCATE function-name (Function Traces) or variable-name (Variable Traces)
   LOC or   - The LOCATE command positions the scrollable display at the first
   L          (or next) row containing the function name (Function Traces
              option) or the variable name (Variable Traces option).