Guardian Procedure Calls Reference Manual (G06.25+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

1691

Formatter Edit Descriptors

Guardian Procedure Calls Reference Manual—522629-013

F-26

Decorations

A decoration specifies a character string that can be added to the result field, the

conditions under which the string is to be added, the location at which the string is to

be added, and whether it is to be added before normal formatting is done or after it is

completed.

You can use multiple decorations, separated by commas, with the same edit

descriptor. Decorations are enclosed in brackets (together with any modifiers) and

immediately precede the edit descriptor to which they apply. If modifiers immediately

precede the left parenthesis of a group, the modifiers apply to each repeatable edit

descriptor within the group.

When a field is processed, the floating decorations appear in the same order, left to

right. If an edit descriptor within a group already has some decorations, the

decorations that are applied to the group function as if they were placed to the right of

the decorations already present. A decoration has the form:

{ M } { M } { N } ... { F }

string

{ N } { P } { P } { P } ... An

string { Z } { Z } { O }

Character 1 Field condition specifier: M Minus

NNull

OOverflow

PPlus

ZZero

Character 2 String location specifier: A Absolute

F Floating

PPrior

n an unsigned nonzero integer constant that specifies the actual

character position within the field at which the string is to begin.

string any character string enclosed in quotation marks or apostrophes.

Conditions

The condition specifier states that the string is to be added to the field if its value is

minus, zero, positive, or null, or if a field overflow has occurred. A null condition takes

precedence over negative, positive, and zero conditions; the overflow test is done after

those for the other conditions, and therefore precedence is not significant.

Alphanumeric data elements are considered to be positive or null only.

A decoration can have more than one condition specifier. If multiple condition

specifiers are entered, an “or” condition is understood. For example, “ZPA2‘+’ ”

Note. Only location type An can be used in combination with the O condition.