HE     * * *  INDEX  * * *
                         INTRODUCTION


    Th� followin� manua� describe� th� us� an� functio� o� th�
CP/͠ - IB͠ dis� utility��  I� i� designe� t� allo� th� use� t�
easily transfer data between CP/M and IBM disk formats.








CP/� i� � registere� trademar� o� Digita� Research� Garde� Grove�
CA��  IB͠ i� � registere� trademar� o� Internationa� Busines�
Machines, Poughkeepsie, NY.

pa �.he TABLE OF CONTENTS
INTRODUCTION ................................................   1
INITIALIZE AN IBM DISKETTE ..................................   2
CHANGE AN IBM VOLUME SERIAL NUMBER ..........................   3
CHANGE AN IBM DATASET'S DIRECTORY ENTRY .....................   4
DELETE AN IBM DATASET'S DIRECTORY ENTRY .....................   5
LIST AN IBM DATASET'S DIRECTORY .............................   6
TRANSFER CP/M TO IBM DATASET (BLOCK FORMAT) .................   7
TRANSFER IBM TO CP/M DATASET (BLOCK FORMAT) .................   8
TRANSFER CP/M TO IBM DATASET (SOURCE FORMAT) ................   9
TRANSFER IBM TO CP/M DATASET (SOURCE FORMAT) ................  10
DISPLAY AN IBM DATASET ......................................  11
HARDWARE/SOFTWARE REQUIREMENTS ..............................  12
MAINTENANCE POLICIES ........................................  13
PROGRAM ERROR REPORT ........................................  14
PA �.HE INTRODUCTION
                         Introduction

    Thi� progra� wa� develope� s� tha� developemen� coul� b� �
performe� o� � smal� compute� utilizin� CP/� fo� larg� IB� site�  �
Th� dat� o� program� wer� code� usin� th� smal� computer�� an� �
the� transfere� t� th� IB� compute� utilizin� thi� program�  �
Also�� certai� dat� wer� transferre� bac� t� th� smal� compute� �
fo� updatin� an� agai� transferre� bac� t� th� IB͠ computer�  �
Thus�� th� tim� involve� fo� codin� an� keypunchin� wer� absorbe� �
o� th� smal� machine��  All transfers were performed by diskette.
    Thi� manua� assume� tha� th� reade� ha� � workin� knowledg� �
o� bot� CP/� an� IB� operatin� systems��  I� particular� th� use� �
shoul� full� understan� th� basi� dis� layou� fo� IB͠ Standar� �
Interchang� Format��  Thi� progra� assume� th� SI� throughou� an� �
wa� writte� t� b� compatibl� wit� onl� it��  NO� othe� IB� forma� �
i� utilized��  Fo� furthe� informatio� concernin� thi� format� �
pleas� revie� manua� GA21-9182� IB� Genera� Informatio� Manua� o� �
Diskettes.
    Th� progra� wa� designe� t� b� men� drive� wit� prompting�  �
Currently�� eac� respons� i� verified�� an� i� incorrect�� re-�
prompted��  I� yo� mak� � mistak� whic� i� � vali� reply� re-boo� �
CP/� an� restar� th� program��  A� thi� time�� n� backu� facilit� �
i� offere� s� b� carefu� a� t� you� responses.
    Whe� workin� wit� CP/� files�� th� fil� name� ar� assume� t� �
b� a� 1-� byt� nam� wit� � typ� o� '.DAT'��  Th� 1-� byt� nam� �
mus� correspon� wit� � fil� nam� o� th� IB� diskette.
pa �.HE INITIALIZE AN IBM DISKETTE
                  Initialize an IBM Diskette

    T� initializ� � diskett� i� IB͠ SIƠ format�� us� thi� �
command�  Plac� th� diskett� t� b� initialize� i� th� appropriat� �
drive��  Selec� thi� functio� (1)��  Repl� wit� th� driv� (A-D)�  �
The� repl� wit� th� ne� 6-byt� volum� seria� number�  Th� progra� �
wil� the� forma� th� diskett� t� IB� specifications��  Thi� ma� �
tak� � fe� minute� s� don'� b� alarme� i� i� doesn'� repl�� t� �
yo� immediately��  Afte� initialization� th� diskett� i� read� t� �
use as an IBM diskette.
PA �.HE CHANGE AN IBM VOLUME SERIAL NUMBER
              Change an IBM Volume Serial Number

    Thi� functio� allow� th� use� t� simpl�� chang� a� IB� �
diskette'� volum� seria� number�  Us� functio� cod� (2� t� invok� �
it�  Repl� wit� th� dis� driv� (A-D� tha� th� diskett� i� on� an� �
the� repl� wit� th� ne� volum� seria� number� 1-� characters�  N� �
checkin� i� don� o� th� res� o� th� diskette��  Onl� th� volum� �
serial number is changed.
PA �.HE CHANGE AN IBM DATASET'S DIRECTORY ENTRY
            Change an IBM Dataset's Directory Entry

    Thi� functio� allow� yo� t� chang� th� director� entr�� fo� �
a� IB� file��  Yo� wil� us� thi� entr� t� creat� � file�� renam�
i� o� adjus� it� parameters��  T� invok� thi� function�� us� cod�
(3)��  Repl�� wit� th� dis� driv� containin� th� IB͠ diskette�
The� repl� wit� th� director� secto� t� b� changed�  Yo� ca� fin�
th� secto� numbe� b� usin� functio� (6)�� Lis� Directory��  Th�
progra� wil� the� displa� al� th� field� i� th� entr� an� reques�
tha� yo� entr� � ne� value��  Ente� ONLY� th� field� tha� yo� wan�
t� change��  Whe� th� las� fiel� ha� bee� entered�� th� director�
wil� automaticall� b� updated�� an� � completio� messag� wil� b�
posted to the terminal.  You will then return to the main menu.
PA �.HE DELETE AN IBM DATASET'S DIRECTORY ENTRY
Delete an IBM Dataset's Directory Entry

    T� delet� � datase� fro� a� IB� diskette� plac� th� diskett� �
i� � drive�� invok� functio� cod� (4)� ente� th� dis� driv� (A-D� �
o� whic� th� diskett� resides� an� ente� th� secto� numbe� o� th� �
director�� entry��  I� yo� ar� i� doub� a� t� th� secto� number� �
us� functio� cod� (6)�� Lis� Directory�� t� fin� ou� wha� i� is�  �
Whe� th� entr� ha� bee� delete� an� � completio� messag� ha� bee� �
posted, control will return to the main menu.
PA �.HE LIST AN IBM DIRECTORY
PA �.HE TRANSFER A CP/M FILE TO IBM FORMAT (BLOCK)
PA �.HE TRANSFER AN IBM FILE TO CP/M FORMAT (BLOCK)
PA �.HE TRANSFER A CP/M FILE TO IBM FORMAT (SOURCE)
PA �.HE TRANSFER AN IBM FILE TO CP/M FORMAT (SOURCE)
PA �.HE MAINTENANCE POLICIES
                     Maintenance Policies

    I� th� even� o� � problem�� contac� Rober� M� Whit� a� (208� �
377-0336��  H� i� responsibl� fo� answerin� question� relatin� t� �
installation�� operatio� an� maintenance��  I� th� proble� i� �
determine� t� b� � par� o� thi� package�� pleas� obtai� � printe� �
dum� befor� callin� fo� support��  ALL� use� modification� mus� b� �
remove� befor� obtainin� an� erro� analysi� an� correctio� fro� �
Rober� M�� White�  I� th� proble� persist� afte� initia� contact� �
pleas� complet� th� Progra� Erro� Repor� supplie� a� � par� o� �
thi� manua� an� sen� i� alon� wit� al� supportin� documentatio� �
to:
                   Robert M. White
                   8530 Stonehaven
                   Boise, ID  83704

    Rober� M�� Whit� wil� provid� custo� modification� t� user� �
wh� reques� them��  Thes� modification� ma� requir� a� additiona� �
charg� an� ma� no� b� quarantee� t� functio� correctl�� i� al� �
futur� releases��  Al� agreement� mus� b� i� writing��  Estimate� �
wil� b� issue� pertainin� t� th� wor� involve� i� performin� th� �
modifications.
PA �.HE Program Error Report
Date: _______� Title:___________________________________________

Submittor:______________________________________________________

Address:  ______________________________________________________

         ______________________________________________________

         ______________________________________________________

Phone:    (   ) ___-____ ext. ____

Error Description:










Environment:
    Computer Type: ________________________________________

    Core Size:     _____k

    No. and type of disks: ________________________________

    Console type:  ________________________________________

    CP/M release:  ________________________________________
PA �