This Command Reference Guide provides complete descriptions of all NetCon commands. Included are the command names, synopsis, description, options, usage, files and examples. This section is provided for information only all necessary user, administration and configuration functions should be preformed through the "netcon" menu utility.
Name
ncapture - DOS/WINDOWS network printer redirector.
Synopsis
ncapture [Server=server] [Queue=queue] [Lpt=1|2|3] ncapture SHow ncapture Off[=1|2|3|ALL] ncapture [Lpt=1|2|3] Timeout=0-1000 seconds (off: T=0)
Description
Ncapture is a DOS/WINDOWS utility that redirects the local printers "LPT1:", "LPT2:" or "LPT3:" to any UNIX print spooler on the NetCon server specified. The UNIX print spoolers are automatically set-up as network print queues during start-up of the NetCon Super-Server. The NetCon print queues are compatible with NetWare print queues. You must be logged into the specified NetCon server with "nclogin.exe" before using "ncapture" or you will be prompted for a login and password.
Options
Server= or S= NetCon server name.
Queue= or Q= Unix Spooler name.
SHow Displays current status.
OFF[1|2|3|ALL] Turns off printer redirection.
Timeout= Sets forced printing timeout in seconds.
Usage
C:> ncapture s=netcon q=p1 C:> ncapture t=10 C:> ncapture SH C:> ncapture off
Files
"/sys/public/ncapture.exe", "/usr/lib/netcon/ncapture.exe"
See Also
"nclogin.exe"
Name
nclogin - DOS/WINDOWS NetCon file server login utility
nclogout - DOS/WINDOWS NetCon file server logout utility.
Synopsis
nclogin [server_name]/[login_name] [password]
nclogout
Description
THIS UTILITY ONLY FUNCTIONAL ON STAND-ALONE SYSTEMS. Nclogin is a DOS/WINDOWS utility used to login to the default or specified NetCon server. If you do not specify a NetCon server name, login_name or password you will be attached to the default server and prompted for a login and password. The login_name and password must be a valid UNIX login and password. You must change to your DEFAULT network drive before using nclogin.
Options
server_name NetCon server name.
login_name Valid UNIX user name.
password Valid UNIX password.
Usage
C:> j: J:> nclogin netcon/root password J:> nclogin J:> nclogout
Files
"/sys/public/nclogin.exe", "usr/lib/netcon/nclogin.exe"
See Also
None
Bugs
In order to maintain UNIX security on each connection you cannot log back in to the NetCon server after you use nclogout. You must reboot the DOS P/C to establish a fresh connection.
Name
ncmap - DOS/WINDOWS network drive mapper
Synopsis
ncmap [D:=server_name/volume:\directory]
ncmap [del D: [D:...]]
Description
The ncmap DOS/WINDOWS utility maps local drive letters A: to Z: to NetCon UNIX volumes and directories specified in the "/usr/lib/netcon/netcexport" file. You should specify a "LASTDRIVE=I" in your "config.sys" file to avoid any conflicts with other networking software. If you are not logged into the specified NetCon server you will be prompted for a valid UNIX login and password.
Options
D:= Any valid DOS drive letter (A:= to Z:=).
server_name Valid NetCon server name.
/volume: Valid NetCon volume from "netcexport".
\directory Valid UNIX sub-directory below specified "/volume".
del D: Delete mapping of drive letter.
Usage
C:> ncmap k:=netcon/sys:\public C:> ncmap del k: C:> ncmap
Files
"/sys/public/ncmap.exe", "/usr/lib/netcon/netcexport",
See Also
ncslist.exe, nclogin.exe
Bugs
None
Name
ncslist.exe - DOS/WINDOWS network servers listing
Synopsis
ncslist
Description
The ncslist DOS/WINDOWS utility lists all the NetCon and NetWare server names on the network. This ulility is used to obtain valid NetCon server name for use with "ncterm", "ncmap", "nclogin" and "ncapture".
Options
NONE
Usage
C:> ncslist
Files
"/sys/public/ncslist.exe", /usr/lib/netcon/ncslist.exe"
See Also
ncmap.exe, nclogin.exe, ncterm.exe, ncapture.exe
Bugs
None
Name
ncterm.exe - MS-DOS/WINDOWS MultiScreen ANSI network terminal emulation program.
Syntax
ncterm [options] [host [ /login_name password]]
Description
NCTERM.EXE is a MultiScreen network virtual terminal emulation program for MS-DOS and WINDOWS machines. It allows DOS/WINDOWS P/C's to login to a UNIX host running NetCon software. NCTERM.EXE emulates both vt100 and ANSI terminals. The ANSI emulation provides the same functionality as an SCO console. NCTERM.EXE utilizes SPX protocols which require that the "LSL", "IPXODI" and "NETX" drivers be loaded on the DOS machine prior to running NCTERM.EXE. NCTERM.EXE also supports the SCO extensions setkey(C), setcolor(C), keyboard(HW), screen(HW) and multiscreen(M). The functionality of the SCO extension setkey (C) is provided through the NetCon command netcsetkey (1).
Ncterm includes limited mouse support in a manner similar to the SCO usemouse (C) command. A mouse configuration file using the same syntax (see usemouse (C)) is supplied on the ncterm command line. Also, a DOS mouse driver must be loaded before starting ncterm. It is not recommended that the mouse be used with ncterm when running ncterm under Windows.
To Load LSL, IPXODI and NETX drivers add the following lines to your DOS/WINDOWS "AUTOEXEC.BAT" file, or you can load them manually from the DOS command prompt.
C:> LSL C:> NE2000 (substitute your driver here) C:> IPXODI C:> NETX or VLM
OPTIONS
"-?" Display the ncterm usage message.
"-v" Display the ncterm version.
"-1" Start ncterm in single-screen mode. Multi-screens a
are disabled.
-e emulation Specify the startup emulation of ANSI, VT100, or NONE. The default is ANSI.
-m filename Specify a mouse configuration file. The mouse will operate in ANSI emulation mode only. Due to limitations in the DOS mouse driver, only 2 buttons on the mouse are supported. A DOS mouse driver must be loaded before starting ncterm. The contents of the mouse configuration file must conform to the syntax shown on the SCO usemouse (C) manual page.
The NCTERM.EXE program is executed from a DOS command prompt.
C: > NCTERM [NETCON_SERVER_NAME[ /login_name password] ]<cr>
If the server name is specified, ncterm will attempt to connect to the server and you will be presented with a login prompt. If a login name and password are also supplied, you will be logged in. If ncterm is started without a server name, you will be presented with the following screen.
*** NetCon Virtual Terminal Version 6.0 *** NCTERM <T>erminal Mode Call <D>os <E>mulation ansi <H>ang-up <C>apture OFF <Q>uit ENTER LETTER:
Menu Functions:
Type the single letter enclosed in <> for the desired function.
(C) Turn ON-OFF capture of screen output to file.
When capture is turned on you will be prompted for a valid file-name.
Enter Capture-Filename: [ ]
Enter a valid file-name and press (cr). Capture will automatically be turned ON. To turn off capture type (Ctrl)+(Home) from the terminal screen, then "C" and capture will be turned OFF.
(T) Enters Terminal mode.
If you are already connected to a NetCon server the terminal screen is displayed. If you are not connected to a server you will be prompted for a valid NetCon server-name.
Enter Server-Name: [ ]
Enter a valid server-name and press <cr> you will then be presented with a terminal screen and prompted for a login:.
(E) Emulation toggles between ansi, vt100, none.
(D) Call DOS command.com. Type "exit" to return to ncterm.
(H) Hang-up from the NetCon server (same as (Alt+H) in terminal mode).
(Q) Quit ncterm, terminating any sessions and returns to DOS.
The following commands are available when in terminal mode.
(Ctrl) + (Home) displays the NCTERM menu in terminal mode
(Ctrl) + (Print Screen) Toggle LPT1: printing on/off. When on, subsequent screen output is simultaneously sent to the LPT1 printer. Press (Ctrl) + (PrintScreen) again to turn off printing.
(Alt) + H Hang up. This multi-screen connection is terminated and the server-name prompt is displayed.
Example Display From "netconfig str0"
str0: flags=63<UP, BROADCAST, NOTRAILERS, RUNNING>ns 1H.8001A05A3E5
(Alt) + M Toggle mouse on/off. This command has no effect unless a mouse driver is loaded and ncterm was started with a mouse configuration file.
(Alt) + 1 or 2 or 3 Switch to multi-screen 1, 2, or 3.
(Alt) + Q All multi-screen connections are terminated and ncterm quits back to the DOS prompt or to Windows.
You can print to a Local printer Attached to a DOS PC running NCTERM.EXE instead of displaying the data. From the terminal screen on the DOS PC execute the following.
echo "\033[4i" ; turn on printing cat <filename> ; send file to printer echo "\033[5i" ; turn off printing
NCTERM will print the file <filename> on the local printer. These commands can be put into a shell script or used in the output section of a printer interface.
Ncterm can display 132 columns on a PC equiped with a VESA display adapter. To change to 132-column display mode:
echo "\033[?3h" ; display up to 132 characters per line.
echo "\033[?3l" ; change back to 80-column display.
Usage
ncterm [-?]
ncterm [-v]
ncterm [-1] [-e emulation] [-m mouse_configuration_file] [server-name[/login_name password]]
Emulation is one of the following: ansi, vt100, or none. In terminal mode:
(Alt+1) MultiScreen 1 (Alt+2) MultiScreen 2 (Alt+3) MultiScreen 3 (Alt+H) Hangup current session. (Alt+M) Toggle mouse on/off. (Alt+Q) Hangup all sessions and quit.
Files
lsl.com, ipxodi.com, netx.com
See Also
screen(HW), keyboard(HW), multiscreen(M), setcolor(C), setkey(C), usemouse(C)
Name
netcconfig - Configures Netware socket
Synopsis
netcconfig device [type]['network_number'][up/down][flags]
Description
The netcconfig command configures the IPX socket for the Network. This command is run automatically by "/usr/bin/netcon.rc". The command may be executed at any time with the "device" argument and it will display the current configuration.
Options
device On SUN "nit0" SCO "str0" socket/streams interface.
type Always "ns" for XEROX NETWORK SYSTEM
'network_number' The network number is always "X0".
up/down Start/Stop
flags Always -trailers
Usage
netcconfig nit0 ns "XO" up -trailers
netcconfig str0 ns "X0" up -trailers
Files
"/dev/netcon", "/dev/nit0"
See Also
None
Name
netclink - netcon Streams linker
Synopsis
netclink [drivers] [interface]
Description
Netclink is used to specify the configuration of the network IPX protocol stack and hardware driver. This command is executed by the NetCon start-up script "/usr/bin/netcon.rc". On SCO UNIX/ODT the driver is an SCO LLI 3.10g supporting both 802.3 and TYPEII Ethernet.
Options
drivers Any SCO LLI 3.10g or later driver on Sun "/dev/nit0"
interface /dev/str_ether2 - TYPE II Ethernet 8137 econfig format
/dev/str_ether - 802.3 packet format STD NetWare format
/dev/str_token - Token-Ring interface
Usage
netclink /dev/wdn0 /dev/str_ether2
Files
/usr/bin/netcon.rc
See Also
None
Bugs
None
Name
netcload - AIX kernel module loader for NetCon.
Synopsis
netcload [-c] [-u] [-e /dev/ent0 - 1] Called from "/usr/bin/netcon.rc"
Description
Load kernel modules for NetCon for Ethernet 8137 or Novell Standard non-standard 802.3. Netcload is normally executed by netcon.rc at system boot time.
Usage
netcload -c -e /dev/ent0 To load with Novell standard 802.3
netcload -c For TYPEII Ethernet 8137
netcload -u To unload (must reboot to reload)
Options
None
Files
/usr/bin/netcon.rc /usr/bin/netcload
See Also
netcon.rc (1), netcload (1).
Bugs
IBM will not allow modules with a file system to unload. You must reboot to reload.
Name
netcmount - Mounts a Netware file system as a UNIX file system
Synopsis
netcmount netcmount SERVER-NAME:VOLUME: DIRECTORY mount_directory [-r]
Description
Netcmount mounts a Netware file system or a remote UNIX file system (with NetCon installed on it) as a local UNIX file system. The file system so mounted may be unmounted with the standard UNIX umount command.
If a default NetWare-server user and password have not yet been assigned, netcmount will prompt for a valid NetWare user name and password. Supply an existing NetWare user name and password to these prompts or the mount will fail. The password is not displayed on the screen as it is typed. The network user must have a password.
Options
Server-Name Specifies the name of the Netware Server followed by a colon (:).
Volume Specifies the NetWare VOLUME to be mounted followed by a colon (:).
Directory Specifies the NetWare Servers volume directory path to be mounted. Use the normal UNIX directory delimiter, the forward slash (/). The UNIX user must have trustee rights to use this directory and be properly mapped with the netcon administration menu utility.
mount_directory Specifies the local UNIX directory upon which the NetWare Server file system is to be mounted.
-r Specifies the named directory as read only.
Usage
/usr/bin/netcmount NETWARE:SYS:/ /netware
Files
/usr/lib/netcon/netcobj.dat
/usr/lib/netcon/netcprop.dat
See Also
mount, umount, netcpass and the System Administrator Guide and the NetCon Menu utility for details on mapping Unix users to NetWare users.
Bugs None
Name
netcon.rc - NetCon Network startup file
Synopsis
netcon.rc [start/stop]
Description
Network start up file called during boot by /etc/rc.local or /etc/rc2.d/S90netcon file. This script is executed automatically during start-up and shutdown and CANNOT be executed manually.
Options
start Starts the Network
stop Stops the Network
Usage
netcon.rc start
Files
All files in /usr/lib/netcon are affected.
See Also
None
Bugs
None
File Layout : # # Copyright 1995 NetCon Corporation # All Rights Reserved # # NetCon start/stop script # Usage: netcon [ start | stop ] # INTERNAL_NET_NUMBER=aaff PROCS="netcpass netcconfig netclink netcnblink netcvt" PATH=/bin:/usr/bin:/etc:/usr/etc:/usr/local/bin:/usr/lib/netcon: case "$1" in start) set `who -r` if [ $9 != "S" ]; then exit 0 fi echo "Starting NetConMT Network Client and Server, Release 6.0" echo "Copyright (c) 1986, 1995 NetCon Corp." echo "Copyright (c) 1984, 1989 Regents of the University of California." echo "All rights reserved." /usr/bin/netclink /dev/wdn0 /dev/str_ether2 & echo "netclink \c" cd /usr/bin /usr/bin/netcconfig str0 ns `X0' up -trailers /usr/bin/netcpass -f & echo "netcpass" /usr/bin/netcconfig str0 sleep 2 # Start NetCon Server, Terminal Servers and ADV protocol here cd /usr/bin su root -c "/usr/bin/netcserv > /dev/null 2>&1 &" echo "netcserv \c" su root -c "/usr/bin/netcvt > /dev/null 2>&1 &" echo "netcvt \c" sleep3 # Stick NetWare file mounts here ###mount /usr/bin/netcmount NETWARE:SYS: / /netware & echo "" ;; stop) echo "NetCon Shutdown..." # # Find all the daemons # PX="" OR="" for P in $PROCS do PX="$PX$OR$P" OR="|" done PX="/$PX/" /bin/su - root -c "/bin/ps -e" 2>/dev/null | \ /usr/bin/awk "$PX { print \"kill \" \$1 }" | /bin/sh /usr/bin/netcrestart -s echo "NetCon Shutdown Complete." ;; *) echo "Usage: $0 [start | stop]" exit 1 ;; esac
Name
netcterm - UNIX to UNIX network virtual terminal emulator.
Synopsis
netcterm [SERVER_NAME]
Description
Netcterm is used to login to another NetCon server on the network from a UNIX system running NetCon. Netcterm reads from the standard input (normally the keyboard) and writes to the network (the remote NetCon server). Netcterm also reads from the network and writes to the standard output. The current terminal set-up remains in effect. The term type should be set up prior to the login to the remote NetCon server.
Options
[Server_name] Specifies the remote NetCon server name to login to.
Usage
netcterm SUN
Files
None
See Also
None
Bugs
None
Name
ncpr - UNIX shell script to set up the UNIX spooler to print to NetWare
Synopsis
/usr/lib/netcon/ncpr
Description
Ncpr is used to set the UNIX print spooler to print to a NetWare or NetCon server and print queue. The script prompts you for the new printer name, server name and queue name; then sets up a UNIX print spooler. See the system administration guide for details.
Usage
/usr/lib/netcon/ncpr
Files
/usr/spool/lp/model/NC
/etc/printcap
/usr/lib/netcon/printcap.sun
See Also
netcprint
Bugs
None
Name
netcorasql - Provides SPX protocol support for ORACLE7 Servers with SQL*Net TCP(V1).
Synopsis
netcorasql [ -s oracle_server_name -p tcp_port -i ipx_port# -b send_buffer_size -d]
Description
Netcorasql provides SPX protocol support to existing ORACLE7 Servers running over TCP/IP with ORACLE SQL*Net TCP (V1). Thus allowing connections from WINDOW's workstations running ORACLE SQL*Net SPX Version 1.1 and 2.1 for Windows with ODBC drivers. The netcorasql daemon once started listens for connection requests on SPX port number 0x83fa by default, the NetCon Server "netcserv" broadcasts SAP's (Service Advertising Protocol) packets and maintains a bindery entry for Server type 0x0103 (ORACLE7 Server) on SPX port 0x83fa. If the port number must be changed it must be changed for both "netcserv" and "netcorasql". The default values for oracle_server_name, tcp_port, ipx_port and send_buffer_size should never be changed under normal conditions. The oracle_server_name [orasrv] is used to determine the TCP/IP port number with a call to getservbyname("orasrv"). When "netcorasql" receives a connection request it connects to the ORACLE7 server via this TCP/IP port number, routing all incoming SPX packets to ORACLE7 server and outgoing packet from the ORACLE7 Server to SPX.
Options
[ -s oracle_server_name] ORACLE SQL*Net TCP/IP server process, default [orasrv].
[ -p tcp_port] Derived from "oracle_server_name", default [0].
[ -i ipx_port#] SPX listen port must match "netcserv", default [0x83fa]
[ -b send_buffer_size] Normally Set by Client to the default[534] to honor the OLD 576 byte IPX/SPX routing limit. [ -d] Turns on debugging (tracing)
Usage
# netcorasql (Return)
Files
/usr/bin/netcon.rc add netcorasql to startup script turn on SAP, netcserv
/etc/services should contain "orasrv 1525/tcp"
/usr/bin/netcserv provides SAP services.
ORACLE_HOME/bin/orasrv ORACLE SQL*Net Server
/etc/orattab ORACLE_SID
See Also
netcserv, netcon.rc
Requirements
Windows 3.1: Oracle SQL*Net SPX for Windows Version 1.1, ORACLE7 ODBC Driver.
Solaris 2.x: ORACLE7 server install with the following options;
ORACLE7 Server (RDBMS).
Distributed Database option.
Procedural Option (PL/SQL V2).
TCP/IP Protocol Adapter (V2).
Multi-Protocol Interchange.
SQL*Net TCP (V1).
MTS (Multi-Threaded Server) must NOT be configured at this time. Answer NO to the question "Would you like MTS (Multi-Threaded Server) configured and the SQL*Net Listener automatically started" during ORACLE7 installation.
The ORACLE7 database must be started, mounted and "orasrv" must be running.
Name
netcpasswd - Change bindery password
Synopsis
netcpasswd [-d] [network_server] [network_login_name]
netcpasswd [-d] [unix_login_name]
Description
Netcpasswd performs two different functions. In both cases it is used to change NetCon user passwords stored in the NetCon bindery. Two different types of passwords are stored in the bindery. One type is used to log a mapped unix user into a mounted server. See netcmount (1). The second type is the password a NetCon client uses to log into the NetCon server. Netcpasswd is used to change either type of password, depending on the invocation.
To change a mapped user's password, you must provide the name of the server and the user's login name for that server on the command line when netcpasswd is invoked. For example:
$ netcpasswd NETWARE SUPERVISOR
This command would be used to change the password used to login as user SUPERVISOR on a server named NETWARE. The mapping for this user must exist; that is, the MAPPED_USER property that maps NETWARE user SUPERVISOR to a valid unix user must be present in the bindery. If this mapping is not found, netcpasswd will terminate with the message:
Network user SUPERVISOR not found.
Netcpasswd will also fail if you are not the superuser and your unix login name does not match the unix login name mapped to this network user.
If there is an old password and you are not the superuser, you will be prompted to enter the old password first. In any event, you will then be prompted to enter the new password twice. This password permits a mapped unix user to access a mounted NetWare or NetCon server as the mapped user rather than as the default user.
Users must be mapped to maintain file access security permissions. The NetCon administration program is used to map the user to the server. Because the password may be assigned at that time, netcpasswd is primarily used to change the password at a later time.
The second purpose of netcpasswd is to add or change a client's password. Clients wishing to login to a NetCon server must have a password stored in the PASSWORD property in the bindery. The second form of the netcpasswd command is used to change this password. A valid unix user's login name may be supplied on the command line. If no login name is given, it defaults to the current login name. Only the superuser can change the password for login names other than his own. The netcon administration program may also be used to add or change the password.
Options
The only option, -d, may be used to display progress information as the program executes.
Files
/usr/lib/netcon/netcobj.dat
/usr/lib/netcon/netcprop.dat
See Also
netcmount (1), NetCon Administrator's Guide for user mapping information.