Accessibility Skip to Top Navigation Skip to Main Content Home  |  Change Text Size  |  Contact IRS  |  About IRS  |  Site Map  |  Español  |  Help  

Part 2. Information Technology

Chapter 3. IDRS Terminal Responses

Section 68. Command Code DUPOL

2.3.68  Command Code DUPOL

Manual Transmittal

December 13, 2011

Purpose

(1) This transmits revised IRM 2.3, IDRS Terminal Responses, Section 68, Command Code DUPOL.

Material Changes

(1) Command Code DUPOL has new definers for 2012; the options now are 0, 1, and 2. The definer reflects the desired processing year. All screen layout descriptions have been modified to reflect these changes.

Effect on Other Documents

IRM 2.3.68, dated 01-01-2011, is superseded.

Audience

You have received a copy of this IRM chapter because you are on the Distribution for IRM 2.3, IDRS Terminal Responses. Each chapter has its own catalog number used for ordering and distributing purposes. You may adjust the subsequent distribution of this chapter to meet your office's needs by adjusting your quarterly IMDDS Order Point Summary Report (IMR02).

Effective Date

(01-01-2012)

Terence V. Milholland
Chief Technology Officer

2.3.68.1  (01-01-2012)
Command Code DUPOL

  1. Command Code (CC) DUPOL is designed to research and display information to assist in fraud detection of SSNs in both paper and electronically filed returns. CC DUPOL extracts taxpayer information from the Duplicate TIN Database that contains tax return information for the Tax Processing years 2010, 2011 and 2012.

2.3.68.2  (01-01-2012)
Command Code DUPOL Input Format

  1. The required input for CC DUPOL is:

    1. Command Code

    2. Command Code Definer (0, 1, or 2)

    3. TIN (edited or unedited SSN)

    4. TIN Type Code (also called 'validity digit'. values are blank or * only)

2.3.68.3  (01-01-2010)
Command Code DUPOL Output Screens

  1. Some of the features of the DUPOL command code output display screens include:

    1. CC DUPOL will display Nationwide and individual Service Center counts of how many times a particular SSN was used for the desired year. These counts will only be displayed on the first screen if multiple pages exist.

    2. CC DUPOL will display how many times the SSN was used, how it was used, and who used it.

    3. CC DUPOL will provide IDRS-like paging when multiple records exist.

    4. The paging routine will automatically position the cursor following the Start of Message symbol. When the ENTER key is depressed, the terminal will display the next page or any page designated by overlaying a page number onto the format by key input.

    Caution:

    Do not leave the terminal in a paging condition. Since no entry code is needed for input, anyone could depress the ENTER key and have unauthorized access to the display. Terminate terminal session by inputting SINOF.

2.3.68.4  (01-01-2012)
Command Code DUPOL Error Screens

  1. In the event of an error situation, one of the following messages will be issued:

    1. INVALID TIN REQUEST - Taxpayer Identification Number is improperly formatted or non-numeric.

    2. NO RECORD FOUND IN TABLE - There is no information for the requested Taxpayer Identification Number in the Duplicate TIN Database file.

    3. CHECK TIN AND RE-ENTER REQUEST - Check Taxpayer Identification Number and re-attempt request.

    4. DUPOL FILE NOT AVAILABLE - TRY LATER - The attempt to access the Duplicate TIN Database failed.

    5. UNSUCCESSFUL READ CAUSED BY TIME-OUT - The CC request was canceled due to the length of turnaround time.

    6. NO RECORD FOUND IN PRIMARY LINK TABLE - The requested SSN indicates multiple use but no information exist on file.

    7. ERROR DETECTED IN RETRIEVING DATA, CONTACT PROGRAMMER - The attempt to retrieve data from DB2 file encountered a severe error and the program abended.

    8. ERROR DETECTED WHILE OPENING CURSOR, CONTACT PROGRAMMER - The attempt to read multiple records resulted in a severe error.

    9. ERROR DETECTED WHILE CLOSING CURSOR, CONTACT PROGRAMMER - The attempt to close file resulted in a severe error.

    10. SQL ERROR ENCOUNTERED: (error code) - The program aborted due to a DB2 system error. Contact ECC-MTB IBM Database Administration Unit for frontline investigation and resolution. If further investigation cites a DB2 systems error, problem will be escalated to appropriate LSSI Project DBA by IBM Operational DBA as mandated by existing Service Level Agreements.

    11. A PAGING REQUEST WAS ENTERED BEFORE A DUPOL REQUEST WAS ENTERED - an attempt to retrieve an additional page was performed before an initial DUPOL request was made.

    12. NO SCREENS AVAILABLE - The attempt to retrieve an additional screen was unsuccessful, no additional screen exists.

    13. INVALID TRANSACTION REQUEST - The CC request was invalid due to a missing or invalid definer code.

    14. (n) PLAN DEFINER NOT AVAILABLE YET - A definer was used that is not one of the three current definers (0, 1 or 2).

    15. DB2 IS ENABLED BUT NOT CONNECTED YET - DB2 is available and enabled, but is not connected to CICS.

    16. DUPOL REQUIRES TRANS-ID DEFINER AND AN EDITED OR UNEDITED SSN often followed by EXAMPLE > DUPOLx WHERE x MUST BE 0, 1 or 2 - Definer is invalid and/or SSN not valid.

Exhibit 2.3.68-1 
Command Code DUPOL Input Screen

This image is too large to be displayed in the current screen. Please click the link to view the image.
Line Position Description
1 01–05 Command Code: DUPOL
1 06 Command Code Definer: (0, 1, or 2)
    0 = Search 2010 Tax Processing Year (2009 Tax Return)
    1= Search 2011 Tax Processing Year (2010 Tax Return)
    2 = Search 2012 Tax Processing Year (2011 Tax Return)
1 07–15, or 07–17 TIN (edited or unedited SSN)
1 16 or 18 TIN Type Code 'validity digit' (blank or * only)

Exhibit 2.3.68-2 
Command Code DUPOL Response Screen

NOTE: This format is the initial response screen. If more records exist enter paging command DUPPG for additional screen.

This image is too large to be displayed in the current screen. Please click the link to view the image.
Line Position Description
01 01–05 Command Code: DUPOL
01 06 Command Code Definer: (0, 1 or 2)
01 07–15 TIN (Unedited SSN)
01 16 TIN Type Code 'validity digit' (blank or * only)
01 29–50 Screen literal
01 70–79 Date requested
03 02–29 Screen literal
03 31–35 Nationwide SSN usage count
03 54–57 Tax year of requested SSN
05 03–07 Service Center literal
05 09–12 Andover Service Center SSN usage count
05 19–23 Service Center literal
05 25–28 Austin Service Center SSN usage count
05 35–39 Service Center literal
05 41–44 Cincinnati Service Center SSN usage count
05 51–55 Service Center literal
05 57–60 Kansas City Service Center SSN usage count
05 67–71 Service Center literal
05 73–76 Ogden Service Center SSN usage count
06 03–07 Service Center literal
06 09–12 Atlanta Service Center SSN usage count
06 19–23 Service Center literal
06 25–28 Service Center SSN usage count
06 35–39 Service Center literal
06 41–44 Fresno Service Center SSN usage count
06 51–55 Service Center literal
06 57–60 Memphis Service Center SSN usage count
06 67–71 Service Center literal
06 73–76 Philadelphia Service Center SSN usage count
08 01–80 literal
09 01–80 literal
10 01–80 literal
11 01–80 literal
12–21 01–09 Abused SSN
12–21 12–21 File Location Code
12–21 25 System ID
12–21 30-32 Date added (Julian date). NOTE: Dates greater than 366 indicate the record was manually added in a subsequent year after the processing year has ended.
12–21 37–45 Primary SSN
12–21 49 Filing Status Code
12–21 57 Dependent Status Indicator
12–21 63–66 SSN Source Code
12–21 70–72 Reversal Date (if significant, indicates Julian date when the TIN was reversed due to tax return being rejected.)
12–21 77 Priority Code
24 22–25 Page number literal
24 27–29 Current screen number
24 31–32 Page literal
24 34–36 Total number of screens
24 49 Start of Message symbol
24 50–54 COMMAND CODE to retrieve additional screen
24 56–58 Next screen number

Exhibit 2.3.68-3 
Command Code DUPPG Response Screen

Description: Screen layout to display additional page of abused SSN occurrences for requested TIN.

This image is too large to be displayed in the current screen. Please click the link to view the image.
Line Position Description
01 01–05 Command Code: DUPOL
01 06 Command Code Definer (0, 1 or 2)
01 07–15 TIN (Unedited SSN)
01 16 TIN Type Code 'validity digit' (blank or * only)
01 29–50 Screen literal
03 01–80 literal
04 01–80 literal
05 01–80 literal
06 01–80 literal
07–20 01–09 Abused SSN
07–20 12–21 File Location Code
07–20 25 System ID
07–20 28–30 Date added (Julian date). NOTE: Dates greater than 366 indicate the record was manually added in a subsequent year after the processing year has ended
07–20 37–45 Primary SSN
07–20 49 Filing Status Code
07–20 57 Dependent Status Indicator
07–20 63–66 SSN Source Code
07–20 70–72 Reversal Date (if significant, indicates Julian date when the TIN was reversed due to tax return being rejected.)
07–20 77 Priority Code
22 01–78 Additional usage message
   
Note: Indicates if more than 24 records exist
24 22–25 Page number literal
24 27–29 Current screen number
24 31–32 Page literal
24 34–36 Total number of screens
24 49 Start of Message symbol
24 50–54 COMMAND CODE to retrieve additional screen
24 56–58 Next screen number

Exhibit 2.3.68-4 
Command Code DUPOL Error Screen

Description: Screen layout for error messages.

This image is too large to be displayed in the current screen. Please click the link to view the image.
Line Position Description
01 01–05 Command Code: DUPOL
01 06 Command Code Definer: (0, 1 or 2)
01 07–15 TIN (Unedited SSN)
01 16 TIN Type Code 'validity digit' (blank or * only)
01 27–48 Screen literal
01 60–69 Error date
22 01–70 Error message line 1:
    Possible responses:
      *INVALID SSN REQUEST
      *DUPOL FILE NOT AVAILABLE - TRY LATER
      *NO RECORD FOUND IN TABLE
      *NO RECORD FOUND IN PRIMARY LINK TABLE
      *UNSUCCESSFUL READ CAUSED BY TIME-OUT
      *ERROR DETECTED IN RETRIEVING DATA, CONTACT PROGRAMMER
      *ERROR DETECTED WHILE OPENING CURSOR
      *ERROR DETECTED WHILE CLOSING CURSOR
      * SQL ERROR ENCOUNTERED: [error code]
      *A PAGING REQUEST WAS ENTERED BEFORE A DUPOL REQUEST WAS ENTERED
      *PLAN DEFINER NOT AVAILABLE YET
      *DUPOL REQUIRES A TRANS-ID DEFINER AND AN EDITED OR UNEDITED SSN [ continued below]
       
23 01–70 Error message line 2
    Possible responses:
      *CHECK TIN AND RE-ENTER REQUEST
      *DUPOL REQUIRES TRANS-ID DEFINER AND AN EDITED OR UNEDITED SSN
      *DB-2 IS ENABLED BUT NOT CONNECTED YET
      [continued from above] EXAMPLE> DUPOLx WHERE x MUST BE 0, 1 or 2.
       

More Internal Revenue Manual