Printer Server
Command Reference Guide
Revision 5.0
ER2053501-00A
Information contained in this document is believed to be accurate and reliable. However, Emulex Corporation assumes no responsibility for its use nor for any infringements of patents or other rights of third parties which may result from its use. Emulex Corporation reserves the right to change product specifications at any time without notice.
The following trademarks of Emulex Corporation are used in this document:
Emulex
NETQue NETQue Mate NETQue Pro2
NETQue Token Ring NETJet
enstall rprint
The following are trademark acknowledgments:
UNIX is a trademark of AT&T Bell Laboratories
Novell and NetWare are trademarks of Novell Corporation AppleTalk is a trademark of Apple Computer
Other brands and product names are trademarks of their respective companies.
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense. Shielded cables must be used between this equipment and attached peripheral devices. The reader is cautioned that changes or modifications made to the equipment not expressly approved by Emulex could void the user’s authority to operate this equipment.
The above statement applies to products marketed in the U.S.A.
This class A digital apparatus meets all requirements of the Canadian Interference - Causing Equipment Regulations. Cet Appareil numerique de la classe A respecte toutes les exigences du reglement sur le material brouilleur du Canada.
The above statement applies to products marketed in Canada.
Emulex Corporation
3535 Harbor Boulevard
Costa Mesa, CA 92626
Copyright © 1995 Emulex Corporation. All rights reserved worldwide. No part of this document may be reproduced by any means nor translated to any electronic medium without the written consent of Emulex Corporation.
Table of Contents
CONVENTIONS ..................................................................................................................... |
1 |
FORMATTING.................................................................................................................... |
1 |
WHAT IS A COMMAND? .................................................................................................... |
1 |
COMMAND LINES ............................................................................................................. |
2 |
PROMPTS .......................................................................................................................... |
2 |
KEYWORDS ...................................................................................................................... |
2 |
VARIABLES ...................................................................................................................... |
2 |
OPTIONS........................................................................................................................... |
3 |
QUOTATION MARKS......................................................................................................... |
3 |
KEYWORD FUNCTIONS..................................................................................................... |
4 |
SET, DEFINE AND CHANGE .............................................................................................. |
4 |
SHOW, MONITOR AND LIST.............................................................................................. |
5 |
CLEAR, PURGE AND DELETE............................................................................................ |
5 |
COMMAND SUMMARY ...................................................................................................... |
6 |
GENERAL COMMANDS.................................................................................................... |
10 |
DISPLAY INTERNAL ARP TABLE .................................................................................... |
10 |
HALT PRINTER SERVER .................................................................................................. |
10 |
HELP .............................................................................................................................. |
10 |
INITIALIZE ...................................................................................................................... |
11 |
BELOW MIO VERSION 6.0...................................................................................... |
11 |
LOGOUT ......................................................................................................................... |
12 |
CHECK IP ADDRESS - PING............................................................................................. |
12 |
UPDATE MEMORY - SYNC .............................................................................................. |
12 |
ii Command Reference Guide |
|
PASSWORDS .................................................................................................................... |
12 |
PRIVILEGED ACCESS ...................................................................................................... |
12 |
SET PRIVILEGE PASSWORD............................................................................................. |
13 |
CHANGE LOGIN PASSWORD ........................................................................................... |
13 |
REMOTE CONSOLE PASSWORD ....................................................................................... |
13 |
NODE COMMANDS............................................................................................................ |
14 |
SHOW NODE................................................................................................................... |
14 |
ESTABLISH OR CHANGE TCP/IP NODES ......................................................................... |
14 |
DEFINE NETWARE NODE ............................................................................................... |
16 |
DELETE NODE ................................................................................................................ |
16 |
PORT COMMANDS ............................................................................................................ |
17 |
SHOW PORT CHARACTERISTICS...................................................................................... |
17 |
TEST PORT ..................................................................................................................... |
17 |
CHANGE PORT ACCESS .................................................................................................. |
18 |
CHANGE PORT TYPE....................................................................................................... |
19 |
CHANGE LINE FEED CHARACTER ................................................................................... |
19 |
CHANGE PORT SPEED..................................................................................................... |
20 |
SHOW PORT STATUS - NETJET ...................................................................................... |
20 |
SERVER COMMANDS ....................................................................................................... |
21 |
DEFINE SERVER NAME ................................................................................................... |
21 |
SHOW ALARMS .............................................................................................................. |
21 |
SHOW SERVER CHARACTERISTICS ................................................................................. |
22 |
SHOW SERVER CONFIGURATION .................................................................................... |
22 |
SHOW SERVER STATUS .................................................................................................. |
22 |
DISPLAY NETWORK CHARACTERISTICS ......................................................................... |
22 |
SHOW SERVER LIMITS.................................................................................................... |
23 |
SET CONSOLE TERMINAL PORT...................................................................................... |
23 |
OTHER OPTIONS ............................................................................................................. |
24 |
SET PROMPT................................................................................................................... |
25 |
MODIFY SNMP .............................................................................................................. |
25 |
CHANGE DOMAIN........................................................................................................... |
26 |
Table of Contents |
iii |
PROTOCOLS .................................................................................................................... |
26 |
ENABLE OR DISABLE PROTOCOLS .................................................................................. |
26 |
SHOW NETBIOS CHARACTERISTICS................................................................................ |
27 |
APPLETALK.................................................................................................................... |
27 |
SHOW SERVER APPLETALK ................................................................................... |
27 |
APPLETALK BACKSPOOFING ................................................................................. |
27 |
DEFINE TBCP - APPLETALK.................................................................................. |
27 |
SHOW FONTS - APPLE ............................................................................................ |
28 |
ADD FONTS - APPLE .............................................................................................. |
28 |
REMOVE FONTS - APPLE ........................................................................................ |
28 |
LAT ............................................................................................................................... |
30 |
CHANGE GROUPS................................................................................................... |
30 |
SHOW SERVER ....................................................................................................... |
30 |
CHANGE AUTHORIZED GROUPS ............................................................................. |
31 |
NETWARE COMMANDS .................................................................................................. |
31 |
DEFINE PASSWORD ................................................................................................ |
31 |
DEFINE NETWARE NODE....................................................................................... |
31 |
CHOOSE FRAME TYPE............................................................................................ |
32 |
DISPLAY CHARACTERISTICS .................................................................................. |
32 |
DEFINE REQUIRED FILESERVER ............................................................................. |
33 |
DEFINE AS REMOTE PRINTER................................................................................. |
34 |
REDISCOVER INTERVAL ......................................................................................... |
34 |
ADJUST PROCESSING SPEED .................................................................................. |
34 |
FORMS ................................................................................................................... |
35 |
SELECTING BINDERY EMULATION OR NDS MODE ................................................ |
35 |
DEFINE CONTEXT - NDS ....................................................................................... |
35 |
DEFINE NDS TREE ................................................................................................ |
36 |
TCP/IP COMMANDS ....................................................................................................... |
36 |
CHANGE TCP/IP ROUTING .................................................................................... |
36 |
ESTABLISH OR CHANGE TCP/IP NODES ................................................................ |
37 |
SHOW TCP/IP CHARACTERISTICS.......................................................................... |
38 |
BOOTP, DHCP AND RARP PARAMETERS ...................................................................... |
38 |
DEFINE BOOTP PARAMETERS ................................................................................ |
38 |
DEFINE DHCP PARAMETERS................................................................................. |
39 |
DEFINE RARP PARAMETERS ................................................................................. |
39 |
iv Command Reference Guide |
|
LOAD/DUMP CONFIGURATION..................................................................................... |
40 |
DEFINE TCP/IP LOAD HOST........................................................................................... |
40 |
DEFINE SERVER LOAD.................................................................................................... |
40 |
DEFINE SOFTWARE FILE NAME ...................................................................................... |
41 |
SET LOAD/DUMP GATEWAY .......................................................................................... |
41 |
SET DUMP HOST............................................................................................................. |
42 |
DEFINE TCP/IP DUMP HOST .......................................................................................... |
42 |
SERVICE COMMANDS...................................................................................................... |
44 |
CHANGE SERVICE........................................................................................................... |
44 |
DEFINE SERVICE............................................................................................................. |
45 |
DELETE SERVICE............................................................................................................ |
45 |
SHOW SERVICE............................................................................................................... |
45 |
Command Reference Guide 1
Conventions
This guide provides the correct syntax for commands used with Emulex printer servers containing software release 5.0. This section describes both general and command conventions used in this document and in other printer server documentation.
NOTE: The user must login to the printer server to perform an Emulex printer server command.
Formatting
You will notice text boxes labeled NOTE or CAUTION.
•Notes provide additional information.
•Caution statements provide warnings to prevent harm to people or equipment.
CAUTION: Observe electrostatic discharge (ESD) procedures during installation.
What is a Command?
A prompt, followed by a keyword and one or more variables, options or quotation marks make up a command. The following explanation will demonstrate the structure and formatting of 5.0 printer server commands.
2 Command Reference Guide
Command Lines
A command line begins with the symbol >, contains the word “Server” and a prompt.
Prompts
A prompt consists of the word Server followed by one or two greater than symbols (>). One (>) indicates nonprivileged status and two (>>) signify privileged or supervisor status. The two prompts are shown below:
Server > (nonprivileged users) Server >> (privileged users)
Nonprivledged users have read only privileges. Privileged or supervisor users have all read and write privileges.
Keywords
Keywords are enclosed in brackets and separated by vertical lines. The user must enter a keyword to perform an action.
>Server>> [set |define |change]
Variables
Variables are used as in mathematics: they represent a quantity, device name, address or other entity. They are shown in bold italic type.
>Server>> [set |define |change] server dhcp n m
n |
a variable |
m |
a variable |
Command Reference Guide 3
Options
Options are used to customize a command. When available, the user should always use options. They are italicized and enclosed in brackets.
>Server>> [set |define |change] server dhcp n m
[temp] [default]
temp |
an optional entry |
default |
an optional entry |
Quotation Marks
When case-sensitive information is required, it must begin and end with quotation marks. Font names are case-sensitive and must appear in quotes within command lines. The example below illustrates the use of a font name within a command line.
>Server>> change port 1 fonts add “Courier-Bold Helvetica-Italics”
4 Command Reference Guide
Keyword Functions
Keywords either modify data (set, define or change), remove data (clear, purge, or delete), or display requests (show, monitor, or list).
Set, Define And Change
set |
Modifications are immediate and temporary |
|
(stored in volatile memory). Old port values will |
|
return when the port is logged out. Old node, |
|
server and service values return when the |
|
printer server is reinitialized. |
define |
Modifications are not immediate but once they |
|
take effect, become permanent (stored in non- |
|
volatile memory). Modifications to ports take |
|
effect when port is logged out. Modifications to |
|
nodes, servers and services take effect when |
|
the printer server is reinitialized. |
change |
Modifications are immediate and permanent. |
NOTE: Commands which affect non-volatile memory will cause a 30 second delay before nonvolatile memory is updated. If printer server power is removed prior to this, the change will be lost.
|
Command Reference Guide 5 |
Show, Monitor And List |
|
show |
Displays current information stored in volatile |
|
memory. |
monitor |
Similar to show, except the display is updated |
|
every second for privileged users or every 10 |
|
seconds for nonprivileged users. |
list |
Displays information stored in non-volatile |
|
memory. |
Clear, Purge And Delete |
|
clear |
Data is removed temporarily, but returns at next |
|
reinitialization. |
purge |
Data is not removed until reinitialization, but then |
|
is removed permanently from non-volatile |
|
memory. |
delete |
Data is removed immediately and permanently. |
6 Command Reference Guide
Command Summary
In the summary below, all commands are presented alphabetically. If the keywords are either set, define or change, only change is listed. Page numbers are provided as a quick directory to find an explanation of the command.
arp [-a] [-b] [-d] [-f] [-l] [-s] [-t] |
10 |
|
change node node_nam ip ip_address [tcpip] [gateway |
14 |
|
[default]] [syslog facility] |
|
|
change port port_num [input |output] speed baud_rate |
20 |
|
change port port_num access [dynamic |local |remote |
18 |
|
|virtual |slprt |none] |
|
|
change port port_num authorized groups group_list |
31 |
|
[enabled |disabled] |
|
|
change port port_num fonts add “font_list” |
28 |
|
change port port_num fonts remove “font_list” [all] |
28 |
|
change port port_num mapcrlf [enabled |disabled] |
19 |
|
change port port_num type [ansi |hardcopy |softcopy] |
19 |
|
change server console port_num |
23 |
|
change server domain domain_name |
26 |
|
change server dump [enabled |disabled] |
42 |
|
change server groups group_list [enabled |disabled] |
30 |
|
change server login password “pass_txt” |
13 |
|
change server maintenance password “pass_txt” |
13 |
|
change server name prntsvr_name |
21 |
|
change server netware context “con_txt” |
35 |
|
change server netware fast printserver [enabled |
34 |
|
|disabled] |
|
|
change server options option_list [enabled |disabled] |
24 |
|
change server rarp n m [temp] |
39 |
|
change server route IP dest_ip gateway gwy_name gwy_ip |
36 |
|
change server snmp com_name access acc_right [trap IP |
25 |
|
|
|
|
Command Reference Guide 7 |
|
ip_addr] [set] [enabled |disabled] |
|
change service “servc_name” [port port_num] |
44 |
[TCPport_num] [password “pass_txt”] [protocol] |
|
[enabled |disabled] |
|
crash 300 |
10 |
define node node_name [nfserver |npserver] |
16 |
define port port_num appletalk backspoof [enabled |
27 |
|disabled] |
|
define port port_num appletalk tbcp [enabled |
27 |
|disabled] |
|
define server authorize protocol [all |none |
26 |
|specific] [enabled |disabled] |
|
define server bootp n m [temp] |
38 |
define server dhcp n m [temp] |
39 |
define server gateway [load_dump] ip [ip_address |
41 |
|none] |
|
define server load [selfload |TFTP [put] |decnet] |
40 |
define server netware [default |802.2 |snap |802.3 |
34 |
|ethernet_II ether_type] |
|
define server netware forms [enabled |disabled] |
35 |
define server netware nds “tree_name” |
36 |
define server netware password “pass_txt” |
31 |
define server netware pserver [auto |disabled |3.x |
35 |
|4.x] |
|
define server netware rediscover minutes |
34 |
define server netware required [enabled |disabled] |
33 |
define server netware rprinter [enabled |disabled] |
34 |
define server preferred dump ip ip_address |
42 |
define server preferred load ip ip_address |
40 |
define server software file_name |
41 |
define service “servc_name” appletalk type “prn_type” |
45 |
delete node node_name [all |ip ip_address |tcpip |
16 |
|gateway |nfserver |npserver |syslog] |
|
delete service “servc_name” |
45 |
|
|
8 Command Reference Guide |
|
help |
10 |
initialize [server] [delay delay_min] [cancel] |
11 |
[flash] [default] [disabled] |
|
logout [port port_num] |
12 |
ping ip_address |
12 |
set server privilege password “pass_txt” |
13 |
set server prompt “prompt_txt” |
25 |
show node node_name [gateway |syslog |nfserver |
14 |
|npserver] |
|
show port port_num characteristics |
17 |
show port port_num fonts |
28 |
show port port_num status [netjet |device] |
20 |
show server alarms |
21 |
show server appletalk |
27 |
show server characteristics |
22 |
show server config [port port_num] [ps] |
22 |
show server LAT |
30 |
show server limits |
23 |
show server netbios |
27 |
show server netware |
32 |
show server network |
22 |
show server status |
22 |
show server tcpip |
38 |
show service “servc_name” characteristics |
45 |
su |
12 |
sync |
12 |
test port_num count count_num |
17 |
In the remaining portion of this guide, commands are grouped by their effect.
Command Reference Guide 9
•General Commands
•Passwords
•Node Commands
•Port Commands
•Server Configuration
•Protocols
•Load/Dump Configuration
•Service Commands
10 Command Reference Guide
General Commands
Display Internal ARP Table
Display or control the printer server’s internal address resolution protocol (ARP) table.
>Server>> arp [-a] [-b] [-d] [-f] [-l] [-s] [-t]
-a |
Displays the ARP table. |
-b |
Caches all ARP entries broadcast on the |
|
network. |
-d |
Deletes specified IP address entry. |
-f |
Fixes all entries in the table (turns off timer). |
-l |
Caches only locally addressed mappings. |
-s |
Allows addition of the server IP and MAC |
|
addresses. |
-t |
Turns on timer. |
At least one option must be entered, but only one option can be specified in a single arp command.
Halt Printer Server
Stop printer server causing memory dump to the dump host and printer server reinitialization. All users are logged off and all sessions are disconnected without any warning.
>Server>> crash 300
The entire command “crash 300” must be entered to be effective.
Help
Refers the user to the User Guide for Emulex Printer Servers.
>help