NAME

lpsrc − remote console program for Digital PrintServer printers

SYNOPSIS

lpsrc hostname

DESCRIPTION

lpsrc is a program that allows any user to have remote console access to a PrintServer printer using any terminal that is supported in the client system’s termcap(5) database.  The only command line parameter is the internet hostname or host address of the printer. 

Once the lpsrc program has made a network connection to the PrintServer printer, it offers a display with a command region in the top half of the screen and a scrolling log in the bottom half of the screen. 

OPTIONS

None. 

COMMANDS

The PrintServer printer console lets you type commands to a shell shown in the top area of the screen. Those commands are:

configuration
show printer software and network configuration
The configuration command shows the network and software configuration parameters of the PrintServer printer.  The network parameters are determined by the printer at boot time. The configuration parameters are set via the printer’s configuration file, stored on a management host. The reported values are as follows:

Accounting May be off, on, or reliable. If on or reliable, the list of accounting/error logging hosts is also displayed.

Logging Indicates whether or not operator log messages are also sent to the error log. 

IP address

IP subnet mask

Ethernet These show the network parameters. 

Consoles Shows what remote consoles, if any, are in use. 

Access control Shows the current access control directives. 

exitexit current console mode
The exit command is used to exit the current console mode.  If the prompt is an octothorp (#), the console is in privileged (or superuser) mode, and exit resumes unprivileged mode.  If the prompt is a percent sign (%), the console is in unprivileged mode, and exit ends the current console session if it is a remote session, or resets the console if it is on the local console.  Typing control-D at the beginning of a line is a synonym for exit.

helpget help on commands
Use help to get short help messages for PrintServer printer console commands.  With no arguments, help prints out a list of the commands available in the current console mode.  If a command to help is supplied, a one-line summary of command’s syntax and function is given. ?  is a synonym for help.

jobsshow the current job queue
Jobs shows a list of the jobs currently queued at the PrintServer printer.  This can be used to infer what client hosts have jobs queued; there may be more jobs queued on the client host(s).  Each line displays the job number, job name, user ID, user’s hostname, client hostname, and the “note” associated with the job. Some of these values may not be known to the PrintServer printer and are left blank. This is a repeating command (see the repeat command.)  Showq is a synonym for jobs.

mansee the details of a command
Usage: man command
Use man command to get detailed help on command. The man command works by reading the help text from the management server daemon on the supporting host, and will not work unless there is an active supporting host providing the man pages online. 

netstat
show network status
The netstat command shows the current status of the TCP/IP subsystem.  The display is divided into three sections: connections, routes, and ARP cache.  The "connections" section shows the status of all TCP connections.  For each connection, it displays the remote address and port, the number of bytes waiting to be delivered to a process, the number of bytes waiting to be sent out, the size of the receive window, the number of bytes available in the peer’s receive window, the values of the send and acknowledgement sequence numbers, and the TCP state. The "routes" section shows the contents of the routing table. For each route, it displays the remote destination, the next hop, the routing flags, the current reference count, and the number of times this route has been used. The flags are as follows: G indicates that the route is for a network, H indicates that the route is to a specific host (given in the Gateway column), and L indicates that the route cannot be updated by received ICMP redirect messages.  The "ARP" section shows the IP address and the corresponding ethernet address for every entry in the ARP cache. This is a repeating command (see the "repeat" command)

repeatshow or set the repeat interval
Usage: repeat [ interval ]
Several of the console commands, such as netstat and status, can be used in repeating mode.  In this mode, rather than just showing the current values and prompting the user for more input, the console pauses for some interval and then executes the command again.  This continues until the user types a new command.  The repeat command is used to set the interval between the repeated executions.  If the integer interval argument is supplied, the repeat interval is set to that value.  There are two special values: a value of 0 disables repeating.  A value of -1 sets the repeat interval to 0; that is, the repeating commands run continuously, with no delay between successive executions.  If no argument is given, the current value of the repeat interval is displayed. Setting the repeat interval to too short a value can significantly affect the speed of the printer, by consuming too much of its computing resources.

showqShow jobs queue. 
This is a synonym for the "jobs" command.

statusshow current status of the PrintServer printer. 
Status shows the current status of the PrintServer printer and its subsystems:  the job server, the POSTSCRIPT interpreter, the print engine, and the current job.  It also shows if the PrintServer printer is currently accepting jobs and whether it is in continuous or single job processing mode.  This is a repeating command (see the "repeat" command). 

?Provide short help information. 
The "?" command is a synonym for "help".

suenable privileged commands
The su command is used to enter privileged mode on the PrintServer printer console.  The user is required to enter the printer’s password, which was set in the configuration file.  The typed password is not echoed. 

PRIVILEGED COMMANDS

Once you have typed the "su" command and provided the correct password to the PrintServer printer, you can type any of these privileged commands in addition to the regular commands. 

abortabort a job
Usage: abort [ jobnumber ]
The abort command is used to abort a job that is queued at the printer.  If you do not specify a job number, the current job is aborted.  If jobnumber is specified and the job exists, that job is removed from the queue.  Note: the PrintServer printer job number is not the same as the lpr(1) job number printed by the lpq(1) command on a client host. 

continuous
Start continuous job processing
The continuous command begins or resumes continuous job processing. 

disable
disable job acceptance
The disable command disables job acceptance at the PrintServer printer.  Job acceptance can be re-enabled with the enable command. 

enableenable job acceptance
The enable command enables job acceptance at the PrintServer printer, which may have been turned off with the disable command. 

nextstart the next job if in single job mode
When the PrintServer printer is in single-job mode, the operator must use the next command to allow each job to print.  This allows the operator to load special forms or trays for specific jobs. 

reconfigure
re-read the remote configuration file
Every PrintServer printer has a remote configuration file. This configuration file controls various software parameters. The reconfigure command causes this file to be re-read and re-executed. 

singleenable single job mode
Single enables single-job mode.  In single job mode, the PrintServer printer waits between jobs for an operator to use the next command to allow the next job to proceed.  This allows the operator to load special forms or trays for specific jobs. 

DIAGNOSTICS

The lpsrc program writes its diagnostic messages to standard error. 

PrintServer closed connection -- exiting
Information.
The PrintServer printer has closed the network connection (probably because of an exit command entered into lpsrc) thereby requesting a program exit. The lpsrc program terminates. 

PrintServer requested program abort
Information.
An error condition in the PrintServer printer has caused it to ask for an abnormal termination of the lpsrc program. 

unexpected frame XX NN NN YYY
Warning.
The lpsrc program has received from the PrintServer printer a command frame that it does not understand. This is almost certainly caused by a version mismatch between the version of the lpsrc program and the software running inside the PrintServer printer. 

I/O error establishing network link to printer
Fatal error.
The lpsrc program has attempted to establish a network link to the PrintServer printer, and has encountered an operating system error while doing so. This error means that there is something significantly wrong either with the network software on the client computer or that the PrintServer client software has not been installed correctly. 

Remote console session rejected--XXX
Fatal error.
The lpsrc program has attempted to make a remote-console connection to the PrintServer printer, and the PrintServer printer has rejected the request. The reason for the rejection is given in the "XXX" field. This error message normally indicates an error in the installation of the PrintServer printer software or a serious mismatch between the version of the lpsrc program and the version of the PrintServer printer software. 

Signal NNN received -- exiting
Information.
The lpsrc program has received a system signal, which normally indicates an operating system error or program logic error. It is aborting. 

AUTHOR

Digital Equipment Corporation

  —  LPS V5.1  —  15 Mar 1995