GETURI Frequently Asked Questions (FAQ)

Frequently Asked Questions (FAQ)

Following are some of the frequently asked questions about GETURI. When reporting problems, please send them via email stating the problem. Let me know what version of GETURI you are using. See the main FAQ for instructions on finding the version you currently have installed.

Is there an API interface to GETURI that I can use to return data to my program instead of reading data from a physical file or stream file?
Yes, with v3.00b of GETURI I have added an API interface. See the GETURI documentation for more information on use of this API interface.
I'm using GETURI with SSL and receiving and error code. What does the error code mean?
You can find descriptions of the return codes (RC) by following the instructions listed on this site. The text for the error number (errono) is listed in the message returned by GETURI. In the document listed the error number returned will be listed as a negative number. For example, if the return code is 24, you'll want to look up the value -24 on the site. (The GSK errors listed on this page are not applicable).
What licensed program do I need installed for SSL to work with GETURI?

You'll need to make sure you have cryptographic support installed. This is a free product from IBM. Contact your IBM Business Partner and they should be able to get it to you. Here are the Licensed Program details:

5722AC3 Crypto Access Provider 128-bit for AS/400
I'm making a GETURI request that uses SSL and receiving an authority error like "Error during initializing SSL. Permission Denied. RC(10) errno(3401)". What do I need to do to fix this?

This is because the user that is making the request does not have the proper authorities to the SSL keyring files and/or directory that are located in the IFS. The keyring files (on most systems) can be found by using the following command:

WRKLNK '/QIBM/UserData/ICSS/Cert/Server/*'
Do you have an example of using GETURI?

The easiest example is simply retrieving data from a web page. Using the following command you can retrieve the web page for Yahoo.com:

GETURI URI(yahoo.com)

The next example is an example of doing a currency conversion and passing data to the web page:

GETURI URI('www.xe.com/ucc/convert.cgi') DATA('Amount=100&From=USD&To=EUR') METHOD(*POST)

The next example is used to POST data to a web service. For example, this could be used when posting XML or a SOAP envelope to a web service. The data in italics should be replaced with the proper information for your web service call:

GETURI URI('server/path') OUTPUT(*STMF) STMF('/path/to/output.ext') DATA(* STMF) DSTMF('/path/to/input.ext') METHOD(*POST)