IBM PERSONAL COMPUTER DOS VERSION 3.1
Contents


Announcement Letter Number 284-284 dated August 14, 1984
US - Last Revised on August 14, 1984



Brief Description of Announcement, Charges, and Availability

     IBM Personal Computer Disk Operating System (DOS) Version 3.1
operates with all members of the IBM Personal Computer family and is
required for the IBM PC Network.


Customer Letter Section

HIGHLIGHTS
*   Replaces DOS 3.0 (does not replace DOS 2.1).
*   Supports all members of the IBM Personal Computer family.
*   Supports one or more diskette drives or fixed disks.
*   Provides fixed disk and diskette initialization.
*   Allows DOS to be started from diskette or fixed disk.
*   Provides file space allocated dynamically as data is added.
*   Provides backup and restore commands to support fixed disk.
*   Provides tree-structured directories.
*   Provides command to display the directory structure.
*   Provides commands to create and remove subdirectories.
*   Supports sequential and direct access of data files.
*   Provides a file recovery utility.
*   Provides current date and time used in directory entries.
*   Supports 'job stream' sequence of programs as batch files.
    Conditional logic supported.
*   Allows automatic execution of program or job stream following
    power-on or system reset.
*   Provides graphics screen dump to printer (graphics and color).
*   Provides global filename characters for filename searches.
*   Provides multiple disk I/O memory buffers for improved
    performance.
*   Accepts commands entered in upper or lower case.
*   Allows copying of DOS to formatted backup diskettes or to fixed
    disks.
*   Provides line editor, debug, disk format, disk check, diskette
    copy, diskette compare programs.
*   Provides large linker for language compilers.
*   Allows user-installable device drivers to be added for new
    hardware support.
*   Provides optional Verify after Write.
*   Provides extended screen and keyboard controls.
*   Provides redirected I/O (Example: keyboard input and direct
    output to a file).
*   Supports piping: Output from Program 'A' used as input to Program
    'B.'
*   Allows diverted parallel printer output to Asynchronous
    Communications Adapter (Example: attach a serial printer.)
*   Provides background file print utility that permits simultaneous
    file printing with other activity.
*   Provides extended device error trapping.
DESCRIPTION
The IBM Personal Computer Disk Operating System (DOS) Version 3.1
provides all of the functions contained in DOS 3.0 plus enhancements
for support of IBM PC Network hardware and software while requiring
the same amount of memory.
       DOS provides the required support for an application program
to interface with the IBM Personal Computer hardware. It operates on
all versions of the IBM Personal Computer. DOS provides a user with
the ability to manage files on a disk or diskette (e.g., display
directories, rename files, copy files). DOS also provides the ability
to start an application consisting of one or more programs linked
together into a single load module.
       DOS provides an input/output interface for programs written
for the BASIC Interpreter or any high-level compiler language
supported by DOS on the IBM Personal Computer family.  In addition,
DOS 3.1 provides the ability to display a diskette directory and
rename, erase, display, compare, or copy files. DOS also permits
'chaining' a series of programs in a predefined job stream. A job
stream or a single program may be designated for automatic execution
when the system is turned on. DOS provides line editor and debug
utility programs to aid in program development. A linker program is
provided to convert language compiler relocatable modules to
executable load modules. DOS 3.1 provides the ability to configure
itself to support national keyboards.
       An enhanced screen dump utility program is also provided.
       A virtual disk feature is provided to allow the use of part of
memory for virtual disk. This feature also supports extended memory
(above 1 megabyte) on the IBM Personal Computer AT for virtual disk.
PUBLICATIONS
DOS 3.1 is described in the following items which are part of the DOS
3.1 package:
*   IBM Personal Computer Disk Operating System User's Guide (Level
    3.1)
*   IBM Personal Computer Disk Operating System Reference (Level 3.1)
*   IBM Personal Computer Disk Operating System Application Setup
    Guide.
       A separately available DOS Technical Reference Manual intended
for application programmers contains detailed technical information
concerning DOS. This manual must be purchased separately (Part Number
6024181).
SCHEDULE
The planned availability date is the first quarter of 1985.
TECHNICAL INFORMATION
SPECIFIED OPERATING ENVIRONMENT
COMPATIBILITY
       DOS 3.0
       DOS 3.1 replaces DOS 3.0. It provides IBM PC Network
enhancements as indicated below. Memory requirements are the same as
DOS 3.0 (36Kb).
REDIRECTOR: Provides the means by which a user can access printer and
DASD devices located on other computers on the IBM PC Network.
SUPPORT FOR REDIRECTOR: Allows use of the IBM PC Network Program.
This package is available separately from DOS and requires the IBM PC
Network hardware.
NEW INTERRUPT 21H FUNCTIONS: Additional function calls providing
support for the IBM PC Network environment.
EXTENDED ERROR RECOVERY: Additional error reporting facilities to
enhance support in the IBM PC Network environment.
JOIN: Splicing of directories.
SUBST: Substitute string (a virtual drive name for a path name)
DOS 2.1
       DOS 3.1 is an upward-compatible enhancement to DOS 2.1. DOS
3.1 requires a minimum 36Kb of user memory (DOS 2.1 requires 24Kb).
DOS 3.1 adds the following enhancements:
REDIRECTOR: Provides the means by which a user can access printer and
DASD devices located on other computers on the IBM PC Network.
FILE SHARING: Optional. Applies on a file basis.  Provides full range
of sharing possibilities.
BLOCK LOCKING: Provides the ability to restrict access to all or part
of a file when the file is opened in a shared mode.
SUPPORT FOR REDIRECTOR: Allows addition of the IBM PC Network
Program.  This package is available separately from DOS and requires
the IBM PC Network hardware.
BACKGROUND PRINT: Modified version of DOS 2.1 Print, which now
supports path specifications and an internal programming interface.
NEW INTERRUPT 21H FUNCTIONS: Additional function calls provide
enhanced file management and support for the IBM PC Network
environment.
ENHANCED ERROR RECOVERY: Additional error reporting facilities to
enhance support.
SUPPORT FOR IBM PERSONAL COMPUTER AT HARDWARE: 1.2MB diskette drives,
non-volatile timer, larger fixed disk.
BASIC INTERPRETER: Changes support IBM Personal Computer AT hardware.
Additional access provided to device drivers and DOS from BASIC. See
BASIC Manual Version 3 for description of changes.
SCREEN DUMP UTILITY: Support added for additional display interfaces
and printers.
VDISK: RAM disk.  Allows use of part of storage for a virtual disk.
Supports extended memory (above 1MB) on IBM Personal Computer AT for
virtual disk.
LARGE LINKER: Supports up to 1 megabyte.
SUBST: Substitute string
JOIN: Splicing of directories.
DOS 1.1
       DOS Version 3.1 offers function not available in DOS 1.1.
Where standard (documented) programming procedures have been
employed, most DOS 1.1 programs should run under Version 3.1 without
change.  Access of absolute memory locations where DOS resides and
direct calls to the BIOS are examples of non-standard protocols. DOS
3.1 uses more memory than DOS 1.1. The storage used is 24Kb greater;
therefore, some programs may no longer fit in the same size machine.
In these cases, a program may be divided into small segments, or more
memory may be added to the system unit.
TECHNICAL DATA:
                                        DOS Command
Function                                or Utility
Configuration file (CONFIG.             BREAK=ON/OFF
SYS)                                    BUFFERS=
                                        DEVICE=
                                        FILES=
                                        LASTDRIVE=

                                        FCBS=
                                        COUNTRY=
                                        SHELL=
Assign drive name to
another drive                           ASSIGN
Batch file support                      AUTOEXEC.BAT
Check for ctrl/break interrupt          BREAK
Check diskette or fixed disk            CHKDSK
Clear screen                            CLS
Compare files                           COMP
Copy files                              COPY
Set date                                DATE
Set time                                TIME
Delete files                            DEL, ERASE
List directory                          DIR
Compare diskettes                       DISKCOMP
Copy diskette                           DISKCOPY
Format diskette or fixed disk           FORMAT
Graphics screen dump
MODIFIED                                GRAPHICS
Load graphics table                     GRAFTABL
Set display or printer options          MODE
Remark within batch file, then
wait                                    PAUSE
Set or change file attributes           ATTRIB
File sharing support                    SHARE
Print files in BACKGROUND               PRINT/PSPRINT
Splicing of directories                 JOIN
Change DOS prompt                       PROMPT
Recover file                            RECOVER
Remark from batch file                  REM
Rename a file                           RENAME, REN
Transfer DOS to another
diskette or fixed disk                  SYS
Display file contents                   TYPE
Display DOS version                     VER
Write-verify data to diskette           VERIFY
Display disk(ette) label                VOL
Line Editor                             EDLIN
Load, alter, display/execute
files                                   DEBUG
Link edit a compiled program            LINK
Change directory                        CHDIR
Substitute screen and keyboard          CTTY
Convert .EXE files to .COM
format                                  EXE2BIN
Search for string in file               FIND
Create a subdirectory                   MKDIR
Pause after displaying
full screen                             MORE
Specify directory paths                 PATH
Remove directory                        RMDIR
Set environment                         SET
Sort data                               SORT
Display directory paths                 TREE
Initialize a fixed disk                 FDISK
Backup fixed disk files to
diskette                                BACKUP
Restore files from diskette to
fixed disk                              RESTORE
Virtual RAM disk                        VDISK
LOAD keyboard program                   KEYBXX
Configure country keyboards             SELECT
Changes volume ID                       LABEL
Substitution of drive
name for path                           SUBST
Join directories                        JOIN
The IBM Personal Computer DOS is a prerequisite for the BASIC disk
and advanced versions of BASIC and provides I/O for the IBM Macro
Assembler, IBM Pascal, IBM FORTRAN, IBM COBOL and IBM BASIC
Compilers, and application programs created by them.
       DOS 3.0 Upgrade (6024212)
       Users of IBM Personal Computer Disk Operating System Version
3.0 will be offered an upgrade to Version 3.1 for a nine-month period
beginning with the availability of DOS 3.1. The upgrade includes the
same manuals and diskettes as Version 3.1.
       DOS 3.0 includes an information sheet with details of the IBM
Personal Computer Disk Operating System Version 3.0 upgrade.
Procedures for the upgrade are as follows:
*   The customer should submit the IBM Personal Computer Disk
    Operating System Version 3.1 (DOS 3.1) product order form, DOS
    Version 3.0 proof of upgrade qualification (front cover page of
    the IBM Personal Computer Disk Operating system Version 3.0 (DOS
    3.0)), along with appropriate payment, to:
        IBM Corporation
        P.O. Box 3160
        Wallingford, CT 06494
*   The IBM Update Service will process the order and return DOS 3.1
    to the appropriate address.
*   Payment for the upgrade product is to be by check or money order
    payable to the IBM Corporation. Applicable state and local taxes
    are to be paid by the licensee.
*   The IBM update service will mail the DOS Version 3.1 product to
    the addressee.
*   Orders for the upgrade will expire nine months after the DOS 3.1
    availability date.
*   The one-time charge for this upgrade is $30.00
SECURITY, AUDITABILITY, AND CONTROL This product can be used and
managed to limit the risk of unintended modification, destruction, or
disclosure of sensitive data. The customer is responsible for the
selection, implementation, and adequacy of appropriate measures. The
customer is also responsible for the accuracy and integrity of
results.
User management is responsible for evaluation, selection, and
implementation of security features, for administrative procedures,
and for appropriate controls in application systems.
PLANNING INFORMATION
CUSTOMER RESPONSIBILITY: The customer is responsible for producing a
backup copy of the original DOS diskette, and creating a copy of DOS
on applications diskettes or fixed disks as described in the DOS
User's Guide.  All newly purchased diskettes must first be
initialized using the DOS FORMAT utility. Fixed disks must be
initialized with both the FDISK and FORMAT utilities.
INSTALLABILITY: The IBM Personal Computer DOS 3.1 resides on the DOS
diskette. A second diskette contains the linker, debug, EXE2BIN,
sample device driver listings, and the sample programs.  If the DOS
diskette is present in diskette drive 'A' or if DOS is resident on
the fixed disk, DOS will automatically be loaded in memory when the
system is started or restarted. DOS can also be copied to a formatted
diskette or the fixed disk to provide the same function.
If automatic program execution is not used each time DOS is
initialized, the user will be asked for the current date and time (on
IBM Personal Computer AT, the current time will be displayed).  This
information will be used to identify the most recent update to a
file. If the AUTOEXEC option is used and 'unattended' operation is
desired, date and time prompting can be bypassed.
LIMITATIONS: DOS Version 3.1 uses approximately 36Kb of memory.  This
is an increase over DOS 2.1 and DOS Version 1.1. On some systems,
this means that additional memory may be required to permit an
application program to be loaded and run. In general, 96Kb to 128Kb
is a minimum memory requirement for DOS 3.1 systems.
       Prior to running a BASIC language program performing diskette
I/O, one of the two language extensions, Disk BASIC or Advanced
BASIC, must be loaded into memory.
PREREQUISITES: On IBM PCjr - 128Kb of memory; one dual-sided diskette
drive; IBM PCjr Color Display; IBM PCjr connector for TV with a color
or black and white television; or IBM PCjr adapter cable for IBM
Color Display, or equivalent.
       On IBM Personal Computer - 96Kb of memory; dual-sided diskette
drive; IBM Color Display or equivalent with the IBM Color/Graphics
Monitor Adapter, or a color or black and white television with an RF
modulator with the IBM Color/Graphics Monitor Adapter, or IBM
Monochrome Display with the IBM Monochrome Display and Printer
Adapter.
       On IBM Portable Personal Computer - 256Kb of memory; one
dual-sided diskette drive.
       On IBM Personal Computer XT - 128Kb of memory; one
single-sided or dual-sided diskette drive; IBM Color Display or
equivalent with the IBM Color/Graphics Monitor Adapter, or a color or
black and white television with an RF modulator with the IBM
Color/Graphics Monitor Adapter, or IBM Monochrome Display with the
IBM Monochrome Display and Printer Adapter.
       On IBM Personal Computer AT - 256Kb of memory; one 1.2Mb

diskette drive; IBM Color Display or equivalent with the IBM
Color/Graphics Monitor Adapter, or a color or black and white
television with an RF modulator with the IBM Color/Graphics Monitor
Adapter, or IBM Monochrome Display with the IBM Monochrome Display
and Printer Adapter.
TECHNICAL ASSISTANCE
The IBM Personal Computing Assistance Center (PCAC) will provide
assistance to eligible IBM customers for the period of their
qualifying contract.
ORDERING INFORMATION
Orders for any quantity may be taken by NAD/NMD marketing
representatives. Orders for quantities less than 20 may be taken by
the IBM Product Centers.  Each Product Center will accept and process
orders within its trading area.
CHARGES, TERMS, AND CONDITIONS
CHARGES
                          Part       Feature    One-Time
Description               Number     Number     Charge
IBM Personal Computer     6024211    4211       $65.00
Disk Operating
System (DOS)
Version 3.1
TERMS AND CONDITIONS
WARRANTED: Program Warranty - No. The provisions of the IBM Program
License Agreement apply.
THE IBM PROGRAM LICENSE AGREEMENT: A copy is packaged and shipped
with the program and is visible to the customer before the diskette
package is opened. The customer is advised that opening the diskette
package indicates acceptance of these terms and conditions. No
signature is required.
QUANTITY DISCOUNT AGREEMENT (QDA): This program is available for
discounts as a qualified eligible licensed program according to the
terms and conditions of the IBM Personal Computer Licensed Program,
Quantity Discount Agreement (Z125-3412), and exhibit (Z125-3413).
Quantity of Qualified
Eligible Licenses             Discount
20 - 49                       12%
50 - 149                      16%
150 or more                   20%
The QDA is not available at IBM Product Centers. However, customers
may qualify for a quantity discount at the Product Center if they
take delivery of the entire order at one time, as follows:
Single-Delivery
Quantity                      Discount
3 - 9                         5%
10 - 19                       8%
TESTING PERIOD: None
EDUCATIONAL ALLOWANCE: Educational allowance of 20% is available to
qualifying institutions. The educational allowance may not be added
to any other discount or allowance.

Contact IBM

Feedback