Server Console Command Line Interface

Syntax Notes:
[]  Required parameter
<>  Optional parameter

DP <HELP or /HELP or ? or /?  <command> >

Description:   Displays the DiscView server console help
	  screen.  If a command is included,  command-
	  specific help will be displayed, otherwise the
	  syntax for all commands will be displayed.

Example:  DP HELP LOCK

	  This example displays specific information on the
	  LOCK command.

DP DEVICE INFO
							    
Description:   This command displays detailed information on
	  a device (e.g., CD-ROM drive) currently attached to
	  any host assigned to this server.

	  Use the related command DP DEVICE LIST to obtain
	  basic information on all attached devices.

Syntax:   DP DEVICE INFO [drive]

	  drive         is number of the device to be displayed
			(as shown using DP DEVICE LIST).

Example:  DP DEVICE INFO 4

	  This example displays information about device
	  number 4 (as shown using DEVICE LIST).

DP DEVICE LIST

Description:   This command displays basic information (in
	  list form) on every device (e.g., CD-ROM drive)
	  currently attached to all hosts assigned to this
	  server.

	  Use the related command DP DEVICE INFO to obtain
	  detailed information on a specific device.

DP DISCSERV

Description:   This command enables (or disables) the
	  DiscServ NLM if present on the server, permitting
	  CD-ROMs in drives attached to SCSI adapters in
	  this server to be mounted as NetWare volumes.

	  If no option is specified, the current status of
	  the DiscServ NLM, including the status of the ASPI
	  interface and host adapters, will be displayed.

Syntax:   DP DISCSERV <ON | OFF>

	  ON            enables the DiscServ NLM.
	  OFF           disables the DiscServ NLM.

Example:  DP DISCSERV ON

	  This example enables the DiscServ NLM, permitting
	  CD-ROMs in drives attached to SCSI adapters in
	  this server to be accessed.

DP DISMOUNT

Description:   This command is used to dismount DiscView 
	  CD-ROM volumes.

	  Note that DiscView CD-ROM volumes can also be
	  dismounted using the standard NetWare DISMOUNT
	  command.

	  If there are users with open files on the
	  specified volume, the dismount will not be
	  initiated unless the /Y option is included (see
	  below).

Syntax:   DP DISMOUNT [VolumeName] </Y>

	  VolumeName    is the name of the volume to be
			dismounted.  The volume must be mounted
			or in the process of being mounted (as
			shown using DP VOLUME LIST) to initiate
			a dismount.
	  
	  /Y            Forces the dismount even if there are
			users with open files.

Example:  DP DISMOUNT NSEPRO

	  This example dismounts the DiscView CD-ROM volume
	  named NSEPRO.

DP DISPLAY

Description:   This command enables (or disables) the
	  display of DiscView NLM diagnostic messages on the
	  server console.  These messages are typically used
	  to help diagnose DiscView related problems.

	  If no option is specified, the current status of
	  the DISPLAY command will be shown.  The normal
	  state is disabled (OFF).

	  Please see the related commands DP LOG and DP
	  LEVEL for more information.

Syntax:   DP DISPLAY <ON | OFF>

	  ON        enables the display of diagnostic
		    messages.
	  OFF       disables the display of diagnostic
		    messages.

Example:  DP DISPLAY ON

	  This example enables the display of diagnostic
	  messages.

DP GROUPS

Description:   This command displays a list of all user
	  groups defined on this server.  This command is
	  used in combination with the DP USERS command to
	  assign CD-ROM volume users.  Only groups can be
	  assigned to a CD-ROM volume using server console
	  commands.

DP HOST LIST

Description:   This command displays basic information (in
	  list form) on every host (e.g., DiscPort) currently
	  assigned to this server.

	  Use the related command DP HOST INFO to obtain
	  detailed information on a specific host.

DP HOST INFO

Description:   This command displays detailed information on
	  a host (e.g., DiscServ adapter) currently assigned
	  to this server.

	  Use the related command DP HOST LIST to obtain
	  basic information on all currently assigned hosts.

Syntax:   DP HOST INFO [defaultName]

	  defaultName   is default name of the host to be
			displayed (as shown using DP HOST LIST).

Example:  DP HOST INFO DISCPORT_123456

	  This example displays information about the
	  DiscPort named DISCPORT_123456 (as shown using DP
	  HOST LIST).

DP LEVEL

Description:   This command sets the level of the diagnostic
	  messages displayed on the server console when
	  DISPLAY is ON (enabled) or logged to a file when
	  LOG is ON (enabled).  As the level is increased,
	  the diagnostic messages become more numerous and
	  more detailed.

	  If no option is specified, the current LEVEL value
	  will be shown.  The default level is 20.

	  Please see the related commands DP DISPLAY and DP
	  LOG for more information.

Syntax:   DP LEVEL <value>

	  value     is a number between 1 and 255.

Example:  DP LEVEL 50

	  This example sets the level of diagnostic messages
	  to 50.

DP LOCK

Description:   This command is used to lock a device (e.g.,
	  CD-ROM drive) currently attached to any host
	  assigned to this server.  Locking prevents the
	  accidental removal of the media (e.g., CD-ROM) from
	  a device.  The lock is only maintained while the
	  device is attached to the host.

	  Please see the related commands DP UNLOCK, DP
	  VOLUME ADD and DP VOLUME RECONFIG for more
	  information.

Syntax:   DP LOCK [drive]

	  drive     is number of the device to be locked (as
		    shown using DP DEVICE LIST).

Example:  DP LOCK 4

	  This example locks device number 4 (as shown using
	  DEVICE LIST).

DP LOG

Description:   Enables (or disables) the logging of DiscView
	  NLM diagnostic messages to a file.  These messages
	  are used to help diagnose DiscView-related
	  problems.  Log entries are copied to the
	  SYS:SYSTEM\DISCPORT.CD\MSG.LOG file.  Log entries
	  are NOT created until the log file is closed (via 
	  the OFF or APPEND option).  If no option is specified,
	  the current status of the LOG will be shown.  The
	  normal state is disabled (OFF).

	  Please see the related commands DP DISPLAY and DP
	  LEVEL for more information.

	  Note that diagnostic messages do NOT need to be
	  displayed on the server console screen to log
	  diagnostic messages.

Syntax:   DP LOG <ON | OFF | APPEND>

	  ON        enables the logging of diagnostic
		    messages, overwriting any existing log
		    entries
	  OFF       disables the logging of diagnostic
		    messages, writing the entries for this
		    log session
	  APPEND    enables the logging of diagnostic
		    messages, writing the entries for the
		    current log (if enabled) and appending
		    new entries to the end of the current
		    log file

Example:  DP LOG ON

	  This example enables the logging of diagnostic
	  messages.

DP MOUNT

Description:   This command is used to initiate the DiscView
	  CD-ROM volume mount process.

Syntax:   DP MOUNT [VolumeName]

	  VolumeName    is the name of the volume to be
			mounted.  The volume must be LOADED
			state (as shown using DP VOLUME LIST) to
			initiate a mount.

Example:  DP MOUNT NSEPRO

	  This example initiates a mount of the DiscView 
	  CD-ROM volume named NSEPRO.

DP SCANDEVICES

Description:   This command forces the DiscView NLMs to
	  initiate the host and device discovery process.
	  The DiscView NLMs check existing hosts (DiscPorts,
	  DiscServ adapters, etc.) and drives for changes
	  about every 10 to 20 seconds and checks for
	  recently added hosts and drives about every 2 to 3
	  minutes.  The SCANDEVICES command forces the
	  DiscView NLMs to initiate this discovery process.

Syntax:   DP SCANDEVICES

DP UNINSTALL

Description:   This command unloads the DiscView NLMs and
	  removes all of the DiscView NLM files and sub-
	  directories on the server, in effect, uninstalling 
	  DiscView from the fileserver.  All DiscView
	  configuration, volume and user information is also
	  deleted.

Syntax:   DP UNINSTALL </Y>

	  /Y        Forces the uninstall.  This option must
		    be included to initiate the uninstall.

Example:  DP UNINSTALL /Y

	  This example initiates the uninstall process.

DP UNLOAD

Description:   This command disables the DiscView NLMs by
	  unloading them from server memory.  All currently
	  mounted CD-ROM volumes will be automatically
	  dismounted first.

Syntax:   DP UNLOAD </Y>

	  /Y        Forces the unload.  This option must be
		    included to initiate the unload.

Example:  DP UNLOAD /Y

	  This example initiates the unload process.

DP UNLOCK

Description:   This command is used to unlock a device (e.g.,
	  CD-ROM drive) currently attached to any host
	  assigned to this server.  Unlocking permits the
	  removal of the media (e.g., CD-ROM) from a device.
	  Devices always default to an unlocked state on
	  initialization.

	  Please see the related commands DP LOCK, DP VOLUME
	  ADD and DP VOLUME RECONFIG for more information.

Syntax:   DP UNLOCK [drive]

	  drive     is number of the device to be unlocked
		    (as shown using DP DEVICE LIST).
	  
Example:  DP UNLOCK 4

	  This example unlocks device number 4 (as shown
	  using the DEVICE LIST command).

DP VER

Description:   Displays the version number and creation
	  dates of all DiscView NLMs, including the NetWare
	  and CLIB versions.

Syntax:   DP VER

DP VOLUME ADD

Description:   This command is used to create a DiscView NLM
	  database file set for a CD-ROM disc, permitting it
	  to be mounted as a NetWare volume.  The size of
	  the database files average 100K and vary based on
	  the number of files and directories on the disc.
	  This process averages about 20 seconds and varies
	  based on the same items effecting size.  The
	  volume is not automatically mounted.

Syntax:   DP VOLUME ADD [Drive] [VolName] <MAC> <AUTOMOUNT>
	  <AUTOLOCK>

	  Drive     is number of the device containing the
		    CD-ROM to be added (as shown using DP
		    DEVICE LIST)
	  VolName   is name used when the CD-ROM volume is
		    mounted
	  MAC       enables volume support for Macintosh
		    clients
	  AUTOMOUNT enables automatically mounting the
		    volume whenever the CD-ROM is inserted
		    in a drive
	  AUTOLOCK  enables automatically locking the drive
		    whenever the CD-ROM is mounted

Example:  DP VOLUME ADD 4 NSEPRO AUTOMOUNT

	  This example creates a volume called NSEPRO for
	  the CD-ROM in device 4 (as shown using DP DEVICE
	  LIST), and enables automount.

DP VOLUME DELETE

Description:   This command deletes the database files and
	  configuration data associated with a CD-ROM
	  volume.

	  Please see the related command DP VOLUME PURGE for
	  more information.

Syntax:   DP VOLUME DELETE [VolName]

	  VolName   name of the volume to be deleted.

Example:  DP VOLUME DELETE NSEPRO

	  This example deletes information related to the 
	  CD-ROM volume named NSEPRO.

DP VOLUME INFO

Description:   This command displays detailed information on
	  a configured CD-ROM volume.

	  Use the related command DP VOLUME LIST to obtain
	  basic information on all CD-ROM volumes.

Syntax:   DP VOLUME INFO VolName

	  VolName   is name of the volume to be displayed
		    (as shown using DP VOLUME LIST).

Example:  DP VOLUME INFO NSEPRO

	  This example displays information about the CD-ROM
	  volume named NSEPRO (as shown using DP VOLUME
	  LIST).

DP VOLUME LIST

Description:   This command displays basic information (in
	  list form) on all configured or newly discovered
	  CD-ROM volumes.

	  Use the related command DP VOLUME INFO to obtain
	  detailed information on a specific volume.

Syntax:   DP VOLUME LIST <LOADED | MOUNTED | NEW | NOTLOADED>

	  LOADED    lists only configured volumes currently
		    in attached drives but not mounted
	  MOUNTED   lists only configured volumes currently
		    mounted
	  NEW       lists only newly discovered volumes
		    currently in attached drives
	  NOTLOADED lists only configured volumes NOT
		    currently in attached drives

Example:  DP VOLUME LIST MOUNTED

	  This example displays a list of all mounted CD-ROM
	  volumes.

DP VOLUME PURGE

Description:   This command deletes all of the DiscView CD-
	  ROM volume configuration information on the file
	  server.  All CD-ROM volumes must be dismounted
	  before initiating a volume purge.

	  Please see the related command DP VOLUME DELETE
	  for more information.

Syntax:   DP VOLUME PURGE [/Y]

	  /Y        Forces the purge.  This option must be
		    included to initiate the purge.

Example:  DP VOLUME PURGE /Y

	  This example deletes all CD-ROM volume information
	  from the server.

DP VOLUME RECONFIG

Description:   This command is used to change the
	  configuration of a CD-ROM volume established when
	  the volume was initially created (using the DP
	  VOLUME ADD command).  But unlike VOLUME ADD, this
	  command does not rebuild the database file set for
	  the volume, therefore the CD-ROM disc does not
	  need to be present in a drive to reconfigure a
	  volume.

Syntax:   DP VOLUME RECONFIG [oldName] [newName] <AUTOMOUNT>
	  <AUTOLOCK>

	  oldName   current name of the volume to be
		    reconfigured
	  newName   is the new name to be used when the 
		    CD-ROM volume is mounted
	  AUTOMOUNT enables automatically mounting the
		    volume whenever the CD-ROM is inserted
		    in a drive
	  AUTOLOCK  enables automatically locking the drive
		    whenever the CD-ROM volume is mounted

Example:  DP VOLUME RECONFIG NSEPRO NSEPRO AUTOMOUNT

	  This example enables automount feature for the
	  volume called NSEPRO without changing the volume's
	  name.

DP VOLUME USERS

Description:   This command is used to assign groups who may
	  access a CD-ROM volume when mounted.  Initially,
	  the EVERYONE group is assigned to a CD-ROM volume
	  when it is configured (using DP VOLUME ADD).
	  Users with SUPERVISOR equivalence will always be
	  able to access all mounted CD-ROM volumes.
	  Multiple groups may be specified as users.  The
	  list of possible user groups can be obtained using
	  the DP GROUPS command.  New groups can only
	  created using the NetWare SYSCON utility.

	  If no group names are specified, the current list
	  of user groups assigned to the volume will be
	  displayed.

Syntax:   DP VOLUME USERS [volName] <[group1] [group2] ...>

	  volName   is the name of the volume to be
		    modified
	  group1    is the name of a user group to be
		    assigned
	  group2    is another user group to be assigned

Example:  DP VOLUME USERS NSEPRO ENGINEERS TECHSUPPORT STAFF

	  This example assigns the users groups ENGINEERS,
	  TECHSUPPORT and STAFF to the volume called NSEPRO.


Copyright (C) 1994, Microtest, Inc.  All rights reserved.

Microtest is a registered trademark of Microtest, Inc.
DiscView, DiscPort and DiscServ are trademarks of Microtest, Inc.

Document Number: 19-814-0894-1
