Bugfix/LS24005158/Fix params assignment at the end of program called

[davidepalladino-apuliasoft]

Description

This work improves the CALL and PLIST (as *ENTRY) where factors are evaluated in certain circumstance. In accord to official documentation:

• during the CALL:

C                   CALL     'PROG'
C     *IN30         PARM      *IN27         BYTE              1

the contents of factor 2, *IN27, are placed in the result field, BYTE. When PROG returns control, the contents of the result field, BYTE, are placed in the factor 1 field, *IN30.

• during the called program:

C     *ENTRY        PLIST
C     FieldA        PARM      FieldB        FieldC
C     FieldD        PARM      FieldE        FieldG

the contents of the result fields (FieldC and FieldG) of the parameter list are placed in the factor 1 fields (FieldA and FieldD). When the called program returns, the contents of the factor 2 fields of the parameter list (FieldB and FieldE) are placed in the result fields (FieldC and FieldG).

Technical notes

On Jariko this behaviour was not implemented. To achieve this goal, I have firstly re-factorized the PlistParam by renaming the attributes in right name for right context; then I have added a new attribute related for Factor 2; finally I have implemented the logic of assignment between program.kt and internal_interpreter.kt.

This resolves the problems thanks to the tests developed and executed on AS400.

Related to #LS24005158

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.