** VNF980.TXT ***  CBLVCAT Rel 9.8          L=003 --- 1999/03/29 11:54:36  (P21)

  Sourced from:  h:\cd\VNF980.DOC    L=009 --- 97/04/09 11:43:36 (P22)
                     _____________________________________
                    |                                     |
                    |              COPYRIGHT              |
                    |_____________________________________|

    Copyright in  the whole  and every  part of  this document  and of  the
    CBLVCAT system and programs is owned by Compute (Bridgend) Ltd,   whose
    registered office is located at 22 Merthyr Mawr Road,  Bridgend, Wales,
    UK, CF31 3NR,  and who reserve the right to alter at their  convenience
    the whole  or any  part of  this document,   or the  CBLVCAT system and
    programs.
    No reproduction  of the  whole or  any part  of the  CBLVCAT system and
    programs,  or of  this document,  is  to be made  without prior written
    authority from Compute (Bridgend) Ltd.

Disclaimer
    At the time of publication,   this document is believed to  be correct.
    Where the  program product  differs from  that stated  herein,  Compute
    (Bridgend) Ltd reserve  the right to  revise either the  program or its
    documentation at their discretion.
    CBL do not warrant that upward compatibility will be maintained for any
    use made of this program product  to perform any operation in a  manner
    not documented within the user manual.









***                                                      COMPUTE (Bridgend) Ltd

Telephone: UK +44 (1656) 652222                             8 Merthyr Mawr Road
Fax:       UK +44 (1656) 652227                             BRIDGEND
                                                            Wales      CF31 3NH
            _______________________________________________________
           |                                                       |
           |                                                       |
           |            CBLVCAT  Rel 9.8 - New Features            |
           |                                                       |
           |_______________________________________________________|


Information  in  this  New   Feature  List,   reflecting  differences   between
CBLVCAT Rel 9.7  and  CBLVCAT Rel 9.8,   is  subject  to alteration at the sole
discretion of Compute (Bridgend) Ltd.



                                   Contents

                 Important Changes
                   Expiry Date - June 2001


                 New Facilities
                   Year 2000 Compliance
                   ICF:  CSA Storage above the line
                   All:  VSAM (non ICF) LC - Improved Performance


                 Other Changes
                   Year 2000 related:
                     All:  Standard Catalog Report layout
                     All:  Standard VTOC    Report layout
                     All:  REPORT VCAT and REPORT VTOC fields
                     All:  LISTVCAT  DD=ucat  OPTION DEFINE
                     All:  SUBSET HIDATE=/LODATE=/HIEXP=/LOEXP=
                     VSE:  MOD DEV=cuu DSN=xxx.. EXP=PERM
                     VSE:  MOD DEV=cuu DSN=xxx.. EXP=TEMP

                   Non Year 2000 related:
                     All:  Local TIMESTMP for ICF and VSAM
                     All:  Variable-Length RRDS (VRDS) reporting
                     All:  SUBSET TYPE=V and TYPE=M for VRDS
                     All:  Secondary ICF/VSAM Extents (NSEC)
                     ICF:  LISTVCAT  VVDS=volser  non-VSAM reporting
                     VSE:  LISTVTOC  RECFM  column
                     CBLNAME Fields/Attributes
                     New/Changed messages
                     Zaps Applied






***         _______________________________________________________
           |                                                       |
           |                                                       |
           |           CBLVCAT 9.8    IMPORTANT CHANGES            |
           |                                                       |
           |_______________________________________________________|


Expiry Date - June 2001

    To facilitate user testing for Year 2000 compliance,  CBLVCAT Rel 9.8x  has
    an expiry date of 12th June 2001.

    Four weeks prior to its expiry,  from Tuesday 15th May 2001,  Rel 9.8  will
    issue a  warning message  to the  operator's console  on every execution of
    CBLVCAT.

    Further  releases  of  CBLVCAT  will  be  distributed  before the expiry of
    Rel 9.8.  The New Features document for each release will announce the date
    from which the previous release will cease to be supported.







***         _______________________________________________________
           |                                                       |
           |                                                       |
           |             CBLVCAT 9.8    NEW FACILITIES             |
           |                                                       |
           |_______________________________________________________|




Year 2000 Compliance                                                    *-***-*

  Definition of compliancy for CBLVCAT:
  -------------------------------------
    Operates correctly for dates either side of the change to the 21st century.

    Operates  correctly  for  both  "YR2000 Ready"  (enabled)  levels  of   the
    Operating Systems and earlier releases.

    See appropriate  IBM documentation  for further  details regarding  enabled
    levels of IBM software:
                  e.g. G225-4508-13   Special Issue - VSE and Year 2000.
                       GC28-1251-05   The Year 2000 and 2-Digit Dates.

  Backgroud information:
  ----------------------
    The following facts,  relating to  the Operating Systems,  have been  taken
    into account when addressing CBLVCAT's YR2000 compliancy:

      Dates in ICF and VSAM Catalogs
        ICF catalogs since DFP Ver 2.3.0 have included century information  for
        the dataset's Creation and Expiry dates.

        VSAM catalogs under MVS will  not be supported when the system date  is
        beyond 1999.

        VSAM catalogs under VSE continue to hold the creation and expiry  dates
        with 2 digits for year.   Year 2000 enabled releases of  VSAM interpret
        the century from these dates using a sliding window technique:

          Create Date: -  Sliding  Window  in  the range -79 to +20 relative to
          ------------    Current Date.
             i.e. for 1997, the window is 1997-79 to 1997+20
                                which equals 1918 to 2017
                                therefore YY=17 is interpreted as 2017.
                                    but   YY=18 is interpreted as 1918.

          Expiry Date: -  Sliding  Window  in  the range   0 to +99 relative to
          ------------    Create Date.
             i.e. for 1997/001, window is 1997+0  to 1997+99
                                which equals 1997 to 2096
                                therefore YY=17 is interpreted as 2017.
                                    and   YY=18 is interpreted as 2018.
                                    but   YY=98 is interpreted as 1998.
                                    and   YY=97 is interpreted as 1997.
                                    but   YY=96 is interpreted as 2096.

          Note:  A  VSAM   definition   will   fail   if  the  expiration   date
          -----  (TO= parameter)  is  outside  the  acceptable  range  of 0 - 99
                 years.

      Dates in VTOCs
        The Year in Creation and Expiry date is held in 1 byte binary, enabling
        values of 0 to 255 relative to 1900 to be stored.

      VSE: SAM and VSAM Permanent Files
        99/366 is never considered as expired.
        99/365 when  explicitly  specified  (DLBL for SAM,   TO= for VSAM)   is
               considered as never expired.
        99/365 when calculated  from a  retention period  is considered expired
               when earlier than or equal to current date.

    See  'Other Changes',   below,   regarding  resulting  changes  to  CBLVCAT
    Operations and Report Layouts.




ICF:  CSA Storage above the line                                        *-***-*

    On systems  with 31-bit  addressing,  CSA  storage for  ICF catalog control
    blocks is now requested by CBLVCAT  from above the 16MB line,  in  spite of
    the fact that CBLVCAT is linked AMODE(24).

    This  avoids  the  possibility  of  running  out  of storage when executing
    LISTVCAT operations for very large catalogs.





ALL:  VSAM (non ICF) LC - Improved Performance                          *-***-*

  Example
  -------
    Without the improved performance feature  a LISTVCAT of an 8 megabyte  VSAM
    catalog with 5000+ datasets  over 6 volumes took more than 2 hours  elapsed
    time.

    With  the  improved  performance  feature  the  same  LISTVCAT  took  about
    6 minutes.

  Background Information:
  -----------------------
    LISTVCAT operations on large VSAM catalogs can experience unacceptably long
    execution times. This is a consequence of the VSAM catalog structure.

    VSAM catalogs are  designed to  optimise direct  access to  a dataset.  The
    dataset's attributes are held  in small (512 byte) control intervals,   and
    each control interval holds information about only 1 dataset.

    This design  allows CBLVCAT  to give  good performance  when listing  small
    subsets of large catalogs with KEY= and/or IGN= since direct processing can
    be used to advantage.

    However,  when listing  all datasets (or  a large proportion)  from a large
    catalog,  direct processing becomes a distinct disadvantage. VSAM will only
    read  multiple  control   intervals  in  one   physical  Input/Output (I/O)
    operation when  using sequential  processing.  Consequently,   using direct
    processing to report on a large number of datasets requires a large  number
    of physical I/Os, resulting in long execution times.

    MVS users will be pleased to know that CBLVCAT already takes full advantage
    of the improved structure introduced with ICF catalogs.


  Improved Performance:
  ---------------------
    OPTION ISC (In-Storage Catalog) will  dramatically reduce the  elapsed time
    of these unacceptably long running jobs.

    To achieve  these gains,   CBLVCAT exploits  the VSAM Read Ahead Feature to
    sequentially read the entire Catalog into storage and thereafter uses  fast
    storage access to process records within the Catalog.

    The improvements in run-time are  subject to the overall system  load.  For
    smaller catalogs, in the region of 200 clusters or less, the run-time gains
    will be less significant.

    On systems with 31-bit addressing,   storage for this feature may  be taken
    from above the 16MB line.  VSE/ESA users wishing to take advantage of  this
    feature,  therefore, should consider executing CBLVCAT in a partition which
    allows such storage to be acquired.

    CBLVCAT supports In-Storage Catalog buffers above the 16MB line in spite of
    being linked  AMODE(24).  The  switch to  AMODE(31) is  done dynamically as
    required.

    In summary, the following should be taken into consideration for OPTION ISC
    processing:
           - The benefits, in terms of elapsed time, will vary with the load on
             your system and the size of the catalog.
           - Sufficient address space required.
           - Any resulting system contention  for virtual storage could  impact
             other batch jobs or on-line response times.
           - SUBSET KEY= and/or IGN= could be faster without ISC.


  Implementation:
  ---------------
    The CBLNAME CBLVCSW9 X'04' bit sets the installation default for In-Storage
    Catalog (ISC) processing:
                       ON - sets OPTION ISC
                       OFF- sets OPTION NOISC

    In the CBL supplied version of CBLNAME,  NOISC is the default.  ISC can  be
    made the default by changing the above setting.

    The  run-time  parameters  OPTION ISC  or  OPTION NOISC  may  be  used   to
    temporarily override the installation default.

    Even with  the installation  default set  to ISC,   CBLVCAT will not invoke
    In-Storage  Catalog  processing  when   KEY=  and/or  IGN=  subsetting   is
    specified.  To override this, for instances when KEY= subsetting results in
    a  significant  proportion  of  a  large  catalog  being selected,  use the
    run-time parameter OPTION ISC.

    ERROR 042 will be produced,  almost immediately,  should sufficient storage
    not be available for the requested catalog to be read. Rerun the job in the
    largest available  batch partition,   preferably a  partition which  allows
    storage from  above the  16MB line  to be  used.  If  enough storage is not
    available, then use OPTION NOISC to process this catalog.

    A future release of CBLVCAT will report the program's storage requirements.








***         _______________________________________________________
           |                                                       |
           |                                                       |
           |             CBLVCAT 9.8    OTHER CHANGES              |
           |                                                       |
           |_______________________________________________________|




All:  Standard Catalog Report layout      *-***-*          Year 2000 Compliance

    The default format of the Standard Catalog Report now accommodates  4 digit
    year fields for the following:
                       Report Heading.
                       TIMESTMP/DEFINED column.
                       Report SUMMARY.

    To revert to the Release 9.7 report format, with 2 digit years, set CBLNAME
    switch CBLVCSW9 X'01' bit on.

    The following summarises the effect  of the above mentioned CBLNAME  switch
    for the TIMESTMP and  DEFINED columns (see also  the effect on EXPIRES  and
    CREATED columns of the Standard VTOC Report, below):
         X'00'  (TIMESTMP)  column   width  20,   format   *ccyy/mm/dd hh.mm.ss
         (see note).
         X'00'  (DEFINED)   column   width  11,   format   *ccyy/mm/dd
         (see note).

         X'01' (TIMESTMP) column width 15, format   *yy/mm/dd hh.mm
         X'01' (DEFINED)  column width  9, format   *yy/mm/dd

  Note:  This format results  in the left  adjacent column (SHR or SPACE CLASS)
  -----  not being reported.



    Default Standard Catalog Report (SW9=X'00') option TIMESTMP           (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVVSW901  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVVSW901 JCL D ***        L=001 --- 97/02/17 10:10:46          *id *                                                             |
| o      options   cblvcsw9=x'00'     timestmp                                                                                           o |
|                                                                                                                                          |
|        lc dd=catwk2                                                                                                                      |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   USERCAT SYSWK2 (3380)  TYPE      NRECS   PCNT  ---- ALLOC TRACKS ----   FRSP   LMAX  KL,RKP  CISIZE BUFSP EXCPS     TIMESTMP           |
| o ---------------------  ----      -----   ----    TOTAL   PRIME  SEC     CI CA  ---- /BLK/IMB ------ /IXL  -----     --------         o |
|                                                                                                                                          |
|   USER.DL1.CAT.SYSWK2    KSDS         41    2.1       72      72     15           505  44,0      512   3072   408  1996/11/22 16.17.32   |
| o -------------------      IX          3    2.6        3       3      3          1017 --IMB--   1024  IXL=2    36                      o |
|   CONTROL.FILE           SAM (R)       1+   5.6        1       1      1          1600    1600   2048   4096        1996/11/22 16.43.32   |
|   INTERMED.WORK.FILE     SAM (R)       2+   5.6        1       1      1          1016    1016   2048   4096        1996/11/22 16.44.01   |
| o PREFIX.WORK.FILE.LR    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1996/11/22 16.44.04 o |
|   PREFIX.WORK.FILE.SI    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1996/11/22 16.44.01   |
|   SAMPLE.CUST            ESDS        102+  37.8      C=1     C=1    C=1          2038           2048   4096  7210  1997/03/25 19.08.13   |
| o SAMPLE.CUSTDX1         KSDS          7    0.1      C=1     C=1    C=1   10 10    42  31,10    2048   7680    13  1997/03/25 19.08.13 o |
|                            IX          1    9.1        1       1      1          3577           3584           15                        |
|   SAMPLE.CUSTDX2         KSDS          8    0.1      C=1     C=1    C=1            36  12,10    2048   7680    10  1997/03/25 19.08.13   |
| o                          IX          1    9.1        1       1      1          3577           3584           12                      o |
|   SAMPLE.INVDX           KSDS          7    0.1      C=1     C=1    C=1   10 10    18   6,10    2048   6656    16  1997/03/25 19.08.13   |
|                            IX          1    6.7        1       1      1          2553           2560           18                        |
| o SAMPLE.INVEN           ESDS         57+  21.2      C=1     C=1    C=1          2038           2048   4096   281  1997/03/25 19.08.13 o |
|   SORTWK.FILE.NR1        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22 16.44.03   |
|   SORTWK.FILE.NR2        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22 16.44.03   |
| o SORTWK.FILE.NR3        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22 16.44.03 o |
|   WORKFILE.J             SAM (R)       2+  33.4        1       1      1          6446    6446  14336  28672        1996/11/22 16.43.51   |
|                                                                                                                                          |
| o                                                    ---     ---    ---                                                                o |
|                                                      164     164    104                                                                  |
|                                                      ---     ---    ---                                                                  |
| o                                                                                                                                      o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                           ------ DEV CHARS ------     DATA  SPACE  DATA      --------- TRACKS ---------                              o |
|            VOLUME    CRA   TYPE     MIN-CA    MAX-CA    SETS  CLASS SPACES    ALLOC    USED   PCNT    FREE    MAXF    TIMESTMP           |
|            ------    ---   ----     ------    ------    ----  ----- ------    -----    ----   ----    ----    ----    --------           |
| o          SYSWK2     NO   3380     32-44K   480-660K    17     0      2        825     164   19.9     661     656 1996/11/22 16.17.34 o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                                                                                                                                      o |
|                                                                                                                                          |
|            ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **            |
| o                                                   ** EXPIRY DATE -- 12 JUN 2001 **                                                   o |
|__________________________________________________________________________________________________________________________________________|




    Default Standard Catalog Report (SW9=X'00') option DEFINED            (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVVSW902  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVVSW902 JCL D ***        L=001 --- 97/02/17 10:31:13          *id *                                                             |
| o      options   cblvcsw9=x'00'     defined                                                                                            o |
|                                                                                                                                          |
|        lc dd=catwk2                                                                                                                      |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   USERCAT SYSWK2 (3380)  TYPE      NRECS   PCNT  ---- ALLOC TRACKS ----   FRSP   LMAX  KL,RKP  CISIZE BUFSP EXCPS   DEFINED              |
| o ---------------------  ----      -----   ----    TOTAL   PRIME  SEC     CI CA  ---- /BLK/IMB ------ /IXL  -----   -------            o |
|                                                                                                                                          |
|   USER.DL1.CAT.SYSWK2    KSDS         41    2.1       72      72     15           505  44,0      512   3072   451  1996/11/22            |
| o -------------------      IX          3    2.6        3       3      3          1017 --IMB--   1024  IXL=2    38                      o |
|   CONTROL.FILE           SAM (R)       1+   5.6        1       1      1          1600    1600   2048   4096        1996/11/22            |
|   INTERMED.WORK.FILE     SAM (R)       2+   5.6        1       1      1          1016    1016   2048   4096        1996/11/22            |
| o PREFIX.WORK.FILE.LR    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1996/11/22          o |
|   PREFIX.WORK.FILE.SI    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1996/11/22            |
|   SAMPLE.CUST            ESDS        102+  37.8      C=1     C=1    C=1          2038           2048   4096  7210  1996/11/22            |
| o SAMPLE.CUSTDX1         KSDS          7    0.1      C=1     C=1    C=1   10 10    42  31,10    2048   7680    13  1996/11/22          o |
|                            IX          1    9.1        1       1      1          3577           3584           15                        |
|   SAMPLE.CUSTDX2         KSDS          8    0.1      C=1     C=1    C=1            36  12,10    2048   7680    10  1996/11/22            |
| o                          IX          1    9.1        1       1      1          3577           3584           12                      o |
|   SAMPLE.INVDX           KSDS          7    0.1      C=1     C=1    C=1   10 10    18   6,10    2048   6656    16  1996/11/22            |
|                            IX          1    6.7        1       1      1          2553           2560           18                        |
| o SAMPLE.INVEN           ESDS         57+  21.2      C=1     C=1    C=1          2038           2048   4096   281  1996/11/22          o |
|   SORTWK.FILE.NR1        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22            |
|   SORTWK.FILE.NR2        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22            |
| o SORTWK.FILE.NR3        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1996/11/22          o |
|   WORKFILE.J             SAM (R)       2+  33.4        1       1      1          6446    6446  14336  28672        1996/11/22            |
|                                                                                                                                          |
| o                                                    ---     ---    ---                                                                o |
|                                                      164     164    104                                                                  |
|                                                      ---     ---    ---                                                                  |
| o                                                                                                                                      o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                           ------ DEV CHARS ------     DATA  SPACE  DATA      --------- TRACKS ---------                              o |
|            VOLUME    CRA   TYPE     MIN-CA    MAX-CA    SETS  CLASS SPACES    ALLOC    USED   PCNT    FREE    MAXF    TIMESTMP           |
|            ------    ---   ----     ------    ------    ----  ----- ------    -----    ----   ----    ----    ----    --------           |
| o          SYSWK2     NO   3380     32-44K   480-660K    17     0      2        825     164   19.9     661     656 1996/11/22 16.17.34 o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                                                                                                                                      o |
|                                                                                                                                          |
|            ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **            |
| o                                                   ** EXPIRY DATE -- 12 JUN 2001 **                                                   o |
|__________________________________________________________________________________________________________________________________________|

  Heading
  -------
    2 digit year increased to 4 digits,  on the default and alternate  Standard
    Catalog Report,  by reducing the  number of spaces before the  literal PAGE
    from 6 to 4.

  TIMESTMP/DEFINED
  ----------------
    The default format of the DEFINED/TIMESTMP column now includes the  century
    in a 4 digit year.

    In addition,  the TIMESTMP field has been expanded to include seconds.  The
    column heading,  TIMESTMP or DEFINED, is moved 4 or 5 positions to the left
    respectively.

    To accommodate these changes,  the SHR/S C column is no longer shown in the
    default Standard Report.  However,   they are available via  the Customised
    Report,  or, on request through a CBLNAME switch, on the alternate Standard
    Report in Rel 9.7 format.

  SUMMARY
  -------
    The default Catalog Summary layout has been slightly modified.

    TIMESTMP,  now including seconds and  4 digit years,  is aligned under  its
    respective  column  in  the  Detail  report.  The TIMESTMP heading is moved
    3 positions to the  left.  As with  the Detail report,   the format of  the
    Summary also reverts to  the Rel 9.7 layout when the  CBLVCSW9 X'01' bit is
    on.









    Alternate Standard Catalog Report (SW9=X'01') option TIMESTMP         (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVVSW911  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVVSW911 JCL D ***        L=001 --- 97/02/17 10:28:22          *id *                                                             |
| o      options   cblvcsw9=x'01'     timestmp                                                                                           o |
|                                                                                                                                          |
|        lc dd=catwk2                                                                                                                      |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   USERCAT SYSWK2 (3380)  TYPE      NRECS   PCNT  ---- ALLOC TRACKS ----   FRSP   LMAX  KL,RKP  CISIZE BUFSP EXCPS  SHR     TIMESTMP      |
| o ---------------------  ----      -----   ----    TOTAL   PRIME  SEC     CI CA  ---- /BLK/IMB ------ /IXL  -----  ---     --------    o |
|                                                                                                                                          |
|   USER.DL1.CAT.SYSWK2    KSDS         41    2.1       72      72     15           505  44,0      512   3072   535  3,3  96/11/22 16.17   |
| o -------------------      IX          3    2.6        3       3      3          1017 --IMB--   1024  IXL=2    42  3,3                 o |
|   CONTROL.FILE           SAM (R)       1+   5.6        1       1      1          1600    1600   2048   4096        1,3  96/11/22 16.43   |
|   INTERMED.WORK.FILE     SAM (R)       2+   5.6        1       1      1          1016    1016   2048   4096        1,3  96/11/22 16.44   |
| o PREFIX.WORK.FILE.LR    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1,3  96/11/22 16.44 o |
|   PREFIX.WORK.FILE.SI    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1,3  96/11/22 16.44   |
|   SAMPLE.CUST            ESDS        102+  37.8      C=1     C=1    C=1          2038           2048   4096  7210  1,3  97/03/25 19.08   |
| o SAMPLE.CUSTDX1         KSDS          7    0.1      C=1     C=1    C=1   10 10    42  31,10    2048   7680    13  1,3  97/03/25 19.08 o |
|                            IX          1    9.1        1       1      1          3577           3584           15  1,3                   |
|   SAMPLE.CUSTDX2         KSDS          8    0.1      C=1     C=1    C=1            36  12,10    2048   7680    10  1,3  97/03/25 19.08   |
| o                          IX          1    9.1        1       1      1          3577           3584           12  1,3                 o |
|   SAMPLE.INVDX           KSDS          7    0.1      C=1     C=1    C=1   10 10    18   6,10    2048   6656    16  1,3  97/03/25 19.08   |
|                            IX          1    6.7        1       1      1          2553           2560           18  1,3                   |
| o SAMPLE.INVEN           ESDS         57+  21.2      C=1     C=1    C=1          2038           2048   4096   281  1,3  97/03/25 19.08 o |
|   SORTWK.FILE.NR1        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22 16.44   |
|   SORTWK.FILE.NR2        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22 16.44   |
| o SORTWK.FILE.NR3        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22 16.44 o |
|   WORKFILE.J             SAM (R)       2+  33.4        1       1      1          6446    6446  14336  28672        1,3  96/11/22 16.43   |
|                                                                                                                                          |
| o                                                    ---     ---    ---                                                                o |
|                                                      164     164    104                                                                  |
|                                                      ---     ---    ---                                                                  |
| o                                                                                                                                      o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                           ------ DEV CHARS ------     DATA  SPACE  DATA      --------- TRACKS ---------                              o |
|            VOLUME    CRA   TYPE     MIN-CA    MAX-CA    SETS  CLASS SPACES    ALLOC    USED   PCNT    FREE    MAXF    TIMESTMP           |
|            ------    ---   ----     ------    ------    ----  ----- ------    -----    ----   ----    ----    ----    --------           |
| o          SYSWK2     NO   3380     32-44K   480-660K    17     0      2        825     164   19.9     661     656    96/11/22 16.17   o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                                                                                                                                      o |
|                                                                                                                                          |
|            ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **            |
| o                                                   ** EXPIRY DATE -- 12 JUN 2001 **                                                   o |
|__________________________________________________________________________________________________________________________________________|



    Alternate Standard Catalog Report (SW9=X'01') option DEFINED          (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVVSW912  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVVSW912 JCL D ***        L=001 --- 97/02/17 10:30:14          *id *                                                             |
| o      options   cblvcsw9=x'01'     defined                                                                                            o |
|                                                                                                                                          |
|        lc dd=catwk2                                                                                                                      |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   USERCAT SYSWK2 (3380)  TYPE      NRECS   PCNT  ---- ALLOC TRACKS ----   FRSP   LMAX  KL,RKP  CISIZE BUFSP EXCPS  SHR   DEFINED         |
| o ---------------------  ----      -----   ----    TOTAL   PRIME  SEC     CI CA  ---- /BLK/IMB ------ /IXL  -----  ---   -------       o |
|                                                                                                                                          |
|   USER.DL1.CAT.SYSWK2    KSDS         41    2.1       72      72     15           505  44,0      512   3072   578  3,3  96/11/22         |
| o -------------------      IX          3    2.6        3       3      3          1017 --IMB--   1024  IXL=2    44  3,3                 o |
|   CONTROL.FILE           SAM (R)       1+   5.6        1       1      1          1600    1600   2048   4096        1,3  96/11/22         |
|   INTERMED.WORK.FILE     SAM (R)       2+   5.6        1       1      1          1016    1016   2048   4096        1,3  96/11/22         |
| o PREFIX.WORK.FILE.LR    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1,3  96/11/22       o |
|   PREFIX.WORK.FILE.SI    SAM (R)       2+  16.7        1       1      1          3192    3192   6656  13312        1,3  96/11/22         |
|   SAMPLE.CUST            ESDS        102+  37.8      C=1     C=1    C=1          2038           2048   4096  7210  1,3  96/11/22         |
| o SAMPLE.CUSTDX1         KSDS          7    0.1      C=1     C=1    C=1   10 10    42  31,10    2048   7680    13  1,3  96/11/22       o |
|                            IX          1    9.1        1       1      1          3577           3584           15  1,3                   |
|   SAMPLE.CUSTDX2         KSDS          8    0.1      C=1     C=1    C=1            36  12,10    2048   7680    10  1,3  96/11/22         |
| o                          IX          1    9.1        1       1      1          3577           3584           12  1,3                 o |
|   SAMPLE.INVDX           KSDS          7    0.1      C=1     C=1    C=1   10 10    18   6,10    2048   6656    16  1,3  96/11/22         |
|                            IX          1    6.7        1       1      1          2553           2560           18  1,3                   |
| o SAMPLE.INVEN           ESDS         57+  21.2      C=1     C=1    C=1          2038           2048   4096   281  1,3  96/11/22       o |
|   SORTWK.FILE.NR1        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22         |
|   SORTWK.FILE.NR2        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22         |
| o SORTWK.FILE.NR3        SAM (R)     900+** ALL**      2       2      1            80      80   2048   4096        1,3  96/11/22       o |
|   WORKFILE.J             SAM (R)       2+  33.4        1       1      1          6446    6446  14336  28672        1,3  96/11/22         |
|                                                                                                                                          |
| o                                                    ---     ---    ---                                                                o |
|                                                      164     164    104                                                                  |
|                                                      ---     ---    ---                                                                  |
| o                                                                                                                                      o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                           ------ DEV CHARS ------     DATA  SPACE  DATA      --------- TRACKS ---------                              o |
|            VOLUME    CRA   TYPE     MIN-CA    MAX-CA    SETS  CLASS SPACES    ALLOC    USED   PCNT    FREE    MAXF    TIMESTMP           |
|            ------    ---   ----     ------    ------    ----  ----- ------    -----    ----   ----    ----    ----    --------           |
| o          SYSWK2     NO   3380     32-44K   480-660K    17     0      2        825     164   19.9     661     656    96/11/22 16.17   o |
|                                                                                                                                          |
|                                                                                                                                          |
| o                                                                                                                                      o |
|                                                                                                                                          |
|            ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **            |
| o                                                   ** EXPIRY DATE -- 12 JUN 2001 **                                                   o |
|__________________________________________________________________________________________________________________________________________|










All:  Standard VTOC Report layout         *-***-*          Year 2000 Compliance

    The default format of the  Standard VTOC Report now always  reports 4 digit
    year fields for the following:
                       Report Heading.
                       CREATED column.
                       EXPIRES column.
                       Report SUMMARY.

    To revert to the Release 9.7 report format, with a 2 digit year but in this
    release always omitting the century,  set CBLNAME switch CBLVCSW9 X'01' bit
    on.

    The following summarises the effect  of the above mentioned CBLNAME  switch
    (see also  the effect  on TIMESTMP/DEFINED  column of  the Standard Catalog
    report, above):
         X'00' (CREATED)  column width 10, format  ccyy/mm/dd
         X'00' (EXPIRES)  column width 11, format *ccyy/mm/dd

         X'01' (CREATED)  column width  8, format    yy/mm/dd
         X'01' (EXPIRES)  column width  9, format   *yy/mm/dd

    Previously,   the  column  widths  were  10 (CREATED) and 11 (EXPIRES) with
    formats of ccyy/mm/dd and *ccyy/mm/dd respectively.  However,  the  century
    was omitted when the value was 19.

    The following examples were created in a YR2000 enabled release of VSE.


    Default Standard VTOC Report (SW9=X'00') option PERM EXPD             (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVTSW901  11.55 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVTSW901 JCL D ***        L=002 --- 97/03/27 11:42:52          *id *                                                             |
| o      options   cblvcsw9=x'00'     perm       expd                                                                                    o |
|                                                                                                                                          |
|        lv vol=syswk2                                                                                                                     |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   VTOC OF SYSWK2           CYL/HD LIMITS   START  ALLOC   USED  TYPE   EXPIRES BLKSIZE LRECL  RECFM    CREATED   INFO                    |
| o --------------           -------------   -----  -----   ----  ----   ------- ------- -----  -----    -------   ----                  o |
|                                                                                                                                          |
|   VTOC                    000/01  000/02       1      2      1  3380                96    96                     OWNED BY VSAM CATALOG   |
| o                                                                                                                                      o |
|   Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9                                                                                                    |
|                           000/04  005/03       4     75         VSAM  PERMANENT                      1996/11/22                          |
| o Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD                                                                                                  o |
|                           005/04  055/03      79    750         VSAM  PERMANENT                      1996/11/22                          |
|   SYSTEM.JOURNAL.A        055/04  056/03     829     15                 *EXPD*                       1997/03/25                          |
| o SYSTEM.JOURNAL.B        056/04  056/04     844      1                 *EXPD*                       1997/03/25                        o |
|   USER.JOURNAL.1A         056/05  057/04     845     15                 *EXPD*                       1997/03/25                          |
|   USER.JOURNAL.1B         057/05  057/05     860      1                 *EXPD*                       1997/03/25                          |
| o CBL.SYSWK2.EXP99366     057/06  057/06     861      1               PERMANENT                      1997/02/03                        o |
|   CBL.SYSWK2.EXP99365     057/07  057/07     862      1               PERMANENT                      1997/02/03                          |
|   CBL.SYSWK2.EXPR1061     057/08  057/08     863      1             *1999/12/31                      1997/02/03                          |
| o CBL.EXPIRY.TEST         057/09  058/03     864     10              2000/12/31                      2000/12/31                        o |
|                                                                                                                                          |
|                                    ------------------------------------------------------------------                                    |
| o                                                                                                                                      o |
|                                                                                                                  OLDEST     1996/11/22   |
|                                                                                                                  LATEST     2000/12/31   |
| o                                                                                                                VTOC RECS LIVE......8 o |
|                                                                                                                            EXPD......4   |
|                                                                                                                            FREE.....92   |
| o                                                                                                                         TOTAL....104 o |
|                                                                                                                  SYSWK2 MOUNTED ON 161   |
|                                                                                                                                          |
| o           ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **         o |
|                                                      ** EXPIRY DATE -- 12 JUN 2001 **                                                    |
|__________________________________________________________________________________________________________________________________________|



    Default Standard VTOC Report (SW9=X'00') option NOPERM EXPD           (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVTSW902  11.55 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVTSW902 JCL D ***        L=002 --- 97/03/27 11:50:35          *id *                                                             |
| o      options   cblvcsw9=x'00'   noperm       expd                                                                                    o |
|                                                                                                                                          |
|        lv vol=syswk2                                                                                                                     |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   VTOC OF SYSWK2           CYL/HD LIMITS   START  ALLOC   USED  TYPE   EXPIRES BLKSIZE LRECL  RECFM    CREATED   INFO                    |
| o --------------           -------------   -----  -----   ----  ----   ------- ------- -----  -----    -------   ----                  o |
|                                                                                                                                          |
|   VTOC                    000/01  000/02       1      2      1  3380                96    96                     OWNED BY VSAM CATALOG   |
| o                                                                                                                                      o |
|   Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9                                                                                                    |
|                           000/04  005/03       4     75         VSAM 1999/13/01                      1996/11/22                          |
| o Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD                                                                                                  o |
|                           005/04  055/03      79    750         VSAM 1999/13/01                      1996/11/22                          |
|   SYSTEM.JOURNAL.A        055/04  056/03     829     15                 *EXPD*                       1997/03/25                          |
| o SYSTEM.JOURNAL.B        056/04  056/04     844      1                 *EXPD*                       1997/03/25                        o |
|   USER.JOURNAL.1A         056/05  057/04     845     15                 *EXPD*                       1997/03/25                          |
|   USER.JOURNAL.1B         057/05  057/05     860      1                 *EXPD*                       1997/03/25                          |
| o CBL.SYSWK2.EXP99366     057/06  057/06     861      1              1999/13/01                      1997/02/03                        o |
|   CBL.SYSWK2.EXP99365     057/07  057/07     862      1              1999/12/31                      1997/02/03                          |
|   CBL.SYSWK2.EXPR1061     057/08  057/08     863      1             *1999/12/31                      1997/02/03                          |
| o CBL.EXPIRY.TEST         057/09  058/03     864     10              2000/12/31                      2000/12/31                        o |
|                                                                                                                                          |
|                                    ------------------------------------------------------------------                                    |
| o                                                                                                                                      o |
|                                                                                                                  OLDEST     1996/11/22   |
|                                                                                                                  LATEST     2000/12/31   |
| o                                                                                                                VTOC RECS LIVE......8 o |
|                                                                                                                            EXPD......4   |
|                                                                                                                            FREE.....92   |
| o                                                                                                                         TOTAL....104 o |
|                                                                                                                  SYSWK2 MOUNTED ON 161   |
|                                                                                                                                          |
| o          ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **          o |
|                                                     ** EXPIRY DATE -- 12 JUN 2001 **                                                     |
|__________________________________________________________________________________________________________________________________________|


  Heading
  -------
    2 digit year increased to 4 digits,  on the default and alternate  Standard
    VTOC Report,  by reducing the number of spaces before the literal PAGE from
    6 to 4.

  CREATED and EXPIRES
  -------------------
    The  default  format  of  the  CREATED  and EXPIRES columns now include the
    century in a 4 digit year.

    As mentioned earlier, previously the century was only shown if the year was
    higher than 1999. For most users, therefore, the century was not displayed.

  EXPIRES
  -------
    Asterisk  eye-catcher,  before  the  date,  indicates  an  expiry  date  of
    1999/12/31  which  has  been  calculated  from  a  retention  period and is
    therefore not considered permanent by the Operating System.  (Only reported
    for a YR2000 enabled release of VSE).
    Although this  may be  intentional,  it  is highlighted  so that  it may be
    checked by  the user  to avoid  files being  silently deleted  on or  after
    31st December 1999.

    Under unusual circumstances,   when the TYPE  column also contains  *EXT=n*
    (missing extent),  then it is not possible to accommodated a blank  between
    the  column  contents   if  the  EXPIRES   date  is  highlighted   with  an
    * (asterisk).

    When  OPTION PERM  is   in  effect  and   CBLVCAT  is  executing   under  a
    YR2000 enabled release of  the operating system,   PERMANENT is only  shown
    instead  of  99/365  or  99/366  when  the  Expiry Date has been explicitly
    specified as opposed to being calculated from a retention value.

    Previously,  PERMANENT was displayed when the file's expiry date was 99/365
    or higher.

  SUMMARY
  -------
    The default VTOC Summary layout has also been slightly modified.

    To accommodate the 4 digit year,
           'OLDEST DATED yy/mm/dd' and 'LATEST DATED yy/mm/dd'
    become 'OLDEST     ccyy/mm/dd' and 'LATEST     ccyy/mm/dd' respectively.

    The  format  of  the  Summary  also  reverts to the Rel 9.7 layout with the
    CBLVCSW9 X'01' bit on.


    Alternate Standard VTOC Report (SW9=X'01') option PERM EXPD           (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVTSW911  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVTSW911 JCL D ***        L=001 --- 97/02/14 17:04:03          *id *                                                             |
| o      options   cblvcsw9=x'01'     perm       expd                                                                                    o |
|                                                                                                                                          |
|        lv vol=syswk2                                                                                                                     |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   VTOC OF SYSWK2           CYL/HD LIMITS   START  ALLOC   USED  TYPE   EXPIRES BLKSIZE LRECL  RECFM    CREATED   INFO                    |
| o --------------           -------------   -----  -----   ----  ----   ------- ------- -----  -----    -------   ----                  o |
|                                                                                                                                          |
|   VTOC                    000/01  000/02       1      2      1  3380                96    96                     OWNED BY VSAM CATALOG   |
| o                                                                                                                                      o |
|   Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9                                                                                                    |
|                           000/04  005/03       4     75         VSAM  PERMANENT                        96/11/22                          |
| o Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD                                                                                                  o |
|                           005/04  055/03      79    750         VSAM  PERMANENT                        96/11/22                          |
|   SYSTEM.JOURNAL.A        055/04  056/03     829     15                 *EXPD*                         97/03/25                          |
| o SYSTEM.JOURNAL.B        056/04  056/04     844      1                 *EXPD*                         97/03/25                        o |
|   USER.JOURNAL.1A         056/05  057/04     845     15                 *EXPD*                         97/03/25                          |
|   USER.JOURNAL.1B         057/05  057/05     860      1                 *EXPD*                         97/03/25                          |
| o CBL.SYSWK2.EXP99366     057/06  057/06     861      1               PERMANENT                        97/02/03                        o |
|   CBL.SYSWK2.EXP99365     057/07  057/07     862      1               PERMANENT                        97/02/03                          |
|   CBL.SYSWK2.EXPR1061     057/08  057/08     863      1               *99/12/31                        97/02/03                          |
| o CBL.EXPIRY.TEST         057/09  058/03     864     10                00/12/31                        00/12/31                        o |
|                                                                                                                                          |
|                                    ------------------------------------------------------------------                                    |
| o                                                                                                                                      o |
|                                                                                                                  OLDEST DATED 96/11/22   |
|                                                                                                                  LATEST DATED 00/12/31   |
| o                                                                                                                VTOC RECS LIVE......8 o |
|                                                                                                                            EXPD......4   |
|                                                                                                                            FREE.....92   |
| o                                                                                                                         TOTAL....104 o |
|                                                                                                                  SYSWK2 MOUNTED ON 161   |
|                                                                                                                                          |
| o          ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **          o |
|                                                     ** EXPIRY DATE -- 12 JUN 2001 **                                                     |
|__________________________________________________________________________________________________________________________________________|



    Alternate Standard VTOC Report (SW9=X'01') option NOPERM EXPD         (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                                             VSE  F4 JOB=VVTSW912  11.56 THU 27 MAR 1997    PAGE   1   |
| o --------------------------------                                                  --------------------------------------    -------- o |
|                                                                                                                                          |
|      ** VVTSW912 JCL D ***        L=001 --- 97/02/14 17:04:05          *id *                                                             |
| o      options   cblvcsw9=x'01'   noperm       expd                                                                                    o |
|                                                                                                                                          |
|        lv vol=syswk2                                                                                                                     |
| o                                                                                                                                      o |
|                                                                                                                                          |
|   VTOC OF SYSWK2           CYL/HD LIMITS   START  ALLOC   USED  TYPE   EXPIRES BLKSIZE LRECL  RECFM    CREATED   INFO                    |
| o --------------           -------------   -----  -----   ----  ----   ------- ------- -----  -----    -------   ----                  o |
|                                                                                                                                          |
|   VTOC                    000/01  000/02       1      2      1  3380                96    96                     OWNED BY VSAM CATALOG   |
| o                                                                                                                                      o |
|   Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9                                                                                                    |
|                           000/04  005/03       4     75         VSAM   99/13/01                        96/11/22                          |
| o Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD                                                                                                  o |
|                           005/04  055/03      79    750         VSAM   99/13/01                        96/11/22                          |
|   SYSTEM.JOURNAL.A        055/04  056/03     829     15                 *EXPD*                         97/03/25                          |
| o SYSTEM.JOURNAL.B        056/04  056/04     844      1                 *EXPD*                         97/03/25                        o |
|   USER.JOURNAL.1A         056/05  057/04     845     15                 *EXPD*                         97/03/25                          |
|   USER.JOURNAL.1B         057/05  057/05     860      1                 *EXPD*                         97/03/25                          |
| o CBL.SYSWK2.EXP99366     057/06  057/06     861      1                99/13/01                        97/02/03                        o |
|   CBL.SYSWK2.EXP99365     057/07  057/07     862      1                99/12/31                        97/02/03                          |
|   CBL.SYSWK2.EXPR1061     057/08  057/08     863      1               *99/12/31                        97/02/03                          |
| o CBL.EXPIRY.TEST         057/09  058/03     864     10                00/12/31                        00/12/31                        o |
|                                                                                                                                          |
|                                    ------------------------------------------------------------------                                    |
| o                                                                                                                                      o |
|                                                                                                                  OLDEST DATED 96/11/22   |
|                                                                                                                  LATEST DATED 00/12/31   |
| o                                                                                                                VTOC RECS LIVE......8 o |
|                                                                                                                            EXPD......4   |
|                                                                                                                            FREE.....92   |
| o                                                                                                                         TOTAL....104 o |
|                                                                                                                  SYSWK2 MOUNTED ON 161   |
|                                                                                                                                          |
| o          ** ** ** ** ** ** ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 ** ** ** ** ** ** **          o |
|                                                     ** EXPIRY DATE -- 12 JUN 2001 **                                                     |
|__________________________________________________________________________________________________________________________________________|








All:  REPORT VCAT and REPORT VTOC fields  *-***-*          Year 2000 Compliance

    In line with the  above changes to the  Standard Catalog and Standard  VTOC
    Report layouts,  the default formats of the TIMESTMP,  DEFINED, CREATED and
    EXPIRES Customised Report fields also now accommodate 4 digit years.

    However,  to  cater for  SORT,  highlighting  by means  of an  asterisk (*)
    follows the date as opposed to preceeding it, as in the Standard Report.

    As  with  the  Standard  Reports,   to  revert to a 2 digit year format set
    CBLNAME switch CBLVCSW9 X'01' bit on.

    The following summarises the effect  of the above mentioned CBLNAME  switch
    for the relevant Customised Report fields:

       REPORT VCAT
       -----------
         X'00' (TIMESTMP) column width 20, format ccyy/mm/dd hh.mm.ss*
         X'00' (DEFINED)  column width 11, format ccyy/mm/dd*

         X'01' (TIMESTMP) column width 15, format   yy/mm/dd hh.mm*
         X'01' (DEFINED)  column width  9, format   yy/mm/dd*

       REPORT VTOC
       -----------
         X'00' (CREATED)  column width 10, format  ccyy/mm/dd
         X'00' (EXPIRES)  column width 11, format  ccyy/mm/dd*

         X'01' (CREATED)  column width  8, format    yy/mm/dd
         X'01' (EXPIRES)  column width  9, format    yy/mm/dd*

    The following examples were created in a YR2000 enabled release of VSE.





    report vcat  sortd TIMESTMP DEFINED dsn (SW9=X'00')                   (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31                    1997/03/27 11:56  PAGE   1                                                         |
| o --------------------------------                    ----------------  --------                                                       o |
|                                                                                                                                          |
|      ** VVVSW906 JCL D ***        L=001 --- 97/02/17 15:39:35          *id *                                                             |
| o      options   cblvcsw9=x'00'                                                                                                        o |
|                                                                                                                                          |
|        report vcat   sortd timestmp    defined    dsn                                                                                    |
| o                                                                                                                                      o |
|        lc dd=catwk2                                                                                                                      |
|                                                                                                                                          |
| o                                                                                                                                      o |
|       TIMESTMP           DEFINED   USERCAT SYSWK2 (3380)                                                                                 |
|       --------           -------   ---------------------                                                                                 |
| o                                                                                                                                      o |
|   1997/03/25 19.08.13  1996/11/22  SAMPLE.INVEN                                                                                          |
|   1997/03/25 19.08.13  1996/11/22  SAMPLE.INVDX                                                                                          |
| o 1997/03/25 19.08.13  1996/11/22  SAMPLE.CUSTDX2                                                                                      o |
|   1997/03/25 19.08.13  1996/11/22  SAMPLE.CUSTDX1                                                                                        |
|   1997/03/25 19.08.13  1996/11/22  SAMPLE.CUST                                                                                           |
| o 1996/11/22 16.44.04  1996/11/22  PREFIX.WORK.FILE.LR                                                                                 o |
|   1996/11/22 16.44.03  1996/11/22  SORTWK.FILE.NR3                                                                                       |
|   1996/11/22 16.44.03  1996/11/22  SORTWK.FILE.NR2                                                                                       |
| o 1996/11/22 16.44.03  1996/11/22  SORTWK.FILE.NR1                                                                                     o |
|   1996/11/22 16.44.01  1996/11/22  PREFIX.WORK.FILE.SI                                                                                   |
|   1996/11/22 16.44.01  1996/11/22  INTERMED.WORK.FILE                                                                                    |
| o 1996/11/22 16.43.51  1996/11/22  WORKFILE.J                                                                                          o |
|   1996/11/22 16.43.32  1996/11/22  CONTROL.FILE                                                                                          |
|   1996/11/22 16.17.32  1996/11/22  USER.DL1.CAT.SYSWK2                                                                                   |
| o                                  -------------------                                                                                 o |
|                                                                                                                                          |
|   ** CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466 **                                                         |
| o                        ** EXPIRY DATE -- 12 JUN 2001 **                                                                              o |
|__________________________________________________________________________________________________________________________________________|



    report vcat  sortd TIMESTMP DEFINED dsn (SW9=X'01')                   (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31              1997/03/27 11:57  PAGE   1                                                               |
| o --------------------------------              ----------------  --------                                                             o |
|                                                                                                                                          |
|      ** VVVSW916 JCL D ***        L=001 --- 97/02/17 15:38:44          *id                                                               |
| o      options   cblvcsw9=x'01'                                                                                                        o |
|                                                                                                                                          |
|        report vcat   sortd timestmp    defined    dsn                                                                                    |
| o                                                                                                                                      o |
|        lc dd=catwk2                                                                                                                      |
|                                                                                                                                          |
| o                                                                                                                                      o |
|       TIMESTMP      DEFINED USERCAT SYSWK2 (3380)                                                                                        |
|       --------      ------- ---------------------                                                                                        |
| o                                                                                                                                      o |
|   97/03/25 19.08  96/11/22  SAMPLE.INVEN                                                                                                 |
|   97/03/25 19.08  96/11/22  SAMPLE.INVDX                                                                                                 |
| o 97/03/25 19.08  96/11/22  SAMPLE.CUSTDX2                                                                                             o |
|   97/03/25 19.08  96/11/22  SAMPLE.CUSTDX1                                                                                               |
|   97/03/25 19.08  96/11/22  SAMPLE.CUST                                                                                                  |
| o 96/11/22 16.44  96/11/22  SORTWK.FILE.NR3                                                                                            o |
|   96/11/22 16.44  96/11/22  SORTWK.FILE.NR2                                                                                              |
|   96/11/22 16.44  96/11/22  SORTWK.FILE.NR1                                                                                              |
| o 96/11/22 16.44  96/11/22  PREFIX.WORK.FILE.SI                                                                                        o |
|   96/11/22 16.44  96/11/22  PREFIX.WORK.FILE.LR                                                                                          |
|   96/11/22 16.44  96/11/22  INTERMED.WORK.FILE                                                                                           |
| o 96/11/22 16.43  96/11/22  WORKFILE.J                                                                                                 o |
|   96/11/22 16.43  96/11/22  CONTROL.FILE                                                                                                 |
|   96/11/22 16.17  96/11/22  USER.DL1.CAT.SYSWK2                                                                                          |
| o                           -------------------                                                                                        o |
|                                                                                                                                          |
|   CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466                                                               |
| o                     ** EXPIRY DATE -- 12 JUN 2001 **                                                                                 o |
|__________________________________________________________________________________________________________________________________________|



    report vtoc  dsn CREATED  sortd EXPIRES (SW9=X'00')                   (New)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31              1997/03/27 11:56  PAGE   1                                                               |
| o --------------------------------              ----------------  --------                                                             o |
|                                                                                                                                          |
|      ** VVTSW906 JCL D ***        L=001 --- 97/02/14 17:03:46          *id                                                               |
| o      options   cblvcsw9=x'00'     perm       expd                                                                                    o |
|                                                                                                                                          |
|        report  vtoc   dsn 37  created   sortd expires                                                                                    |
| o                                                                                                                                      o |
|        lv vol=syswk2                                                                                                                     |
|                                                                                                                                          |
| o                                                                                                                                      o |
|   VTOC OF SYSWK2                         CREATED     EXPIRES                                                                             |
|   --------------                         -------     -------                                                                             |
| o                                                                                                                                      o |
|   CBL.EXPIRY.TEST                      2000/12/31 2000/12/31                                                                             |
|   CBL.SYSWK2.EXPR1061                  1997/02/03 1999/12/31*                                                                            |
| o Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9  1996/11/22  PERMANENT                                                                           o |
|   Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD  1996/11/22  PERMANENT                                                                             |
|   CBL.SYSWK2.EXP99366                  1997/02/03  PERMANENT                                                                             |
| o CBL.SYSWK2.EXP99365                  1997/02/03  PERMANENT                                                                           o |
|   SYSTEM.JOURNAL.A                     1997/03/25    *EXPD*                                                                              |
|   SYSTEM.JOURNAL.B                     1997/03/25    *EXPD*                                                                              |
| o USER.JOURNAL.1A                      1997/03/25    *EXPD*                                                                            o |
|   USER.JOURNAL.1B                      1997/03/25    *EXPD*                                                                              |
|   VTOC                                                                                                                                   |
| o                                                                                                                                      o |
|                                    ---------------------------------------                                                               |
|                                                                                                                                          |
| o                                                                                                                                      o |
|   CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466                                                               |
|                       ** EXPIRY DATE -- 12 JUN 2001 **                                                                                   |
|__________________________________________________________________________________________________________________________________________|



    report vtoc  dsn CREATED  sortd EXPIRES (SW9=X'01')                   (Old)
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   CBLVCAT REL 9.80 AT CBL - VMPS31              1997/03/27 11:56  PAGE   1                                                               |
| o --------------------------------              ----------------  --------                                                             o |
|                                                                                                                                          |
|      ** VVTSW916 JCL D ***        L=001 --- 97/02/14 17:04:11          *id                                                               |
| o      options   cblvcsw9=x'01'     perm       expd                                                                                    o |
|                                                                                                                                          |
|        report  vtoc   dsn 37  created   sortd expires                                                                                    |
| o                                                                                                                                      o |
|        lv vol=syswk2                                                                                                                     |
|                                                                                                                                          |
| o                                                                                                                                      o |
|   VTOC OF SYSWK2                         CREATED     EXPIRES                                                                             |
|   --------------                         -------     -------                                                                             |
| o                                                                                                                                      o |
|   CBL.SYSWK2.EXPR1061                    97/02/03   99/12/31*                                                                            |
|   CBL.EXPIRY.TEST                        00/12/31   00/12/31                                                                             |
| o Z9999994.VSAMDSPC.TADCEEDD.TC3F9AF9    96/11/22   PERMANENT                                                                          o |
|   Z9999992.VSAMDSPC.TADCEEDE.T1A8C7DD    96/11/22   PERMANENT                                                                            |
|   CBL.SYSWK2.EXP99366                    97/02/03   PERMANENT                                                                            |
| o CBL.SYSWK2.EXP99365                    97/02/03   PERMANENT                                                                          o |
|   SYSTEM.JOURNAL.A                       97/03/25    *EXPD*                                                                              |
|   SYSTEM.JOURNAL.B                       97/03/25    *EXPD*                                                                              |
| o USER.JOURNAL.1A                        97/03/25    *EXPD*                                                                            o |
|   USER.JOURNAL.1B                        97/03/25    *EXPD*                                                                              |
|   VTOC                                                                                                                                   |
| o                                                                                                                                      o |
|                                    ---------------------------------------                                                               |
|                                                                                                                                          |
| o                                                                                                                                      o |
|   CBLVCAT IS LICENSED BY COMPUTE (BRIDGEND) LTD +44 (1656) 652222 & 656466                                                               |
|                       ** EXPIRY DATE -- 12 JUN 2001 **                                                                                   |
|__________________________________________________________________________________________________________________________________________|


  EXPIRES
  -------
    The  *  eye-catcher  (only  reported  for  a YR2000 enabled release of VSE)
    indicates an  expiry date  of 1999/12/31  which has  been calculated from a
    retention period and is therefore not considered permanent by the Operating
    System.  Although this may be intentional, it is highlighted so that it may
    be checked by the  user to avoid files  being silently deleted on  or after
    31st December 1999.

  TIMESTMP
  --------
    As in previous releases, the * eye-catcher indicates a KSDS index is out of
    step with its data component.

  DEFINED
  -------
    As in previous releases, the * eye-catcher indicates today's date.







All:  LISTVCAT DD=ucat OPTION DEFINE      *-***-*          Year 2000 Compliance

    OPTION DEFINE produces an output file of IDCAMS DELETE/DEFINE statements.

    The expiry parameter TO (.....) is  now reported/punched as a 4 digit  year
    for ICF and YR2000 Ready (enabled) VSAM releases.
                            e.g. TO   (1998001)

    YR2000 enabled releases of VSE/VSAM continue to hold both the creation  and
    expiry dates with  2 digit years.  CBLVCAT  interprets the century  using a
    Sliding Window of  0 to +99,  relative to  the file's create date  (not the
    current date).  Examples of Sliding Windows are shown in the description of
    'Year 2000 Compliance' earlier under 'New Facilities'.

    Previously, the TO (.....) date was always represented by a 2 digit year.
                            e.g. TO   (  98001)









All:  HIDATE=/LODATE=/HIEXP=/LOEXP=       *-***-*          Year 2000 Compliance

    Although  LC HIDATE=/LODATE=  was  previously  documented as supporting the
    ccyymmdd format,   HIDATE=20yymmdd resulted  in WARN 010 NO FILES SELECTED.
    This has been corrected.

    Other than when the +/-ddd format of the argument is used,  the recommended
    format is ccyymmdd.  Otherwise,  the interpretation of the century for  the
    yymmdd and yy/mm/dd formats of the argument are as follows:
      HIDATE/LODATE - use a sliding window in the range -79 to +20 relative  to
                      Current Date.
      HIEXP/LOEXP   - use a sliding window in the range   0 to +99 relative  to
                      Current Date.

    See Year 2000 Compliance,  earlier  under New Facilities,  for  examples of
    'Sliding Windows'.

    Previously, when yy was 30 or higher, cc was interpreted as 19,
            and when yy was less than 30, cc was interpreted as 20.







VSE:  MOD DEV=cuu DSN=xxx.. EXP=PERM      *-***-*          Year 2000 Compliance

    Previously, the EXP=PERM parameter of the MOD operation modified the file's
    expiry date to 99/365.

    The same  operation under  Release 9.8 changes  the file's  expiry date  to
    99/366,  which  is  always  considered  Permanent  by the operating system,
    irrespective of version/release.

    Consequently,  EXP=PERM may be used with both enabled and earlier  releases
    of VSE to modify the expiry date from 99/365 to 99/366,  therefore ensuring
    that files are not silently deleted on or after 31st December 1999.







VSE:  MOD DEV=cuu DSN=xxx.. EXP=TEMP      *-***-*          Year 2000 Compliance

    Documented only for completeness,   this operation continues to  change the
    file's expiry date to 01/001 as this is always interpreted by the operating
    system as 1st January 1901 (i.e. temporary).








All:  Local TIMESTMP for ICF and VSAM                                   *-***-*

    TIMESTAMP  information  may  now  be  displayed  after CBLVCAT has adjusted
    (+ or -) the stored Greenwich Mean Time (GMT) value by the value stored  in
    the system local offset (Zone).

    Set CBLNAME CBLVCSW9 X'02' bit on,  permanently in CBLNAME or as a run-time
    override, for the Local TIMESTMP facility.

    The system local offset value is controlled by the following:
             MVS - TIMEZONE W.hh.mm.ss in SYS1.PARMLIB(CLOCKnn).
             VSE - IPL Command  SET ZONE=WEST/hh/mm.
             VM  - TIMEZONE DEFINITION in SYSTEM CONFIG.

    ICF  and  VSAM  catalogs  hold  Timestamp  information  in  binary units of
    1.048576 seconds.  The local offset  in MVS and VM  is also held in  binary
    seconds, whereas VSE stores it in minutes.

    Consequently,  the  accuracy of  the seconds  value in  the reported  Local
    TIMESTMP is subject to rounding errors.  These may have been introduced  by
    CBLVCAT's conversion and adjustment routines.









ALL:  Variable-Length RRDS (VRDS) reporting                             *-***-*

    A Variable-Length Relative-Record DataSet appears to the application as  an
    RRDS file.  However,  internally  they are more like  a KSDS as the  system
    maintains an associated index.

    Although the acronym used in OS/390(MVS) is VRRDS,  for  brevity,   CBLVCAT
    uses the VSE/ESA acronym of VRDS.

    Consequently, they are reported in the TYPE column as follows:
                                 TYPE
                                 ----
                                 VRDS

    Previously, CBLVCAT reported a VRDS incorrectly as KSDS.









All:  SUBSET TYPE=V, TYPE=C and TYPE=M for VRDS                         *-***-*

    Subsetting on Variable-Length  Relative Record DataSets (VRDS)  is achieved
    by using the SUBSET TYPE=V parameter.

    SUBSET TYPE=C   includes   VRDS   and   is   now  the  same  as  specifying
    SUBSET TYPE=EKLPRSV
    (i.e. ESDS, KSDS, LDS, PAGESP, RRDS, SAM Managed and VRDS).

    SUBSET TYPE=M   includes   VRDS   and   is   now  the  same  as  specifying
    SUBSET TYPE=AEKRV
    (i.e. AIX, ESDS, KSDS, RRDS and VRDS).








All:  Secondary ICF/VSAM Extents (NSEC)                                 *-***-*

    NSEC always reports the number of extents, not allocations, since it is the
    number of extents which limits the expansion of the file.

      Terminology
      -----------
        Extent               - a contiguous area of disk space.
        Allocation           - the act of reserving 1 or more extents for a
                               file.
        Primary allocation   - the first attempt  to allocate  space for  a
                               file on a volume.  Such an allocation is for
                               the Primary Allocation amount.
        Secondary allocation - a second  or  subsequent  allocation attempt
                               caused by the expansion of the file. Such an
                               allocation is  for the  Secondary Allocation
                               amount.

    Each allocation,  Primary and  Secondary,  may be satisfied  with 1 or more
    extent(s). ICF and VSAM support up to 123 extents, except for VSAM REUSABLE
    files which are restricted to 16 extents per volume.

    Previously,  when Total Allocation was equal to Primary Allocation  CBLVCAT
    reported  NSEC as 0  even  when  the  Primary  Allocation had used multiple
    extents.   This  has  been  corrected  to  assist  the  user  to   identify
    fragmentation, i.e. more than 1 extent, of Primary Allocations.







ICF:  LC VVDS=volser  non-VSAM reporting                                *-***-*

    When listing the catalog entries  for an SMS controlled VVDS,   CBLVCAT now
    also reports  the limited  information contained  in the  VVDS relating  to
    non-VSAM datasets:
 __________________________________________________________________________________________________________________________________________
|                                                                                                                                          |
|   VVDS    CBLI20         TYPE      NRECS   PCNT  ---- ALLOC TRACKS ----   FRSP   LMAX  KL,RKP  CISIZE BUFSP EXCPS     TIMESTMP           |
| o ---------------------  ----      -----   ----    TOTAL   PRIME  SEC     CI CA  ---- /BLK/IMB ------ /IXL  -----     --------         o |
|                                                                                                                                          |
|   SYS1.SVCLIB            NONVSAM                 CAT=USERCAT.MVSV5R                                                                      |
| o SYS1.SCNMLNK1          NONVSAM                 CAT=USERCAT.MVSV5R                                                                    o |
|__________________________________________________________________________________________________________________________________________|

    Previously,   CBLVCAT  erroneously  reported  +99999 CI/CA SPLITS for these
    entries.






VSE:  LISTVTOC   RECFM column                                           *-***-*

    VSE  releases  up  to  VSE/ESA 2.2  do  not  record  the  file's   geometry
    (RECFM, LRECL and BLKSIZE) in disk VTOCs.

    Previously,  CBLVCAT  erroneously reported  RECFM=F for  all VSE SAM files,
    including those created as RECFM=V.

    This has been corrected.   CBLVCAT now interprets the  Format 1 VTOC record
    correctly and,  until  VSE is updated  to store such  information,  reports
    blanks in the RECFM column.






CBLNAME Fields/Attributes                                               *-***-*

    The following switches have been added to the Installation Standard program
    CBLNAME.  Switch settings are covered  in detail for the appropriate  topic
    within this document.

    The  following  summarises  the  changes  and  defaults  on  the   supplied
    object/load module.

         +X'9B' CBLVCSW9 DC X'00'      X'01' ON  - Reports with 2 digit years.
                                             OFF - Reports with 4 digit years.

                                       X'02' ON  - local TIMESTMP.
                                             OFF - GMT TIMESTMP.

                                       X'04' ON  - OPTION ISC.
                                             OFF - OPTION NOISC.

    Run time OPTIONS may be used for all CBLNAME switches.










New or Changed Messages                                                 *-***-*

              SEV 1-14   KSDS/AIX/VRDS HAS NO IMBEDDED FREE SPACE   (changed)
                         literal VRDS added to message.

              WARN 022   CONFLICTING CATALOG STATISTICS             (new)
                         Condition should not occur - contact CBL.







Zaps Applied                                                            *-***-*

    Zaps 01-04 of CBLVCAT Rel 9.7 have been applied at source:
              01  FAIL=IGN and ERR028 gave incorrect errors for MOD and DEL.
              02  0C1 for multiple LC DD= with superfluous EXTENT card.
              03  ERR051 for multiple LC DD= with superfluous parms on DLBL.
              04  DEFINE output could have incorrect RELATE value.


                                      --- End ---
