Part 2. Information Technology

Chapter 3. IDRS Terminal Responses

Section 78. Command Code LOCAT

2.3.78 Command Code LOCAT

Manual Transmittal

August 01, 2023

Purpose

(1) This transmits revised IRM 2.3.78, IDRS Terminal Responses, Command Code LOCAT.

Material Changes

(1) Updated Chief Information Officer to Acting, Chief Information Office as Kaschit Pandya under signature section.

(2) Updated 2.3.78.1 added new Internal Controls sections for Background, Authority, Responsibilities, Program Management and Review, Program Controls, Terms/Definitions/Acronyms and Related Resources.

(3) Updated Metadata.

Effect on Other Documents

IRM 2.3.78, dated March 30, 2020 is superseded.

Audience

SB/SE, TE/GE, W&I, LB&I

Effective Date

(08-01-2023)


Kaschit Pandya
Acting, Chief Information Officer

2.3.78.1 (08-01-2023)

Program Scope and Objectives

  1. Command Code LOCAT is designed to display the Primary Location Code (PLC) and Collection Location Codes (CLC) based on the input of a 5 digit zip code and Business Operation Division (BOD) code. The PLC contains the Universal Location Code (ULC) and the Area Office Code (AO) responsible for the taxpayer's account. "Universal" is meant to indicate that this code is the same across all BODs. The ULC carries the old 65 FIDO values. The CLC (previously known as the TDA location code) identified the area office of the Collection organization. The Area Office Codes have been assigned unique system values. Therefore, all W&I AO's will begin with a 1 (11–15) and designates W&I area offices 01–05; all SB/SE AO's will begin with a 2 or 3 (21–27, 35) and designates SB/SE area offices 01–07, 15; TE AO's will begin with 4 and designates TE area offices 41–47; and the LM AO will always be 50.

  2. Purpose: This transmits revised IRM 2.3.78, IDRS Terminal Responses, Command LOCAT.

  3. Audience: LMSB, SB/SE, TE/GE, W&I.

  4. Program Owner: Customer Service.

  5. Primary Stakeholders: Wage & Investment (W & I), Large Business and International (LB & I), Small Business Self-Employed (SB/SE), Tax Exempt and Government Entities (TE/GE).

  6. Program Goals: This system is designed to display the Primary Location Code (PLC) and Collection Location Codes (CLC) based on the input of a 5 digit zip code and Business Operation Division (BOD) code.

2.3.78.1.1 (08-01-2023)

Background

  1. Command Code LOCAT purpose is to display the Primary Location and Collection Location Codes.

2.3.78.1.2 (08-01-2023)

Authority

  1. Not Available.

2.3.78.1.3 (08-01-2023)

Responsibilities

  1. Applications Development is responsible for operation and maintenance of the command code.

2.3.78.1.4 (08-01-2023)

Program Management and Review

  1. Program Reports:Upon transmit LOCAT will return the ULC and CLC based on the Zip Code and BOD code.

  2. Program Effectiveness: N/A.

2.3.78.1.5 (08-01-2023)

Program Controls

  1. None.

2.3.78.1.6 (08-01-2023)

Terms/Definitions/Acronyms

  1. Acronym Definition
    PLC Primary Location Code
    CLC Collection Location Code
    ULC Universal Location Code
    BOD Business Operation Division
    AO Area Office Code
    W&I Wage & Investment
    LB&I Large Business & International
    TE/GE Tax Exempt & Government Entities

2.3.78.1.7 (08-01-2023)

Related Resources

  1. None.

2.3.78.1.8 (01-01-2008)

Terminal Response: Error Messages

  1. The following are error messages for CC LOCAT

    • INVALID ZIP CODE INPUT — The zip code input on the screen is not numeric or was not a valid zip code value.

    • BOD CODE MUST BE WI, SB, TE, or LM — The value input in the BOD-CD field was not one of the 4 valid values.

    • BOD CODE OF TE REQUIRES INPUT OF BOD CLIENT CODE — If the BOD-CD value is TE the BOD-CLIENT-CD must be input.

    • INVALID DEFINER CODE— The command code definer (line 1 position 6 — immediately after command code) must contain either F or blank.

    • ERROR DETERMINING CLC FOR ULCAO— The primary location code calculated by the command code doe not have a corresponding CLC. User support should contact National Office programmer.

2.3.78.1.8.1 (01-01-2008)
Terminal Response: Valid Messages

  1. Valid response to CC LOCAT with a definer code of F will be the display of a LOCAT response with literals identifying the input format. Valid response to CC LOCAT with a blank definer will be the requested location information.

Exhibit 2.3.78-1

CC LOCAT or LOCATF

There are 2 ways to do LOCAT:

  1. LOCAT nnnnn nn n — nnnnn is the 5 digit zip code. nn is the BOD code. n is the TE-BOD-CLIENT-CD. See descriptions below.
    OR

  2. LOCATF — Enter with definer "F" and a second screen will appear with prompts for the zip code, BOD code, and TE-BOD-CLIENT-CD:
    LOCAT ZIP>nnnnn BOD>nn TECLIENT>n

    Note:

    See descriptions below.

Description of Entries:

ZIP> required input — 5 digit zip code
BOD> required input. values are:
WI —Wage and Investment
SB — Small Business/Self-Employed
LM — Large/Mid-sized Business
TE — Tax Exempt/Government Entity
TECLIENT>
(TE-CLIENT-CD)		 Required only if the BOD is TE. Values are:
B — Tax Exempt Bonds (TEB)
F — Federal, State & Local Govts (FSL)
I— Indian Tribal Governments (ITG)
1 — Combo ITG & TEB
2 — Combo FSL & TEB
3– Combo Exempt Org & TEB

Exhibit 2.3.78-2

Response Screen to a CC LOCAT request

This is an Image: 32689001.gif

Please click here for the text description of the image.

See figure.

Record Element Specifications

Item Line Position Description
1 1 11–15 Zip code from input
2 1 21–22 BOD code from input
3 1 33 TE-BOD-CLIENT-CD from input
4 4 7–10 Primary Location Code — the Universal Location Code and the Area Office Code for the zip code and BOD code input.
5 4 18–19 Small Business Collection Location Code — the CLC Area Office that would be assigned for this zip/BOD if at a SB site.
6 4 27–28 Wage and Investment Collection Location Code —the CLC Area Office that would be assigned to this zip/BOD if at a WI site.
7 4 35–36 Small Business Service Center — the Service Center code where the SB organization would work this case.
8 4 43–44 Wage and Investment Service Center — the Service Center code where the WI Organization would work this case.
  7–11 1–80 Explanatory messages for codes displayed on line 4.