z/OS ISPF Dialog Tag Language Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


P (Paragraph)

z/OS ISPF Dialog Tag Language Guide and Reference
SC19-3620-00

The P tag defines a paragraph of text within an information region.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-<P--+---------+--+-----------------+--+----------+----------->
       '-COMPACT-'  '-INTENSE=varname-'  '-INDENT=n-'   

>--+----------+--+----------------+-->--+----------------+------>
   '-OFFSET=n-'  |        .-NO--. |     '-paragraph-text-'   
                 '-SPACE=-+-YES-+-'                          

>--+------+----------------------------------------------------><
   '-</P>-'   

Parameters

COMPACT
This attribute causes the paragraph to format without a blank line before the paragraph.
INTENSE=varname
This attribute supplies a variable name that must contain a valid value for the INTENS keyword. The entire paragraph is controlled by this value. For example, if the variable contains the value NON, the paragraph is not visible.
INDENT=n
This attribute specifies that the paragraph be indented from the current left margin.
OFFSET=n
This attribute specifies that the formatted text following the first line of the paragraph should be indented an additional n bytes.
SPACE= NO | YES
This attribute is used when processing <P> tags coded within ENTITY definitions. When the ENTITY keyword SPACE is not specified, text following a paragraph tag within the ENTITY definition is processed as coded by default. This may result in unwanted spaces between words in the paragraph, which can be removed by specifying <p space=yes>.
paragraph-text
This is the text of the paragraph.

Comments

The P tag defines a paragraph of text within an information region. You can code the P tag anywhere within an INFO definition.

Each paragraph formats as an unindented block of text. A blank line is added before the paragraph unless the COMPACT attribute is specified.

Paragraphs within a list align with the text of the list item.

Restrictions

Processing

Table 1. Tags you can code within a P definition
Tag Reference Usage Required
ATTENTION ATTENTION (Attention) Single No
CAUTION CAUTION (Caution) Single No
HP HP (Highlighted Phrase) Multiple No
PS PS (Point-and-Shoot) Multiple No
RP RP (Reference Phrase) Multiple No
WARNING WARNING (Warning) Single No

Examples

Here is help panel markup that contains four paragraphs. The first three paragraphs are coded within an information region with a defined width of 40, so the text of the paragraphs is formatted according to this width. The last paragraph is coded within an information region with no defined width, so the paragraph text is formatted according to the width defined on the HELP tag. Figure 1 shows the formatted result.
<!DOCTYPE DM SYSTEM>

<HELP NAME=p DEPTH=22 WIDTH=60>P Tag Help
<AREA>
<INFO WIDTH=40>
  <P>Here's a paragraph.
  Lines are formatted to fill the width of the
  information region.
  <P>Here's another paragraph.
  Notice the line skip between the paragraphs.
  <P>Paragraphs are very versatile.
  You can use them within many other tags.
</INFO>
<INFO WIDTH=58>
  <P>The paragraphs above were formatted within an
  information region defined with a width of 40.
  This paragraph is formatted within the width specified
  for the panel.
</INFO>
</AREA>
</HELP>
Figure 1. Paragraphs
                         P Tag Help

 Here's a paragraph. Lines are formatted
 to fill the width of the information
 region.

 Here's another paragraph. Notice the
 line skip between the paragraphs.

 Paragraphs are very versatile. You can
 use them within many other tags.

 The paragraphs above were formatted within an information
 region defined with a width of 40. This paragraph is
 formatted within the width specified for the panel.




  F1=Help        F3=Exit        F5=Exhelp      F6=Keyshelp
  F7=PrvTopic    F8=NxtTopic   F10=PrvPage    F11=NxtPage
 F12=Cancel

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014