PTSEG (Parameter Term Segment)

The PTSEG tag defines a segment of the parameter term. It is used to provide vertical separation of the PT tag text.

Syntax


>>-<PTSEG>--+----------+---------------------------------------><
            '-</PTSEG>-'

Comments

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

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

Restrictions

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

Processing

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

Examples

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

<!DOCTYPE DM SYSTEM()>

<PANEL NAME=ptseg 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:

    <PARML TSIZE="8 1" INDENT=2>
      <PT>
          LOCATE
          function-name
          (Function Traces) or variable name (Variable Traces)
        <PTSEG>
          LOC or
        <PTSEG>
          L
      <PT SPLIT=yes>-
      <PD>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).
    </PARML>
  </INFO>
</AREA>
</PANEL>

Figure 1. Parameter 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).