TotalNET Advanced Server 5.2 Reference Manual

Chapter 5 Client Utilities

TAS provides a set of PC utilities located under $TNHOME/usr/lib/pcbin. These utilities include general, NetWare, and SMB client utilities. For information on the location of the TotalNET home directory, see the TotalNET Advanced Server Release Notes.

General Client Utilities:

"utype" -- Displaying UNIX text files.
"version" -- Viewing the PC utility version.

NetWare Client Utilities:

Only DOS VLM/NETX clients support these utilities. You should use them only if you do not have NetWare login utilities:

"attach" -- Attaching to a server.
"capture" -- Management of port redirection.
"edscript" -- Editing login scripts.
"login" -- Logging in to a file server.
"logout" -- Logging out of a file server.
"map" -- Redirecting drives.
"slist" -- Listing active NetWare servers.

SMB Client Utility:

"nettime" -- Synchronizing system times.

utype

This command adds carriage returns to UNIX text files' lines so they can appear in DOS. UNIX text files and DOS text files differ in one character at the end of each line. DOS text lines end with a carriage return/line-feed (CLRF), and UNIX text files end with a line-feed only (LF). The text files appear on a local computer screen.

Location

$TNHOME/usr/lib/pcbin

Usage

utype file...

Option

file

Specify the name of the UNIX file to display.

Example

Use the following command to add carriage returns to the lines of UNIX text files alpha, beta, delta, and gamma, and display the files:

utype alpha beta delta gamma

version

This command displays the version of a PC utility on your server.

Location

$TNHOME/usr/lib/pcbin

Usage

version file...

Option

file

Specify the name of the PC utility whose version you want to view.

Example

Use the following command to display the version of the PC utility sketch:

version sketch

attach

This command accesses another NetWare file server while maintaining your current connections.

Location

$TNHOME/usr/lib/pcbin

Usage

attach server[/user]

Options

server	Specify the NetWare server to which you want to attach.
user	Specify the user name you want to use for connection to the server, if other than your current user name.

Example

Use the following command to attach to the server nwquest as user knight:

attach nwquest/knight

capture

This command manages redirection of local ports to a NetWare print queue.

Location

$TNHOME/usr/lib/pcbin

Usage

To direct a local port to a print queue:

capture s=server q=queue Lpt={1|2|3} [option...]

To remove a connection to a print queue:

capture Off ={1|2|3|ALL} [/Cancel]

To display the connection:

capture SHow

Options

server

Specify a NetWare server.

queue

Specify the name of a print queue on the NetWare server.

option

Specify either Notify or NoNotify and Autoend or NoAutoend:

Notify -- Send notification when data prints.

NoNotify -- Do not send notification when data prints.

Autoend -- Send data to the network printer when you enter or exit an application.

NoAutoend -- Do not send data to the network printer when you enter or exit an application.

This option defaults to NoNotify and Autoend.

Examples

Use the following command to direct local port 1 to print queue china through server wall and receive notification when the data prints:
capture wall china 1 Notify

Use the following command to remove connections from all print queues:
capture Off =ALL

Use the following command to display the print queue connection:
capture SHow

edscript

This command edits a NetWare login script file. For information on NetWare login scripts that work with TAS, refer to Chapter 6, NetWare Login Scripts.

Location

$TNHOME/usr/lib/pcbin

Usage

edscript option...

Option

option

Specify one of the following:

/user:name -- Specify a user other than yourself.

/server:name -- Specify a server other than the default.

/editor:command -- Specify an alternate editor program.

/system -- Specify the system-default login script.

/[no]temp -- Indicate whether or not to use a temporary file for editors which do not support UNC file names.

/[no]os2 -- Indicates whether or not to use OS/2-specific login script files.

/perm -- Permanently alters edscript to use the specified /editor:command, /[no]temp, and /[no]os2 settings.

Examples

Use the following command to specify user bungee and the server nwsproing:
edscript /user:bungee /server:sproing

Use the following command to specify editor program edscript:
edscript /editor:edscript

Use the following command to specify the system-default login script:
edscript /system

Use the following command to use a temporary file for editors that do not support UNC file names:
edscript /temp

Use the following command to avoid using OS/2-specific login script files:
edscript /noos2

Use the following command to permanently alter edscript to use the specified /editor:command, /[no]temp, and /[no]os2 settings:
edscript /perm

login

This command logs in to a NetWare file server.

Location

$TNHOME/usr/lib/pcbin

Usage

login [option...] server[/user]

Options

option

Specify one of the following:

/Clearscreen -- Clears your workstation screen after you enter your password.

/Noattach -- Invokes a login script without severing your current connections. Use this option with /Script=scriptname.

/Script=scriptname -- Overrides the system and user login scripts with a new login script if you include it right after login. Use this option with /Noattach.

server

Specify the name of the NetWare server to which you want to connect.

user

Specify the user name you want to use for connection to the server, if other than your current user name.

Example

Use the following command to connect to server plate as user fork and clear your screen after you enter your password:

login /Clearscreen plate/fork

logout

This command logs you out from one or all servers.

Location

$TNHOME/usr/lib/pcbin

Usage

logout [server]

Options

(no options)	Log out of all currently-connected servers.
server	Specify the name of the NetWare server to which you want to disconnect.

Examples

Use the following command to log out of all currently-connected servers:
logout

Use the following command to log out of the server fish:
logout fish

map

This command allows you to redirect a drive to a directory on a NetWare file server, delete a mapped drive, or view your current drive mappings.

Location

$TNHOME/usr/lib/pcbin

Usage

To map a local drive to a directory on a server:

map [option...] drive: server/volume:[\\directory]

To delete a mapped drive:

map DEL drive:

To show mapped drives:

map [drive:]

Options

(no options)	Show all mapped drives.
option	Specify one of the following: ROOT -- Map a drive to a fake root directory on the server. INSert[=n] -- Change search drive mappings.
drive	Specify a local drive.
server	Specify the name of the NetWare server.
volume	Specify the volume on the server to which you want to map.
directory	Specify the path under volume to which you want to map.

Examples

Use the following command to show all mapped drives:
```
map
```

Use the following command to map the E drive to a fake root directory on server tongue and volume cheek:
```
map ROOT E: tongue/cheek:
```

Use the following command to change the search drive mappings for the F drive on server tooth and volume claw:

map INSert F: tooth/claw:
Use the following command to map the G drive to the directory force/field
on volume five of server jet:
map G: jet/five:\\force/field

slist

This command lists active NetWare servers. If you include the wildcards "*" or "?", servers whose names match the patterns appear in the list. The display pauses automatically after each 20 servers.

Location

$TNHOME/usr/lib/pcbin

Usage

slist [server] [/Continuous]

Options

(no options)	List all active NetWare servers on the network.
server	Specify the pattern of server names to list.
/Continuous	Display the list without pauses.

Examples

Use the following command to list all active NetWare servers on the network and display the list without pauses:
slist /Continuous

Use the following command to list the server green, if active:
slist green

nettime

This command displays the system time on a SMB server and synchronizes local computer time with the server system time.

Location

$TNHOME/usr/lib/pcbin

Usage

To use this utility, map a volume on the server whose time you want to display to a local drive. Then run this command:

nettime drive: [/S]

Options

drive	Specify the mapped server drive.
/S	Synchronize the local time with the server time.

Examples

Use the following command to display the system time on the SMB server mapped to the E drive:
nettime E:

Use the following command to synchronize the local time with the time of the server mapped to the E drive:
nettime E: /S