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

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

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

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

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

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

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

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

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

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

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

SET PROTECTION

Sets the protection of the print queue.

FORMAT

SET PROTECTION protection_string

PARAMETER

protection_string

Specifies a VMS queue protection mask.

EXAMPLE

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

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

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

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

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

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

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

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

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

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

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

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

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

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).