Partnertax.ai
Start free trial →

Internal Revenue Manual

IRM 2.3.25

Command Codes DM1DT and DTVUE

Official textirs.govlast amended 17 subsections

# Part 2. Information Technology

Chapter 3. IDRS Terminal Responses

Section 25. Command Codes DM1DT and DTVUE

2.3.25 Command Codes DM1DT and DTVUE

Manual Transmittal

December 22, 2025

Purpose

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

Material Changes

(1) IRM 2.3.25 revised throughout to update organizational title Taxpayer Services.

Effect on Other Documents

IRM 2.3.25, dated 11-08-2023, is superseded.

Audience

Taxpayer Services (TS), 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.

Effective Date

(01-02-2026)


Kaschit Pandya
Acting Chief Information Officer

# Program Scope and Objectives

2.3.25.1 (02-07-2025)

  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: Taxpayer Services (TS), 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: Tax Data On-line (TDOL), a branch within CP

  6. Primary Stakeholders: Taxpayer Services (TS), 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

2.3.25.1.1 (11-08-2023)

  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

2.3.25.1.2 (01-02-2026)

  1. Unified Work Request (UWR) 999071

# Roles and Responsibilities

2.3.25.1.3 (11-08-2023)

  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

2.3.25.1.4 (11-08-2023)

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

# Program Controls

2.3.25.1.5 (11-08-2023)

  1. Access to this program is governed by SACS.

# Terms and Acronyms

2.3.25.1.6 (11-08-2023)

  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
    SACS Security and Communication(s) System

# Related Resources

2.3.25.1.7 (11-08-2023)

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

# Command Code DTVUE Overview

2.3.25.2 (01-01-2009)

  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

2.3.25.3 (01-01-2009)

  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

2.3.25.4 (01-01-2009)

  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

2.3.25.5 (01-01-2009)

  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

Exhibit 2.3.25-1

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

Exhibit 2.3.25-2

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

Exhibit 2.3.25-3

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

Exhibit 2.3.25-4

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

Source: view the official text

Report a problem

What's wrong?

Sent anonymously with this page's citation. No personal information is collected.
In this part (40 sections)
  1. 2.2.2 · PCS Command Code TSLOD
  2. 2.2.3 · PCS Command Code TSCHG
  3. 2.2.4 · PCS Command Code TSINQ
  4. 2.2.5 · PCS Command Code TSDEL
  5. 2.2.6 · PCS Command Code TSNOT
  6. 2.2.7 · PCS Command Code TSCLS
  7. 2.2.8 · PCS Command Code MSCHG
  8. 2.2.9 · PCS Command Code TSUMY
  9. 2.3.1 · Section Titles and Command Codes for IDRS Terminal Responses
  10. 2.3.2 · Introduction to IDRS Terminal Responses
  11. 2.3.8 · Standard Validity Criteria
  12. 2.3.10 · Command Codes MFREQ and RECON
  13. 2.3.11 · Command Codes TXMOD and SUMRY
  14. 2.3.12 · Command Code ACTON
  15. 2.3.13 · Command Codes FFINQ, REINF, and REMFE
  16. 2.3.15 · Command Code ENMOD
  17. 2.3.16 · Command Codes RFINK and RAFRQ
  18. 2.3.17 · Command Code ESTABD
  19. 2.3.18 · Command Code ESTABM
  20. 2.3.20 · Command Code URINQ (URF)
  21. 2.3.25 · Command Codes DM1DT and DTVUE
  22. 2.3.26 · Command Code TDINQ
  23. 2.3.27 · Command Code ECREQ
  24. 2.3.28 · Command Code FTDPN
  25. 2.3.29 · Command Codes INTST, ICOMP, and COMPA
  26. 2.3.30 · Command Code DAILY
  27. 2.3.31 · Command Codes CFINK , RPINK, KAFFQ and KAFTQ for CAF Inquiry
  28. 2.3.32 · Command Code MFTRA
  29. 2.3.34 · Command Code PATRA
  30. 2.3.35 · Command Code IRPTR
  31. 2.3.36 · Command Code SCFTR
  32. 2.3.37 · Command Code UPTIN for the GUF System
  33. 2.3.38 · Command Code TXCMP
  34. 2.3.40 · Command Code PICRD
  35. 2.3.41 · Command Code PIEST
  36. 2.3.43 · Command Code PIFTF
  37. 2.3.44 · Command Code PIVAR
  38. 2.3.45 · Command Code XSINQ
  39. 2.3.47 · Command Codes INOLE, EOGEN, and SPARQ
  40. 2.3.48 · Command Code UPDIS for the GUF System
Full table of contents →