7. PRINTER-CONFIG Command Reference

 

 

This chapter describes the commands you can run from the PRINTER-CONFIG command line. With PRINTER-CONFIG you can examine, modify, and save configuration files for MultiNet remote print queues.

To invoke PRINTER-CONFIG:

$ MULTINET CONFIGURE /PRINTERS

At the PRINTER-CONFIG prompt, type ? to list the available commands. For online help use the PRINTER-CONFIG HELP command.

Changes do not take effect until you do one of the following:

·         Restart the MultiNet remote printer queues with the @MULTINET:REMOTE-PRINTER-QUEUES.COM command.

·         Restart your system.

For details on configuring MultiNet remote printer queues, refer to the MultiNet Installation and Administrator’s Guide.

Command Summary

The below table lists the commands you can run from the PRINTER-CONFIG prompt.

PRINTER-CONFIG Command

Description

ADD

Adds a new VMS print queue to the current configuration.

ATTACH

Switches the terminal to another process.

CLEAR

Removes all printer queues from the current configuration.

DELETE

Removes a single printer queue from the current configuration.

ERASE

Removes all printer queues from the current configuration (same as CLEAR).

EXIT

Saves the current printer configuration and leaves PRINTER-CONFIG mode.

GET

Reads in a printer configuration file.

HELP

Displays information about one or all commands.

MODIFY

Changes a printer configuration file.

PUSH

Accesses the DCL command line and pauses PRINTER-CONFIG.

QUIT

Exits PRINTER-CONFIG and prompts to save changes.

SAVE

Writes out the current printer configuration file (same as WRITE).

SELECT

Picks the printer that will be modified by subsequent SET commands.

SET ALLOW-USER-SPECIFIED-PRINTER

Controls whether the print queue allows the use of PRINT/PARAMETER=(...) for specifying the destination address or printer for an LPD job (to override the original queue configuration).

SET BASE-PRIORITY

Specifies the base process priority at which jobs are initiated from a batch execution queue.

SET BLOCK-LIMIT-LOWER

Limits the size of print jobs that can be processed on an output execution queue.

SET BLOCK-LIMIT-UPPER

Limits the size of print jobs that can be processed on an output execution queue.

SET BURST

Controls whether two file flag pages with a burst bar between them are printed preceding output.

SET CHARACTERISTICS

Specifies one or more characteristics for processing jobs on an execution queue.

SET DEFAULT-FORM

Sets the default form used when submitting a print job to this printer.

SET DESCRIPTION

Specifies a string of up to 255 characters used to provide operator-supplied information about the queue.

SET FLAG

Forces a VMS banner page to print at the beginning of each file, by default, on the print queue.

SET LIBRARY

Sets the device control library for the print queue.

SET NOFEED

Prevents the VMS print symbiont formatting code from inserting a form feed between pages.

SET OWNER

Sets the owner of the print queue.

SET PROTECTION

Sets the protection of the print queue.

SET RETAIN-ON-ERROR

Retains jobs that terminate in an error in the queue.

SET SCHEDULE-NOSIZE

Prints jobs in the order they were submitted, regardless of size.

SET SEPARATE-BURST

Specifies whether two job flag pages with a burst bar between them are printed at the beginning of each job.

SET SEPARATE-FLAG

Specifies whether a job flag page is printed at the beginning of each job.

SET SEPARATE-RESET

Specifies one or more device control library modules that contain the job reset sequence for the queue.

SET SEPARATE-TRAILER

Specifies whether a job flag page is printed at the end of each job.

SET SUPPRESS-EOJ-FF

When set on a STREAM queue, the VMS print symbiont formatting code does not add a form feed to the end of the job.

SET SUPPRESS-REMOTE-BANNER

When set on an LPD queue, the remote LPD is informed not to print a banner page; many LPD servers do not support this option.

SET SUPPRESS-TELNET

When set on a STREAM queue, MultiNet does not try to use the TELNET protocol to communicate with the printer.

SET TAB-EXPAND

Forces the VMS print symbiont formatting code to expand TAB characters into the correct number of SPACE characters.

SET TRAILER

Controls whether a file trailer page is printed following output.

SET WS-DEFAULT

Defines for a batch job a working set default, the default number of physical pages that the job can use.

SET WS-EXTENT

Defines for the batch job a working set extent, the maximum amount of physical memory that the job can use.

SET WS-QUOTA

Defines for a batch job a working set quota, the amount of physical memory that is guaranteed to the job.

SHOW

Displays the current printer configuration.

SPAWN

Invokes a DCL command in PRINTER-CONFIG, or starts a subprocess.

STATUS

Displays the status of the printer configuration.

USE

Reads in a configuration file (same as GET).

VERSION

Displays the PRINTER-CONFIG version and release information.

WRITE

Writes out the current printer configuration file.

 

 

 


 

ADD

Adds a new VMS print queue to the current MultiNet configuration, and prompts for queue configuration parameters.

 

FORMAT

ADD queue_name

 

PARAMETER

queue_name

Specifies the name of the queue to add to the configuration.

 

EXAMPLES

This example adds a remote printer queue that prints via LPD on remote system 192.0.0.15.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility V5.6(nn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
ADD SYS$LASER
[Adding new configuration entry for queue "SYS$LASER"]
Remote Host Name or IP address:
192.0.0.15
Protocol Type: [LPD] LPD
Remote Queue Name: [lp]: lp
[SYS$LASER => 192.0.0.15, lp]
PRINTER-CONFIG>

This example adds a remote printer queue that prints data by connecting to TCP port 1395 at address 192.0.0.98.

PRINTER-CONFIG>ADD SYS$LPTERM
[Adding new configuration entry for queue “SYS$LPTERM”]
Remote Host Name or IP address:
192.0.0.98
Protocol Type: [LPD] STREAM
TCP Port  Number: [23] 1395
[SYS$LPTERM => 192.0.0.98, TCP port 1395 (no telnet option negotiation)]
PRINTER-CONFIG>

Note: The Remote Queue Name specified may be case-sensitive. In particular, if the server is a UNIX system, you must specify it in the same case as it occurs in the UNIX /etc/printcap file, usually lowercase.

If the server is an Ethernet card in a printer, the name is not arbitrary. Check the Ethernet card documentation for the correct remote queue name.

 

 

 

 

 


 

ATTACH

Detaches the terminal from the calling process and reattaches it to another process. Use the SPAWN SHOW PROCESS /SUBPROCESSES command to list the names of subprocesses. Use the DCL LOGOUT command to return to the original process. ATTACH does not work if the MULTINET_DISABLE_SPAWN logical is enabled.

 

FORMAT

ATTACH process-name

 

PARAMETER

process-name

Specifies the name of a process to which you want your terminal attached. (Not all subprocesses can be attached; some testing may be required.)

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SPAWN
$ MM
MM>SPAWN SHOW PROCESS /SUB
...
There are 3 processes in this job:
_TWA42:
 PROC_1
  PROC_2  (*)
MM>
ATTACH  _TWA42:
PRINTER-CONFIG>ATTACH PROC_1
MM>QUIT
$ LOGOUT
PRINTER-CONFIG>

This example shows the use and exit of attached subprocesses.

1.      The first command uses SPAWN to create a subprocess. MM is invoked from the DCL command line. Next, the SPAWN SHOW PROCESS/SUB command is used to list all the subprocess names. The display shows that three subprocesses are active. (Process _TWA42: is PRINTER-CONFIG, PROC_1 is MM, and PROC_2 is the SPAWN SHOW PROCESS/SUB command.)

2.      The MM>ATTACH command returns control to the PRINTER-CONFIG process. From this utility, ATTACH returns control to MM. To exit, QUIT is invoked from MM, and LOGOUT is invoked at the original spawned DCL command line; control returns back to PRINTER-CONFIG. (If SPAWN SHOW PROCESS /SUB had been entered, only this command and the configuration processes would be active.)

 

 

 

 


 

CLEAR

Removes all remote printer queues from the current MultiNet configuration.

 

FORMAT

CLEAR

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
CLEAR

 

 

 

 


 

DELETE

Removes the specified remote print queue from the current MultiNet configuration.

 

FORMAT

DELETE queue_name

 

PARAMETER

queue_name

Specifies the name of the remote print queue to remove.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
DELETE SYS$LASER

 

 

 

 


 

ERASE

Removes all printer queues from the current MultiNet configuration. (Functionally equivalent to CLEAR.)

 

 

 

 


 

EXIT

Saves the current configuration, if it has been modified, then quits.

 

FORMAT

EXIT

 

EXAMPLES

When the configuration has not changed, a message displays indicating that the configuration file is not updated.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
EXIT
[Configuration not modified, so no update needed]
$

When the configuration has been changed, a message displays indicating that the configuration file is updated.

PRINTER-CONFIG>EXIT
[Writing configuration to MULTINET:REMOTE-PRINTER-QUEUES.COM]
$

 

 

 

 


 

GET

Reads in a MultiNet remote printer configuration file that defaults to MULTINET:REMOTE-PRINTER-QUEUES.COM.

After a GET, you can use the various configuration commands to modify the printer configuration.

 

FORMAT

GET config-file

 

PARAMETER

config-file

Specifies the name of the configuration file to read in.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
GET
[Reading in configuration from MULTINET_ROOT:[MULTINET]REMOTE-PRINTER-QUEUES.COM.68]

 

 

 

 


 

HELP

Invokes the command help.

 

FORMAT

HELP [topics]

 

PARAMETER

topics

Contains a space-delimited list of topics that begins with a topic followed by subtopics. The default topic is HELP.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
HELP ?
ADD      ATTACH   CLEAR   DELETE   ERASE    EXIT     GET      HELP
MODIFY   PUSH     QUIT    SAVE     SHOW     SPAWN    STATUS   USE
VERSION  WRITE
PRINTER-CONFIG>

 

 

 

 


 

MODIFY

Changes the parameters of the specified queue in the MultiNet remote printer configuration.

 

FORMAT

MODIFY queue_name

 

PARAMETER

queue_name

Specifies the name of the queue whose parameters you want to change.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
MODIFY REMOTE_LASER
[Modifying configuration entry for queue "REMOTE_LASER"]
Remote Host Name: [192.0.0.1]
192.0.0.2
Protocol Type: [LPD] RETURN
Remote Queue Name: [LASER] RETURN
[REMOTE_LASER => 192.0.0.2, LASER]
PRINTER-CONFIG>

 

 

 

 


 

PUSH

Starts and attaches a DCL subprocess. If a parent process exists, attach to it. To return from DCL, use the ATTACH or the LOGOUT command. To switch back from a DCL subprocess, use the ATTACH command.

PUSH does not work if the MULTINET_DISABLE_SPAWN logical is set.

 

FORMAT

PUSH

 

 

 

 


 

QUIT

If the configuration file has been edited, QUIT prompts you to save the file before leaving.

 

FORMAT

QUIT

 

 

 

 


 

SAVE

Functionally equivalent to WRITE.

 

 

 

 


 

SELECT

Picks the printer that will be modified by any subsequent SET commands.

 

FORMAT

SELECT printer

 

PARAMETER

printer

Specifies the name of the printer to pick for modification.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>

 

 

 

 


 

SET ALLOW-USER-SPECIFIED-PRINTER

Controls whether the print queue allows the use of PRINT/PARAMETER=(...) for specifying the destination address and/or printer for an LPD job (to override the original queue configuration).

 

FORMAT

SET ALLOW-USER-SPECIFIED-PRINTER {enable | disable}

 

PARAMETER

{enable | disable}

Specifies whether this function is enabled or disabled.

 

EXAMPLE

This example shows how to enable the use of PRINT/PARAMETER=(...) to override the original queue configuration.

$ MULTINET CONFIGURE /PRINTER
MultiNet Remote Printer Configuration Utility V5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SEL HP-PRINT
[The Selected Printer is now HP-PRINT]
PRINTER-CONFIG>
SET ALLOW-USER-SPECIFIED-PRINTER ENABLE

 

 

 

 


 

SET BASE-PRIORITY

Establishes the base priority of the symbiont process when the symbiont process is created.

By default, if you omit this, the symbiont process is initiated at the same priority as the base priority established by DEFPRI at system generation (usually 4).

 

FORMAT

SET BASE-PRIORITY priority

 

PARAMETER

priority

Specifies the base priority in decimal format, 0 to 15.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET BASE-PRIORITY 4
PRINTER-CONFIG>

 

 

 

 


 

SET BLOCK-LIMIT-LOWER

Limits the size of print jobs that can be processed on the queue. Allows you to reserve certain printers for certain size jobs. You can set the lower block limit only if the upper block limit is also set (see SET BLOCK-LIMIT-UPPER).

 

FORMAT

SET BLOCK-LIMIT-LOWER lowlim

 

PARAMETER

lowlim

The lowlim parameter is a decimal number referring to the minimum number of blocks accepted by the queue for a print job. If a print job is submitted that contains fewer blocks than the lowlim value, the job remains pending until the block limit for the queue is changed. After the block limit for the queue is decreased sufficiently, the job is processed.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET BLOCK-LIMIT-LOWER 25
PRINTER-CONFIG>

 

 

 

 


 

SET BLOCK-LIMIT-UPPER

Limits the size of print jobs that can be processed on the queue. Allows you to reserve certain printers for certain size jobs.

 

FORMAT

SET BLOCK-LIMIT-UPPER uplim

 

PARAMETER

uplim

The uplim parameter is a decimal number referring to the maximum number of blocks that the queue accepts for a print job. If a print job is submitted that exceeds this value, the job remains pending until the block limit for the queue is changed. After the block limit for the queue is increased sufficiently, the job is processed.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET BLOCK-LIMIT-UPPER 300
PRINTER-CONFIG>

 

 

 

 


 

SET BURST

Controls whether two file flag pages with a burst bar between them are printed preceding output.

 

FORMAT

SET BURST keyword

 

PARAMETER

keyword

If you specify the keyword...

Description

ALL (default)

These flag pages are printed before each fill in the job.

ONE

These flag pages are printed once before the first file in the job.

NONE

No flag pages are printed. It is equivalent to NOBURST.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET BURST ONE
PRINTER-CONFIG>

 

 

 

 


 

SET CHARACTERISTICS

Specifies one or more characteristics for processing print jobs. If a queue does not have all the characteristics that have been specified for a job, the job remains pending. Only the characteristics specified are established for the queue.

 

FORMAT

SET CHARACTERISTICS characteristic,...

 

PARAMETER

characteristics,...

Queue characteristics are installation specific. The characteristic parameter can be either a value from 0 to 127 or a characteristic name that has been defined by the DEFINE /CHARACTERISTIC command.

Parenthesis are not required; they are added automatically.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET CHARACTERISTICS 56
PRINTER-CONFIG>

 

 

 

 


 

SET DEFAULT-FORM

Specifies the default form used when submitting a print job to the printer.

 

FORMAT

SET DEFAULT-FORM formname

 

PARAMETER

formname

Specifies the name of a form previously defined on the system with the DEFINE /FORM command.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET DEFAULT-FORM POSTSCRIPT
[Default Form POSTSCRIPT]
PRINTER-CONFIG>

 

 

 

 


 

SET DESCRIPTION

Specifies a string of up to 255 characters used to provide operator-supplied information about the queue.

 

FORMAT

SET DESCRIPTION string

 

PARAMETER

string

Sequence of any printable characters, including spaces. Case of input is preserved. The string may optionally be enclosed in quotation marks (" ").

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET DESCRIPTION THIS IS A TEST QUEUE.
PRINTER-CONFIG>

 

 

 

 


 

SET FLAG

By default, forces a VMS banner page to print at the beginning of each file on the print queue.

 

FORMAT

SET FLAG mode

 

PARAMETER

mode

If mode is ENABLE, banner pages are printed; if DISABLE, banner pages are not printed.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET FLAG ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET LIBRARY

Sets the print queue's device control library.

 

FORMAT

SET LIBRARY libraryfile

 

PARAMETER

libraryfile

Specifies the name of a text library located in SYS$LIBRARY to be used as the device control library for the print queue.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET LIBRARY SYSDEVCTL
[LIBRARY SYSDEVCTL]
PRINTER-CONFIG>

 

 

 

 


 

SET NOFEED

Prevents the VMS print symbiont formatting code from inserting a form feed between pages.

 

FORMAT

SET NOFEED mode

 

PARAMETER

mode

If mode is ENABLE, form feeds are not inserted; if DISABLE, they are inserted.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET NOFEED ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET OWNER

Sets the owner of the print queue.

 

FORMAT

SET OWNER owner

 

PARAMETER

owner

Specifies the identifier or UIC of a user on the system.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET OWNER OPERATOR
[OWNER OPERATOR]
PRINTER-CONFIG>

 

 

 

 


 

SET PROTECTION

Sets the protection of the print queue.

 

FORMAT

SET PROTECTION protection_string

 

PARAMETER

protection_string

Specifies a VMS queue protection mask.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET PROTECTION (S:RWED,O:REW,G:RE,W:RE)
[PROTECTION (S:RWED,O:REW,G:RE,W:RE)]
PRINTER-CONFIG>

 

 

 

 


 

SET RETAIN-ON-ERROR

Retains jobs in the queue that terminate in an error.

 

FORMAT

SET RETAIN-ON-ERROR mode

 

PARAMETER

mode

If mode is ENABLE, jobs are retained; if DISABLE, jobs are not retained.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET RETAIN-ON-ERROR ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SCHEDULE-NOSIZE

Prints jobs in the order they were submitted, regardless of size.

 

FORMAT

SET SCHEDULE-NOSIZE mode

 

PARAMETER

mode

If mode is ENABLE, jobs will print in the order they are submitted; if mode is DISABLE, jobs will print in order by size (shorter prints before longer).

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SCHEDULE-NOSIZE ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SEPARATE-BURST

Specifies whether two job flag pages with a burst bar between them are printed at the beginning of each job.

 

FORMAT

SET SEPARATE-BURST mode

 

PARAMETER

mode

If mode is ENABLE, prints the flag pages; if DISABLE, will not print the flag pages.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SEPARATE-BURST ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SEPARATE-FLAG

Specifies whether a job flag page is printed at the beginning of each job.

 

FORMAT

SET SEPARATE-FLAG mode

 

PARAMETER

mode

If mode is ENABLE, job flag page will print; if it is DISABLE, job flag page will not print.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SEPARATE-FLAG ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SEPARATE-RESET

Specifies one or more device control library modules that contain the job reset sequence for the queue. The specified modules from the queue's device control library (by default SYS$LIBRARY:SYSDEVCTL) are used to reset the device at the end of each job. The RESET sequence occurs after any file trailer and before any job trailer. Thus, all job separation pages are printed when the device is in its RESET state.

 

FORMAT

SET SEPARATE-RESET module,...

 

PARAMETER

module

This is the name of the device control library module.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SEPARATE-RESET cosmos
PRINTER-CONFIG>

 

 

 

 


 

SET SEPARATE-TRAILER

Specifies whether a job flag page is printed at the end of each job.

 

FORMAT

SET SEPARATE-TRAILER mode

 

PARAMETER

mode

If mode is ENABLE, job flag page will print; if it is DISABLE, job flag page will not print.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SEPARATE-TRAILER ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SUPPRESS-EOJ-FF

When set on a STREAM queue, the VMS print symbiont formatting code does not add a form feed to the end of the job.

 

FORMAT

SET SUPPRESS-EOJ-FF mode

 

PARAMETER

mode

If mode is ENABLE, a form feed is not inserted at the end of each job; if DISABLE, a form feed is inserted at the end of each job.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6(nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SUPPRESS-EOJ-FF ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SUPPRESS-REMOTE-BANNER

When set on an LPD queue, the remote LPD does not print a banner page. (Many LPD servers do not support this option.)

 

FORMAT

SET SUPPRESS-REMOTE-BANNER mode

 

PARAMETER

mode

If mode is ENABLE, banner pages may or may not be generated on the remote system; if DISABLE, banner pages are generated on the remote system.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SUPPRESS-REMOTE-BANNER ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET SUPPRESS-TELNET

When set on a STREAM queue, MultiNet does not try to use the TELNET protocol to negotiate options with the remote printer. Most terminal servers expect MultiNet to negotiate TELNET options, and most printers that connect directly to an IP network expect MultiNet not to do so.

 

FORMAT

SET SUPPRESS-TELNET mode

 

PARAMETER

mode

If mode is ENABLE, TELNET options are not negotiated; if DISABLE, TELNET options are negotiated.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET SUPPRESS-TELNET ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET TAB-EXPAND

Forces the VMS print symbiont formatting code to expand TAB characters into the correct number of SPACE characters.

 

FORMAT

SET TAB-EXPAND mode

 

PARAMETER

mode

If mode is ENABLE, tabs are converted to SPACES; if DISABLE, tabs are not changed.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET EXPAND-TAB ENABLE
PRINTER-CONFIG>

 

 

 

 


 

SET TRAILER

Controls whether a file trailer page is printed following output.

 

FORMAT

SET TRAILER keyword

 

PARAMETER

keyword

If you specify the keyword...

Description

ALL (default)

These flag pages are printed before each fill in the job.

ONE

These flag pages are printed once before the first file in the job.

NONE

No flag pages are printed. It is equivalent to NOBURST.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET TRAILER ALL
PRINTER-CONFIG>

 

 

 

 


 

SET WS-DEFAULT

Establishes the working set default of the symbiont process for the queue when the symbiont process is created.

The value set by this command overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue.

 

FORMAT

SET WS-DEFAULT quota

 

PARAMETER

quota

Specify the value as a number of 512-byte pagelets on Alpha systems or 512-byte pages on VAX.

 

Note: OpenVMS rounds this value up to the nearest CPU-specific page so that actual amount of physical memory allowed may be larger than the specified amount on Alpha. For further information, see the OpenVMS System Manager's Manual.

 

 

If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if it includes a WSDEFAULT value).

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET WS-DEFAULT 27
PRINTER-CONFIG>

 

 

 

 


 

SET WS-EXTENT

Establishes the working set extent of the symbiont process for the queue when the symbiont process is created.

The value set by this command overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue.

 

FORMAT

SET WS-EXTENT quota

 

PARAMETER

quota

Specify the value as a number of 512-byte pagelets on Alpha or and 512-byte pages on VAX.

 

Note: OpenVMS rounds this value up to the nearest CPU-specific page so that actual amount of physical memory allowed may be larger than the specified amount on Alpha.

 

 

If you specify 0 or NONE, the working set extent value defaults to the value specified in the UAF or by the SUBMIT command (if it includes a WSEXTENT value).

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET WS-EXTENT 0
PRINTER-CONFIG>

 

 

 

 


 

SET WS-QUOTA

Establishes the working set quota of the symbiont process for the queue when the symbiont process is created. The value set by this command overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue.

 

FORMAT

SET WS-QUOTA quota

 

PARAMETER

quota

Specify the value as a number of 512-byte pagelets on OpenVMS Alpha or 512-byte pages on OpenVMS VAX. OpenVMS rounds this value up to the nearest CPU-specific page so that actual amount of physical memory allowed may be larger than the specified amount on OpenVMS Alpha. For further information, see the OpenVMS System Manager's Manual.

If you specify 0 or NONE, the working set quota value defaults to the value specified in the UAF or by the SUBMIT command (if it includes a WSQUOTA value).

Working set default, working set quota, and working set extent values are included in each user record in the system UAF. You can specify working set values for individual jobs or for all jobs in a given queue. The decision table shows the action taken for different combinations of specifications that involve working set values.

Is the SUBMIT command value specified?

Is the queue value specified?

Action taken

No

No

Use the UAF value.

No

Yes

Use value for the queue.

Yes

Yes

Use smaller of the two values.

Yes

No

Compare specified value with UAF value; use the smaller.

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:REMOTE-PRINTER-QUEUES.COM]
PRINTER-CONFIG>
SELECT TEST
[The Selected Printer is now TEST]
PRINTER-CONFIG>
SET WS-QUOTA 12
PRINTER-CONFIG>

 

 

 

 


SHOW

Displays the current MultiNet printer configuration.

 

FORMAT

SHOW

 

EXAMPLES

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SHOW
Queue Name          IP Destination        Remote Queue Name
----------          --------------        -----------------
SYS$LASER           192.0.0.15            laser
SYS$LPTERM          192.0.0.98            TCP port 1395
PRINTER-CONFIG>

This example shows detailed queue characteristics for a specific printer called HP5.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SHOW HP5
Queue Name          IP Destination        Remote Queue Name
----------          --------------        -----------------
HP5                 192.0.0.9             TCP PORT 9100
Device Control Library = HPLF3SI
Queue Owner = [SUPPORT,*]
Default Form = WHITEPAPER
End of Job Form Feed will be suppressed
Telnet Options Processing will be suppressed
PRINTER-CONFIG>

 

 

 

 


 

SPAWN

Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. To return from DCL, use the LOGOUT command. SPAWN does not work if the MULTINET_DISABLE_SPAWN logical is set.

 

FORMAT

SPAWN [command]

 

PARAMETER

command

Specifies a command to execute. If you omit command, a DCL command line subprocess is created.

 

QUALIFIERS

/INPUT=file-spec

Specifies an input file to the command you enter with SPAWN.

 

/LOGICAL_NAMES
/NOLOGICAL_NAMES

Specifies that logical names and logical name tables are not copied to the subprocess.

 

/SYMBOLS
/NOSYMBOLS

Specifies that global and local names are not passed to the subprocess.

 

/WAIT
/NOWAIT

Returns control without waiting for the command to complete. Do not use this qualifier with commands that have prompts or screen displays.

 

/OUTPUT=file-spec

Specifies a file that retains the output of the command invoked with SPAWN. This qualifier only works when a single command is entered without creating a DCL subprocess. In addition, this qualifier is positional; you must enter it immediately after SPAWN or other qualifiers.

 

EXAMPLES

This example displays terminal information, captures the output in a file, then displays the information with the TYPE command.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SPAWN/OUTPUT=FOO. SHOW TERM
PRINTER-CONFIG>SPAWN TYPE FOO.
...

This example invokes a command procedure.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SPAWN @COMPROC
...

This example displays help information about the PRINTER-CONFIG utility. Use the LOGOUT command to return control to PRINTER-CONFIG.

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
SPAWN
$ HELP MULTINET CONFIGURE /PRINTERS
...
$
LOGOUT
PRINTER-CONFIG>

 

 

 

 


 

STATUS

Shows the status of the MultiNet remote printer configuration program.

 

FORMAT

STATUS

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6 (nnn)
PRINTER-CONFIG>
STATUS
This is the MultiNet Remote Printer configuration program Version Example

There are 1/1000 queues in the current configuration.
The configuration MULTINET:REMOTE-PRINTER-QUEUES.COM is not modified.
PRINTER-CONFIG>

 

 

 

 


 

USE

Functionally equivalent to GET.

 

 

 

 


 

VERSION

Shows the version and release information of the MultiNet remote printer configuration program.

 

FORMAT

VERSION

 

EXAMPLE

$ MULTINET CONFIGURE /PRINTERS
MultiNet Remote Printer Configuration Utility 5.6(nnn)
PRINTER-CONFIG>
VERSION
This is the MultiNet Remote Printer configuration program Version 5.6(nnn)
PRINTER-CONFIG>

 

 

 

 


 

WRITE

Writes out the current MultiNet remote printer configuration to a MultiNet remote printer configuration file.

 

FORMAT

WRITE config_file

 

PARAMETER

config_file

Specifies the name of the file to which to write the current MultiNet printer configuration (by default, the same file from which the configuration was read).