Sign in

docs ILE Concepts

Object compatibility

Object compatibility

Object compatibility

Use the Display Program (DSPPGM), Display Service Program (DSPSRVPGM), or Display Module (DSPMOD) command with DETAIL(*BASIC) to determine whether your module or program object is able to run correctly without first being converted. The value of the Conversion required field is either *YES or *NO. If the value of Conversion required is *YES for a program object, the program is converted the first time it is activated. Alternately, you can use CHGPGM FRCCRT(*YES) or Start Object Conversion (STROBJCVN) to force conversion to occur at a more convenient time. See Optimizing Compatible Programs for more information about when these two commands can be used.

If the value of the Conversion required field is *YES for a module object, and the module object is not in an older format (see *FORMAT in the following table), binding this module object into a program or service program results in a program object that also requires conversion. This outcome is useful when you are building programs for deployment to a system that has more features than the build system. If the value of the Conversion required field is *NO, then your program or module object is ready for immediate use.

The reason that a module or program object requires conversion can be determined by viewing the Conversion details field. This field has one of the following values.

ValueMeaning
*FORMATThe object is not compatible with the current machine. The object is in an older format. (For example, objects created for releases earlier than 6.1 are in a different format from objects created for 6.1.) Binding a module object in an older format causes the bound module to be converted.
*FEATUREThe object is not compatible with the current machine. The object format is compatible with the current machine, but the object uses at least one feature that is not supported by the current machine.
*COMPATThe object is compatible with the current machine. The object format is compatible with the current machine, and all features that the object uses are implemented by the current machine. However, the object uses at least one feature that is not supported by the common level of hardware supported by version, release, and modification level that the object was created for.
*COMMONThe object is compatible with the current machine. The object format is compatible, and all features that the object uses are implemented by the common level of hardware supported by the version, release, and modification level that the object was created for.