CHARSET Statement

The CHARSET statement specifies the contents of one or more of the character segments of a library character set module. A library character set module consists of header information followed by 64 character segments. Each character segment contains the character's 6-bit code for a WCGM location, its scan pattern, and its pitch. You can use the INCLUDE statement to copy an entire module, minus any segments deleted using the DELSEG keyword. In addition, you can use the CHARSET statement to select character segments from any module named with a library character set ID or the GCM keyword. The CHARSET statement can also specify the scan pattern and characteristics for a new character.

The CHARSET statement must always be followed by a NAME statement, another CHARSET statement, or one or more data statements. The CHARSET statement must be preceded by an OPTION statement with the DEVICE parameter if you want to create library character set modules in the 3800 Model 3 compatibility mode module format. The CHARSET statement can be preceded by an INCLUDE statement. More than one CHARSET statement can be coded in the operation group. The operation group can include CHARSET statements that select characters from existing modules and CHARSET statements that create new characters. The CHARSET 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 CHARSET statement with no operands specified, followed by a NAME statement that identifies a library character set module, is used to format and print the module.

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

Label	Statement	Parameters
[label]	CHARSET	[REF=((segno,cloc) [,(segno,cloc)][,...]) [,{GCM=name\|ID=xx}]]

where:

REF=((segno,cloc) [,(segno,cloc)][,...])

identifies one or more character segments within an existing graphic character modification module or library character set module. If the reference is to a GCM, the scan pattern and pitch of the character referred to are used, and a 6-bit WCGM location code is assigned. If the reference is to a character in a library character set, the entire segment, including the 6-bit WCGM location code, is used, unless the cloc subparameter is specified for that segment. 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 or library character set module built with the IEBIMAGE program, segno is a number from 1 to 64.
cloc: specifies a 6-bit code that points to a WCGM location, and can be any value between X'00' and X'3F'. When a library character set segment is referred to, if cloc is not specified, the character's 6-bit code remains unchanged when the segment is copied. If a graphic character modification segment is referred to, cloc must be specified.

The REF parameter can be coded in a CHARSET 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. GCM should not be coded with ID.

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

ID=xx

can be coded when the REF parameter is coded and identifies a library character set that contains the character segments referred to by the REF parameter.

xx: specifies the 2-hexadecimal-digit ID of the library character set module. The second digit must be odd, and '7F' and 'FF' are not allowed.

ID should not be coded with GCM.

When neither ID nor GCM has been coded, the segments are copied from the IBM-supplied World Trade National Use Graphics graphic character modification module.

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

Label	Statement	Parameters
[label]	CHARSET	ASSIGN=(cloc[,pitch]) data statements SEQ=nn

where:

ASSIGN=(cloc[,pitch])

identifies a newly-created character and its characteristics. The ASSIGN parameter specifies the new character's 6-bit code and its pitch. When IEBIMAGE detects the ASSIGN parameter, the program 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.

cloc: specifies the character's 6-bit code for a WCGM location and can be any value between X'00' and X'3F'. Cloc is required when ASSIGN is coded.
pitch: specifies the character's horizontal size and is one of the following decimal numbers: 10, 12, or 15. If pitch is not specified, the default is 10.

At least one data statement must follow a CHARSET 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.