Calling the MFDIST Program - GeoTAX_Premium - 7 - 7.7

GeoTAX Premium for Windows, UNIX/Linux, and z/OS

Product type
Software
Portfolio
Verify
Product family
Geo Addressing
Product
GeoTAX Premium
Version
7.7
Language
English
Product name
GeoTAX Premium
Title
GeoTAX Premium for Windows, UNIX/Linux, and z/OS
Copyright
2023
First publish date
1998
ft:lastEdition
2023-10-19
ft:lastPublication
2023-10-19T16:49:54.924301

The MFDIST program compares your two input latitude/longitude coordinates to GeoTAX and calculates the distance between these two points.

Note: MFDIST is valid only on z/OS.

Your calling program must pass the following parameters to MFDIST.

Parameter Area

Parameter Area Name

Description

Input

DSIIN

100-character input area consisting of subfields (DSIxxx) that contain input information and processing requirements.

Output

DSOOUT

50-character output area consisting of subfields (DSOxxx) that contain processing results and return codes.

The DSIIN Input Parameter Area

The following table describes the subfields in the DSIIN input parameter area.

Position

Name

Length

Contents

1

DSIFNC

1

Field that your program fills in:

E   End of job indicator: Nothing is stored in the output area. The calling program must clear active memory.

blank   GCP20 performs the distance calculation.

Other values are treated as blanks.

2-10

Reserved

9

 

11-18

DSILAT1

8

Latitude of the first coordinate. The first 7 positions must contain the latitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional: N or S (North or South).

Example: The latitude coordinate 39 degrees, 30 minutes, North, is expressed as 0395000N.

19-26

DSILNG1

8

Longitude of the first coordinate. The first 7 positions must contain the longitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional associated with the longitude: E or W (East or West) of Greenwich, England.

Example: The longitude coordinate, 57 degrees, 15 minutes, West, is expressed as 0572500W.

27-34

DSILAT2

8

Latitude of the second coordinate. The first 7 positions must contain the latitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional: N or S (North or South).

35-42

DSILNG2

8

Longitude of the second coordinate. The first 7 positions must contain the longitude, expressed in degrees, with 4 decimal positions understood. The 8th position must contain the directional associated with the longitude: E or W (East or West) of Greenwich, England.

43-100

Reserved

58

 

The DSOOUT Output Parameter Area

The following table describes the subfields in the DSOOUT Output Parameter Area.

Position

Name

Length

Contents

1-8

DSODST

8

Distance between the 2 input coordinates described in the input parameter. This distance is expressed in miles, accurate to one one-thousandth of a mile (.001). If the distance cannot be calculated, this field contains spaces.

Note: If no output distance is calculated, it is likely that an input error occurred. Check your coordinates, and try again.
 

9-50

Reserved

42

 

The DSRSV Reserved Parameter Area

The following table describes the subfields in the DSRSV Reserved Parameter Area.

Position

Name

Length

Contents

1-320

Reserved

320