GSGLIBV - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000

Returns the current version of the GeoStan library.

Syntax

01 GSFUNSTAT          PIC S9(9) BINARY.
*
CALL "GSGLIBV" USING GSFUNSTAT.

Arguments

GSFUNSTAT   Return value for the procedure. Output.

Return values

n Low Byte = Major version number.

n High Byte = Minor version number.

Prerequisites

GSINITWP

Notes

In general, the major version number changes whenever Precisely adds a new API features, or when the data structures in the GeoStan data files change.

Minor version number changes for each release of GeoStan.

Example

The best way to extract the high and low bytes is to subdefine GSFUNSTAT as follows:

01 GSFUNSTAT            PIC S9(9) BINARY.
01 GS-MINOR-VERSION     PIC 9(2) BINARY.
01 GS-MAJOR-VERSION     PIC 9(2) BINARY.         
CALL "GSGLIBV" USING GSFUNSTAT.      
DIVIDE GSFUNSTAT BY 256 GIVING GS-MINOR-VERSION                               
REMAINDER MAJOR-VERSION