INQY ENVIRON2 enhancement

The new INQY call ENVIRON2 subfunction returns more information about an IMS execution environment than the ENVIRON subfunction. ENVIRON2 returns output such as primary and active JVM addressing modes, Managed ACB activation, IMS installed version, and IMS function level. To use this enhancement, install APAR/PTF PH45098/UI90543.

The ENVIRON subfunction remains unchanged to preserve compatibility with existing application programs. The new IMS DL/I INQY call ENVIRON2 subfunction includes all the values that are returned by ENVIRON, and adds the following information:

An integer value that represents the address mode of the Java virtual machine (JVM) requested for an IMS dependent region.
A field to indicate whether the program is running in a Managed ACB environment.
IMS installed release level, IMS function level, and IMS functions enabled bitmap.
A version number for the INQY ENVIRON2 output.

Recommendation: The INQY ENVIRON2 DL/I call expands the returned output length from x’7E’ (decimal 126) bytes to x’B2’ (decimal 178) bytes. If the buffer provided for the output area is too short, the call completes with status code AG, and the output is truncated. To ensure that the output area is large enough, specify a length of 512 bytes, which provides sufficient length and accommodates future expansion of INQY ENVIRON2.

Documentation changes

The following table lists the publications that contain new or changed topics for the INQY call ENVIRON2 enhancement.

Table 1. Links to topics that have new or changed content for this enhancement
Publication	New or changed topics
Application programming APIs	INQY call INQY call (Transaction Manager) CALL FUNCTION statement System service call summary
System definition	APARM= parameter for procedures EXEC parameters for IMS batch message processing regions EXEC parameters for IMS message processing regions
IMS messages and codes	AQ