The declarations of the structures of the SM2GMS macro are in SM2GMS.H, and the definitions of the symbolic constants for evaluating the return codes are in SM2RC.H.
The “SM2GMS_get_measurement_stat_mdl” structure, which is used to call the macro, contains the “hdr” structure element of the structure type ESMFHDR (this structure is declared in FHDR.H) and the “status” structure element of the structure type “SM2GMS_status_data_mdl”.
The macro sets parameters internally in “hdr”, and it also stores its return codes there. The evaluation of the return codes is described in section "Evaluating the return codes".
The macro supplies the “host_name” element internally with the value passed by the caller in the “host_name” parameter.
In the “status” structure element, the macro stores its information on the status of SM2. This information corresponds to that in the MEASUREMENT STATUS screen.
The “status” structure element contains four elements of the structure type “SM2GMS_measurement_program”, in which displays for the defined and active monitoring programs of SM2 are set. By querying these flags, the user can check whether the associated monitoring programs for the data buffers requested with the SM2GDAT macro are activated in SM2.
The “ss_sm2_status” should also be noted. This indicates whether the SM2 subsystem should be unloaded.