To create an ASCII file (that may be printed) for a
particular block or group of blocks on a specified device.
HINTS/RESTRICTIONS:
BLKPRT may be run from any account on the system and will
function for any device on the system.
BLKPRT will create the ASCII file in the account you are
currently logged into under the filespec of {block #}.BLK.
FORMAT:
.BLKPRT {device:} block-number1 {block-number2}
The device may be any device that the driver is resident for
and is currently on the system. Multiple digit drive numbers are
permitted.
Block is the number of the block you wish to search for. The
entry may be in either hex or octal depending on the current
SETting. A hex block number must start with a numeric character.
For example block F43 must be entered as 0F43. If the block
number entry does not agree with the current SETting for hex or
octal, the input block number will be incorrect.
DEFAULTS:
If no device is specified, then BLKPRT will default to the
device you are currently logged into.
If no block number is entered on the command line, BLKPRT
will return a specification error.
OPERATION:
1. Type BLKPRT followed by the device and block number(s)
you wish to print.
2. BLKPRT will create an ASCII file with a filespec of the
first block number and an extension of .BLK in the
account you are currently logged into. If the block
number entered is to large for the device BLKPRT will
1
return:
?Block number specified is too large for this
device.
ERRORS:
A. ^specification error:
Your command line was of incorrect format. The ^
points to the location that BLKPRT does not understand.
B. ?Block number too large for this device.
The number you have entered is larger than the
number of blocks on the specified, or default device.
C. ?Block number specified is a negative octal number
The number you have entered equates to a negative
octal number. Check the block and try again.
D. All other error messages are from AMOSL operating system
CHARACTERISTICS:
You can use BLKPRT to create a sequential file so you can
have printed copy of any block on any mounted device.
BLKPRT is both re-entrant and reusable.
BLKPRT is control C (^C) interruptable, if CTRLC is SET on
the user's terminal.
EXAMPLES:
.BLKPRT DSK1:22706
Block print on device: DSK1
Block number to be printed: 22706
Block print has been initiated on Log-device:22706.BLK
Printing output file
.BLKPRT 22706
Block print on device: Log-device
Block number to be printed: 22706
Block print has been initiated on Log-device:22706.BLK
2
Printing output file
BLKPRT.LIT was written by:
Quaker State Oil Refining Corp.
Research Center
Oil City, PA 16301 - April 1984
