2.2.8 PCS Command Code MSCHG

Manual Transmittal

December 03, 2019


(1) This transmits revised IRM 2.2.8, Partnership Control System, PCS Command Code MSCHG.

Material Changes

(1) Program Scope and Objectives added.

(2) Terms/Definitions/Acronyms added.

(3) Related Resources added.

Effect on Other Documents

IRM 2.2.8, dated December 17, 2014, is superseded.


This document provides instructions for the general use of the operators accessing the Partnership Control Systems display terminals in the SB/SE, LBI, TE/GE, and Appeals Operation Divisions in the Campus and Area/Industry Offices.

Effective Date


Nancy Sieger
Acting Chief Information Officer

Program Scope and Objectives

  1. This IRM provides instructions on how to use IDRS command code MSCHG.


  1. List of terms and definitions used throughout this IRM section.

    PICF Partnership Information Control File
    GENDATA The Gendata Data Store is an output file from the UNISYS Real Time process
    TEFRA Tax Equity and Fiscal Responsibility Act of 1982
    TIN Taxpayer Identification Number
    MFT Code Masterfile Tax Code

Related Resources

  1. IRM 4.29, Partnership Control System (PCS)

  2. IRM 4.31, Pass-Through Entity Handbook

  3. Form 8336, Partnership Control System PCS Mass Change

PICF Mass Changes (Command Code MSCHG)

  1. Command Code MSCHG is used to build records and write the records to a GENDATA tape for later use by batch processing. These records will be used to effect mass changes to accounts on the PICF. The PICF record will not reflect the change until the following cycle of batch processing has been completed.

  2. The input records must all be Partnerships. The mass change done during batch processing is to the Partner records (Investors) linked to the Partnership. Mass change of Elements 3 and 4 also causes the Partnership’s Special-Project-Code or TEFRA-IND to be changed.

  3. A Mass change of Element 1 will only add the Report-Package-Date to investors that are controlled by the inputting campus. If the PN-CTF-IND = B, apply the change to investors with PBC 295, and if PN-CTF-IND = O apply the change to investors with PBC 298 or 398 only. Also when the Report-Package-Date is set, the Report-Package-Indicator will be set to a Y.

  4. The following elements may be changed by Command Code MSCHG within the limitations prescribed for each individual element.

    Item Number Element Name
  5. When all lines 2-12 have been successfully processed, "OK" will be displayed in positions 43-44 and the message "REQUEST COMPLETED" will be displayed on line 13. For subsequent screens, if lines 2-12 contain "OK" in positions 43-44, the "OK" will be overlaid with "BY" and the line is not processed.

  6. When an error is encountered, processing will stop and asterisks "**" will be displayed in positions 43-44 of the line with the error. The line with the "**" will be re-validated, if the operator does not correct the error, the "**" will be overlaid with "DR" and processing will be continued on the next line.

  7. MSCHG will generate the following error messages which will be displayed on line 13:

    Message Condition
    1-YR-ASSMT-DT > 32 MONTHS AWAY Self explanatory.
    AREA DEADLOCKED, TRY AGAIN Self explanatory.
    AREA IS DOWN Self explanatory.
    AREA IS RESTRICTED Self explanatory.
    BAD FORMAT-CHANGE FIELD The change data is not formatted as shown in the requirements.
    CC-DEFINER NOT VALID WITH MSCHG The CC-definer is not blank or T.
    ITEM NUM MUST HAVE HYPHEN The item number must be followed by a hyphen.
    I/O ERROR. INVALID TRANSACTION Self explanatory.
    INVALID ITEM NUMBER The item number is not in the range 1–4.
    INVALID PN-CLOSING-CD The PN-CLOSING-CD is not A, B, C, D, J, N, O, or S.
    INVALID TAX PERIOD Not YYYYMM format or valid.
    INVALID TIN, F/S TIN does not have a valid configuration and/or File Source Indicator.
    LINE 2 BLANK Line 2 must have data.
    LINES 2–12 BYPASSED Lines 2–12 have "DR" or "BY" in pos. 43–44.
    MFT/TAX PERIOD INCONSISTENT MFT and Tax Period are inconsistent.
    ONLY PROJ CODE 0013 or 0015 ALLOWED AFTER YR 1990 For 1991 and subsequent, only "0000" "0013" or "0015" is a valid SPECIAL-PROJECT-CD input.
    PS TIN CHANGED TO nnnnnnnnnnnn PICF account is change-TIN case. Displays new edited TIN. Re-input using new TIN.
    RECOVERY IN PROGRESS Self explanatory.
    REQUEST NOT PROCESSED INPUT ON LINES 1–12 ONLY There is data on line 13. Line 13 is reserved for messages.
    SPECIFIC TAX SHELTER PROJ CODE REQUIRED The SPECIAL-PROJECT-CD input is not a valid tax shelter project code for 1990 and prior.
    SYSTEM ERROR ON ACCESS/UPDATE PICF is down or unavailable.
    SYSTEM ERROR ON ACCESS PICF is down or unavailable.
    TIN/FS/MFT INCONSISTENT The TIN and File Source are not consistent with the MFT.

Command Code MSCHG

MSCHG Input Screen Format

This is an Image: 28581076.gif

Please click here for the text description of the image.

Record Element Description

Element Line Position Description
1 1 1–5 CC MSCHG
2 2–12 1–12 Edited Key Case TIN (Item 2)
3 2–12 14–15 Key Case MFT Code NN (Item 3)
4 2–12 17–22 Tax Period YYYYMM (Item 4)
5 2–12 31–32 Change Item Number ("1" , "2" , "3" , "4" or "5" ) (Item 5)
6 2–12 33–41 Change Value (V–V)
7 13 1–40 System-Message Line

Note: Item numbers in parenthesis refer to those on Form 8336.

Command Code MSCHG — Input Screen Example

MSCHG Input Screen Example

This is an Image: 28581077.gif

Please click here for the text description of the image.

Record Element Description

Element Line Position Description
1 1 1–5 CC "MSCHG"
2 2–12 1–12 Key Case TIN "06–1234567"
3 2–12 14–15 MFT Code "06"
4 2–12 17–22 Tax Period "199912"
5 2–12 33–41 Change Elements "3–0013"

This is an example of an input screen changing the SPECIAL-PROJECT-CODE to 0013. This will cause the SPECIAL-PROJECT-CODE of all of the Partner's (Investors) records that are linked to this Partnership as well as the Partnership record to be changed.


Tax shelter SPECIAL-PROJECT-CDs are only valid for tax periods prior to 1991. Beginning with tax period 1991, SPECIAL-PROJECT-CDs "0013" and "0015" will be the only codes which will be allowed in MSCHG.