auto-disconnect command

The auto-disconnect command allows certain clients the capability to disconnect from the server with a custom delay, reserving the line for reconnect.

Syntax

auto-disconnect [(n[-m])] {delay time} {(C

Parameter(s)

n Indicates the PIB number of the process from which you want to log off.
n-m Specifies a range of PIB numbers of the processes from which to log off.
delay time Specifies the number of minutes to reserve the line associated with the process (or processes). The maximum delay time is 32,767 minutes (approximately 22 days, 18 hours).
(C

If you specify the C (Clear) option, the feature is disabled for the specified process (or processes). The process remains connected when the client is at the Logon Please: prompt.

If there is only one parameter, then:
  • If you are using the C option, the first parameter is the PIB number.
  • If you are not using the C option, the first parameter is delay time set on the current PIB number.
Note: With the current implementation, the auto-disconnect command only allows you to specify one range or lines. It does not support multiple comma-delimited ranges. For example: 1-5,10-13.

Description

The delay you define with the auto-disconnect command allows clients who want to reserve their connection (line) to do so while they are logged off.

The client disconnects at the specified time, reserving the line, and releasing the license consumed by the client. Using the delayed disconnect feature allows the license to be available to other clients. This allows a larger number of users to connect to a server over a period of time than are licensed to do so.

To resume the client connection, connect via normal methods. If a license is available for consumption, the client immediately commences connection on the associated line(s) and process(es).

Restrictions and Considerations

Consider the following information when evaluating the delayed disconnect and disconnect on logoff features:

  • With respect to licensing, both features are similar in that they make a license available for use by another client.
  • Disconnect on Logoff is defined in the Administration Utility (the Ports and Telnet Servers dialog boxes of the Workstation tab), while delayed disconnect is defined and activated with the auto-disconnect TCL command.
  • Disconnect on Logoff affects only the process linked to the line connected to a COM port. The auto-disconnect command affects the process regardless of client type.
  • Disconnect on Logoff overrides the auto-disconnect command, causing an immediate disconnect regardless of the setting of the auto-disconnect feature.
These client types may use delayed disconnect:
  • Telnet clients connected via an mvTelnet server
  • Terminal clients connected via a COM port
  • mvTerm clients

Using the auto-disconnect command

Perform these steps when you are ready to disconnect a qualified client from the server:
  1. Run the auto-disconnect command line at TCL.

    See the format and parameter descriptions for more information.

  2. Press Enter.

Example(s)

This example disconnects line 1 after 10 minutes at the Logon Please: prompt.

auto-disconnect 1 10

This example disconnects lines 2 through 4 after 5 minutes at the Logon Please: prompt.

auto-disconnect 2-4 5

This example clears the auto-disconnect command settings for line 1.

auto-disconnect 1 (C

This example clears the auto-disconnect command settings for lines 2 through 4.

auto-disconnect 2-4 (C