When executed in the browser, this example will display a file name. In this example, you first use the Server.CreateObject command to access the Connection and Recordset ActiveX objects. Next, you use the Open method of the Connection object. The first parameter provided on this command defines the ConnectionString. This value contains the provider name, which in the case of the iSeries is IBMDA400, and the data source, which will be the name or IP address of your iSeries. The next two parameters define the user ID and password to be used to log on to your iSeries.

Once you've defined your Connection, you're ready for the Recordset. Again, you use the Open method, but this time the two parameters provided define the data source and the Connection object to be used to access that source. The data source parameter contains a simple SQL SELECT statement that defines the data you want to retrieve.

In this example, you are selecting all fields from the SYSTABLES catalog. Next, you use the MoveFirst method to move to the top of the selected Recordset. The final line shown sends the value of the first field from the recordset to the client browser, using the Fields collection. This collection can be accessed by using a numeric value to represent the position of the field in the file or by using a text string containing the field name itself, as shown below:

The Command object is similar to the Recordset object in that it allows you to access data within your database. As the name suggests, however, this object allows you to modify the data within this database. The sample shown below could be used to delete all records from the specified table:

Define the connection object as you did in the earlier example. Then, use the ActiveConnection property to define the connection to be used for the Command. Next, define the CommandText property of the Command object. In this case, it's nothing more than an SQL DELETE statement. Finally, use the Execute method of the Command object to execute the statement. You can also use the Command object to run a command on the iSeries. The example below uses the QCMDEXC API to execute a command on the iSeries:

In this example, you are using the OVRDBF command to override the member to be used the next time the file "MYFILE" is accessed. After you create the text for the command itself, you need to determine the length of the command to pass to QCMDEXC. Then, you define the CommandText parameter containing the QCMDEXC API. Finally, you use the Execute method to run the command. This override will be active throughout the life of the connection.

As you're working with ASP, one thing that can be troublesome is error handling, since there's no real debugging environment for ASP. There's a simple workaround, though. If you disable automatic error handling within your ASP script, you can trap the errors within the script manually. The example below does just this:

This modified version of the original example first uses the ON ERROR RESUME NEXT command to disable error handling and then uses the Errors collection of the Connection object to determine if the OLE DB provider returned any errors to the application. This is an easy way to monitor for SQL syntax errors or other errors within the definition of your data source.

This basic technique can be used over and over again to let you create entire applications using ASP to connect to the iSeries DB2 Database.

--Mike Faust
This email address is being protected from spambots. You need JavaScript enabled to view it.

Mike Faust is a senior consultant/analyst for Retail Technologies Corporation in Orlando, Florida. Mike is also the author of the books Active Server Pages Primer, The iSeries and AS/400 Programmer's Guide to Cool Things, JavaScript for the Business Developer, and SQL Built-in Functions and Stored Procedures. You can contact Mike at This email address is being protected from spambots. You need JavaScript enabled to view it..

---

MC Press books written by Mike Faust available now on the MC Press Bookstore.

		Active Server Pages Primer Learn how to make the most of ASP while creating a fully functional ASP "shopping cart" application. List Price $79.00 Now On Sale
		JavaScript for the Business Developer Learn how JavaScript can help you create dynamic business applications with Web browser interfaces. List Price $44.95 Now On Sale
		SQL Built-in Functions and Stored Procedures Unleash the full power of SQL with these highly useful tools. List Price $49.95 Now On Sale