DSPSAVTAP -- Display Save Tape

DSPSAVTAP DISPLAY SAVE TAPE TAASAVM
The Display Save Tape command is a simple front end to the DSPTAP command. It defaults to display SAVRST labels and device TAP01. This avoids a typical error where the DATATYPE parameter is defaulted on DSPTAP and the error is not discovered until after the tape label is displayed. A typical command would be entered as: DSPSAVTAP This would display the first label in save/restore format on the TAP01 device. You can also display a single library (label) from TAP01 by specifying: DSPSAVTAP LABEL(xxxx) On most tape devices this will correctly position the tape to the label and then cause the DSPTAP command to be run from that position. However, 1/4 inch cartridge devices do not provide for back space and cannot provide an efficient solution. The correct label is displayed, but the tape must be processed twice. Command parameters CMD ------------------ DEV The device name. The default is TAP01. LABEL The label (library) to be displayed. The default is ALL. VOL The tape volume to be displayed. MOUNTED is the default to mean the volume that is currently on the device. A specific volume ID may be entered. If the device specified is a media library device, then the volume specified should be the cartridge identifier to be mounted and used. SEQNBR The sequence number to be displayed. In general, you would do the following: 1) To display all or the first file, take the defaults for both LABEL and SEQNBR. 2) To display a specific label (library), specify LABEL(xxx) and take the default for SEQNBR. 3) To display a specific sequence number, take the default for LABEL and specify the sequence number. The default for SEQNBR is DFT which means that the LABEL parameter is evaluated. If LABEL(ALL) is specified, the default acts as SEQNBR(1). If LABEL(xxx) is specified, the default acts as SEQNBR(SEARCH). A number value (such as 2) means to display the file at the specified sequence number. SEARCH may be specified in conjunction with a label name to cause the tape to be read until the label is found. On most tape devices, SEARCH is an efficient technique. However, 1/4 inch cartridge devices do not provide for 'back space' and cannot provide an efficient solution. The correct label is displayed, but the tape must be processed twice. If both a label and a sequence number are specified, the label must exist at the file sequence number or an error will occur. DATATYPE The data type of the label. The default is SAVRST. LABELS may also be specified. OUTPUT The type of output. This is the normal output parameter with a default of . PRINT may be specified. Restrictions ------------ None. Prerequisites ------------- The following TAA Tools must be on your system: SNDCOMPMSG Send completion message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- DSPSAVTAP CMD TAASAVM QATTCMD TAASAVMC *PGM CLP TAASAVMC QATTCL

DSPSAVTAP       DISPLAY SAVE TAPE                      TAASAVM


The Display  Save Tape  command is  a simple  front end  to the  DSPTAP
command.   It  defaults  to display  *SAVRST labels  and  device TAP01.
This  avoids a typical error where  the DATATYPE parameter is defaulted
on DSPTAP and the  error is not discovered  until after the tape  label
is displayed.

A typical command would be entered as:

           DSPSAVTAP

This  would display  the  first  label in  save/restore  format on  the
TAP01 device.

You   can  also  display  a  single   library  (label)  from  TAP01  by
specifying:

           DSPSAVTAP        LABEL(xxxx)

On most  tape devices  this will  correctly position  the  tape to  the
label and then cause  the DSPTAP command to be  run from that position.

However, 1/4  inch cartridge devices do not  provide for back space and
cannot  provide  an   efficient  solution.     The  correct  label   is
displayed, but the tape must be processed twice.

Command parameters                                    *CMD
------------------

   DEV           The device name.  The default is TAP01.

   LABEL         The label (library)  to be displayed.  The  default is
                 *ALL.

   VOL           The  tape volume  to be  displayed.   *MOUNTED  is the
                 default  to mean the  volume that is  currently on the
                 device.

                 A specific volume ID may be entered.

                 If the  device specified  is a  media library  device,
                 then  the volume  specified  should  be the  cartridge
                 identifier to be mounted and used.

   SEQNBR        The  sequence  number to  be displayed.    In general,
                 you would do the following:

                 1)  To  display  all  or  the  first  file,  take  the
                 defaults for both LABEL and SEQNBR.

                 2)  To display  a  specific  label (library),  specify
                 LABEL(xxx) and take the default for SEQNBR.

                 3)  To display  a specific  sequence number,  take the
                 default for LABEL and specify the sequence number.

                 The default for  SEQNBR is *DFT  which means that  the
                 LABEL  parameter  is evaluated.    If  LABEL(*ALL)  is
                 specified,  the   default  acts  as   SEQNBR(1).    If
                 LABEL(xxx)   is   specified,  the   default   acts  as
                 SEQNBR(*SEARCH).

                 A number value (such  as 2) means to display  the file
                 at the specified sequence number.

                 *SEARCH may  be specified in conjunction  with a label
                 name  to cause the tape to be  read until the label is
                 found.

                 On  most  tape  devices,   *SEARCH  is  an   efficient
                 technique.   However,  1/4 inch  cartridge devices  do
                 not  provide for  'back space'  and cannot  provide an
                 efficient solution.  The  correct label is  displayed,
                 but the tape must be processed twice.

                 If both a  label and a sequence number  are specified,
                 the label  must exist at  the file sequence  number or
                 an error will occur.

   DATATYPE      The  data type of the label.   The default is *SAVRST.
                 *LABELS may also be specified.

   OUTPUT        The  type  of output.    This  is  the  normal  output
                 parameter  with  a  default  of  *.    *PRINT  may  be
                 specified.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

         SNDCOMPMSG     Send completion message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DSPSAVTAP     *CMD                   TAASAVM       QATTCMD
   TAASAVMC      *PGM       CLP         TAASAVMC      QATTCL

Added to TAA Productivity tools April 1, 1995

Home Page

Up to Top