%GRAPH converts the value of the expression from character, graphic,
or UCS-2 and returns a graphic value. The result is varying length
if the parameter is varying length.
The second parameter, ccsid, is optional
and indicates the CCSID of the resulting expression. The CCSID defaults
to the default graphic CCSID of the module
as specified by control
keyword CCSID(*GRAPH).
If CCSID(*GRAPH : *IGNORE) is specified on the control specification or assumed for
the module, the %GRAPH built-in is not allowed.
If the parameter is a constant, the conversion will be done at
compile time. In this case, the CCSID is the graphic CCSID related
to the CCSID of the source file.
If the parameter is character
data with an EBCDIC CCSID, the character data must be in the
form
shift-out graphic-data shift-in
For example,
'oAABBCCi'.
See Conversions for
information about the possibility that converting some data
to graphic may not be able to convert all
the data successfully.
Note: The literals containing DBCS
data in this example, such as 'oFFGGi', do not have valid DBCS data
or valid shift characters.
See Graphic Format
for more information.