InetIn

Downloads all, or part, of the current server handle.

Synopsis

error = InetIn(variableName, flags, size)

Args

variableName is the name of some REXX variable that you wish to be set to the downloaded data.

flags specifies some options. It may be any of the following, each separated by a | character:

ValueMeaning
FREE Free the current server handle automatically after download.

If omitted, flags defaults to none of the above.

size is the number of bytes to download of the resource. Omit this if you wish the entire resource to be downloaded.

Returns

An empty string if successful, or an error message if a problem.

Notes

If you call InetIn before calling InetConnectUrl(), InetConnect() or some other function to set the current server handle, then a REXX SYNTAX condition is raised. CONDITION('E') returns error number 40.1 and CONDITION('D') returns the message DLL function "INETIN" reported server handle not open!.

If you specify a size, and the resource is less than that number of bytes, then the returned data will be only as many bytes as are available.

InetMaxIn determines the largest resource that InetIn can download.