Feature/ls24003953/parm factor1

[dom-apuliasoft]

Description

When using PARM with CALL operations, the first factor of the PARM can be used to specify where to put the "updated" value of the parameter when callee terminates its execution.

For instance in the following snippet, when PROCEDURE ends its execution, the new value of $A gets put in *IN36

     C                   CALL      'PROCEDURE'
     C     *IN36         PARM      *OFF          $A                1

This feature of PARM was unsupported.

From a technical standpoint changes concern:

• The addition of a result field in PlistParam
• The new AST creation rule for PARM factor 1
• The new assignment rule in the execute method of CallStmt
• The removal of a useless check in misc.kt during the creation of PlistParams

Related to:

• LS24003953

Checklist:

• If this feature involves RPGLE fixes or improvements, they are well-described in the summary.
• There are tests for this feature.
• RPGLE code used for tests is easily understandable and includes comments that clarify the purpose of this feature.
• The code follows Kotlin conventions (run ./gradlew ktlintCheck).
• The code passes all tests (run ./gradlew check).
• Relevant documentation is included in the docs directory.

[lanarimarco]

If this feature allows to put the parameter output in more than one field, I would add in the test case another parameter.

[dom-apuliasoft]

@lanarimarco test coverage should now be improved.
There are also 2 things that were added after the previous revision:

• A specific test where we check the behaviour when binding the same identifier to multiple parameters
• The PlusExpr evaluation rule with StringValue and BooleanValue (used in the new test cases)

All these behaviours have been checked on AS400 thanks to the support of @davidepalladino-apuliasoft

[lanarimarco]

Another little change