APPENDIX 9: GBAT REFERENCE TABLES
Table A9-1: GBAT Control Entry Descriptions by Keyword
This table lists all of the control entries alphabetically by keyword. Each control entry’s coding format is indicated, and its purpose and usage are described. Control entry variables are indicated using ‘S’ and ‘L’ to represent the starting position and length, respectively, of a field in the input data records, and ‘V’ to represent other types of variables. Certain control entries do not have full table entries of their own but are cross-referenced to closely related control entries.
| Control Entry | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ALIASES=V | Specifies whether an input alias file is to be used during this GBAT run. If so, during the processing of the input data file, the user-defined street name aliases in the alias file supplement the set of street names that Geosupport recognizes ([see ChapterIX.6](../../chapters/chapterIX/section06/)). This control entry is optional; if it is not coded, the default value is NO. The valid variable values are NO, YES and VAL. ALIASES=NO directs GBAT not to perform any alias processing. If there is an ALIASES DD statement in the JCL, it is ignored. ALIASES=YES directs GBAT to validate the ALIASES file, and then to process the input data file whether or not there are any invalid records in the alias file. An ALIASES DD statement referring to the alias file is required to be in the JCL. ALIASES=VAL directs GBAT to validate the alias file, and then to process the input data file only if there are no invalid records in the alias file. An ALIASES DD statement referring to the alias file is required to be in the JCL. | |||||||||||||||
| AUXSEG=V | Specifies whether the Work Area 2 to be used to form the records written into the output file of accepted data (OUTFILE) is the regular WA2 or the auxiliary segment WA2 ([see Chapter II.6](../../chapters/chapterII/section06/)). The valid variable values are YES and NO and are self-explanatory. Currently, the Auxiliary Segment WA2 option is only available for COW format Functions 3 and 3C; this control entry is invalid for all other functions. For the functions that have the Auxiliary Segment WA2 option, this control entry is invalid when GEOCODE=NO or VAL; it is optional when GEOCODE=YES or ALL, and the default value is NO. | |||||||||||||||
| BBL=S,10 | Specifies the starting position and length of the input BBL field in the input data records. This control entry is valid only for Function BL. This control entry can be used in place of the three control entries BORO, BLOCK and LOT whenever the input data records contain those three items in adjacent positions so that they can be treated collectively as a BBL field. The length value must be explicitly coded as ‘10’. | |||||||||||||||
| BIN=S or BIN=S,7 | Specifies the starting position and length of the input Building Identification Number (BIN) field in the input data records. This control entry is valid only for Function BN. An input BIN field must always have a length of seven bytes, which may be coded explicitly as ‘7’ in this control entry or it may be left uncoded, in which case it defaults to that value. | |||||||||||||||
| BLOCK=S or BLOCK=S,5 | Specifies the starting position and length of the input tax block field in the input data records. This control entry is valid only for Function BL. Either all three control entries BORO, BLOCK and LOT must be specified, or the control entry BBL must be specified. An input tax block field must always have a length of five bytes, which may be coded explicitly as ‘5’ in this control entry, or it may be left uncoded, in which case it defaults to that value. | |||||||||||||||
| BORO=S,L | Specifies the starting position and length of the input borough code field in the input data records. This control entry is valid for all functions except Function BN. It is mandatory for functions that require an input borough code field. BORO is optional if ZIPCODE is specified for Function 1, 1A, 1B or 1E. For Functions 2, 3, 3C, 3S and D, which accept multiple input street fields, the field specified by BORO serves as the input borough code field for the input street field specified by the control entry ONSTREET or STRTCODE; in addition, if the control entries CROSSBORO1 and CROSSBORO2 are not coded, it also serves as the input borough code field for the other input street fields. The maximum permissible length value of BORO is L=12. Note: The input borough code field specified by BORO may contain user-defined, non-standard borough code values - see discussion at table entry for BRONX. | |||||||||||||||
| BRONX=V BROOKLYN=V MANHATTAN=V QUEENS=V STATEN=V |
GBAT can accept non-standard, user-defined borough code values in the input
borough code fields specified by the control entries BORO, CROSSBORO1 and
CROSSBORO2. (If there is more than one input borough code field, the same
borough code values must be used in all of them.) The five control entries
BRONX, BROOKLYN, MANHATTAN, QUEENS and STATEN are used to specify the character strings that represent each borough in those input borough code fields. (Note: these control entries do not pertain to the borough code sub-fields that are embedded within larger data items such as BBL, BIN and B7SC, which must always contain the standard Geosupport borough code values.) The five borough code values may be specified as any strings of non-blank characters the lengths of which do not exceed the length value specified in the BORO control entry (which has a maximum permissible length value of 12). Embedded blanks should not be included in user-defined borough code values, since the first blank that GBAT encounters when scanning a borough code value terminates the scan. For example, coding STATEN=STATEN ISLAND would cause GBAT to interpret the control entry as STATEN=STATEN and to interpret ISLAND as the next keyword in the control file. Since ISLAND is an invalid control keyword, GBAT would terminate abnormally. However, coding STATEN=STATENISLAND (without the embedded blank) is acceptable.
These five control entries are optional, but if any of them is coded, all five must be coded. If these control entries are not coded, the default values are the standard Geosupport borough codes, as follows:
MANHATTAN=1 BRONX=2 BROOKLYN=3 QUEENS=4 STATEN=5 |
|||||||||||||||
| BROOKLYN | See BRONX. | |||||||||||||||
| BROWSEFLAG=V | Specifies whether the Browse Flag request (described in [Chapter III.7](../../chapters/chapterIII/section07/) and [III.8](../../chapters/chapterIII/section08/)) is in effect. This control entry is valid only for COW functions that return normalized street name output. For such functions, this control entry is optional. BROWSEFLAG=P specifies that the Browse Flag is set to ‘P’. Only the primary name and street code of the input street names will be returned to the user. BROWSEFLAG=F specifies that the Browse Flag is set to ‘F’. Only principal street name and street code of the input street names will be returned to the user. BROWSEFLAG=R specifies that the Browse Flag is set to ‘R’. Only the DCP or BOE preferred street name and street code of the input street names will be returned to the user. The value of ‘R’ is valid only for ‘GEOCODE=YES’ or ‘GEOCODE=ALL’. | |||||||||||||||
| B7SC1=S or B7SC1=S,8 B7SC1=S,8 B7SC1=S,8 B7SC3=S or B7SC3=S,8 |
Specify the starting positions of up to three input Borough-and-7-digit Street Code (B7SC) fields for input to Function DG. An input B7SC field must always have a length of 8, which may be coded explicitly in these control entries, or it may be left uncoded, in which case it defaults to 8. | |||||||||||||||
| B10SC1=S or B10SC1=S or B10SC2=S or B10SC2=S,11 B10SC3=S or B10SC3=S,11 |
Specify the starting positions of up to three input Borough-and-10-digit Street Code (B10SC) fields for input to Function DN. An input B10SC field must always have a length of 11, which may be coded explicitly in these control entries, or it may be left uncoded, in which case it defaults to 11. | |||||||||||||||
| COMPACT=V | Specifies whether the Compact Names option (described in [Chapter III.3](../../chapters/chapterIII/section03/)) is in effect. This control entry is valid only for functions that return normalized street name output. For such functions, this control entry is optional, and NO is the default value. COMPACT=YES specifies that the Compact Names option is in effect. Street names with numeric components are normalized into the compact format. COMPACT=NO specifies that the Compact Names option is not in effect. Street names with numeric components are normalized into the sort format. | |||||||||||||||
| COMPASS=S | Specifies the position of an input compass direction field in the input data records. This control entry is never coded with a length variable; GBAT always assumes an input compass direction field to be one byte long. This control entry is valid only for Functions 2, 3C and 3S. For Function 2: this control entry is required only if the input data file contains at least one input street intersection defined by a pair of streets that intersect at two distinct locations ([see Chapter VII.2](../../chapters/chapterVII/section02/)). In such input data records, the input compass direction field must contain a valid non-blank compass direction value, ‘N’, ‘S’, ‘E’ or ‘W’, which serves to designate which of the two intersections of the given pair of streets is to be processed. In other input data records, the input compass direction field should be blank. For Function 3C: this control entry is mandatory. The input data field that this control entry specifies contains the compass direction designating the side of the street. This field must contain a valid non-blank compass direction value, ‘N’, ‘S’, ‘E’ or ‘W’, in every input data record. For Function 3S: this control entry corresponds to the ‘first input intersection’, that is, the input intersection defined either by ONSTREET and CROSS1 or by STRTCODE and CRSCOD1. (The control entry COMPASS2 corresponds to the second input intersection.) The COMPASS control entry is required only if the input data file contains at least one first input intersection that is defined by a pair of streets that intersect in two locations ([see Chapter VII.2](../../chapters/chapterVII/section02/)). In such input data records, the input data field that this control entry specifies must contain a valid compass direction value identifying which of the two locations is the intended first input intersection. In other input data records, this field should contain a blank. | |||||||||||||||
| COMPASS2=S | Specifies the position of the input compass direction field in the input data records that corresponds to the second input intersection, that is, the input intersection defined either by ONSTREET and CROSS2 or by STRTCODE and CRSCOD2. The COMPASS2 control entry is never coded with a length variable; GBAT always assumes an input compass direction field to be one byte long. The COMPASS2 control entry is valid only for Function 3S. It is required only if the input data file contains at least one second input intersection that is defined by a pair of streets that intersect at two distinct locations ([see Chapter VII.2](../../chapters/chapterVII/section02/)). In such input data records, the input data field that this control entry specifies must contain a valid compass direction value identifying which of the two locations is the intended second input intersection. In other input data records, this field should contain a blank. | |||||||||||||||
| CROSSBORO1=S,L | Specifies the starting position and length of the input borough code field corresponding to the input street field specified by the control entry CROSS1 or CRSCOD1. CROSSBORO1 is coded only if the input data records have separate borough code fields corresponding to each of the input street fields. Such separate input borough code fields enable GBAT to process input data files containing borough boundary locations that are defined by streets in different boroughs (see discussion of Geosupports borough boundary processing feature in [Chapter VII.7](../../chapters/chapterVII/section07/)). CROSSBORO1 is valid for Functions 2, 3, 3C, 3S and D, and is optional for those functions. If CROSSBORO1 is not coded, then the field specified by BORO is used as the input borough code field for the input street field specified by CROSS1 or CRSCOD1. If CROSSBORO1 is coded, then whenever the field it specifies contains a blank, the contents of the field specified by BORO is used as the input borough code for the input street field specified by CROSS1 or CRSCOD1. If CROSSBORO1 is coded, and the input street field it applies to is specified by CRSCOD1 rather than CROSS1 (i.e., if that field contains street codes rather than street names), and the length of CRSCOD1 is specified as 4 or 6 (i.e., the input street code field is in one of the formats that contain their own borough code), then CROSSBORO1 is ignored, and the input borough code field it specifies is not used. Note: The input borough code field specified by CROSSBORO1 may contain user-defined, non-standard borough code values - see discussion at table entry for BRONX. | |||||||||||||||
| CROSSBORO2=S,L | Specifies the starting position and length of the input borough code field corresponding to the input street field specified by the control entry CROSS2 or CRSCOD2. CROSSBORO2 is coded only if the input data records have separate borough code fields corresponding to each of the input street fields. Such separate input borough code fields enable GBAT to process input data files containing borough boundary locations that are defined by streets in different boroughs (see discussion of Geosupport’s borough boundary processing feature in [Chapter VII.7](../../chapters/chapterVII/section07/). CROSSBORO2 is valid for Functions 3, 3C, 3S and D, and is optional for those functions. If CROSSBORO2 is not coded, then the field specified by BORO is used as the input borough code field for the input street field specified by CROSS2 or CRSCOD2. If CROSSBORO2 is coded, then whenever the field it specifies contains a blank, the contents of the field specified by BORO is used as the input borough code for the input street field specified by CROSS2 or CRSCOD2. If CROSSBORO2 is coded, and the input street field it applies to is specified by CRSCOD2 rather than CROSS2 (i.e., if that field contains street codes rather than street names), and the length of CRSCOD2 is specified as 4 or 6 (i.e., the input street code field is in one of the formats that contain their own borough code), then CROSSBORO2 is ignored, and the input borough code field it specifies is not used. Note: The input borough code field specified by CROSSBORO2 may contain user-defined, non-standard borough code values - see discussion at table entry for BRONX. | |||||||||||||||
| CROSSSTNAMES=V | Specifies whether a list of street names of the cross streets or intersecting streets is to be included in the appended output data. Note: the CROSSSTNAMES feature incurs processing overhead, and should only be used when necessary. Note that CROSSSTNAMES may no longer be necessary with certain COW functions since MODE=X (Extended Mode) and Function 1B Work Areas are now supported, and they contain the cross street B7SCs and the corresponding Principal cross street names. CROSSSTNAMES=YES specifies that the street names of the cross streets (RECTYPE=1, 1E, 2, 3 or 3C) or intersecting streets (RECTYTPE=2) are to be appended. This causes a 320-byte block of data to be included in the appended data containing those street names, laid out as described in the [Appendix 3](../appendix03/) entry for the List of Street Names (see paragraph on List of Cross Street Names). CROSSSTNAMES=YES is valid only when GEOCODE=ALL and RECTYPE=1, 1E, 2, 3 or 3C have been specified. CROSSSTNAMES=NO specifies that the street names of cross streets or intersecting streets are not to be appended. The default value is NO. This control entry is optional; if it is not coded, the default value is NO. | |||||||||||||||
| CROSS1, CROSS2 | See ONSTREET. | |||||||||||||||
| CRSCOD1, CRSCOD2 | See STRTCODE. | |||||||||||||||
| GEOCODE=V | Specifies whether GBAT will issue one-work-area or two-work-area calls (see Chapter II.4; whether OUTFILE will be produced; and if so, what information GBAT will append to the user input records in forming the OUTFILE records (see Chapter XI.7. The valid variable values for this control entry are NO, YES, ALL and VAL. For COW Functions 1, 1E, 1A and 1B, see also keyword GEOUNIT. GEOCODE=NO specifies a one-work-area call. Only selected information from Work Area 1 is appended. For Function BL, the BBL is appended; for Function BN, the BIN is appended; for the other functions, normalized house numbers, normalized street names and street codes are appended. For a detailed layout of the appended information for GEOCODE=NO, see Table A9-4 for MSW format, and see Table A12-2 for COW format. In addition, for COW Functions 1, 1E, 1A and 1B, if GEOUNIT=YES is specified, the Normalized Display Format Unit output field is also appended, in the form of a 70-byte block of data, the first 14 bytes of which are the Unit output field. For a description of the Unit fields, see Chapter V.15. OUTFILE is produced. GEOCODE=YES specifies a two‑work‑area call. Only a copy of Work Area 2 for the given function is appended. OUTFILE is produced. GEOCODE=ALL specifies a two‑work‑area call. Both the GEOCODE=NO information (including the GEOUNIT=YES information, as described above with GEOCODE=NO) and the GEOCODE=YES information are appended. In addition, if CROSSSTNAMES=YES is specified, a list of street names of the cross streets or intersecting streets is also appended, in the form of a 320-byte block of data, between the GEOCODE=NO data and the GEOCODE=YES data. OUTFILE is produced. GEOCODE=VAL specifies a two‑work‑area call. OUTFILE is not produced. This control entry is optional. The default value depends on the function: it is NO for Functions 1, 1N, 2, 3, D, DG and DN, and it is YES for all other functions. The values YES, ALL and VAL are invalid for functions that can only be called using one work area (currently, Functions 1N, D, DG and DN). | |||||||||||||||
| GEOUNIT=V | Specifies whether GBAT will append the Normalized Display Format Unit Output field. This control entry is valid only for COW Functions 1, 1E, 1A and 1B and only when GEOCODE=NO or GEOCODE=ALL is specified. The Normalized Display Format Unit output field is appended, in the form of a 70-byte block of data, the first 14 bytes of which are the Unit output field. See the description of GEOCODE=V above. The GEOUNIT control entry is optional. The valid values are YES and NO. The default is GEOUNIT=NO. For a description of the Unit fields, see Chapter V.15. | |||||||||||||||
| HNI=V | Specifies whether the input house number fields specified by the HOUSENUM and HOUSENUM2 control entries are House Numbers in Internal format (HNIs) (see Chapter V.2) or are in character format, indicated by the variable values YES and NO respectively. The HNI control entry is optional only for MSW Functions 1, 1A, 1E, D, DG and DN, and is invalid for other functions and for the COW format. The default value depends on the function. For MSW Functions 1, 1A and 1E, NO is the default, and YES is also valid. For MSW Functions D, DG and DN, YES is the default and is the only valid value. | |||||||||||||||
| HNS=V | Specifies whether the input house number field specified by the HOUSENUM and HOUSENUM2 control entries are House Numbers in Sort format (HNSs) (see Chapter V.2) or are in character format, indicated by the variable values YES and NO respectively. The HNS control entry is optional for COW Functions 1, 1A, 1E, D, DG and DN, and is invalid for other functions and for the MSW format. The default value depends on the function. For COW Functions 1, 1A and 1E, NO is the default, and YES is also valid. For COW Functions D, DG and DN, YES is the default and is the only valid value. | |||||||||||||||
| HOUSENUM=S or HOUSENUM=S,L | Specifies the starting position and length of an input house number field. This control entry is optional. It is valid for Functions 1, 1A, 1B, 1E, D, DG and DN. For Functions 1, 1A, 1B and 1E, if HOUSENUM is not coded, Geosupport assumes that the input street name field (specified by the control entry ONSTREET) contains a free‑form address (see ChapterV.3). If HOUSENUM is coded, the input data field it specifies may contain either a House Number in Internal format (HNI - for MSW format only - see ChapterV.2), a House Number in Sort Format (HNS - for COW format only - see ChapterV.2), or a house number in character format. If it contains an HNI, then the control entry HNI=YES must be in effect (either by explicitly coding it or by default), and HOUSENUM’s length variable must either be coded with the value ‘6’ or not coded (in which case it defaults to ‘6’ by virtue of HNI=YES). If it contains an HNS, then the control entry HNS=YES must be in effect (either by explicitly coding it or by default), and HOUSENUM’s length variable must either be coded with the value ‘11’ or not coded (in which case it defaults to ‘11’ by virtue of HNS=YES). If HOUSENUM is not an HNI or an HNS, its length variable must be a number between 5 and 12. For Functions D, DG and DN, if HOUSENUM is coded, for MSW format, the input data field it specifies must contain an HNI, and the length variable must either be coded with the value ‘6’ or not coded (in which case it defaults to ‘6’). For COW format, the input data field it specifies must contain an HNS, and the length variable must either be coded with the value ‘11’ or not coded (in which case it defaults to ‘11’). | |||||||||||||||
| HOUSENUM2=S or HOUSENUM2=S,L | Specifies the starting position and length of an input house number field containing an HNI for the MSW format, or an HNS for the COW format. HOUSENUM2 is valid for Functions D, DG and DN, for which it is optional. Those functions can accept two input HNI or HNS fields per call. Coding both HOUSENUM and HOUSENUM2 enables two input HNI or HNS fields to be processed through Functions D, DG or DN in a single GBAT pass. For the MSW format, when HOUSENUM2 is coded, the OUTFILE records include a corresponding 12-byte field (identified as HND-2 in Table A9-4) in the appended data for a House Number in Display format (HND), and the total length of the appended data is 120 bytes. When HOUSENUM2 is not coded using the MSW format, no corresponding HND-2 field is included in the OUTFILE records, and the total length of the appended data is 108 bytes. For the COW format, the OUTFILE record length is always 128 bytes, and has space for two 16-byte output House Numbers in Display format (HNDs), each of which would either have data or be blank, dependent on the input.. | |||||||||||||||
| LONGWA2=V | Specifies whether the Work Area 2 to be used to form the records written into the output file of accepted data (OUTFILE) is the regular WA2 or the long WA2 (see ChapterII.5). The valid variable values are YES and NO and are self-explanatory. Currently, the long WA2 option is only available for MSW format Functions 1, 1E, and 3, and for both MSW and COW formats for Functions 1A and BL; this control entry is invalid for all other functions. For the functions that have the long WA2 option, this control entry is invalid when GEOCODE=NO or VAL; it is optional when GEOCODE=YES or ALL, and the default value is NO. | |||||||||||||||
| LOT=S,L | Specifies the starting position and length of the input tax lot field. This control entry is valid only for Function BL. The Function BL user must specify either all three control entries BORO, BLOCK and LOT, or the control entry BBL. The length value of LOT must be explicitly coded as ‘4’. There is no default. | |||||||||||||||
| MANHATTAN | See BRONX. | |||||||||||||||
| MAXREJECTS=V | Specifies how many rejects (including warnings, if REJECTWARNINGS=YES has been specified) occurring at the beginning of the input data file, other than any records rejected for an invalid borough code, are to cause a ‘MAXREJECTS termination’, that is, would cause GBAT to terminate execution abnormally and exit with Condition Code 20 (see ChapterXI.3). The variable value must be either a positive integer specifying the number of such rejects that are to cause a MAXREJECTS termination, or the value NOMAX. If MAXREJECTS=NOMAX is coded, the entire input data file is processed, regardless of the number of rejects occurring at the beginning of the file. The MAXREJECTS control entry is optional, and the default value is MAXREJECTS=200. | |||||||||||||||
| MODE=V | Specifies whether the Work Area 2 to be used to form the records written into the output file of accepted data (OUTFILE) is the regular WA2 or the Extended WA2 (see ChapterII.7). The valid variable values are X or NO. X requests the Extended Work Area 2. Currently, the extended WA2 option is available only for COW format (WORKAREA=COW) Functions 1, 1E, 1A, 3, 3C, BL, and BN; this control entry is invalid for all other functions. When MODE=X, LONGWA2 cannot be set to YES for Function 1A or BL. All other control cards are the same for each of the Functions 1, 1E, 1A, 3, 3C, BL or BN. For the functions that have the extended WA2 option, this control entry (MODE=X) is invalid when GEOCODE=NO or VAL; it is optional when GEOCODE=YES or ALL, and the default value of MODE is NO. | |||||||||||||||
| NODE=S or NODE=S,7 | Specifies the starting position and length of the input node ID field. This NODE=S,7 control entry is valid only for COW Functions 2 and 2W. An input node ID field must always have a length of seven bytes, which may be coded explicitly as ‘7’ in this control entry or it may be left uncoded, in which case it defaults to that value. This entry must be coded if you have node input instead of two intersecting streets or an intersection name. Since node input stands on its own and does not require a borough code, the GBAT statistical report will not include groupings by borough. It is therefore recommended that the user not mix street name/street code input with node input. | |||||||||||||||
| ONSTREET=S,L CROSS1=S,L CROSS2=S,L |
Specify the starting positions and lengths of input street name fields for Functions
1, 1A, 1B, 1E, 1N, 2, 3, 3C, 3S. (For functions 1, 1A, 1B, 1E, those fields may
contain free-form addresses.) The appropriate combination of these control entries
for the function being called must be coded, as follows:
Note: for Functions 1, 1A, 1B, 1E, 2, 3, 3C and 3S, but not function 1N, input street data may be provided either in the form of street name fields, specified using the control entries ONSTREET, CROSS1 and CROSS2, or alternatively, in the form of five-digit street code fields (see ChapterIV.8), specified using the control entries STRTCODE, CRSCOD1 and CRSCOD2. For those of the aforementioned functions that accept multiple input streets, either all of those input streets must take the form of street names or all must take the form of street codes; a mixture of names and codes is not permitted. For Function 1N, street name input fields are mandatory. |
|||||||||||||||
| QUEENS | See BRONX. | |||||||||||||||
| REALSTREETONLY=V | Specifies whether the Real Street Only request (described in Chapter VII.6) is in effect. This control entry is valid only for COW function 3S. This control entry is optional. REALSTREETONLY=YES specifies that the Real Street Only flag is set to ‘R’. Only real streets (not bends or non-street features) will be returned to the user. REALSTREETONLY=NO specifies that the Real Street Only flag is set to blank. All intersections, including bends and non-street features, will be returned to the user. If this control entry is not coded, the default value is NO. | |||||||||||||||
| RECTYPE=V | Specifies the Geosupport function to be executed. This control entry is mandatory. The valid variable values are the valid Geosupport function codes. As of this writing, these are 1, 1A, 1B, 1E, 1N, 2, 3, 3C, 3S, AP, BL, BN, D, DG, DN. | |||||||||||||||
| REJECTWARNINGS=V | Specifies whether input data records that result in warnings are to be treated as accepted records or as rejects (see discussion of REJECTWARNINGS in Section XI.7). The valid variable values are YES and NO. This control entry is optional, and the default value is NO. If REJECTWARNINGS=YES is coded, records resulting in warnings (GRC=01) are treated as rejects; that is, they are written into ERRFILE (or ERRFIL2) rather than OUTFILE, they are counted as rejects in the report of run statistics, and they are considered to be rejects for the purpose of determining whether a MAXREJECTS termination is to be triggered. If REJECTWARNINGS=NO is coded or is in effect by default, warnings are treated as accepted records; that is, they are written into OUTFILE rather than ERRFILE (or ERRFIL2), they are counted as accepted records in the report of run statistics, and they are considered to be accepted records for the purpose of determining whether a MAXREJECTS termination is to be triggered. | |||||||||||||||
| RELATEDNODES=V | If COW Function 2 results in a ‘many-node case’ (GRC 03 with Reason Code A), this control entry specifies if GBAT should return the Nodes and B7SCs for the streets at those nodes (up to 20 nodes). This control entry is valid only with WORKAREA=COW, RECTYPE=2 and GEOCODE=YES or ALL. ERRFIL3 will contain this output. The variable values are YES and NO and are self-explanatory. If these If this control entry is not coded, the default value is NO. | |||||||||||||||
| ROADBED=V | Specifies whether the output of a multi-Roadbed street should contain Roadbed information or information based on the center line of the street. This control entry is valid only for Functions 1, 1E, 1B and 3S for which it is optional. The variable values are YES and NO and are self-explanatory. If this control entry is not coded, the default value is NO. | |||||||||||||||
| SNL=V | Specifies a value for the Street Name Normalization Length Limit (SNL) parameter (see ChapterIII.2). The variable value must be a number between 4 and 32, inclusive. This control entry is valid only for functions that return normalized street names, for which it is optional. The default value is 32. | |||||||||||||||
| STATEN | See BRONX. | |||||||||||||||
| STRTCODE=S,L CRSCOD1=S,L CRSCOD2=S,L |
Specify the starting positions and lengths of input five-digit street code fields for
Functions 1, 1A, 1B, 1E, 2, 3, 3C, 3S and D. The appropriate combination of these
control entries for the function being called must be coded, as follows:
|
|||||||||||||||
| TITLE=V | Specifies a title to appear on the top of the SYSPRINT output report of summary run statistics. A valid variable value is any character string of up to 73 bytes ending in a semicolon. This control entry is optional. If it is not coded, the report is generated without a title. If it is coded, it is mandatory to terminate the title character string with a semicolon, which does not appear in the actual report. | |||||||||||||||
| TPADDATA=V | Specifies whether TPAD processing should be performed for functions 1A, 1B, BL, and BN Work Area 2 giving more up-to-date property-level information. (see ChapterVI.11).The valid variable values are YES and NO. Y requests the TPAD processing. The TPADDATA option is available only for COW format (WORKAREA=COW) Functions 1A, 1B, BL, and BN; this control entry is invalid for all other functions. All other control cards are the same for each of the Functions 1A, 1B, BL or BN. For the functions that have the TPAD option, this control entry (TPADDATA=YES) is invalid/ignored when GEOCODE=NO or VAL; it is optional when GEOCODE=YES or ALL, and the default value of TPADDATA= NO. | |||||||||||||||
| UNIT=S,L | Specify the starting position and length for the input Unit field. This control entry is valid only for COW Functions 1, 1E, 1A and 1B. This control entry is optional and there is no default. To have GBAT append the Normalized Display Format Unit Output field (in OUTFILE) also specify GEOUNIT=YES and either GEOCODE=NO or GEOCODE=ALL. See the description of those control entries. For a description of the Unit fields, see ChapterV.15. | |||||||||||||||
| VSAM=V | Specifies whether the input data file is a VSAM file or a sequential file. The valid variable values are YES and NO, specifying that the file is a VSAM file or a sequential file, respectively. This control entry is optional, and NO is the default value. If NO is specified or is in effect by default, then in the JCL, the DD statement for the input data file must contain the DDname INFILE. If YES is specified, the DDname must be coded as INVSAM. | |||||||||||||||
| WORKAREA=V | Specifies whether the work areas should be in MSW or COW format. The WORKAREA control entry is valid for all functions. The valid variable values are COW (Character Only Work Area) and MSW (Mainframe Specific Work Area), and are self-explanatory. If this control entry is not coded, the default value is MSW. | |||||||||||||||
| WORKAREA1=V | Specifies whether Work Area 1 is to be included at the end of each record written to the Output File of Rejected Records. The valid variable values are YES or NO. YES requests that Work Area 1 be included in the output records. NO requests that Work Area 1 not be included in the output records. When WORKAREA1=YES the records are written to ERRFIL4 and ERRFIL5; when WORKAREA1=NO, the records are written to ERRFILE and ERRFIL2 (see Chapter IX.8). WORKAREA1 is optional and is valid only when the format is COW (WORKAREA=COW). The default value of WORKAREA1 is NO. | |||||||||||||||
| ZIPCODE=S or ZIPCODE=S,5 | Specifies the starting position and length of the input ZIP code field. This control entry is valid only for Functions 1, 1A, 1B and 1E. An input ZIP code field must always have a length of five bytes, which may be coded explicitly as ‘5’ in this control entry or it may be left uncoded, in which case it defaults to that value. | |||||||||||||||
| 1ABLVERSION=V | Specifies that standard processing is to be performed for Functions 1A and BL (see ChapterVI.8). The 1ABLVERSION control entry is valid only for Functions 1A and BL, and is required for the MSW format. The only valid variable value for this control entry is STANDARD or S, and is self-explanatory. Note: Legacy has been discontinued.. |
Table A9-2: Summary of GBAT Control Entries by Keyword
This table lists all of the control entries alphabetically by keyword, indicates their coding formats, their allowable and default variable values, and the Geosupport functions for which each control entry or combination of control entry and variable value is valid. Control entry variables are indicated using ‘S’ and ‘L’ to represent the starting position and length of a field in the input data records, respectively, and ‘V’ to represent variables of other types.
| Control Entry | Valid Variable Values | Default | Functions |
|---|---|---|---|
| ALIASES=V | NO, YES, VAL | NO | 1, 1A, 1B, 1E, 1N, 2, 3, 3C, 3S, AP |
| AUXSEG=V | YES, NO | NO | COW only: 3, 3C |
| BBL=S,10 | 1 <=S <=( LRECL-1)-10 | None | BL |
| BIN=S or BIN=S,7 | 1 <=S <=( LRECL+1)-7 | L=7 | BN |
| BLOCK=S or BLOCK=S,5 | 1 <=S <=( LRECL+1)-5 | L=5 | BL |
| BORO=S,L | 1
<=S <=( LRECL+1)-L 1 <=L <=1 2 |
None | All but BN, DG, DN |
| BRONX=V | Any character string that fits BORO | 2 | All but BN, DG, DN |
| BROOKLYN=V | Any character string that fits BORO | 3 | All but BN, DG, DN |
| BROWSEFLAG=V | P, F, R | None | 1, 1A, 1B, 1E,1N, 2, 3, 3C, AP |
| B7SC1=S or B7SC1=S,8 | 1 <=S <=( LRECL+1)-8 | L=8 | DG |
| B7SC2=S or B7SC2=S,8 | 1 <=S <=( LRECL+1)-8 | L=8 | DG |
| B7SC3=S or B7SC3=S,8 | 1 <=S <=( LRECL+1)-8 | L=8 | DG |
| B10SC1=S or B10SC1=S,11 | 1 <=S <=( LRECL+1)-11 | L=11 | DN |
| B10SC2=S or B10SC2=S,11 | 1 <=S <=( LRECL+1)-11 | L=11 | DN |
| B10SC3=S or B10SC3=S,11 | 1 <=S <=( LRECL+1)-11 | L=11 | DN |
| COMPACT=V | YES, NO | NO | All but BL, BN |
| COMPASS=S | 1 <=S <=L RECL | None | 2, 3C, 3S |
| COMPASS2=S | 1 <=S <=L RECL | None | 3S |
| CROSSBORO1=S,L | 1
<=S <=( LRECL+1)-L 1 <=L <=1 2 |
None | 2, 3, 3C, 3S, D |
| CROSSBORO2=S,L | 1
<=S <=( LRECL+1)-L 1 <=L <=1 2 |
None | 3, 3C, 3S, D |
| CROSSSTNAMES=V | YES, NO (YES is valid only for GEOCODE=ALL) | NO | 1, 1B, 1E, 2, 3, 3C |
| CROSS1=S,L | 1
<=S <=( LRECL+1)-L 4 <=L <=3 2 |
None | 2, 3, 3C, 3S |
| CROSS2=S,L | 1
<=S <=( LRECL+1)-L 4 <=L <=3 2 |
None | 3, 3C, 3S |
| CRSCOD1=S,L | 1
<=S <=( LRECL+1)-L 1 <=L <=1 2 |
None | 3, 3C, 3S, D |
| CROSS1=S,L | 1
<=S <=( LRECL+1)-L 4 <=L <=3 2 |
None | 2, 3, 3C, 3S |
| CROSS2=S,L | 1
<=S <=( LRECL+1)-L 4 <=L <=3 2 |
None | 3, 3C, 3S |
| CRSCOD1=S,L | 1
<=S <=( LRECL+1)-L L=3 if field contains P5SC (MSW) L=4 if field contains PB5SC (MSW) L=5 if field contains 5SC L=6 if field contains B5SC |
None | 2, 3, 3C, 3S, D |
| CRSCOD2=S,L | 1
<=S <=( LRECL+1)-L L=3 if field contains P5SC (MSW) L=4 if field contains PB5SC (MSW) L=5 if field contains 5SC L=6 if field contains B5SC |
None | 3, 3C, 3S, D |
| GEOCODE=V | NO, YES, ALL, VAL YES and ALL are invalid for Functions 1N, D, DG, DN) |
NO | 1, 1N, 2, 3, D, DG, DN |
| YES | 1A, 1B, 1E, 3C, 3S, AP, BL, BN | ||
| GEOUNIT=V | YES, NO (YES is valid only for GEOCODE=NO or GEOCODE=ALL) |
NO | COW only: 1, 1E, 1A, 1B |
| HNI=V | YES, NO (MSW format only) (NO is invalid for MSW Fns D, DG, DN) |
YES | D, DG, DN |
| NO | 1, 1A, 1E | ||
| HNS=V | YES, NO (COW format only) (NO is invalid for COW Fns D, DG, DN) |
YES | D, DG, DN |
| NO | 1, 1A, 1B, 1E, AP | ||
| HOUSENUM=S or HOUSENUM=S,L | 1
<=S <=( LRECL+1)-L 5 <=L <=1 2 if field contains house number in character format L= 6 if field contains HNI L=11 if field contains HNS |
L=6 when HNI=YES;L=11 when HNS= YES else no length default | 1, 1A, 1B, 1E, AP, D, DG, DN |
| HOUSENUM2=S or HOUSENUM2=S,L | 1
<=S <=( LRECL+1)-L L= 6 if field contains HNI L=11 if field contains HNS |
L=6 when HNI=YES; L=11 when HNS=YES |
D, DG, DN |
| LONGWA2=V | YES, NO | NO | MSW and COW: 1A, BL MSW only: 1, 1E, 3 |
| LOT=S,4 | 1 <=S <=( LRECL+1)-4 | None | BL |
| MANHATTAN=V | Any character string that fits BORO | 1 | All but BN, DG, DN |
| MAXREJECTS=V | Any positive integer or NOMAX | 200 | All |
| MODE=V | X, NO | NO | COW and GEOCODE=ALL or YES: 1,1E,1A,3,3C, BL,BN |
| ONSTREET=S,L | 1
<=S <=( LRECL+1)-L 4 <=L <=3 2 |
None | 1, 1A, 1B, 1E, 1N, AP, 2, 3, 3C, 3S |
| QUEENS=V | Any character string that fits BORO | 4 | All but BN, DG, DN |
| RECTYPE=V | 1, 1A, 1B, 1E, 1N, 2, 3, 3C, 3S, AP, BL, BN, D, DG, DN | None | All (Note 1B and AP are COW only |
| REALSTREETONLY=V | YES, NO | NO | COW only: 3S |
| REJECTWARNINGS=V | YES, NO | NO | All |
| ROADBED | YES, NO | NO | 1, 1B, 1E, 3S |
| SNL=V | 4 <=V <=3 2 | 32 | All but BL, BN |
| STATEN=V | Any character string that fits BORO | 5 | All but BN, DG, DN |
| STRTCODE=S,L | 1
<=S <=( LRECL+1)-L L=3 if contains P5SC (MSW L=4 if contains PB5SC (MSW) L=5 if contains 5SC L=6 if contains B5SC |
None | 1, 1A, 1B, 1E, 2, 3, 3C, 3S, AP, D |
| TITLE=V | Any character string of up to 73 bytes ending in a semicolon | No title | All |
| TPADDATA=V | YES, NO | NO | 1A, 1B, BL, BN |
| UNIT=S,L | 1
<=S <=( LRECL+1)-L 1 <=L <=1 4 |
None | COW only: 1, 1E, 1A, 1B |
| VSAM=V | YES, NO | NO | All |
| WORKAREA=V | COW, MSW | MSW | All |
| WORKAREA1=V | YES, NO | NO | COW only: All |
| ZIPCODE=S or ZIPCODE=S,5 | 1 <=S <=( LRECL+1)-5 | L=5 | 1, 1A, 1B, 1E, AP |
| 1ABLVERSION=V | STANDARD, S | None | 1A, BL |
Table A9-3: Summary of GBAT Control Entry Usage by Function
This table lists, by Geosupport function, which control entries are allowable and which of those are mandatory. Control entries are represented in this table by their keywords. Some combinations of control entries are mandatory or prohibited; such conditions are indicated in this table by using the logical connectors “and”, “or” (inclusive or) and “xor” (exclusive or) and by using underlining, as follows:
- A table entry of the form “A and B” signifies that if either A or B is coded, then both must be coded. Similarly, “A and B and C” signifies that if any of A, B or C is coded, then all three must be coded.
- A table entry of the form “A or B” signifies that A may be coded without B, B may be coded without A, and A and B may both be coded. Similarly, “A or B or C” signifies that any combination of these three items may be coded.”
- A table entry of the form “A xor B” signifies that if either A or B is coded, then the other one must not be coded.
- If a table entry is underlined, that control entry or combination of control entries is mandatory for the given function. All table entries not underlined are optional.
- Square brackets (“ [.....]”) are sometimes used for logical grouping to increase clarity. Thus, a table entry of the form “A or B” signifies that it is mandatory to code A or B; that is, it is mandatory to code at least one of A and B and it is permissible to code both A and B. “A xor B” signifies that it is mandatory to code A xor B; that is, it is mandatory to code either A or B but prohibited (because of the exclusive or) to code both A and B. A table entry of the form “ [A and B] xor [C and D]” signifies that it is mandatory to code either both A and B or both C and D but prohibited to code all four of them.
| Function | Control Entries |
| 1 | ALIASES, BORO or ZIPCODE, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW),COMPACT, CROSSSTNAMES, GEOCODE, GEOUNIT (requires WORKAREA=COW and [GEOCODE=NO or GEOCODE=ALL]), HNI xor HNS (see Note 1), HOUSENUM (see Note 2), LONGWA2 xor WORKAREA=COW, MAXREJECTS, MODE=X (valid only if WORKAREA=COW and GEOCODE=ALL or YES), ONSTREET xor STRTCODE, RECTYPE, REJECTWARNINGS, ROADBED, SNL, TITLE, UNIT (requires WORKAREA=COW), WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| Note 1: HNI is a valid entry only if WORKAREA defaults to MSW or is set to MSW. HNS is a valid entry only if WORKAREA=COW | |
| Note 2: For Functions 1, 1A 1B and 1E, HOUSENUM is optional in the sense that coding it is either mandatory or prohibited, depending, respectively, on whether the input data file contains free-form addresses (in which a single field contains the house number followed by the street name in non-fixed positions; see ChapterV.3) or parsed-form addresses (in which the house number and street name are in separate fields). When HOUSENUM is not coded, the input street must be in the form of street names rather than street codes, the input street name field must be specified by the control entry ONSTREET, and in every input data record, that field must contain either a free-form address or a Non-Addressable Place name (NAP). When HOUSENUM is coded, and the input street is in the form of street names, GBAT assumes that the input street name field contains street names and NAPs only, not free-form addresses. | |
| 1 Extended | Same as Function 1, except [GEOCODE=ALL] xor [GEOCODE=YES], MODE=X, WORKAREA=COW |
| 1A | ALIASES, BORO or ZIPCODE, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, GEOCODE, GEOUNIT (requires WORKAREA=COW and [GEOCODE=NO or GEOCODE=ALL]), HNI xor HNS (see Note 1 following Function 1 entry), HOUSENUM (see Note 2 following Function 1 entry), LONGWA2, MAXREJECTS, ONSTREET xor STRTCODE, RECTYPE, REJECTWARNINGS, ROADBED, SNL, TITLE, TPADDATA (requires WORKAREA=COW), UNIT (requires WORKAREA=COW), WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM, 1ABLVERSION |
| 1A Extended | Same as Function 1A, except [GEOCODE=ALL] xor [GEOCODE=YES], LONGWA2=NO (specified or by default), MODE=X, WORKAREA=COW |
| 1B | ALIASES, BORO or ZIPCODE , BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG , COMPACT, CROSSSTNAMES, [GEOCODE=ALL] xor [GEOCODE=YES], GEOUNIT (requires GEOCODE=ALL), HNS, HOUSENUM (see Note 2 following Function 1 entry), MAXREJECTS, ONSTREET xor STRTCODE, RECTYPE, REJECTWARNINGS, ROADBED, SNL, TITLE, TPADDATA, UNIT, WORKAREA=COW, WORKAREA1, VSAM |
| 1E | ALIASES, BORO or ZIPCODE , BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, CROSSSTNAMES, GEOCODE, GEOUNIT (requires WORKAREA=COW and [GEOCODE=NO or GEOCODE=ALL]), HNI xor HNS (see Note 1 following Function 1 entry), HOUSENUM (see Note 2 following Function 1 entry), LONGWA2 xor WORKAREA=COW, MAXREJECTS, ONSTREET xor STRTCODE, RECTYPE, REJECTWARNINGS, ROADBED, SNL, TITLE, UNIT (requires WORKAREA=COW), WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| 1E Extended | Same as Function 1E, except [GEOCODE=ALL] xor [GEOCODE=YES], MODE=X, WORKAREA=COW |
| 1N | ALIASES, BORO, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, GEOCODE, MAXREJECTS, ONSTREET, RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, VSAM |
| 2 | ALIASES, BORO, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, COMPASS, CROSSBORO1, CROSSSTNAMES, GEOCODE, MAXREJECTS, [ONSTREET and CROSS1] xor [STRTCODE and CRSCOD1], RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| 3 | ALIASES, AUXSEG (see Note 3), BORO, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, CROSSBORO1, CROSSBORO2, CROSSSTNAMES, GEOCODE, LONGWA2 xor WORKAREA=COW, MAXREJECTS, [ONSTREET and CROSS1 and CROSS2] xor [STRTCODE and CRSCOD1 and CRSCOD2], RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| Note 3: AUXSEG is a valid entry only if WORKAREA=COW | |
| 3C | ALIASES, AUXSEG (see Note 3 following Function 3 entry), BORO, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG (valid only if WORKAREA=COW), COMPACT, COMPASS, CROSSBORO1, CROSSBORO2, CROSSSTNAMES, GEOCODE, MAXREJECTS, [ONSTREET and CROSS1 and CROSS2] xor [STRTCODE and CRSCOD1 and CRSCOD2], RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| 3/3C (extended) | |
| 3S | ALIASES, BORO, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, COMPACT, COMPASS, COMPASS2, CROSSBORO1, CROSSBORO2, [CROSS1 and CROSS2] xor STRTCODE, [CRSCOD1 and CRSCOD2] xor ONSTREET, GEOCODE, MAXREJECTS, ONSTREET xor STRTCODE, REALSTREETONLY (see Note 4), RECTYPE, REJECTWARNINGS, ROADBED, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| Note 4: REALSTREETONLY is a valid entry only if WORKAREA=COW | |
| AP | ALIASES, BORO or ZIPCODE, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, BROWSEFLAG , COMPACT, GEOCODE, HNS, HOUSENUM (see Note 2 following Function 1 entry), MAXREJECTS, ONSTREET xor STRTCODE, RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA=COW, WORKAREA1, VSAM |
| AP Extended | Same as Function AP, except [GEOCODE=ALL] xor [GEOCODE=YES], MODE=X |
| BL | BORO and BLOCK and LOT xor BBL, BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, LONGWA2, MAXREJECTS, RECTYPE, REJECTWARNINGS, TITLE, TPADDATA (requires WORKAREA=COW), VSAM, WORKAREA, WORKAREA1 (requires WORKAREA=COW), 1ABLVERSION |
| BL Extended | Same as Function BL, except [GEOCODE=ALL] xor [GEOCODE=YES], LONGWA2=NO (specified or by default), MODE=X, WORKAREA=COW |
| BN | BIN, GEOCODE, MAXREJECTS, RECTYPE, REJECTWARNINGS, TITLE, TPADDATA (requires WORKAREA=COW), WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| BN Extended | Same as Function BN, except [GEOCODE=ALL] xor [GEOCODE=YES], MODE=X, WORKAREA=COW |
| D | BRONX and BROOKLYN and MANHATTAN and QUEENS and STATEN, COMPACT, CROSSBORO1, CROSSBORO2, GEOCODE, HNI xor HNS, HOUSENUM or HOUSENUM2 or [BORO and STRTCODE] or [BORO and STRTCODE and CRSCOD1] or [BORO and STRTCODE and CRSCOD1 and CRSCOD2], MAXREJECTS, RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| DG | COMPACT, GEOCODE, HNI xor HNS, HOUSENUM or HOUSENUM2 or B7SC1 or [B7SC1 and B7SC2] or [B7SC1 and B7SC2 and B7SC3], MAXREJECTS, RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
| DN | COMPACT, GEOCODE, HNI xor HNS, HOUSENUM or HOUSENUM2 or B10SC1 or [B10SC1 and B10SC2] or [B10SC1 and B10SC2 and B10SC3], MAXREJECTS, RECTYPE, REJECTWARNINGS, SNL, TITLE, WORKAREA, WORKAREA1 (requires WORKAREA=COW), VSAM |
<span id="appendix09-tblA9-4"Table A9-4: MSW Appended Items for GEOCODE=NO
NOTE: For COW Appended Items for GEOCODE=NO see TABLE 12.2 This table contains, by function or combination of function and option, a layout of the data that GBAT appends to the input data record to form the OUTFILE record for the MSW format when GEOCODE=NO has been specified.
| Function(s) | Option | Appended Items | Length |
| 1, 1A, 1E | HND HNHPD Normalized Street Name 10SC | 12 8 32 10 | |
| Total Length: | 62 | ||
| 1N | Normalized Street Name 10SC | 32 10 | |
| Total Length: | 42 | ||
| 2 | Normalized Street Name-1 10SC-1 Normalized Street Name-2 10SC-2 | 32 10 32 10 | |
| Total Length: | 84 | ||
| 3, 3C, 3S | Normalized Street Name-1 10SC-1 Normalized Street Name-2 10SC-2 Normalized Street Name-3 10SC-3 | 32 10 32 10 32 10 | |
| Total Length: | 126 | ||
| BL | 1ABLVERSION=STANDARD | BBL (Standard Format): Borough Code Tax Block Tax Lot | 1 5 4 |
| Total Length: | 10 | ||
| 1ABLVERSION=LEGACY | No longer supported | ||
| BN | BIN Filler | 73 | |
| Total Length: | 10 | ||
| D, DG, DN | HOUSENUM2 control entry not coded | HND Normalized Street Name-1 Normalized Street Name-2 Normalized Street Name-3 | 12 32 32 32 |
| Total Length: | 108 | ||
| D, DG,DN (cont.) | HOUSENUM2 control entry coded | HND-1 Normalized Street Name-1 Normalized Street Name-2 Normalized Street Name-3 HND-2 | 12 32 32 32 12 |
| Total Length: | 120 |
Table A9-5: MSW Format- Length of GBAT‑Appended Data
This table lists, by function and GEOCODE value, the length in bytes of the data that GBAT appends to an input data record that has been accepted by Geosupport to form the corresponding OUTFILE record. The LRECL value that the user must specify in the OUTFILE DD statement in the JCL is computed by adding the length of the appended data as indicated in this table to the LRECL of the input data file.
Note: For Functions 1, 1E, 2, 3 and 3C, when GEOCODE=ALL and CROSSSTNAMES=YES, the appended data consist of the concatenation of the GEOCODE=NO data, followed by a 320-byte block of data containing cross street names, followed by the GEOCODE=YES data. For further information about the layout of the appended CROSSSTNAMES data, refer to the Appendix 3 entry for the List of Street Names (see paragraph on List of Cross Street Names).
| MSW Functions | Options | GEOCODE Value | ||
| NO | YES | ALL | ||
| 62 | ||||
| LONGWA2=NO, CROSSSTNAMES=NO | 200 | 262 | ||
| 1, 1E | LONGWA2=YES, CROSSSTNAMES=NO | 300 | 362 | |
| LONGWA2=NO, CROSSSTNAMES=YES | 582 | |||
| LONGWA2=YES, CROSSSTNAMES=YES | 682 | |||
| 1ABLVERSION=STANDARD | 62 | |||
| 1A | 1ABLVERSION=STANDARD, LONGWA2=NO | 939 | 1001 | |
| 1ABLVERSION=STANDARD,LONGWA2=YES | 17683 | 17745 | ||
| 1N | 42 | Invalid | Invalid | |
| 2 | CROSSSTNAMES=NO | 84 | 200 | 284 |
| CROSSSTNAMES=YES | 604 | |||
| 126 | ||||
| LONGWA2=NO, CROSSSTNAMES=NO | 200 | 326 | ||
| 3 | LONGWA2=YES, CROSSSTNAMES=NO | 300 | 426 | |
| LONGWA2=NO, CROSSSTNAMES=YES | 646 | |||
| LONGWA2=YES, CROSSSTNAMES=YES | 746 | |||
| 3C | CROSSSTNAMES=NO | 126 | 200 | 326 |
| CROSSSTNAMES=YES | 646 | |||
| 3S | 126 | 4224 | 4350 | |
| BL | 1ABLVERSION=STANDARD | 10 | ||
| 1ABLVERSION=STANDARD, LONGWA2=NO | 939 | 949 | ||
| 1ABLVERSION=STANDARD, LONGWA2=YES | 17683 | 17693 | ||
| BN | 10 | 939 | 949 | |
| D, DG, DN | HOUSENUM2 not coded | 108 | Invalid | Invalid |
| HOUSENUM2 coded | 120 | Invalid | Invalid | |