RPG API程序参数DS字段新增的影响分析及编译必要性问询

问题描述 #

现有一个作为API使用的RPG程序需要修改，要对输入数据结构（DS）和输出数据结构各新增一个字段。该API采用外部结构定义DS，需先修改参考表（901_i/901_o），调用该API的现有程序也通过相同外部文件定义DS参数。部分调用程序不需要新增字段，现问询：这些程序是否会受此变更影响？是否需要进行编译等修改？
补充说明：实际场景中新增字段LimitAccessToSociety未放在DS末尾，而是置于GetNoOfRows字段之前，调用示例为callp IAC3003(...)，新增字段对应第一个参数。

核心结论 #

会受到严重影响，必须重新编译所有调用该API的程序，部分特殊场景还需调整代码。

具体影响与原因 #

• 数据偏移完全错乱：RPG中通过外部文件定义的DS，是严格按照字段在文件中的顺序、长度分配内存的。新增字段插在GetNoOfRows之前，会导致原DS中GetNoOfRows及之后所有字段的内存偏移量全部后移。未重新编译的调用程序传递的DS数据会出现字段错位——比如原本要传给GetNoOfRows的值会被API读取为新增字段LimitAccessToSociety的值，后续所有字段的对应关系全错，直接引发逻辑异常甚至程序崩溃。
• 参数传递匹配失效：新增字段作为参数位置的前置变更，导致调用程序的参数列表内存布局和API的新定义完全不匹配。哪怕调用程序不需要使用这个字段，它传递的DS结构已经不符合API的预期，API读取数据时必然出错。

处理要求 #

• 所有调用程序必须重新编译：重新编译时，编译器会根据更新后的外部文件（901_i/901_o）重新生成DS的内存布局，确保和API的定义一致，从根源上解决字段错位问题。
• 无需新增字段的程序无需修改代码：只要这些程序的DS是通过外部文件定义的，重新编译后会自动继承新的字段结构，不需要手动添加字段代码；但如果程序中有硬编码的字段偏移、长度相关逻辑，需要额外检查并调整。

内容的提问来源于stack exchange，提问作者Theju112