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:
Value | Meaning |
---|---|
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.