PreviousNext
Help > XML Easycom > Request XML stream > Program tag
Program tag

 Program tag is used to effectively call a program or procedure.

Program tag can be expanded with the following elements.

 

<program  name="Procedure_Name"

  <parameterlist>

    <data_name  [ usage="input" ]
     [ encoding="base64" ] >input value </data_name >

  </parameterlist>

</program>

 

Attribute

Value

Description

name=

Procedure name

Name of a procedure previously defined in a <define> tag in the current or previous XML file.

 

<parameterlist>

List of input values

This sub tag includes all the values for all input parameter elements.

 

<data_name>

Parameter or Element name

This tag has the name of the parameter or the name of the member when parmeter is a structure.

 

<input value>

String

Input value for the parameter or data structure member.

When parameter is a data structure, it is divided into members, and value is set for each member. There is no input value at data structure level.

In the following example, QObjName is a DS, divided into two members: Obj and Lib.
Value is set for each member.

<parameterList>

  <receiverLength>4096</receiverLength>

  <QObjName>

    <Obj>CRMSRVP01</Obj>

    <Lib>*LIBL</Lib>

  </QObjName>

</parameterList>

 

 

usage

Input

When program definition is loaded from an RPG source, input or output usage is usually not set by RPG.

This attribute can be used at execution time to tell the system we don’t expect a value on return for this parameter.

 

encoding

Base64

When encoding is set to "base64", input value must be provided in base64 format. Value will be converted as it, from base64 to binary, without any other character conversion.

 

 

Example

<?xml version="1.0" encoding="utf-8" ?>

<Easycom>

<Program Name="qbnrpii">

   <parameterList>

      <receiverLength>4096</receiverLength>

      <QObjName>

         <Obj>CRMSRVP01</Obj>

         <Lib>*LIBL</Lib>

      </QObjName>

   </parameterList>

</Program>

</Easycom>

 

This tag is processing the effective call of the program or procedure.