Add structure

Use the Add Structure option in the Web Interaction wizard to define a structure that can be used as a parameter. Use only literal values for each field.

Option Description
Structure name The name for the structure. Do not use blanks or hyphens in the name.
Count If the structure is an array, Count specifies the size of the array. If the Count field is blank, the structure 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 whether the structure is used for input, output, or input and output. (Character and numeric types are converted.)
input & output
The structure provides input to the host program and receives output from the host program. This is the default.
input
The structure provides input to the host program.
output
The structure receives output from the host program.
Output size The number of bytes to reserve for output data for the structure. See the outputsize attribute in PCML struct tag.
Min. version The lowest version of OS/400 on which this structure exists. See the minvrm attribute in the PCML struct tag description.
Max. version The highest version of OS/400 on which this structure exists. See the maxvrm attribute in the PCML struct tag description.
Offset The offset to the structure within an output parameter. See the offset attribute in the PCML struct tag description.
Offset from The base location from which the offset attribute is relative. See the offsetfrom attribute in the PCML struct tag description.

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 Workspace to open the Workspace File Selection window. Select a PCML file and click OK.
  • Click Remote File System to open the Browse for File window. Select a PCML file and click OK. If you are importing a PCML file generated by the ILE RPG or ILE COBOL Program Verifier, choose Remote File System and navigate to your local workspace.

    A tree view of the selected PCML file is shown in the right pane of the window. You can select one or more structures and programs in the left pane.

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.