LIT (Literal)

The LIT tag defines a string where all blanks are significant and included in the value.

Syntax


>>-<LIT>--literal-display-value--</LIT>------------------------><

Parameters

literal-display-value: This attribute specifies a string with all blanks preserved.

Comments

The LIT tag defines a string where all blanks are significant and included in the value. No stripping of leading, trailing, or embedded blanks is performed.

This is the only way to specify trailing blanks or a value of all blanks in the XLATI displayed-value.

The LIT start and end tags must be on the same line as the literal-display-value to preserve the original spacing of the value.

Restrictions

The LIT tag requires an end tag.
You must code the LIT tag only within an XLATI definition. See XLATI (Translate Item) for a complete description of this tag.
Multiple LIT tags may be coded within a single XLATI definition, as long as they are not nested within each other. However, a better approach is to include the whole XLATI displayed-value within the LIT tag.

Processing

None.

Examples

Here is markup that contains a variable class definition with two translate lists. The last four translate items in the second list contain LIT definitions that preserve trailing blanks in the displayed value of their respective translate items.

<!DOCTYPE DM SYSTEM>

<VARCLASS NAME=aa TYPE='char 2'>
<VARCLASS NAME=bb TYPE='char 9'>
<VARCLASS NAME=cc TYPE='char 9'>
  <XLATL FORMAT=upper>
  </XLATL>
  <XLATL>
    <XLATI VALUE=1>BIGCHARGE
    <XLATI VALUE=2><LIT>V I S T A</LIT>
    <XLATI VALUE=3><LIT>EZCARD   </LIT>
    <XLATI VALUE=4><LIT>CHECK    </LIT>
    <XLATI VALUE=5><LIT>     CASH</LIT>
</XLATL>

<VARLIST>
  <VARDCL NAME=dispva VARCLASS=cc>
  <VARDCL NAME=inptva VARCLASS=bb>
  <VARDCL NAME=chckva VARCLASS=aa>
</VARLIST>

<PANEL NAME=lit>LIT translation
  <TOPINST>You can display this panel with ISPF option 7.2
  <TOPINST>For this example, enter the word 'BIGCHARGE', 'V I S T A',
           'EZCARD', 'CHECK', or '     CASH' in the "literal value"
           field (no quotes).
  <TOPINST>The literal will be translated to the corresponding number
           defined in the XLATL tag, and will be displayed in the
           "translated value" field.
  <TOPINST>The literal you enter will be displayed (left justified) in
           the "original value" field.
  <DTACOL>
  <:-- assign "literal value" to "original value" -->
  <SOURCE>
  &inptva = &dispva
  </SOURCE>
  <DTAFLD DATAVAR=dispva ENTWIDTH=9 PMTWIDTH=20 ALIGN=center>Literal value
  <DTAFLD DATAVAR=chckva ENTWIDTH=2 PMTWIDTH=20 USAGE=out>Translated value
  <DTAFLD DATAVAR=inptva ENTWIDTH=9 PMTWIDTH=20 USAGE=out>Original value
  <:-- assign translated "literal value" to "translated value" -->
  <SOURCE>
  &chckva = &dispva
  </SOURCE>
  </DTACOL>
  <CMDAREA>
</PANEL>