AccessibilitySkip to Top NavigationSkip to Main ContentHome  |  Contact IRS  |  About IRS  |  Site Map  |  Español  |  Help  

2.3.47  Command Codes INOLE, EOGEN, and SPARQ

2.3.47.1  (01-01-2005)
On Line Entity (OLE) Description

  1. ON LINE ENTITY (OLE) is the first phase of the Corporate Files On-line (CFOL) project. OLE makes possible, to all IDRS users, national entity information through the National Account Profile (NAP) in Martinsburg.

  2. The NAP contains extensive Master File entity information for all taxpayers on the IMF, BMF (SSN and EIN), and EPMF. There is also Social Security data (DM-1) and spouse cross-reference data.

  3. Command Code INOLE is used as a research tool to display the entity information found on the NAP.

  4. Command Code EOGEN is used to display EIN and name line information for exempt organizations.

  5. Command Code SPARQ is used as a research tool to display the address information for both the primary and secondary taxpayers on a jointly filed return.

2.3.47.2  (01-01-2000)
Command Code INOLE

  1. The intent of this Command Code is to negate the need for some MFTRA requests when entity information (less posted entity transactions) is needed for the user to perform their duties.

  2. The display of NAP data will be restricted to one page of screen information. For items such as IMF Prior Namelines, it may be necessary to do a MFTRA to see all the occurrences of these fields.

2.3.47.3  (01-01-2005)
Command Code INOLE Input Format

  1. Command Code INOLE is designed to display Master File entity data (including SSA name controls, Cross Reference information, and Merge Transactions) for a specific Taxpayer Identification Number (TIN) residing on the NAP. The request type (via command code definer) determines the kind of data desired by the requestor. Requests are researched via the input TIN. If primary TIN is unknown, a request may be input with the spouse's TIN. There are five types of INOLE inquiries that can be requested.

  2. Command Code INOLE input with the definer "G" — an unedited or edited TIN will be input. This command will be useful when the tin type is unknown. The returning screen will contain any nameline information available for any account attributable to that number, regardless of file if edited TIN is input. This request type involves multiple database accesses and should be used only when necessary.

    1. Command Code INOLE input with the definer "T" — an edited TIN (either SSN or EIN) and file source will be input. This command will be useful when research is desired on all accounts with the same SSN or EIN. Nameline and street address information will be returned to the user for each matching account.

    2. Command Code INOLE input with the definer "S" — an edited TIN and file source will be input. This request type will be most useful when the specific account is already known. Namelines (current and prior), street addresses, tax year, Social Security name controls, cross reference and other information specific to the type of account being requested will be returned to the user.

    3. Command Code INOLE input with the definer "X" — an edited TIN and file source will be input. This request type will be most useful when researching TINs that have no Master File account. DM1 name controls, Cross reference and merge transaction information will be returned to the user. Information returned to the user will be specific to the file source input. On SSN requests, both tin types (valid and invalid) will be searched for data, regardless of file source input. If a file source of IMF valid is input, the resulting display will show data for both the valid and invalid accounts if such data exists.

    4. Command Code INOLE input with the definer "P" — an edited EIN, file source (P), and EPMF Plan number. This request type will be used to display EPMF Plan information. The EPMF SPECIFIC SCREEN is capable of displaying only five plan names. The screen display for the " P" definer is able to display up to ten plan names. The list of plan names displayed will begin with the plan number that is input, or the next highest number.

2.3.47.4  (01-01-2008)
Command Code INOLE Default Procedures

  1. After all research data is retrieved, the system will analyze for all significant fields. Depending on the information found on the NAP for a requested TIN, the screen may be defaulted in order to provide more information back to the terminal operator. This will be done in order to prevent subsequent requests. The terminal operator will be made aware that this has occurred. The defaults are as follows:

  2. General Request (INOLEG)

    1. Only information found pertains to multiple SSNs — default is Tin-type SSN — See Exhibit 2.3.47-4.

    2. Only information found pertains to multiple EINs — default is Tin-type EIN — See Exhibit 2.3.47-3.

    3. Only information found pertains to a single SSN — default is specific (IMF, BMF) — See Exhibit 2.3.47-8. See Exhibit 2.3.47-6.

    4. Only information found pertains to a single EIN — default is specific (BMF or EPMF) — See Exhibit 2.3.47-5. See Exhibit 2.3.47-7.

  3. Tin-type Request (INOLET)

    1. Only information found pertains to a single SSN — default is specific (IMF, BMF) — See Exhibit 2.3.47-8. See Exhibit 2.3.47-6.

    2. Only information found pertains to a single EIN — default is specific (BMF or EPMF) — See Exhibit 2.3.47-5. See Exhibit 2.3.47-7.

  4. General, Tin-type or Specific Request (INOLEG, T or S) — No Master File account is present but Cross Reference and/or transaction information is available — See Exhibit 2.3.47-9. See Exhibit 2.3.47-10.

2.3.47.5  (01-01-2000)
Command Code EOGEN

  1. Command Code EOGEN is used to request the display of group ruling information for exempt organizations: both parents and subordinates using the Group Exempt Number (GEN). Name information will also be presented for each EIN shown. This command code will get its information at MCC.

  2. EOGEN must be input with one of two Definer Codes: "P " if information about the parent organization is desired and "S" if a list of subordinate (to parent) organizations is desired. A successful Definer Code "P" causes a command code BMFOL Definer Code "0" screen to be displayed for the parent. EOGEN screens that contain subordinate EIN's, Definer Code " S" give the user the ability to enter his/her entry code at a specific subordinate EIN on the screen. By then hitting enter key XMIT) a command code BMFOL, Definer Code "0" is requested.

  3. Error messages:

    1. "INVALID STATE REQUEST" — Requested state field is invalid, valid ranges are state abbr, blanks if no state in request and "." if requesting foreign state

    2. "INVALID REQUEST — VALID GEN NUMBERS ARE 0001 TO 9999 " — .

    3. "INVALID REQUEST — VALID DEFINER CODES ARE P OR S. "

    4. "GEN NOT ON FILE" — Requested Group Exemption Number not found.

    5. "NO SUBS FOR THIS GEN" — No subordinates associated with requested Group Exemption Number.

    6. "NO SUBS FOR THIS REQUESTED STATE" — No subordinates associated with requested Group Exemption Number and requested state.

    7. "**EOGEN PARENT FILE NOT AVAILABLE — TRY LATER**" — Unable to fulfill request because file was unable to be accessed, try later.

    8. "**EOGEN SUBORDINATE FILE NOT AVAILABLE — TRY LATER** " — Unable to fulfill request because file was unable to be access, try later.

2.3.47.6  (01-01-2003)
Command Code SPARQ

  1. Command Code SPARQ is designed to be used to research for a more current address of a former spouse. Only prior tax years can be researched for spouse address information. The entity and cross reference data on the NAP are used to find the most current address for both taxpayers of a jointly filed return. Requests are researched by primary and secondary TIN's and tax period. This same feature has also been made available to notice programs to send a copy of a notice to the former spouse at a different address.

  2. If the secondary TIN is unknown, command code INOLE or IMFOL can be used to locate the secondary TIN for the tax year in question or a request can be input with the primary TIN, zeroes in the secondary TIN, and tax period only. If the request is input without the secondary TIN, command code SPARQ uses the tax period year to locate the secondary SSN.

  3. Command code SPARQ first checks to see if the most current name line year for the primary SSN still has the same secondary SSN. A check is then made to see if the secondary SSN is now filing as a primary taxpayer. A final check is made, using the cross reference data on the NAP to see if the secondary SSN is now filing jointly with another primary taxpayer. If more than one of the above is possible, the name line year is used to determine the most current address.

  4. If SPARQ is unable to locate a more current address for the secondary SSN, only the address for the primary SSN will be displayed.

2.3.47.7  (01-01-2002)
Command Code SPARQ Terminal Response

  1. Messages will appear on line 24. Only one message will appear at a time. A message will be displayed showing which source had the most current address for the secondary SSN. Error message will be displayed in the order of validity checks performed.

  2. Error messages:

    1. "PRIMARY TIN IS INVALID, PLEASE CHECK INPUT" or "SECONDARY TIN IS INVALID, PLEASE CHECK INPUT" — SSN other than numeric or incorrectly formatted.

    2. "TAX PERIOD IS INVALID, PLEASE CHECK INPUT" — Tax period invalid or not a prior tax year.

    3. "PRIMARY TIN NOT ON MF" — The primary SSN input does not have account data on the NAP file.

    4. "SECONDARY TIN NOT ASSOCIATED WITH PRIMARY" — Command code SPARQ was input without a secondary SSN and the primary taxpayer did not file a joint return for the tax year in question or no secondary SSN was found.

    5. "NAP FILE NOT AVAILABLE" — There was a file or system effort during the attempt to access the NAP file, try again later.

    6. "NO DM1 DATA AVAILABLE ON NAP FOR PRIMARY" — The primary input SSN cannot be found on the SSA file.

    7. "NO DM1 DATA AVAILABLE ON NAP FOR SECONDARY" — The secondary input SSN cannot be found on the SSA file.

    8. "SECONDARY TIN NOT ON MF" — The secondary input SSN does not have account data on the NAP file.

    9. "SPOUSE ADDRESS UNDER SAME PRIMARY SSN-INPUT PRIMARY DECEASED " — The input primary and secondary SSNs were filing a joint return for input tax period, but the primary is now deceased.

    10. "SPOUSE ADDRESS UNDER SAME PRIMARY SSN-INPUT SECONDARY DECEASED " — The input primary and secondary SSNs were filing a joint return for input tax period, but the secondary is now deceased.

    11. "SPOUSE ADDRESS UNDER SAME PRIMARY SSN-BOTH DECEASED" — The input primary and secondary SSNs were filing a joint return for the input tax period, both the primary and secondary taxpayers are now deceased.

    12. "NO SECONDARY ADDRESS DATA ON NAP" — There is no address data available on the NAP for input secondary SSN.

    13. "SPOUSE AS PRIMARY, BUT ADDRESS THE SAME — INPUT PRIMARY DECEASED" — The spouse is now filing as a primary taxpayer, the input primary is deceased.

    14. "SPOUSE AS PRIMARY, BUT ADDRESS THE SAME — INPUT SECONDARY DECEASED" — The spouse was filing as the primary for input tax period, but is now deceased.

    15. "SPOUSE AS PRIMARY, BUT ADDRESS THE SAME — BOTH PRIMARY AND SECONDARY DECEASED" — The spouse was filing as the primary for input tax period, but the input primary and secondary are both deceased.

    16. "SPOUSE FILING WITH NEW PRIMARY TAXPAYER — INPUT PRIMARY DECEASED" — The input secondary was filing with a new primary taxpayer, the input primary taxpayer is deceased.

    17. "SPOUSE FILING WITH NEW PRIMARY TAXPAYER — INPUT SECONDARY DECEASED" — The input secondary was filing with a new primary, but is now deceased.

    18. "SPOUSE FILING WITH NEW PRIMARY TAXPAYER — INPUT PRIMARY AND SECONDARY DECEASED" — The input secondary was filing with a new primary, but the input secondary and input primary are both deceased.

    19. "NO PRIMARY ADDRESS DATA ON NAP" — There is no address data available on the NAP for input primary SSN.

  3. Other messages:

    1. "SPOUSE FILING WITH SAME PRIMARY SSN" — The primary and secondary SSN's are still filing joint returns together.

    2. "SPOUSE NOW FILING AS PRIMARY TAXPAYER" — The former spouse is now filing as a primary taxpayer.

    3. "SPOUSE FILING WITH NEW PRIMARY SSN" — The most current cross reference data on the NAP file for the secondary SSN was for a different primary SSN.

    4. "LATEST SPOUSE ADDRESS INFORMATION QUESTIONABLE" — The latest address available for spouse appears not to be good now because a later return (without spouse) indicates spouse may not live there anymore.

    5. "FILING STATUS CODE CHANGE BUT ADDRESS IS THE SAME" — Both primary and spouse filed after requested year not jointly but they have the same address.

Exhibit 2.3.47-1  (01-01-2000)
Command Code INOLE INPUT SCREEN

Description: Description: Input formats for Command Code INOLE.
This image is too large to be displayed in the current screen. Please click the link to view the image.
E1— INOLEG E2— nnnnnnnnn
nnn-nn-nnnn
nn-nnnnnnn
— unedited TIN
— edited TIN (SSN)
— edited TIN (EIN)
  INOLET   nnn-nn-nnnn
nn–nnnnnnn
— edited TIN (SSN)
— edited TIN (EIN)
  INOLES   nnn-nn-nnnnv
nn-nnnnnnnv
— edited TIN (SSN) with Display Source Code
— edited TIN (EIN) with Display Source Code
  INOLEX   nnn-nn-nnnnv
nn-nnnnnnnv
— edited TIN (SSN) with Display Source Code
— edited TIN (EIN) with Display Source Code
  INOLEP   nn-nnnnnnnvnnn — edited TIN (EIN) with Display Source Code = "p" . Immediately followed by a 3-digit numeric PLAN-NUM.

Exhibit 2.3.47-2  (01-01-2002)
Command Code INOLE GENERAL SCREEN

Description: Response screen layout used for "INOLEG" responses.
Note: "Display groups " having no significant data will not be displayed. Remaining "display groups" will shift upward accordingly.
This image is too large to be displayed in the current screen. Please click the link to view the image.
Line-Item Position Description
1.1 1 COMMAND-CD
1.2 6 COMMAND-DEFINER-CD
1.3 7 TIN
1.4 21 Literal
1.5 29 NAME-CONTROL-(SSA) — the literal "*MORE" will appear if there are more name controls than can be displayed.
3.1 1 TIN-(PRIMARY)
3.2 12 DISPLAY-SOURCE-CD-value = "[slashb]"
3.3 15 Literal
3.4 22 PRIMARY-LOCATION-CD
3.5 26 Literal
3.6 27 COLLECTION-LOCATION-CD
3.7 32 XREF Indicator — denotes the presence of Cross Reference information.
3.8 41 TIN-(PRIMARY)
3.9 52 DISPLAY-SOURCE-CD-value = "*"
3.10 55 Literal
3.11 62 PRIMARY-LOCATION-CD
3.12 66 Literal
3.13 67 COLLECTION-LOCATION-CD
3.14 72 XREF Indicator — denotes the presence of Cross Reference information.
4.1 1 TP-PRIMARY-NM
4.2 41 TP-PRIMARY-NM
5.1 1 Literal
5.2 7 TP-PRIMARY-NAME-YR
5.3 13 Literal
5.4 17 FILING-STATUS-CD
5.5 20 Literal
5.6 26 TIN-(SPOUSE)
5.7 37 DISPLAY-SOURCE-CD
5.8 41 Literal
5.9 47 TP-PRIMARY-NAME-YR
5.10 53 Literal
5.11 57 FILING-STATUS-CD
5.12 60 Literal
5.13 66 TIN-(SPOUSE)
5.14 77 DISPLAY-SOURCE-CD
7.1 1 TIN-(PRIMARY)
7.2 12 DISPLAY-SOURCE-CD-value = "P"
7.3 15 Literal
7.4 22 PRIMARY-LOCATION-CD
7.5 26 Literal
7.6 27 COLLECTION-LOCATION-CD
7.7 32 XREF Indicator — denotes the presence of Cross Reference information.
7.8 41 TIN-(PRIMARY)
7.9 52 DISPLAY-SOURCE-CD-value = "X"
7.10 55 Literal
7.11 62 PRIMARY-LOCATION-CD
7.12 66 Literal
7.13 67 COLLECTION-LOCATION-CD
7.14 72 XREF Indicator — denotes the presence of Cross Reference information.
8.1 1 TP-PRIMARY-NM
8.2 41 TP-PRIMARY-NM
10.1 1 TIN-(PRIMARY)
10.2 12 DISPLAY-SOURCE-CD-value = "V"
10.3 15 Literal
10.4 22 PRIMARY-LOCATION-CD
10.5 26 Literal
10.6 27 COLLECTION-LOCATION-CD
10.7 32 XREF Indicator — denotes the presence of Cross Reference information.
10.8 41 Literal
10.9 51 NAME-CONTROL-(PRIOR)
11.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM
13.1 1 TIN-(PRIMARY)
13.2 12 DISPLAY-SOURCE-CD-value = "W"
13.3 15 Literal
13.4 22 PRIMARY-LOCATION-CD
13.5 26 Literal
13.6 27 SECONDARY-LOCATION-CD
13.7 32 XREF Indicator — denotes the presence of Cross Reference information.
13.8 41 Literal
13.9 51 NAME-CONTROL-(PRIOR)
14.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM
16.1 1 TIN-(PRIMARY)
16.2 11 DISPLAY-SOURCE-CD-value = ";[slashb];"
16.3 15 Literal
16.4 22 PRIMARY-LOCATION-CD
16.5 26 Literal
16.6 27 COLLECTION-LOCATION-CD
16.7 32 XREF Indicator — denotes the presence of Cross Reference information.
16.8 41 Literal
16.9 51 NAME-CONTROL-(PRIOR)
17.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM
19.1 1 TIN-(PRIMARY)
19.2 11 DISPLAY-SOURCE-CD-value = "P"
19.3 15 Literal
19.4 22 PRIMARY-LOCATION-CD
19.5 26 Literal
19.6 27 COLLECTION-LOCATION-CD
19.7 32 XREF Indicator — denotes the presence of Cross Reference information.
19.8 41 Literal
19.9 51 NAME-CONTROL-(PRIOR)
20.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM

Exhibit 2.3.47-3  (01-01-2006)
Command Code INOLE TIN TYPE EIN SCREEN

Description: Response screen layout used for displaying BMF EIN and EPMF data.
Note: "Display groups " having no significant data will not be displayed. Remaining "display groups" will shift upward accordingly.
This image is too large to be displayed in the current screen. Please click the link to view the image.
Line-Item Position Description
1.1 1 COMMAND-CD
1.2 6 COMMAND-DEFINER-CD
1.3 7 TIN-(EIN)
3.1 1 TIN-(PRIMARY)
3.2 11 DISPLAY-SOURCE-CD — value = "[slashb]"
3.3 15 Literal
3.4 22 PRIMARY-LOCATION-CD
3.5 26 Literal
3.6 27 COLLECTION-LOCATION-CD
3.7 32 XREF Indicator — denotes the presence of Cross Reference information.
4.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM
5.1 1 TP-FOREIGN-ADDR
6.1 1 TP-STREET-ADDR
6.2 1 CITY-NM
6.3 24 STATE-CD
6.4 27 ZIP-CD
6.5 50 Literal
7.1 1 CITY-NM
7.2 24 STATE-CD
7.3 27 ZIP-CD
7.4 45 Filing Requirements
8.1 1 literal
8.2 13 NAME-CONTROL-(CURRENT)
8.3 22 literal
8.4 32 NAME-CONTROL-(PRIOR)
8.5 45 Filing Requirements
9.1 1 literal
9.2 17 FISCAL-YEAR-MTH
9.3 45 Filing Requirements
10.1 1 literal
10.2 9 Exempt Organization Data Indicator Value "Y" — Account contains EO data
10.3 45 Filing Requirements
11.1 45 Filing Requirements
12.1 45 Filing Requirements
14.1 1 TIN-(PRIMARY)
14.2 11 DISPLAY-SOURCE-CD — value = "P"
14.3 15 literal
14.4 22 PRIMARY-LOCATION-CD
14.5 26 literal
14.6 27 COLLECTION-LOCATION-CD
14.7 32 XREF Indicator — denotes the presence of Cross Reference information.
15.1 1 TP-PRIMARY-NM and TP-PRIMARY-CONTINUATION-NM
16.1 1 TP-FOREIGN-ADDR.
17.1 1 TP-STREET-ADDR
17.2–4 47 literal
18.1 1 CITY-NM
18.2 24 STATE-CD
18.3 27 ZIP-CD
18.4–6 46 literal
19.1 1 literal
19.2 13 NAME-CONTROL-(CURRENT)
19.3 22 literal
19.4 32 NAME-CONTROL-(PRIOR)
19.5 47 PLAN-NUM
19.6 59 PLAN-YEAR-MTH
19.7 66 PLAN-EFFECTIVE-DT
20.1 1 literal
20.2 17 FISCAL-YEAR-MTH
20.3 47 PLAN-NUM
20.4 59 PLAN-YEAR-MTH
20.5 66 PLAN-EFFECTIVE-DT
21.1 47 PLAN-NUM
21.2 59 PLAN-YEAR-MTH
21.3 66 PLAN-EFFECTIVE-DT
22.1 47 PLAN-NUM
22.2 59 PLAN-YEAR-MTH
22.3 66 PLAN-EFFECTIVE-DT
23.1 47 PLAN-NUM
23.2 59 PLAN-YEAR-MTH
23.3 66 PLAN-EFFECTIVE-DT

Exhibit 2.3.47-4  (01-01-2002)
Command Code INOLE TIN TYPE SSN SCREEN

Description: Response screen layout used for displaying multiple Master File account information related by SSN.
Note: "Display groups " having no significant data will not be displayed. Remaining "display groups" will shift upward accordingly.
This image is too large to be displayed in the current screen. Please click the link to view the image.
Line-Item Position Description
1.1 1 COMMAND-CD
1.2 6 COMMAND-DEFINER-CD
1.3 7 TIN-(SSN)
1.4 23 literal
1.5 31 NAME-CONTROL-(SSA) — the literal "*MORE" will appear if there are more name controls than can be displayed.
2.1 23 literal
2.2 35 NAME-CONTROL-(SSA)
3.1 1