The MFDIST program compares your two input latitude/longitude coordinates to GeoTAX and calculates the distance between these two points.
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 |
|