4D v14.3

RESTART 4D

Home

 
4D v14.3
RESTART 4D

RESTART 4D 


 

RESTART 4D {( time {; message} )} 
Parameter Type   Description
time  Longint in Time delay (seconds) before 4D restarts
message  String in Text to display on client machines

The RESTART 4D command restarts the current merged 4D application.

This command is intended for use in the context of a merged application (client/server or single-user) and must be used in conjunction with the SET UPDATE FOLDER command. In this case, the automatic update process is launched: the new version of the application designated by SET UPDATE FOLDER automatically replaces the current version at the time of the restart resulting from RESTART 4D. The pathname of the data file is saved and used automatically. 

Note: If no update information was specified using the SET UPDATE FOLDER command in the current session, the command simply restarts the merged application with the same data file. 

RESTART 4D cannot be used outside of this context. In particular, it does not work for a 4D database that is not merged.

You can use the time parameter to defer restarting the application in order to give client machines time to disconnect. You must pass a value in seconds for the time. If you omit this parameter, the server application waits, for a maximum of 10 minutes, for all the client applications to be disconnected. After that, all client applications are automatically disconnected. 

Note: The time parameter is only taken into account with server applications (it is ignored in the case of a single-user application). 

The optional message parameter displays a custom message for connected client applications. 

If the command is executed correctly, the OK system variable is set to 1; otherwise, it is set to 0 and the application restarts. You can intercept any errors generated by the command using a method installed using the ON ERR CALL command.

 
PROPERTIES 

Product: 4D
Theme: 4D Environment
Number: 1292

The OK variable is changed by the commandThis command modifies the Error system variable

 
HISTORY 

New
Created: 4D v14

 
SEE ALSO 

Get last update log path
SET UPDATE FOLDER

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)