z/OS DFSMSdfp Utilities
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GRAPHIC Statement

z/OS DFSMSdfp Utilities
SC23-6864-00

The GRAPHIC statement specifies the contents of one or more of the character segments of a graphic character modification module. A graphic character modification module consists of header information followed by from 1 to 64 character segments. Each character segment contains
  • The character's 8-bit data code, its scan pattern, and its pitch (for the 3800 Model 1)
  • Six bytes of descriptive information and the 120-byte scan pattern (for the 3800 Model 3)

By using the INCLUDE statement, you can copy an entire module, minus any segments deleted using the DELSEG keyword. In addition, you can select character segments from any module named with the GCM keyword on the GRAPHIC statement. The GRAPHIC statement can also specify the scan pattern and characteristics for a new character.

The GRAPHIC statement must always be followed by a NAME statement, another GRAPHIC statement, or one or more data statements. The OPTION statement with the DEVICE parameter must precede the GRAPHIC statement to create a graphic character modification module in the 3800 Model 3 compatibility mode module format. The GRAPHIC statement can be preceded by an INCLUDE statement. More than one GRAPHIC statement can be coded in the operation group. The operation group can include GRAPHIC statements that select characters from existing modules and GRAPHIC statements that create new characters. The GRAPHIC statement, preceded by an INCLUDE statement, can be used to delete one or more segments from the copy of an existing module to create a new module.

A GRAPHIC statement with no operands specified, followed by a NAME statement that identifies a graphic character modification module, is used to format and print the module. When you specify a graphic character modification module to be printed for a 3800 Model 3, you must specify the OPTION statement with the DEVICE parameter to ensure that the system assigns the correct prefix (GRF2) to the graphic character modification module name.

The syntax of the GRAPHIC statement, when it is used to select a character segment from another graphic character modification module, is:

Label Statement Parameters

[label]

GRAPHIC

[REF=((segno[,xloc])
[,(
segno[,xloc])]
[,...])
     [,GCM=
name]]

where:
REF=((segno[,xloc]) [,(segno[,xloc])] [,...])
identifies one or more character segments within an existing graphic character modification module. Each character segment contains the scan pattern for a character and the 6 bytes of descriptive information (used to locate its translate table entry). The 6 bytes of descriptive information can be respecified with the xloc subparameter. The REF parameter cannot be used to change a character's pitch or scan pattern.
segno
is the segment number, a decimal integer between 1 and 999. When a character segment is copied from the IBM-supplied World Trade National Use Graphics graphic character modification module, segno can be greater than 64. When the character segment is copied from a graphic character modification module built with the IEBIMAGE program, segno is a number from 1 to 64.
xloc
specifies an 8-bit data code for the character, and can be any value between X'00' and X'FF'. You should ensure that xloc identifies a translate table entry that points to a character position in the WCGM (that is, the translate table entry does not contain X'FF'). If xloc is not specified, the character's 8-bit data code remains unchanged when the segment is copied.

The REF parameter can be coded in a GRAPHIC statement that includes the ASSIGN parameter.

GCM=name
can be coded when the REF parameter is coded and identifies the graphic character modification module that contains the character segments referred to by the REF parameter.
name
specifies the 1- to 4-character user-specified name of the graphic character modification module.

If GCM is coded, REF must also be coded.

When GCM is not coded, the segments are copied from the IBM-supplied World Trade National Use Graphics graphic character modification module.

The syntax of the GRAPHIC statement, when it is used to specify the scan pattern and characteristics of a newly-created character, is:

Label Statement Parameters

[label]

GRAPHIC

ASSIGN=(xloc[,pitch])
data statements  SEQ=nn

where:
ASSIGN=(xloc[,pitch])
identifies a newly-created character and its characteristics. The ASSIGN parameter specifies the new character's 8-bit data code and its pitch. When IEBIMAGE detects the ASSIGN parameter, it assumes that all following statements, until a statement without the characters SEQ= in columns 25 through 28 is encountered, are data statements that specify the character's scan pattern.
xloc
specifies the character's 8-bit data code, and can be any value between X'00' and X'FF'. You should ensure that xloc identifies a translation table entry that points to a character position in a WCGM (that is, the translation table entry does not contain X'FF'). The xloc is required when ASSIGN is coded.
pitch
specifies the character's horizontal size and is one of the decimal numbers 10, 12, or 15. If pitch is not specified, the default is 10.

At least one data statement must follow a GRAPHIC statement containing the ASSIGN parameter.

data statements
describe the design of the character as it is represented on a character design form. For details of how to design a character and how to use the character design form, see IBM 3800 Printing Subsystem Programmer's Guide.

Each data statement represents a line on the design form. Each nonblank line on the design form must be represented with a data statement; a blank line can also be represented with a data statement. You can code up to 24 (for 3800 Model 1) or 40 (for 3800 Model 3) data statements to describe the new character's pattern.

On each statement, columns 1 through 18 (for Model 1) or 24 (for Model 3) can contain nonblank grid positions when the character is 10-pitch. Any nonblank character can be punched in each column that represents a nonblank grid position. Columns 1 through 15 (for Model 1) or 20 (for Model 3) can contain nonblank grid positions when the character is 12-pitch. Columns 1 through 15 (for Model 1) or 1 through 16 (for Model 3) can contain nonblank grid positions when the character is 15-pitch.

SEQ=nn
specifies the sequence number that must appear in columns 25 through 30 of the data statement and identifies the line as a data statement; nn specifies a line number (corresponding to a line on the character design form) and is a 2-digit decimal number from 01 to 40.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014