VERSION command processing

GIMAPI allocates the storage for AN API_VERSION structure. If the storage cannot be allocated, existing message GIM30700E is issued and the module terminates.

If allocation was successful, GIMAPI sets the elements of the structure with the values of the current version, release, modification and PTF level then returns to the calling program.

For example, the level of IBM SMP/E for z/OS, V3R6 is 36.00. As the result of a call to GIMAPI with the VERSION command, the elements of the API_VERSION structure are set as follows:

  apiver="03"
  apirel="06"
  apimod="00"
  apiptf="00"

The version can be accessed by the user as the complete string, "03060000" or as the previously listed individual parts.

The calling program needs to issue the FREE command at some point after calling the VERSION command.