Edit Web service parameters

Edit parameters on the Object Selection page in the Web Service wizard to define a parameter required by the Web service that you want to call. Note that some of the values for parameters in a Web service are pre-determined and cannot be modified. For Web services, the default usage designation of "input & output" is often not ideal; use this page to change the parameter's usage.

Option Description
Parameter name The name of the parameter.
Usage The usage of the parameter (character and numeric types are converted):
input:
Input to the host program.
output:
Output from the host program. Character and numeric types are converted.
input & output:
Both input and output. This is the default value.
inherit:
Usage is inherited from the parent element. If the structure has no parent, usage becomes input & output.
CCSID The host Coded Character Set ID for the character data type parameter. If this field is left blank, the default CCSID of the host environment is used. See the ccsid attribute in PCML data tag.
Data type (pre-defined) The type of data being used for the parameter:
  • character
  • UCS-2/graphics
  • integer
  • packed decimal
  • zoned decimal
  • floating point
  • byte
  • structure
  • structure name
Length (pre-defined) The length that the parameter requires. See Values for length and precision.
Precision (pre-defined) The number of bytes of precision for some numeric data types. See Values for length and precision.
Count (pre-defined) The size of the array. If Count is 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.

Values for length and precision

The length and precision attributes have different values for each data type. The following table lists each data type with a description of the possible values for length and precision.

character The number of characters for this parameter. Not applicable
UCS-2/graphics The number of characters for this parameter. Not applicable
integer The number of bytes for this parameter Indicates the number of bits of precision and whether the integer is signed or unsigned.
packed decimal or zoned decimal The number of digits of data for this parameter. The number of decimal digits for the parameter.
floating point The number of bytes for this parameter: 2, 4, or 8. Not applicable
byte The number of bytes of data for this parameter. Not applicable
structure Not allowed Not applicable

The following table shows the corresponding length and precision for integer declaration in an RPG program:

RPG Data type Length Precision
3 byte 1 Not applicable
5 integer 2 15 for signed, 16 for unsigned
10 integer 4 31 for signed, 32 for unsigned
20 integer 8 63 for signed

The following table shows the corresponding length and precision for integer declaration in a COBOL program:

COBOL Data type Length Precision
PIC 9(1) to PIC 9(4) integer 2 15
PIC 9(5) to PIC 9(9) integer 4 31
PIC 9(10) to PIC 9(18) integer 8 63
Related tasks
Creating an iSeries program Web service
Configuring your iSeries Web Service runtime environment
Testing an iSeries Web service
Developing iSeries Web services without source files