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. <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.