IMAGELIB

Read syntax diagramSkip visual syntax diagram IMAGELIB libname

Purpose

Use the IMAGELIB utility to create or replace an image library with images in text decks. The output image library can then be referenced by a printer by issuing the START command with the IMAGE option for the printer.

Operands

libname
identifies in one to eight characters the image library that you want to create or replace. This name is also the name of the new or replacement library. The control file that lists the members that you want to create or replace also must have this name as its file name (see Usage Note 2.b).

Usage Notes

  1. The IMAGELIB utility can invoke one or more CP commands that require a user privilege class other than G.
  2. Before you enter the IMAGELIB command, you must do two things:
    1. First, follow the procedure that applies to your type of printer.
      • For 3800 images, enter the GENIMAGE utility to create the text decks that contain the images for the new library.
      • For impact printer images, code the appropriate FCB or UCS macro in an ASSEMBLE file. Assemble this file to create the TEXT deck for each image.
    2. Create a control file whose file name is the same as the IMAGELIB you want to build, and whose filetype is CNTRL. The format of this file is one statement per TEXT deck you want to include, with the names of the decks in columns 1 through 8.
  3. You may use the IMAGELIB utility with these printers:
    • 1403
    • 3203
    • 3262
    • 3800
    • 4245
  4. Using VMRELOCATE for a virtual machine that might be using this function is not recommended and may have undesired results. If a virtual machine reads an IMAGELIB and is then relocated to another system, any subsequent save of that IMAGELIB will be written out to a different system, not the one from which it was read.

Messages

  • HCP247I NAMED IMAGE imagename CREATED
  • HCP248E SPECIFIED IMAGE imagename NON-EXISTENT
  • HCP249E ERROR LOADING IMAGE imagename
  • HCP253E RESIDUAL BYTE COUNT = nnnnnnnn (HEX)
  • HCP254E ERROR SAVING imagelib
  • HCP759E INSUFFICIENT VIRTUAL STORAGE
Note: If the control file discussed in Usage Note 2.b does not exist or is not valid, IMAGELIB issues a return code of 4 in register 15, but does not enter an error message.