Adding or Modifying a UCS Image Table Entry

To use a new UCS image name/alias with the 3262 Model 5, 4245, 4248, or 6262 Model 14 printers, add an entry for that image name/alias to the UCS image table. Use the assembler to create the image table object module, then link-edit the object module into SYS1.IMAGELIB, as shown in the following procedure. Similarly, to specify other images as defaults or change the description on an old image, change the image table.

To build new UCS table entries, or to change the format of old entries, use the following procedure. For examples of coding the IGGUCSIT macro, see Figure 1 and Figure 2.

To build a new UCS image table entry issue the IGGUCSIT macro, as described in the following text. If you are updating the image table as shown in the following examples, the linkage editor builds a new entry at the start of the table, even if you intended to replace an existing entry. When the system subsequently uses the table, it encounters the new entry first, thus the old one is effectively replaced.
Include the UCS image table source, using the IGGUCS5 or IGGUCS6 macro, both of which reside in SYS1.MODGEN.
Assemble the image table module (UCS5 or UCS6).
Link-edit the assembled module into SYS1.IMAGELIB.
Requirement: The RENT linkage editor attribute is required.

The format of the IGGUCSIT macro is:


                 .-LIST--.                     
>>-IGGUCSIT--MF=-+-DSECT-+--,NAME=image_name-------------------->

>--+--------------------+--+-------------------+---------------->
   '-,ALIAS=image_alias-'  |           .-NO--. |   
                           '-,DEFAULT=-+-YES-+-'   

>--+--------------------+--+-------------------+---------------->
   '-,DESCR=description-'  |          .-4245-. |   
                           '-,DEVICE=-+-4248-+-'   

>--+-----------------------+--+----------------+---------------><
   '-,VLENGTH=(n1,n2,...n)-'  |        .-NO--. |   
                              '-,FOLD=-+-YES-+-'

MF=LIST or DSECT

Specifies the form of the macro instruction.

LIST: Produces a UCS image table entry based on the information supplied in other IGGUCSIT parameters. If LIST is selected or allowed to default, the NAME parameter must also be coded.
DSECT: Produces a DSECT for a single UCS image table entry, similar to the sample entry shown in Figure 1. If you code DSECT, all other parameters of IGGUCSIT are ignored.

LIST is the default.

NAME=image_name

Specifies the one to four character UCS image name.

ALIAS=image_alias

Specifies a one to four character alias name for the UCS image. If ALIAS is not specified, the image name coded in the NAME parameter will be entered in the UCS image table.

Exception: The 3262, 4248, and 6262 printers have no band IDs in common. Because these devices all use the UCS6 image table, select a unique alias name for each of these printer types. The alias must not appear in the image table more than once.

DEFAULT=YES or NO

Indicates whether the new UCS image is to be used as a default value.

YES: Indicates that this UCS image is a default. Default images are used by the system for jobs that do not request a specific image.
NO: Indicates that this UCS image should not be used as a default.

If the DEFAULT parameter is not specified, the new UCS image is not used as a default.

DESCR=description

Specifies descriptive information about the new UCS image. description can be up to 32 EBCDIC or hexadecimal characters long. You cannot use EBCDIC and hexadecimal characters in combination.

Descriptive information is placed in the header line of the verification display, following the real UCS image name. If you omit the DESCR parameter, no description appears in the display. For more information on the verification display, see Verifying the UCS Image.

If VLENGTH is not specified for the 4245 Printer, the DESCR parameter is ignored.

DEVICE=4245 or 4248

Specifies the type of device for which an image table entry is to be created.

If you specify MF=LIST on the first invocation of the IGGUCSIT macro, DEVICE defaults to 4245. The default for subsequent invocations is the printer type that you specified (or the default) on the first invocation. Table entries with different DEVICE specifications are not allowed.

For the 3262 Model 5 or 6262 Model 14 printers, DEVICE=4248 should be specified to create the appropriate form of the image table entry.

VLENGTH=(n1,n2,. . . n)

Specifies the lengths of each line in the UCS verification display. The length of each line must be specified separately, even if all lines are of the same length.

n1 is the length of print line 1; n2 is the length of print line 2; n is the length of the last print line. To display the complete image, the sum of the verification line lengths should equal 350.

For details on the verification report, see Verifying the UCS Image.

The VLENGTH parameter is not valid for the 3262 Model 5, 4248, or 6262 Model 14 printers.

FOLD=YES or NO

Indicates whether the UCS image is to be folded.

YES: Indicates that the UCS image is to be folded. Allows printing only uppercase characters from either upper- or lowercase data codes. Folding continues until an UNFOLD command is received.
NO: Indicates that the UCS image is not to be folded. This is the default.