LOADVFCB
Authorization
Privilege Class: G
Purpose
Use LOADVFCB to specify the forms control buffer image for a virtual impact printer.
Note: To load the forms control buffer (FCB) with a specified image for a real printer, use
the LOADBUF command.
Operands
- vdev
- identifies the virtual device number of your virtual spooled impact printer.
- FCB name
- specifies the forms control buffer image for your virtual printer. The operand
name is the 1- to 4-character name of the FCB image. You may specify
either the name of an IBM-supplied FCB image or the name of another FCB image supplied by your
system programmer. The three IBM-supplied FCB images are FCB1, FCB8, and FCBS. The default FCB image
is FCB1. The formats of the IBM-supplied FCB images are as follows:
- Name
- Meaning
- FCB1
- Space 6 lines/inch, Length 66 lines per page
- Line
- Channel Skip Specification
- 1
- 1
- 3
- 2
- 5
- 3
- 7
- 4
- 9
- 5
- 11
- 6
- 13
- 7
- 15
- 8
- 19
- 10
- 21
- 11
- 23
- 12
- 64
- 9
- Name
- Meaning
- FCB8
- Space 8 lines/inch, Length 68 lines per page
- Line
- Channel Skip Specification
- 1
- 1
- 4
- 2
- 8
- 3
- 12
- 4
- 16
- 5
- 20
- 6
- 24
- 7
- 28
- 8
- 32
- 10
- 36
- 11
- 63
- 12
- 66
- 9
- Name
- Meaning
- FCBS
- Space 8 lines/inch, Length 68 lines per page
- Line
- Channel Skip Specification
- 1
- 1
- 54
- 2
- 55
- 3
- 56
- 4
- 57
- 5
- 58
- 6
- 59
- 7
- 60
- 8
- 61
- 10
- 62
- 11
- 63
- 12
- 64
- 9
- Index nn
- identifies the first print position. The operand nn must be a number
from 1 through 31; a leading zero need not be specified. If you enter the keyword INDEX without a
value, the value defaults to the value specified in the FCB image.
Note that the INDEX option is valid only for a virtual spooled 3211 printer; it is not valid for other impact printers.
- IMAGE imagelib
- specifies the image library that contains the specified FCB. If you do not specify the IMAGE option, you get the default image library for the device type. The default image library is IMAGxxxx, where xxxx is the device type; for example, the default image library is IMAG1403 for a 1403 type printer.
Usage Notes
- The virtual FCB image should match the FCB image on the real printer. If it does not, results
are unpredictable.
If the spool file is printed on a real 1403 printer, the virtual FCB image is ignored, and channel skipping is controlled by the carriage tape.
- If you are running a program in your virtual machine that requires printer overflow sensing information and you are printing on a real 1403, you need to take special steps to retrieve the sensing information. First, ensure that the CP directory entry for your virtual machine indicates that the printer is a 3203, 3211, 3262, 4245, or 4248, even though the program and the guest operating system in which the program runs define the printer as a 1403. Then use the LOADVFCB command to specify a virtual FCB image that matches the 1403. CP uses this virtual FCB image as a basis for retrieving sensing information.
- If the virtual machine operating system issues a LOAD FCB channel command word to the virtual spooled printer, the LOAD FCB CCW image replaces the virtual FCB image provided on the LOADVFCB command line. Note that the CMS PRINT command issues a LOAD FCB CCW and thereby replaces the virtual FCB image.
- The LOADVFCB command allows specification of the extended FCB image for a virtual 4248 printer. If an attempt is made to send the extended FCB image to a printer that does not support the extended FCB format, an error message results.
- If the default FCB image has been modified, the virtual FCB image from the spooled printer is stored in any file created on that printer. When the file is printed on a real printer, the FCB is loaded into the real printer according to the FILEFCB or DEFFCB option specified on the START command. The file then prints properly on the real printer.
Messages
- HCP003E Invalid option - {option|command contains extra option(s) starting with option}
- HCP022E A virtual device number was not supplied or it was invalid.
- HCP026E Operand missing or invalid
- HCP031E Buffer missing or invalid; [FCB too long|extended FCB not supported]
- HCP040E Device {rdev|vdev|ldev} does not exist
- HCP241E An undefined load image imagename was specified for printer vdev.
- HCP413E Command processing cannot complete due to a spool paging error.
- HCP418E {rdev|vdev} is not a spooled device.
- HCP419E {rdev|vdev} is not a spooled printer.
- HCP421E Printer prt-type does not support the {feature feature|command command}.
- HCP422E The same option was specified twice.
- HCP1001E An operand is missing for option.
- HCP1013E An invalid operand was supplied for option - operand
- HCP1562E The length of buffer bufname is invalid.
- HCP2500E Image library libname could not be found [for printer vdev].
- HCP2501E A spool paging I/O error occurred while reading image [library] imagename on printer vdev.