The options in the Add Program area of the wizard page are available by default when you select the Use an iSeries program or procedure radio button. The options, which are described in the following table, are used to define the program object or service program object that you want to call. If you have previously defined programs or service programs for Web interactions, the Edit Program area lets you change the options that you previously defined. Click the Add Program button if you want to define a new program or service program. You can also right-click the root icon or program icon in the Program Call definitions view and select Add Program.
Option | Description |
---|---|
Program alias | Enter a name as a program alias for the program object that you specify. This value is used when creating the Java classes for this interaction. |
Program object | The name of a program object or a service program object. It must be a valid iSeries object name. Click Browse and connect to an iSeries server to look up the program object that you want to call. See Browse for objects below for more information. |
Library | The name of the library that contains the program object. It must be a valid iSeries library name. You can also select *LIBL if the library that contains the program object is your library list, or *CURLIB if the library that contains the program object is your current library. The resulting path will be /QSYS.LIB/%LIBL%/programName.pgm. |
Program type | Default: *PGM. Select *PGM to indicate that the object is a program object. Select *SRVPGM if the object is a service program object. |
Entry point | The name of the procedure or function within a service program object. The target of this program call, to be supplied if the object is a service program object. Note that this value is case sensitive. Click Browse and connect to an iSeries server to look up the service program that you want to call. See Browse for procedures below for more information. |
CCSID of entry point | The CCSID of the entry point within a service program. For more information, see the service program entry notes in the ServiceProgramCall javadoc. |
Return type | The type of value, if any, that is returned from a service
program call. Only *SRVPGM objects can have a return type. void: The program does not return a value. integer: The program returns a 4-byte signed integer. The default value is void. void and integer are the only valid return types. The only way to have a service program return other data types is to specify an output or an input & output parameter, using Add parameter. |
Parse order | The order in which output parameters will be processed. The value specified is a blank separated list of parameter names in the order in which the parameters are to be processed. The names in the list must be identical to the names specified on the name attribute of tags belonging to the program. The default value is to process output parameters in the order the tags appear in the document. |
Thread safe | When you call a Java program and an iSeries program that are on the same server, use this field to specify whether you want to call the iSeries program in the same job and on the same thread as the Java program. If you know your program is thread-safe, setting the property to true results in better performance. To keep the environment safe, the default is to call programs in separate server jobs. The default value is false. |
Source location | If you want to view the program source to determine program or parameter attributes, select one of the following in the drop down list, then click View to see the source: |
Associate this program with the interaction. | This check box is automatically selected when the program
you are defining is the only program that appears in the Program call definitions
area. If more than one program appears in the list, you can select the program
that you want to use with the interaction you are defining:
A small asterisk on the upper right of the program icon indicates that it is associated with the Web interaction currently being defined. |
The Import PCML and Synchronize All buttons always appear on the page.
Control | Description |
---|---|
Import PCML | Click Import PCML to select a
standalone PCML file from your workspace or from the remote file system. You
can also select ILE COBOL or ILE RPG source code from the remote file system
which will automatically generate a PCML file for import..
Click OK to import the selected items into your current program call definitions. If the name of an imported item conflicts with the name of an existing item in the current program call definitions, a dialog box will appears to prompt users for overwrite. To keep existing item from overwritten, user should rename the item prior to import. If the selected item requires a structure, the wizard also imports the required structure. |
Synchronize All | If you retrieved properties of a field from the database reference on the iSeries host, and you find that the properties defined in the Web Interaction wizard no longer match the actual properties in the database reference, click Synchronize All to automatically refresh them. |
Allows you to select an object in the iSeries native libraries.
Allows you to select a procedure in the iSeries native libraries.
Allows you to select a file in the iSeries native libraries.
Allows you to select a file in the iSeries integrated file system or a local file system.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.