Command group | Flag affected | Reversible | Execute on client | Platform(s) |
---|---|---|---|---|
External commands | YES | NO | NO | All |
WebDevSetConfig ([errorproc,commstimeout]) Returns status
Note: The flag is set according to whether Omnis was able to make a call to this external command.
This Web command is multi-threaded, allowing another thread to execute in the multi-threaded server while it runs. Note that the same socket cannot safely be used concurrently by more than one thread.
WebDevSetConfig allows you to set some configuration options for the WEB commands. The WEB commands are the commands with names prefixed by CGI, FTP, HTTP, POP3, TCP, and UU, and the MailSplit and SMTPSend commands.
ErrorProc is the WebDevError method. WebDevError is an Omnis method which ALL of the other WEB commands call when an error occurs. WEB command execution is as follows:
Attempt to execute command
If no error occurs, return successful status.
If an error occurs, and there is no WebDevError method, return the error code.
If an error occurs, and there is a WebDevError method, call the WebDevError method, and then return the error code.
ErrorProc is an Omnis Character field containing the name of the WebDevError method, for example MYLIBRARY.MYCODE/MYPROC.
When a WEB command calls the WebDevError method, it passes it three parameters:
A character parameter containing an error message.
A long integer containing the error code.
A character parameter containing the WEB command name.
To clear the WebDevError method, either pass no parameters, or an empty first parameter, to WebDevSetConfig.
You can also optionally pass CommsTimeout to this command. CommsTimeout is a long integer, which specifies the number of seconds that WEB commands will wait to connect, or wait to receive data, before deciding that the remote application is not going to respond. Note: this time-out does not apply to TCPReceive. WebDevSetConfig multiplies this value by 60, to generate a value in 1/60th second ticks, and stores the resulting unsigned long integer. If you pass zero, this will set the time-out to the default value of 60 seconds. If you do not pass a CommsTimeout parameter, the time-out remains unchanged. A negative value will also cause the command to ignore server Blocking errors; in this case, the timeout will be the negated value of the parameter.
The WebDevSetConfig command returns a long integer Status. Zero for success, or less than zero if an error occurs. Possible error codes are listed in the Web Command Error Codes Appendix.
# call method $error in the current window instance a web error occurs
# $construct
WebDevSetConfig (con($cinst().$name,'.$error'))
# $error method
OK message Error executing [pCommand] {[pErrorCode] : [pErrorMsg]}
# $event of push button - force error so $error gets called
FTPConnect ('ftp.unknownserver.net','Username','Password') Returns lFTPSocket