Use the Add Parameter option in the Web Interaction wizard to define a parameter required by the program object or service program object that you want to call. The maximum number of parameters for a service program is 7. Select the Advanced check box to show advanced attributes for a parameter. Use only literal values for each field.
Option | Description |
---|---|
Parameter name | The name for the parameter. Do not use blanks or hyphens in the name. |
Data type | The type of data being used for the parameter: character: Returned as a java.lang.String. The default value for data type is character. This data type takes one byte for each character. UCS-2/graphics: Returned as a java.lang.String. This data type takes two bytes for each character. Integer: Returned as a java.lang.Long. packed decimal: Returned as a java.math.BigDecimal. zoned decimal: Returned as a java.math.BigDecimal. floating point: Returned as a java.lang.Float if a length of 4 is specified; otherwise returned as a java.lang.Double for a length of 8. byte: Returned as an array of byte values (byte[]). The data is not converted. structure: The data type as a structure if the parameter is a structure. |
Structure name | The name of the structure being used as a parameter with structure data type. Define the structure first by clicking Add Structure. If the structure is defined, and you selected the structure data type, a list of names is shown in the Structure name field. |
Length | The length that the parameter requires. See Values for length and precision. You can enter a numeric or select a value from the drop-down list. Values in the list are data elements of type int that are referenced by your program. |
Precision | The number of bytes of precision for some numeric data types. See Values for length and precision. |
Count | The size of the array. If Count is left blank, the parameter is not defined as an array, although it may be defined as an element of a structure that is defined as an array. |
Usage | Specify if the parameter is used for input, output,
or input and output.
|
Initial value | An initial value for the parameter, if it is not explicitly set by the application program when the usage of the parameter is input or input & output. See the init attribute in PCML data tag. |
Output size | The number of bytes to reserve for output data for the parameter. This field should be left blank for fixed-size output parameters. See the outputsize attribute in PCML data tag. |
Bidi string type | The bi-directional string type for the parameter with data type character. See the bidistringtype attribute in the PCML data tag description. |
Trim | Trim white space from character data.
|
Min. version | The lowest version of OS/400 on which this element exists. See the minvrm attribute in the PCML data tag description. |
Max. version | The highest version of OS/400 on which this element exists. See the maxvrm attribute in the PCML data tag description. |
Offset | The offset to the element within an output parameter. See the offset attribute in the PCML data tag description. |
Offset from | The base location from which the offset attribute is relative. See the offsetfrom attribute in the PCML data tag description. |
CCSID | The host Coded Character Set ID for the character data type attribute. If this field is blank, the default CCSID of the host environment is used. See the ccsid attribute in the PCML data tag description. |
Passed by | How the parameter is passed. (Only for service program
parameters.) reference: The parameter is passed by reference. When the program is called, the program is passed a pointer to the parameter value. value: The parameter is passed by an integer value. This value is allowed with integer data type and a length of 4. |
Specify database reference field | Click Specify to add parameters
from a physical or logical data file, which has file type PD-DTA, LF, PF38-DTA,
or LF38. See Specify database reference
field. Click Synchronize to include changes that were made to the field definition in the data file after the parameter was first specified in the program call definition. |
Show database field definition | Click Show to list the data properties of the field definition in the data file for the parameter defined in the program call definition. |
See Data type conversion from database reference to see the data types for parameters in relation to the data types that are used in the database reference.
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. |
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.