Command
Command
Table of Contents
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-1
Key Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-1
Command Shell Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2
npsh Access Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2
Main npsh Command Prefixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2
npsh Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2
User Accounts and Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . G-3
Getting Command Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3
Complete Command List . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3
Debug Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3
List Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-4
Set Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-6
Store Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-16
Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-21
G-i
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Key Features
• different ways to access the M205/M206’s built-in command shell,
npsh - npsh Access Methods on page 2.
• different npsh command prefixes - Main npsh Command Prefixes on
page 2.
• finding help for the commands on-line - Getting Command Help on
page 3.
• listing of all commands beginning with “store” - Store Commands
on page 16.
• listing of all commands beginning with “set” - Set Commands on
page 6.
• listing of all commands beginning with “list” - List Commands on
page 4.
• listing of all commands beginning with “debug” - Debug Commands
on page 3.
• listing of extra commands - Miscellaneous Commands on page 21.
G-1
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Command Shell As mentioned in the M205/M206 Quick Reference Guide, the print server
Overview comes with an in-depth command shell called “npsh”. It allows you to
manipulate objects like destinations, I/O ports, and models and provides
monitoring and troubleshooting capabilities as well.
npsh Prompt
When npsh is accessed through a Telnet session, a prompt is displayed
after login to indicate that it is ready to accept a command from the user.
The Telnet prompt is formatted ipaddress:userid> where ipaddress
is the IP address of the M205/M206 and userid is the user ID of the cur-
rently logged-in user. For example,
G-2
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
192.75.11.32:root>
Complete Com- This section outlines the entire M205/M206 command set including the
mand List command syntax, a description, and in most cases, an example for each
command listed.
Note: If you see the word “ifnum” (which stands for “interface num-
ber”) in any npsh commands, you should substitute a “1” unless
told otherwise. This “1” represents the one network interface (i.e.
Ethernet) supported by the M205/M206.
Debug Commands
The “debug” set of commands help troubleshoot problems that may
occur on the M205/M206. Some of the output may be cryptic but it helps
when troubleshooting with Microplex Technical Support.
G-3
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
debug eeprom
List Commands
These commands list the current or working settings for a particular sec-
tion within the command shell. To view stored settings in Flash, you’ll
need to add in “stored” within the beginning of any of the following
commands. For example, “list prn” shows you the current PRN set-
tings but “list stored prn” shows you the settings sitting in Flash.
Normally these should match. You may also type “list default” to
view the factory default settings.
list [default|stored] arp
G-4
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
List the current destination settings (e.g. names and mapped I/O port,
model used, logpaths, state and service(s)).
list [default|stored] diff
List the differences between the current settings and the stored set-
tings in Flash. Normally, you want these values to match so issue a
“save” command followed by a “reset”.
list [default|stored] ifc
List the current logpath settings (e.g. names and mapped destina-
tions).
list [default|stored] model
List the current model settings (e.g. names and mapped destinations).
list [default|stored] prn
List the current general print server settings (e.g. print server name
and Novell mode).
list [default|stored] rprinter
List all current TCP/IP network settings (e.g. IP address and subnet
mask).
G-5
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
List the current user definitions (e.g. user names and types).
list [default|stored] var
List all pre-defined variables including any newly created ones. Any
of these defined variables can be referenced in a string by placing a
“$” before the variable name (e.g. “set model m1 trailer
$FF”).
Set Commands
These settings alter the current or working settings in memory only.
Therefore, they will be lost if the M205/M206 is power cycled. To ensure
this doesn’t happen, be sure to issue a “save” command so the current
settings get written to Flash.
set date year month day
Set the current date noting the four-digit year, the two-digit month
from 1 to 12, and the day being the number in the month. If the M205/
M206 is reset, this value will be lost so you will need to reset the date
again.
set date 1997 02 10
To turn it off:
set dest d1prn backchannel
G-6
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Set the destination to handle only certain print services. To add a ser-
vice, specify the service name. To disable a service, use “-” before the
name. The available services are:
socket Direct socket printing via TCP/IP.
lpd LPR printing with TCP/IP including LPR clients on any
platform.
lpsched LP or System V printing with TCP/IP.
rprinter Novell RPRINTER support.
pserver Novell PSERVER support.
appletalk AppleTalk printing. Disabling this service will guarantee
this destination doesn’t appear in the Chooser on the
Apple station.
netbios Windows 95 and Windows for Workgroups printing.
ftpd Printing using the File Transfer Protocol (FTP) via TCP/
IP.
For example, to disable appletalk service, type:
set dest d2prn2 service -appletalk
G-7
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Determine where the log information should be sent for a print job or
attached printer. The choices are:
prn parallel port prn.
email Particular user’s email address. This address is set using
the “set sysinfo email emailname@IPad-
dress” command.
syslog A central TCP/IP host running the SYSLOG daemon.
This host is set using the “set sysinfo syslog
IPaddress” command.
set logpath l3 port 2000
Establish the type of printer and print job logging to be done within
this logpath. The options are:
job Job ID, username, etc.
user User ID along with three messages per job about start
and finish.
pgcnt Number of pages printed per job. Needs bi-directional
communication.
cksum 16-bit checksum value to confirm integrity of data
printed.
printer Special printer messages if supported (needs bi-direc-
tional communication).
ioport Printer error messages determined through the parallel
port pins.
set logpath l2 type job user printer pgcnt
G-8
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Determine whether a banner page should be added for print jobs pass-
ing through the model’s mapped destination/queue. ps will produce a
PostScript banner page. text will produce a text banner page. auto
will determine which type is needed depending on the type of print
job data passing through. By default, banner pages are added to the
front of the job. However, if after is set, the banner page will come at
the end.
Note: Banner type and printer type must match.
set model m8 banner text
Set a header string to be sent to the printer ahead of any print jobs
passing through this model. headerstring can consist of up to nine
elements. An example element is a hexadecimal code (e.g. 0x04) or a
pre-defined variable on the print server (e.g. $PCL-RST for a printer
reset). Use “list var” to see all available variables. For example:
set model m4 header $PCL-RST
G-9
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Set a trailer string to be sent to the printer at the end of any print jobs
passing through this model. trailerstring can consist of up to nine ele-
ments. An example element is a hexadecimal code (e.g. 0x04) or a
pre-defined variable on the print server (e.g. $FF for a formfeed). Use
“list var” to see all available variables.
set model m7 trailer $FF
G-10
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Set the model type to raw so that it does not process the data passing
through it in any way (no sensing or conversion). In this mode there is
no ASCII or PostScript processing and no switching strings appended
to jobs. For example
set model m2 type raw
Assert or don’t assert the AUTOFD line for carriage return insertion.
This only affects printers that support this function such as impact
printers.
set prn -autofd
Set all current parallel port settings to the stored values in Flash.
set prn flush
Flush the data in the parallel port’s input and output buffers.
set prn flush
G-11
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Terminate the print job sent to the parallel port if it is not printed after
the timeout period in minutes expires. The minutes value ranges from
0 to 255 with 0 indicating no timing out to take place. This is the
default setting and should be fine for most print setups.
set prn timeout none
Note: Using unlock option when the port is active can cause
output from two jobs to intermix.
set prn xtab tablength|none
G-12
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Define the user’s email address to receive printer and job logging
information from a particular logpath on the M205/M206. email-
name is the host or IP name of the user and IPaddress is the IP
address where the mail is stored on your network.
set sysinfo email [email protected]
G-13
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Define where the debugging information should be sent to. This can
be sent to an output device off of the M205/M206’s I/O port or to a
central TCP/IP host running a SYSLOG daemon. To set this host, use
the command “set sysinfo syslog hostIPaddress”.
set sysinfo syslog 192.75.11.2
Set the IP address of the host running the SYSLOG daemon. M205/
M206 debugging or print job and printer logging information can be
sent there.
set sysinfo syslog 192.75.11.30
Set your DNS server’s IP address so the M205/M206 can resolve host
names when used with its built-in Telnet and Ping clients.
set sysinfo dns 192.75.11.2
Set the key value used for descrambling print jobs that have passed
through Microplex’s npscramble utility on a TCP/IP host. This key is
a four-digit hexadecimal value obtained from the host software,
npscramble. Within the npscramble source code, there is a variable
called SR_KEY which contains the default key value. This can be
changed to any four-digit value you’d like.
set sysinfo descramblekey 1234
Enable and disable certain network protocol stacks within the M205/
M206. Sometimes it helps to disable any protocols you are not using
on your network.
set sysinfo module -novell
G-14
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Set the current time noting the hours based on the 24-hour system
and the minutes and seconds ranging from 0 to 59. If the M205/M206
is reset, this value will be lost so you will need to reset the time again.
set time 10 30
Note: If you forget the root password, you can use a TCP/IP
host and RSHD and superuser to set the users back to
factory defaults or you can re-set the jumpers. See “Back
to Factory Defaults” on page 55 of the M205/M206
Quick Installation and Configuration Guide.
set user type username root|guest
G-15
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Store Commands
These commands change the settings stored in Flash (permanent mem-
ory) and do not affect the current or working settings in memory. A power
cycle is needed before the stored settings become current.
store ifc from default
Store all current network settings to Flash so they are retained after a
power cycle. This ensures all current settings match what’s stored in
Flash.
store ifc ifnum utp [-]li [-]rx
G-16
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Store all current general print server settings to Flash so they are
retained after a power cycle. This ensures all current settings match
what’s stored in Flash.
store pserver name newservername
G-17
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Allows users to enable and disable the keepalive packets sent by the
M205/M206 to the host in order to maintain a SPX connection. For
example, to disable the keepalive packets type:
store pserver novell opts -spxkeepalive
Store the time (in seconds) between polling by the M205/M206 to see
if print jobs are in the queue on the file server. This is applicable to a
PSERVER setup only. For example, to poll every 5 seconds, type:
store pserver novell polltime 5
Note: The M205/M206’s NET LED will flash according to the
poll time.
store pserver opts [[-]jobsecurity] [[-]
iobuffer][jobtimeout seconds]
G-18
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Store the IP address for the NIT module specified by ifnum (ifnum
will always be 1 for the M205/M206).
store tcpip 1 addr 192.75.11.9
Store all current TCP/IP network settings to Flash so they are retained
after a power cycle. This ensures all current settings match what’s
stored in Flash.
store tcpip ifnum mask netmask
G-19
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
G-20
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
Determine the receive window size for the M205/M206. Usually the
packets value ranges from 2-8 with the lower number allowing for
more simultaneous TCP connections with the print server.
store tcpip tcp rxwin
Miscellaneous Commands
These commands don’t fall under any specific section of the command
shell but they are used quite frequently.
cancel jobID
Remove a job from an I/O port’s queue. Use “lpstat” to find a par-
ticular job’s ID first.
cancel d1prn1-10
chr string
Used with redirection, the chr command sends output control codes to
the printer. Arguments must be separated by spaces. Arguments can
be a combination of words, any printable character or the common set
of $BS, $STAB, $ESC, $DEL, $EOF, $NULL, $FF, $LF, or Oxhh
(hexadecimal code for any character). You will echo string or redirect
string to the I/O port using:
chr string > ioport
disable ioport|destination
Disable the I/O port so queued jobs aren’t printed or disable a desti-
nation so jobs cannot be queued to it. The I/O port is always prn.
disable prn
enable ioport|destination
G-21
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
keycode
Load the settings stored in Flash and use them as the current or work-
ing settings. If default is specified as well, factory settings will be
loaded. Use this after power failure to restore settings saved in Flash.
lp options -d destname
lpstat
G-22
Appendix G - More on Commands
M205/M206 Installation and Configuration Guide
reset
Save the current settings to Flash so they are remembered after power
cycles. Sysinfo, destination, model, logpath, variable, user, and I/O
port settings will be saved. If default is specified as well, factory
settings will be saved to Flash overwriting any new settings you have
configured. Resetting the unit is not required.
start fox|tts|loopb prn
stop all|prn
G-23