{
{ CML$TAPE_SUBSYSTEM_USAGE_DATA
{
{
{   PURPOSE:
{      The purpose of this statistic is to record the amount of
{ work performed by a tape storage device for a particular job. The
{ information is used by maintenance personnel to measure the
{ failure rate per amount of service performed.  The evsn/rvsn
{ of the tape medium is included in this statistic to aid in the
{ isolation of failure.  It is difficult to diagnose whether a tape
{ reel or a tape device is at fault.  If the evsn/rvsn can be
{ implicated in failures on other tape devices, then the
{ installation can discontinue use of the tape reel. An installation
{ may also use this statistic to track the "wear and tear" of a tape
{ reel.
{
{ FREQUENCY:
{    This statistic is emitted each time a tape reel which had been
{ assigned to a job is dismounted by the system.  If no i/o was
{ performed to the tape reel, this statistic is still emitted to
{ record the fact that the tape had been mounted.
{    This statistic is emitted once for each detach of a tape
{ storage device used by the job. This permits the collection of
{ usage data for tape transports/devices.
{
{ CONTENT:
{    The  descriptive-data portion of this statistic contains:
{
{    '<mf>.<iou>.<pp>.<channel>.<element>.<unit>,<evsn>,<rvsn>,<file>
{
{      where <mf> is the identification of the mainframe in the form
{        $SYSTEM_mmmm_ssss.  Where 'mmmm' is the model number of
{        Central Processor zero (CP0), e.g. 0990, and 'ssss' is the
{        serial number of that processor, e.g. 0104.
{
{      where  <iou>  is  the  string  'IOUn' where n is 0 or 1.
{        This identifies the IOU associated with the channel over
{        which the usage occurred.
{
{      where <pp> is the string 'PPn' where n is the decimal
{        representation of the logical PP number used to access the
{        tape subsystem.
{
{      where <channel> is the string 'CHn' where n is the channel
{      number (in decimal) through which the tape device was
{      accessed.
{
{      where <element> is the element name of either a 7021_3x
{        controller, a 7221_1 adapter or a 698_xx CCC whose work
{        is being reported.
{
{      where  <unit> is the element name of the tape storage device
{        whose work is being reported.
{
{      where <evsn> is the external-vsn of the tape volume which was
{        the object of the work performed.
{
{      where <rvsn> is the recorded-vsn of the tape volume which was
{        the object of the work performed.
{
{      where <file> is the the last name (identifier) in the file path.
{
{
{    The  counter-value portion of this statistic contains:
{
{    1.  Tape unit density selection in effect during the last read
{        or write operation on the tape medium.
{           1 - NRZI ( 800 CPI)
{           2 - PE   (1600 CPI)
{           3 - GCR  (6250 CPI)
{           4 - Cartridge Tape (38000 CPI)
{    2.  Total number of tape blocks written to the tape medium by
{        the job using this physical path.  This count includes
{        blocks which were written during failure recovery.
{    3.  Total number of tape blocks read from the tape medium by
{        the job using this physical path.  This count includes
{        blocks which were read during failure recovery and any
{        forespaces/backspaces executed on the unit. This counter
{        indicates total read type usage.
{    4.  Total number of i/o requests made by the job for this
{        path to the tape storage device. The i/o requests are for
{        any request sent to the PP (motion functions, write, read, etc.).
{    5.  Blocks skipped is the total number of forespaces/backspaces
{        (does not include recovery) that were executed from the time
{        the tape was assigned until the tape was unloaded. The subsystem
{        uses forspaces/backspaces to search for a tapemark instead of
{        using the hardware function.
{    6.  Blocks written for accounting (does not include recovery).
{        A tapemark written is counted as 1 block.
{    7.  Blocks read for accounting (does not include recovery).
{        A tapemark read is counted as 1 block. This count does not
{        include any forespace/backspace operation as they are included
{        with the skip count in counter 5 above.
{    8.  Number of bytes written (does not include recovery).
{    9.  Number of bytes read. (does not include recovery or any forespace,
{        backspace operations as they are included with the skip count).
{        The byte counts for both write/read are derived using the max block
{        size for each instance of open.  Each close causes the bytes counts
{        to be incremented by a value derived from the block count for that
{        instance of open times the max block size for that instance of open.
{   10.  Number of wallclock seconds that the tape was mounted.


  CONST
    cml$tape_subsystem_usage_data = cmc$min_ecc +5000;

*copyc cmc$condition_limits
