net-errors command

The net-errors BASIC program sets or displays error handling behavior when accessing remote files.

With no options, the current error handling behavior displays with these options:

Remote Error Logging When enabled, this logs all remote errors to the errors file.
Remote Error Notification When enabled, all remote errors are displayed on the users terminal.
Remote Error Intervention When enabled, all remote errors force the user to select an action from a menu.
Note: Even with this option disabled, intervention is required when an update operation fails.

If options are specified, then the error handling behavior is changed and then redisplays.

This command affects the current line only unless specified with the g option. The local settings have precedence over the global settings.

  • If net-errors indicates global on, then the local settings are not in effect and the global settings are used.
  • If net-errors indicates global off, then local changes are in effect.

The only way to revert from local to global settings is to set the global values. This can be done by either logging off and back on, or by setting the global values. Caution must be used with the latter because it affects all users using the global options (those that have not made local settings). In the latter case, consider checking the existing global options using net-errors (g and then setting them to the same values shown using net-errors (g <options>.

Syntax

net-errors {(options)}

Synonym(s)

remote-errors

Parameter(s)

options c Clears all error handling options.
g Sets the options specified with the net-errors command globally for all lines. If no other options are specified, displays the global default options.
l Enables error logging.
n Enables user notification.
i Enables notification and intervention on all errors.
s Suppresses the option display.
Warning: The selection of any option clears all other options. As such, it is necessary to specify all desired options when changing the behavior. net-errors processes the given options in the order specified. For example, net-errors (lcn will enable logging, then clear all settings (including the logging that was just enabled), and then finally enable notifications.

Example(s)

net-errors
Remote Error Logging
on
Remote Error Notification
on
Remote Error Intervention
on

net-errors (i
Remote Error Logging       off
Remote Error Notification  on
Remote Error Intervention  on

net-errors (n
Remote Error Logging       off
Remote Error Notification  on
Remote Error Intervention  off

net-errors (c
Remote Error Logging       off
Remote Error Notification  off
Remote Error Intervention  off

net-errors (l
Remote Error Logging       on
Remote Error Notification  off
Remote Error Intervention  off