The program GCP20 compares two input latitude/longitude coordinates to GeoTAX and calculates the distance between these points.
Use the following command to invoke the GCP20 distance calculation program:
CALL GCP20 USING DSIIN
DSOOUT
Your calling program must pass the following parameters to GCP20.
|
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. |
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 | 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-`00 | Reserved | 58 |
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 |
|