SHUTDOWN

Use the SHUTDOWN command to close the XDB Server program at a specified time. You can also use a variant of this command to cancel a SHUTDOWN request that you have issued.

Invocation

This command can embedded in a host language or executed interactively.

Authorization

Any of the following:

  • A super user
  • A user with SYSADM or SYSCTRL privileges

Syntax for SHUTDOWN AT

Use this command to shut down the server at a specific time or on a specific date. The syntax appears below:

SHUTDOWN AT {date-constant | time-constant | timestamp-constant}

For example:

SHUTDOWN AT 23:30:10
SHUTDOWN AT 10/09/1991
SHUTDOWN AT "1991-10-09-23.30.10.0"

Note that the timestamp value must be in double quotes. All users will be rolled back before shutdown.

Syntax for SHUTDOWN IN

Use this command to shut down the server in a specified length of time. The syntax appears below:

SHUTDOWN IN integer-constant duration
integer-constant Represents any short or long integer.
duration Represents a time duration descriptor.

For example:

SHUTDOWN IN 10 seconds
SHUTDOWN IN 2 hours
SHUTDOWN IN 6 months

All users will be rolled back before shutdown.

Syntax for SHUTDOWN ON LAST DISCONNECT

Use this command to shut down the server when the last user logs off the system. SHUTDOWN ON LAST DISCONNECT does not prevent new users from logging on to the server while the SHUTDOWN command is pending-- contrast this command with SHUTDOWN QUIESCE, below. If any new users log on to the server while the command is pending, the server will not shut down until after those users disconnect.

The syntax appears below:

SHUTDOWN ON LAST DISCONNECT

Syntax for SHUTDOWN QUIESCE

Use this command to disable new login requests and shut down the server when the last user logs off the system. SHUTDOWN QUIESCE prevents new users from logging on to the server while the SHUTDOWN command is pending-- contrast this command with SHUTDOWN ON LAST DISCONNECT, above.

The syntax appears below:

SHUTDOWN QUIESCE

Syntax for SHUTDOWN CANCEL

Use this command to cancel a SHUTDOWN command that is pending. The syntax appears below:

SHUTDOWN CANCEL