CAPTURE

Set printer and printing parameters.

Synopsis

CAPTURE [P=printer | Q=queue] L=port number [option ...] [/? | /VER]

Description

Use CAPTURE on your workstation to:

• redirect screen displays to a network printer

• redirect DOS and OS/2 print jobs to a network printer from an application designed to print to workstation printer ports

• redirect data to a network file

• define how a job is printed

Options

P=printer

Specify which printer the print job should be sent to (specify a default in PRINTCON).

Q=queue

Specify which queue the print job should be sent to (specify the default at the NetWare server console or in PRINTCON).

L=port number

Specify the LPT port you want captured. You can specify ``LPT1:'' instead of ``L=1''. A NET.CFG option allows up to nine LPT ports.

option

The supported options are as follows:

SH (Show)

View the current status of printer ports. Do not use with other options.

S=NetWare server

Specify which NetWare server the print job should be sent to. The default is the current server (bindery server).

ECCA (Endcap Cancel)

End the capture of data to LPT ports and discard the data sent to the print queue.

If the data was captured to a file and cancel is omitted, the file remains open and cannot be accessed.

CR=path

Create a file in which to store printed data.

To create the file in your current directory, replace path with just the filename.

---

NOTE: This option is not available in OS/2.

---

ALL

End the capture of all LPT ports when used with ECCA.

View all online help screens when used with the Help option.

V (Verbose)

View more information about the printer, print queue, and print job configuration than is provided with the SH option.

K (Keep)

Keep captured data at the print queue if the workstation fails.

J=job name

Specify the PRINTCON job configuration to use; does not require other options.

NB

Print no banner page.

B=banner name

Specify the text that will appear in the lower half of the banner page. The limit is 12 characters.

NAM=username

Specify the text that will appear in the upper half of the banner page. The limit is 12 characters.

F=form name or number

Specify the form name or number that the printer will use. CAPTURE will not function with an invalid form name. If you specify an invalid number, CAPTURE gives a warning message but still prints.

C=n

Specify the number of copies. The allowable range is 1 to 255.

NPRINT, PCONSOLE, PRINTCON print job configurations, and OS/2 CAPTURE allow up to 65,000 copies.

T=number

Specify the number of spaces that replace each tab in a text print job. You do not need this option for byte-stream print jobs. The default is 1. The allowable range is 1 to 18.

NT

Specify that no spaces be allocated to tabs in a text print job.

TI=n

Specify the number of seconds the operating system should wait after the last data is received before closing the print job. The allowable range is 0 to 1000.

FF

Specify that the printer add blank paper at the end of the print job.

NFF

Specify that the printer not add blank paper at the end of the print job.

AU

Specify that the captured data be closed and sent to the printer after exiting an application.

NA

Specify that captured data not be closed and sent to the printer after exiting an application. This allows more information to be added to the print job.

NOTI

Specify that the user receive a message when the print job is printed.

NNOTI

Specify that the user does not receive a message when the print job is printed.

/?

View online help. (Other parameters are ignored).

/VER

View the version number of the utility and the list of files it uses to execute. (Other parameters are ignored.)

Usage

Default options include Banner (B=banner name), Autoendcap (AU), No Tabs (NT), and Form Feed (FF).

All options function with a preceding forward slash (/), but only the Help option requires it (/?).

Because CAPTURE settings must be reset each time you reboot your computer, consider placing them in the system or individual login scripts.

NetWare 4 allows you to specify the printer name instead of a print queue. You can still capture to print queues.

You can type CAPTURE without any options if a default print queue is specified at the NetWare server or in a default print job configuration.

You do not need to use CAPTURE if you use a NetWare-aware application that can send print jobs to specified printers or print queues.

CAPTURE redirects printing only with the LPT ports; you cannot specify a COM port.

The NET.CFG file includes a network printers=number option. Replace number with the number of printers (0 to 9) you would like to access at the same time. The default number is 3.

If you specify a print job configuration that has a complex printer mode, you might need to increase the bytes (the default is 64, the allowable range 0 to 255) in the printer header=number option.

Examples

• To view current capture, type:
  
  CAPTURE SH

• To capture to network printer P1, type:
  
  CAPTURE P=P1

• To capture to print queue Q1, type:
  
  CAPTURE Q=Q1

• To end a capture, type:
  
  CAPTURE EC

• To use print job configuration ``CHARTS'', type:
  
  CAPTURE J=CHARTS

• To print to a file that you name ``REPORT'', type:
  
  CAPTURE CR=REPORT

• To print to printer SALES without a banner, type:
  
  CAPTURE P=SALES NB

• To view online help, type:
  
  CAPTURE /?

Additional information

For more information on CAPTURE, see ``Using CAPTURE''.