TCPRSERVER(8MDQS) COMMAND REFERENCE TCPRSERVER(8MDQS) NAME tcprserver - color printer server to print GRF image files for MDQS SYNOPSIS tcprserver [ -i ] [ -c conffilepath ] [ -p proccmdpath ] [ -P printer ] DESCRIPTION tcprserver is the color printer server for MDQS that prints image files conforming to the Generic Rastor Format (GRF) protocol. GRF is used for transmitting and storing rastor images. For more information on GRF see grf(5)). tcprserver uses installable protocol drivers to configure itself to the color printer it is driving. GRF protocol drivers can only be executed by the tcprserver program. The tcprserver program and GRF protocol drivers are not user- executable programs. tcprserver selects the GRF protocol driver by matching the GRF tag entry for the printer type in the /etc/tcprconf file when it reads the GRF image file header. This allows images processed for one color printer to be redirected to other color printers. The tcprserver program interprets almost none of the GRF tag entries in the image file. It passes the GRF tags onto the specified GRF protocol driver for mapping to the destination color printer. The following GRF tag entries are interpreted by the tcprserver program: headerend This tag is required. Marks the end of all GRF header information and implicitly marks the start of the image data. The tcprserver program finds the end of the GRF header in the image file with this entry. imagetype {screendata|copydata} This tag is required. Specifies the type of image file queued to the tcprserver program. Image files of type screendata contain unprocessed image data usually taken directly from a terminal screen. These files must be processed before they can be printed on a color printer. Printed 5/12/88 1
TCPRSERVER(8MDQS) COMMAND REFERENCE TCPRSERVER(8MDQS) Image files of type copydata contain an image that has been through software processing and can be printed. destinationdevice {4692|4693d|4696} This tag is required. Specifies the type of processing performed on the image file. This tag entry searches the /etc/tcprconf file for the GRF protocol driver to load. Note: Even though an image file is processed for one color printer, it can be redirected to an alternate printer by means of the /etc/tcprconf entries. copiertype {copier4692|copier4693d|copier4696} An alternate form of the "destination_device" GRF tag, which can also be used in the /etc/tcprconf file. Use of this tag should be avoided since it is considered obsolete, and has been replaced by the more generic "destination_device" tag. printertype {printer4692|printer4693d|printer4696} An alternate form of the "destination_device" GRF tag, which can also be used in the /etc/tcprconf file. Use of this tag should be avoided since it is considered obsolete, and has been replaced by the more generic "destination_device" tag. OPTIONS -i Uses the system's ioctls the protocol driver supports to send copy request and print request header information. The tcprserver program defaults to it's own formatting for copy request and print request header information and using system write calls to send the data to generic device drivers. If this option is set the tcprserver program assumes the device driver supports ioctls capable of sending copy request and print request header information and uses them in sending the request data. Note: Image data is always sent by system write calls. -c conffilepath Specifies the path for the tcpr configuration file (tcprconf(5mdqs)). This file maps the printer type to the set of installable GRF protocol drivers it can select from when it reads the copier_type GRF tag entry. If this option is not specified the default path is /etc/tcprconf used. -p proccmdpath Specifies the path for the processing command. Printed 5/12/88 2
TCPRSERVER(8MDQS) COMMAND REFERENCE TCPRSERVER(8MDQS) processing converts a GRF image file into a copy-data file for a color printer when the file is passed to the MDQS server. See processing(1) for a detailed description of the command. If this option is not specified the default path is /bin/processing. -P printer Specifies the color printer types the tcprserver program serves. The tcprserver program uses this option to search the /etc/tcprconf file for entries to match to the copier_type GRF tag to select an installable GRF protocol driver. Following is a list of example color printer types that could be used to describe the Tektronix 4692 and 4693D color printers: Tek4692H Tektronix 4692 Color Graphics Printer using handshake mode. Tek4692S Tektronix 4692 Color Graphics Printer using streaming mode. Tek4693DH Tektronix 4693D Color Graphics Printer using handshake mode. Tek4692S Tektronix 4693D Color Graphics Printer using streaming mode. EXAMPLES The following example shows the /etc/qconf entries for the tcprserver program serving a 4693D color printer in streaming mode using system ioctl calls to format header information for the printer. The queue for this printer is tcpr4693. ---------------------------------------- # # Device Descriptions # # <dname> <device> <forms> <status> tcpr0 /dev/hctc default ---------------------------------------- # # Queue Descriptions # # <qname> <status> tcpr4693 ---------------------------------------- # Printed 5/12/88 3
TCPRSERVER(8MDQS) COMMAND REFERENCE TCPRSERVER(8MDQS) # Queue-->Device Mappings # # <qname> <dname> <server> tcpr4693 tcpr0 /usr/lib/mdqs/tcprserver -i -P Tek4693D_S The following example shows the /etc/tcprconf entry necessary to make the previous example work. The Tek4693D_S entry loads and executes the /usr/lib/mdqs/tcprdrv_Tek4693D protocol driver for image files containing the GRF tag entry and parameter destinationdevice 4693d. Tek4693D_S Destination_Device 4693d /usr/lib/mdqs/tcprdrv_Tek4693D -s The following example shows an alternate entry in the /etc/tcprconf file that forces any image file processed for a Tektronix 469X series color printer to be printed. This includes the 4692, 4693D, and 4696 color printers. This works because the GRF parameter value can be a regular expression used to do pattern matching. See tcprconf(5mdqs) for a detailed description of the entries in the /etc/tcprconf file. In this example, the GRF tags specific to a color printer other than the 4693D are ignored. Tek4693D_S Destination_Device 469[2-6] /usr/lib/mdqs/tcprdrv_Tek4693D -s DIAGNOSTICS Diagnostics are passed back to the MDQS daemon and reported in the MDQS console log specified in the /etc/qconf file. CAVEATS The tcprserver program is never called directly by the user. The program is specified in the file /etc/qconf and called by the MDQS daemon. The -i option is required when using a data-streaming communication mode to a Tektronix color printer. SEE ALSO tcpr(1mdqs), processing(1), screencopy(1), x_grf(1), st_grf(1), tchc(4), qconf(5mdqs), tcprconf(5mdqs), grf(5), mdqsd(8mdqs), tcprdrv_Tek4692(8mdqs), tcprdrv_Tek4693D(8mdqs), tcprdrv_Tek4696(8mdqs), sysadmin(8). REFERENCES For more information, consult the Users Manual for your system. Printed 5/12/88 4
%%index%% na:480,124; sy:604,415; de:1019,2926;4497,3022; op:7519,1823;9894,2094; ex:11988,859;13399,1644; di:15043,267; ca:15310,540; se:15850,619; re:16469,210; %%index%%000000000186