2.3.25 Command Codes DM1DT and DTVUE

Manual Transmittal

November 08, 2023

Purpose

(1) This transmits revised IRM 2.3.25, IDRS Terminal Responses, Command Codes DM1DT and DTVUE.

Material Changes

(1) IRM 2.3.25.1 updated for Internal Controls per SPDER IRM 1.11.2

Effect on Other Documents

IRM 2.3.25, dated 04-13-2020, 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

(11-08-2023)


Kaschit Pandya
Acting, Chief Information Officer

Program Scope and Objectives

  1. Overview:This IRM provides information on CFOL command codes DM1DT and DTVUE. Details below.

  2. Purpose:These sections provide instructions for accessing and modifying entity information though the Data Master–1 (DM1) information in Martinsburg, WV.

  3. Audience:Wage and Investment (W&I), Small Business/Self Employed (SB/SE), Tax Exempt and Government Entity (TE/GE), Taxpayer Advocate Service (TAS), Criminal Investigation (CI), Appeals, as well as other IRS organizations profiled for these restricted IDRS command codes.

  4. Policy Owner:Director, Corporate Data Domain(CP)

  5. Program Owner:Modernization and Information Technology (MITS)

  6. Primary Stakeholders: Wage and Investment (W&I), Small Business/Self Employed (SB/SE), Tax Exempt and Government Entity (TE/GE), and Enterprise Operations (EOPS).

  7. Program Goals: These are the instructions for using the CFOL/IDRS command codes DM1DT and DTVUE.

Background

  1. DM1 Date Processing Overview: Two services are provided for Date Processing by separate IDRS Command Codes.

    1. DM1DT allows the user to change the date of birth, or date of death, on the Data Master (DM1) file for a particular Social Security Number (SSN), Individual Taxpayer Identification Number (ITIN), or Adoption Taxpayer Identification Number (ATIN).

    2. DTVUE allows the user to view DM1 date data for a particular SSN/ITIN/ATIN.

Authority

  1. Unified Work Request (UWR) 967232

Roles and Responsibilities

  1. Applications Development (AD) is responsible for operations and maintenance of the command codes.

  2. Director, CP

  3. Branch Chief, TDOL

Program Management and Review

  1. Project’s data source is the DM1 VSAM files

Program Controls

  1. Access to this program is governed by SACS.

Terms/Acronyms

  1. Acronym Definition
    CFOL Corporate Files Online
    CP Corporate Data domain
    DM1 Data Master 1
    DM1DT DM1 date entry command code
    DTVUE DM1 date view command code
    IDRS Integrated Data Retrieval System
    IMDDS Internal Management Document Distribution System
    IMF Individual Master File
    IPPIN Identity Theft Protection Pin
    IRS Internal Revenue Service
    ISPF Interactive System Productivity Facility
    IT Information Technology
    NAP National Account Profile
    SSN Social Security Number
    TDOL Tax Data On-line Branch
    TIN Tax Identification Number

Related Resources

  1. Functional Specifications Package (FSP) 5.10.21.00 Data Master One (DM-1) VSAM Update

Command Code DTVUE Overview

  1. Some of the features of the DTVUE command code and the DM1 file are:

    1. This command code displays date of birth (DOB) and date of death (DOD) information from the DM1 file.

    2. All DM1 records contain a date of birth from the Social Security Administration.

    3. DM1 records may also contain an IRS date of birth previously input via command code DM1DT. Whenever an IRS date of birth is present, it is the one used for all processing decisions.

    4. Some DM1 records contain a date of death from the Social Security Administration.

    5. DM1 records may also contain an IRS date of death. Whenever an IRS date of death is present, it is the one used for all processing decisions.

Command Code DTVUE Requirements

  1. Command Code DTVUE has several requirements:

    1. The name control must be input to ensure the SSN-ITIN-ATIN was correctly entered.

    2. The SSN/ITIN/ATIN requested must find a matching record on the DM1.

Command Code DM1DT Overview

  1. Here is an overview of the command code DM1DT:

    1. The command code creates an update record, which will be applied to the DM1 during weekly processing.

    2. The user may add, change, or delete an IRS date (either DOB or DOD).

    3. If the DM1 is not available, the exact message issued will be "DM1 FILE NOT AVAILABLE" . Any other message indicating failure of the command code will represent a failure of the telecommunications or systems support and should NOTbe reported as a DM1 problem.

    4. A successful execution will be confirmed with a message "REQUEST COMPLETED" .

Command Code DM1DT Requirements

  1. The IDRS Command Code DM1DT has several requirements:

    1. An Action Code, a Birth/Death Indicator, a new IRS date (except for delete records), and a name control must be input.

    2. If the Action Code is D (delete), then the new IRS date must be '00000000'. Otherwise, the message NAME CONTROL MISMATCH will be returned.

    3. The SSN/ITIN/ATIN must be within the range for TINs.

    4. The Action Code must be A (add date), C (change date), or D (delete date).

    5. The Birth/Death Indicator must be B (birth) or D (death).

    6. The new IRS date must be a valid date.

    7. The new IRS date must be before the current date.

    8. A delete record must not contain a new IRS date.

    9. The SSN must find a match on the DM1 file.

    10. The input Name Control must match one of the name controls on the DM1 file.

    11. If the Action Code is A (add) and the Birth/Death Indicator is B (birth), then the DM1 must not already contain an IRS Date of Birth. Similarly, if the Birth/Death Indicator is D, the DM1 must not already contain an IRS Date of Death.

    12. If the Action Code is C (change) or D (delete) and the Birth/Death Indicator is B (birth), then the DM1 must already contain an IRS Date of Birth. Similarly, if the Birth/Death Indicator is D, the DM1 must already contain an IRS Date of Death.

    13. If the Action Code is A (add) and the Birth/Death Indicator is B (birth), then the new IRS Date of Birth must differ from the existing SSA Date of Birth. Similarly, an added IRS Date of Death must differ from any existing SSA Date of Death.

    14. If the Action Code is C (change) and the Birth/Death Indicator is B (birth), then the new IRS Date of Birth must differ from the existing IRS Date of Birth. Similarly, an added IRS Date of Death must differ from the existing IRS Date of Death.

    15. Only one action per SSN per week is permitted.

Command Code DM1DT Input Screen

Description: Screen layout for Command Code DM1DT request.

This is an Image: 28138001.gif

Please click here for the text description of the image.

Line Position Description
01 01–05 Command Code: DM1DT
01 07–17 TIN (Edited SSN)
01 19 Action Code (A = add; C = change; D = delete)
01 21 Birth/Death Indicator (B = birth; D = death)
01 23–30 IRS date (YYYYMMDD)
01 32–35 Name Control

Command Code DM1DT Output Display

Description: Screen layout for Command Code DM1DT output.

This is an Image: 28138002.gif

Please click here for the text description of the image.

Line Position Description
01 01–05 Command Code: DM1DT
01 07–17 TIN (Edited SSN)
01 19 Action Code (A = add; C = change; D = delete)
01 21 Birth/Death Indicator (B = birth; D = death)
01 23–30 IRS date (YYYYMMDD)
01 32–35 Name Control
19 21–59 message

Command Code DTVUE Input Display

Description: Screen layout for Command Code DTVUE request.

This is an Image: 28138003.gif

Please click here for the text description of the image.

Line Position Description
01 01–05 Command Code: DTVUE
01 07–17 TIN (Edited SSN)
01 19–22 Name Control

Command Code DTVUE Output Display

Description: Screen layout for Command Code DTVUE output.

This is an Image: 28138004.gif

Please click here for the text description of the image.

Line Position Description
01 01–05 Command Code: DTVUE
01 07–17 TIN (Edited SSN)
01 19–22 Name Control
07 31–33 literal: IRS
07 48–50 literal: SSA
09 10–22 literal: DATE OF BIRTH
09 29–36 IRS date of birth
09 46–53 SSA date of birth
13 10–22 literal: DATE OF DEATH
13 29–36 IRS date of death
13 46–53 SSA date of death
19 21–59 message