>'UTIL11
>N1
>f
 
 
                              pmap - utility
                                   - # -
>X
pmap
====
 
 
tHE pmap uTILITY IS A COMPREHENSIVE dISK/fILE mAPPING uTILITY.  iT ALLOWS THE USER TO EASILY LOCATE FILES SECTORS, AND DETERMINE THE STATUS OF ALL GRANULES ON A DISK.  aLL ldos SUPPORTED DISK DEVICES MAY BE OPERATED ON, INCLUDING sINGLE/dOUBLE dENSITY, sINGLE/dOUBLE sIDED, 5" AND 8" FLOPPIES AND FIXED/REMOVABLE DISK SYSTEMS.  tHE SYNTAX OF THE pmap COMMAND IS:
 
          =====================================================
          !  pmap,*,:A                                        !
          !  pmap,*,FILESPEC                                  !
          !                                                   !
          !           *  = SEND OUTPUT TO PRINTER             !
          !           :A = MAP THIS DRIVE                     !
          !           FILESPEC = ANY VALID FILESPEC           !
          !                                                   !
          !  ABBR: none                                       !
          =====================================================
 
     mAPPING A DRIVE:
 
tHE gat TABLE OF THE SPECIFIED DISKETTE WILL BE READ INTO MEMORY.  eACH CYLINDER WILL BE MAPPED GRANULE BY GRANULE.  tHE DISPLAY WILL SHOW THE CYLINDER NUMBER, AND A LIST OF ALL THE GRANULES ON A SECTOR BASIS.  aN EXAMPLE OF A SINGLE DENSITY, SINGLE SIDED DISK COULD BE:
cYLINDER  00: 00-04XX  05-09XX
tHE FIRST X POSITION WILL INDICATE THE STATUS OF THE aLLOCATION bIT ASSOCIATED WITH GRAN, AND THE SECTORS 00-04 INDICATE THE RANGE OF SECTORS IN THE FIRST GRAN.  tHIS POSITION WILL DISPLAY A GRAPHIC BLOCK IF THE CORRESPONDING GRANULE IS ASSIGNED, AND A PERIOD IF THE GRANULE IS CURRENTLY AVAILABLE.  tHE SECOND X POSITION INDICATES THE STATUS OF THE CORRESPONDING lOCKOUT bIT FOR THE GRAN.  tHIS POSITION WILL DISPLAY AN x IF THE CORRESPONDING GRANULE IS LOCKED-OUT, OR A SPACE IF IT IS AVAILABLE.  aLL GRANULES INDICATING LOCKED-OUT STATUS SHOULD ALSO HAVE THE CORRESPONDING ALLOCATION BIT SET.
note:  rIGID DRIVES DO NOT HAVE A LOCKOUT TABLE, SO THAT INFORMATION WILL NOT GIVEN.
 
     tHE DISPLAY WILL PAUSE EACH SCREENFUL AND WAIT FOR YOU TO PRESS A KEY TO CONTINUE.  pRESS break TO ABORT AT ANY TIME, OR shift @ TO PAUSE THE DISPLAY MANUALLY.  tHIS PROCEDURE WILL CONTINUE TILL ALL CYLINDERS HAVE BEEN DISPLAYED.
 
     mAPPING A fILE:
 
tHE ASSOCIATED DIRECTORY RECORD FOR THE GIVEN FILE WILL BE READ INTO MEMORY.  aLL SECTORS ASSIGNED TO THE FILE WILL BE TRACED THROUGH THE DIRECTORY MANUALLY.  tHE CURRENT SECTOR THAT IS BEING OPERATED ON WILL BE DISPLAYED TO THE VIDEO (OR PRINTER IF SPECIFIED).  aN ATTEMPT WILL BE MADE TO READ EACH SECTOR AS IT IS COMPUTED.  iF THE SECTOR WAS READ SUCCESSFULLY, IT WILL BE SURROUNDED BY A THIN LINE (ASCII 95).  iF A READ ERROR WAS ISSUED BY THE SYSTEM, THE CYLINDER AND SECTOR NUMBER WILL BE SURROUNDED BY GRAPHIC BLOCKS.  aT ANY TIME, YOU MAY ABORT BY PRESSING break, OR PAUSE BY PRESSING shift @.  tHIS PROCEDURE WILL CONTINUE UNTIL THE END OF FILE IS REACHED, AND AN EXIT IS MADE BACK TO ldos.

