6.0;edmtdesc (edit_magtape_descriptor), revision 6.0, 83/02/21
EDMTDESC (EDIT_MAGTAPE_DESCRIPTOR) -- Create, list, and modify magnetic tape
                                      descriptor objects.
usage:  EDMTDESC  pathname  {-C | -L [var...] | -S {var value...}... }   {CL}


FORMAT

  EDMTDESC  pathname  {options}


  EDMTDESC allows you to create, list, and modify magnetic tape descriptor
  objects.  These descriptor files provide information to the streams manager
  so that it can handle subsequent tape operations much as an SIO descriptor
  file describes the configuration of an SIO line.


ARGUMENTS

  pathname
  (required)        Specify name of magtape descriptor file to be created,
                    listed, or edited.


OPTIONS

  At least one of the following options must be specified.

  -C                Create a new magtape descriptor object with the name given
                    in the 'pathname' argument.

  -L [var...]       List the values of the variable(s) specified.  If no
                    variables are named, the entire magtape descriptor is
                    listed.

  -S {var value}... Set the variable(s) indicated to the specified value(s).
                    At least one variable/value pair is required if -S is
                    specified.  Multiple variable/value pairs are permitted,
                    separated by blanks.

  EDMTDESC uses the command line parser, and so also accepts the standard
  command options listed in HELP CL.


VARIABLES

  The variables known to EDMTDESC are listed below, along with their types and
  default values.  The variable types are:  integer (int), Boolean (y/n),
  character string of n letters (c [n]), and date (in format yy/mm/dd.hh:mm).

  name    type   default  definition

  U       int     0       magtape unit number (normally 0)
  LAB     y/n     yes     'yes' if magtape is ANSI labeled, 'no' if
                           unlabeled
  REO     y/n     no      'yes' to reopen previously used volume, 'no'
                           to open new volume ('yes' suppresses rewind)
  CLV     y/n     yes     'yes' closes volume when file is closed,
                           'no' leaves volume open
  SPOS    y/n     no      'yes' saves volume position when volume is
                           closed (for reopen), 'no' rewinds volume
                           when closed
  VID     c[6]    -auto   volume identifier (labeled volumes)
  VACC    c[1]            volume accessibility (labeled volumes)
  OWN     c[14]   -auto   volume owner (labeled volumes)
  F       int*    1       file sequence number -- integer or "cur" for
                           current file, or "end" for new file at end
                           of labeled volume
  RF      c[1]    D       record format -- "F" for fixed length, "D"
                           for variable length, "S" for spanned,
                           "U" for undefined
  BL      int     2048    block length, in bytes
  RL      int     2048    (maximum) record length, in bytes
  ASCNL   y/n     yes     'yes' for ascii newline handling (strip
                           newlines on write, supply them on read),
                           'no' for no newline handling
  FSECT   int     1       file section number (labeled volumes)
  FID     c[17]           file identifier (labeled volumes)
  FSID    c[6]            file set identifier (labeled volumes)
  GEN     int     1       generation of file (labeled volumes)
  GENV    int     1       generation version of file (labeled volumes)
  CDATE   date    -auto   creation date of file (labeled volumes)
  EDATE   date    -auto   expiration date of file (labeled volumes)
  FACC    c[1]            file accessibility (labeled volumes)
  SYSC    c[xx]           system code (labeled volumes)
  SYSU    c[xx]           system use (labeled volumes)
  BOFF    int     0       buffer offset (labeled volumes, should be 0)


EXAMPLE

  $ edmtdesc set_tape -s u 1 lab yes        Edit file "set_tape";
                                             set the tape unit number
                                             to 1; declare tape as
                                             ANSI labeled.

RELATED TOPICS

  More information is available.  Type:

    - HELP MAGTAPE
      for general information on magnetic tape usage.