APPENDIX 17: TPAD - ADDITIONAL INFORMATION
Geosupport Warnings, TPAD Conflict Flag, Reason Code Qualifier and Error Message
The TPAD Option allows users to get up-to-date property-level information. The TPAD Option is available for Function 1A, BL, BN, and 1B calls (PAD calls). When users turn the TPAD Switch ‘on’ in their applications, Geosupport reads the Transitional PAD file (TPAD) for intra-cycle PAD data and if any is found, Geosupport returns the TPAD data to the calling application. See Chapter VI.11 for a more detailed description of the TPAD option and the information it returns.
This appendix describes the special return code and error message handling with respect to TPAD. If your applications make function 1A, BL, BN or 1B calls with the TPAD Option ‘on’, then you must read this description.
Geosupport is designed to return information about both a normal warning (e.g. Hyphen Deleted) and a TPAD Conflict situation (e.g. …No Existing PAD BBL) with only one Function 1A, BL, BN or 1B call (with TPAD Switch ‘on’) to Geosupport. The value in the Geosupport Reason Code will be the value that a user would expect when a Geosupport function call has completed with a warning. The TPAD Conflict Flag will be in Work Area 2 (WA2) for all PAD calls with the TPAD Option ‘on’. The ‘*’ Reason Code (which indicates a TPAD Warning) will appear in only one exceptional case. In the situation where there was no regular Warning Message for the regular PAD call and there was TPAD data found that conflicts with the PAD data, then the GRC will contain ‘01’ (indicating a warning) and the Reason Code will contain ‘*’ (indicating that there is only a TPAD Conflict Flag warning and no regular Geosupport warning).
In addition, if TPAD data is found and there is a conflict with the PAD data, the value in the WA2 Conflict Flag field will also be placed into a new field called the Geosupport Reason Code Qualifier field which immediately follows the Geosupport Reason Code field in Work Area 1 (WA1). When this new field is populated with the TPAD Conflict Flag, the TPAD Conflict Message will be put in the Geosupport Error Message field instead of the Geosupport Warning Message that would normally appear. Note, therefore, that if there was a Geosupport Warning involving the regular PAD portion of this call, the Reason Code field will indicate the nature of the warning as with all other Geosupport calls (but the Error Message field for this warning will be overridden by the TPAD Conflict message if a conflict exists).
Values of ‘0’ or ‘1’ in the TPAD Conflict Flag (in WA2) are considered ‘normal results’. ‘0’ signifies TPAD data was found and does not conflict with PAD data; ‘1’ signifies that no TPAD data was found. When there are ‘normal results’, the WA2 TPAD Conflict Flag will not be placed into the new Geosupport Reason Qualifier field in WA1.
The following table shows the possible results for Function 1A, BL, BN an 1B calls with the TPAD Switch ‘on’.
Regular Geosupport Warning for PAD Call | ||||
---|---|---|---|---|
Yes | No | |||
TPAD Data Found | TPAD Data Found | |||
Work Area 1 Fields | Yes | No | Yes | No |
Geosupport Return Code (GRC) |
01 | 01 | 01 | 00 |
Reason Code | Warning Reason Code |
Warning Reason Code |
\* | blank |
Reason Code Qualifier | TPAD Conflict Flag† |
blank | TPAD Conflict Flag† |
blank |
Error Message | TPAD Conflict Flag† |
blank | TPAD Conflict Flag† |
blank |
WA2 Conflict Flag | TPAD Conflict Flag | TPAD Conflict Flag | TPAD Conflict Flag | TPAD Conflict Flag |
† Note: The TPAD Conflict Flag appears in the Reason Code Qualifier only if its value is greater than ‘1’. Similarly, the TPAD Conflict Message will appear in the Error Message field, only if the TPAD Conflict field is greater than ‘1’. The TPAD Conflict Flag ‘1’ (no TPAD data was found) and the TPAD Conflict Flag ‘0’ (TPAD data found and it does not conflict with PAD data) will not appear in the Reason Code Qualifier field in WA1. The Error Message field will have a TPAD Conflict Message only when TPAD data was found and it conflicts with the PAD data in some way (and as a result, the Reason Code Qualifier will be non-blank). Note that if there is no Regular Geosupport Warning, and there is TPAD data which does not conflict with the PAD data (Conflict Flag ‘0’), the GRC will be ‘00’ the Reason Code, Reason Code Qualifier, and Error Message will all be blank.
See examples on the following pages.
Examples: PAD Data Found with Regular Warnings
PAD Data (with regular Geosupport warning) and No TPAD Data Found | |
---|---|
Input: 12-34 Sample Street | |
WA1 Fields | Value |
GRC | 01 |
Reason Code | 3 [indicates input address number altered – hyphen deleted] |
Reason Code Qualifier | blank |
Error Message | ADDR NUMBER ALTERED: HYPHEN DELETED |
WA2 Conflict Flag | 1 |
PAD Data (with regular Geosupport warning) and TPAD Data (with no conflicts) | |
---|---|
Input: 12-34 Sample Street | |
WA1 Fields | Value |
GRC | 01 |
Reason Code | 3 [indicates input address number altered – hyphen deleted] |
Reason Code Qualifier | blank |
Error Message | ADDR NUMBER ALTERED: HYPHEN DELETED |
WA2 Conflict Flag | 0 |
PAD Data (with regular Geosupport warning) and TPAD Data (with conflicts) | |
---|---|
Input: 12-34 Sample Street | |
WA1 Fields | Value |
GRC | 01 |
Reason Code | 3 [indicates input address number altered – hyphen deleted] |
Reason Code Qualifier | D [indicates address in TPAD but not PAD (PAD data from BL call)] |
Error Message | ADDRESS FOUND IN TPAD, NOT FOUND IN PAD…… |
WA2 Conflict Flag | D |
Examples: PAD Data Found with No Regular Geosupport Warning
PAD Data (with no regular Geosupport warning) and No TPAD Data Found | |
---|---|
Input: 1234 Sample Street | |
WA1 Fields | Value |
GRC | 00 |
Reason Code | Blank |
Reason Code Qualifier | Blank |
Error Message | Blank |
WA2 Conflict Flag | 1 |
PAD Data (with no regular Geosupport warning) and TPAD Data (with no conflicts) | |
---|---|
Input: 1234 Sample Street | |
WA1 Fields | Value |
GRC | 00 |
Reason Code | Blank |
Reason Code Qualifier | Blank |
Error Message | Blank |
WA2 Conflict Flag | 0 |
PAD Data (with no regular Geosupport warning) and TPAD Data (with conflicts) | |
---|---|
Input: 1234 Sample Street | |
WA1 Fields | Value |
GRC | 01 |
Reason Code | * [indicates TPAD Conflict only; no regular warning] |
Reason Code Qualifier | D [indicates address in TPAD but not PAD (PAD data from BL call)] |
Error Message | ADDRESS FOUND IN TPAD, NOT FOUND IN PAD…….. |
WA2 Conflict Flag | D |
The Reason Code Qualifier is used to define a specific TPAD warning. When there is a true conflict between TPAD data and PAD data, the Reason Code Qualifier contains the same information as the TPAD Conflict Flag.
The following table indicates where in Work Area 1 the one-byte Reason Code Qualifier field(s) may be found.
(1 byte) Position | |||
---|---|---|---|
Field Name | Function(s) | COW | MSW |
Reason Code Qualifier | 1A, BL, BN | 714 | n/a |
Reason Code Qualifier 2 | 1B | 575 | n/a |
For Functions 1A, BL, and BN the Reason Code Qualifier is a one-byte field, in column 714 of COW Work Area 1. For Function 1B, the Reason Code Qualifier 2 is a one-byte field, in column 575 of COW Work Area 1.
The following table contains the field name in the COPY libraries for the Reason Code Qualifiers.
Reason Code Qualifier(s) Field Names in COPY Libraries |
|||
---|---|---|---|
Language | COPY Library (COW Only) |
Function(s) (COW Only) |
Field Name |
BAL | P1BAL | 1A, BL, BN 1B |
reason_code_qual reason_code_qual_2 |
COBOL | P1COB | 1A, BL, BN 1B |
GEO-WA1-OUT-REASON-CODE-QUAL GEO-WA1-OUT-REASON-CODE-QUAL2 |
Natural | GEOLP1 | 1A, BL, BN 1B |
PIWA1-OUT-REASON-CODE-QUAL PIWA1-OUT-REASON-CODE-QUAL-2 |
PL/1 | P1PL1 | 1A, BL, BN 1B |
PIWA1_OUT_REASON_CODE_QUAL PIWA1_OUT_REASON_CODE_QUAL_2 |