DFSMS/VM Year 2000 Appendix


Product Number: 5706-116 FL 221

Table of Contents

Year 2000 Enhancements for DFSMS/VM

  • Fixed Window Date Usage
  • Saved ISMF Lists
  • DFSMS COPY and MOVE commands
  • DFSMS/VM Generated Reports
  • DFSMS CHECK Command Report
  • DFSMS REPORT Command Report
  • Removal of ISMF Alphabetic Restriction on Directory Names

    • Year 2000 Enhancements for DFSMS/VM

    APAR VM61214 provides year 2000 support and enhancements for DFSMS/VM in the following areas:

    • Fixed window usage has been standardized to 1950-2049.
    • The List Date column on the Saved ISMF Lists Panel has been extended to 10-characters.
    • DFSMS COPY and MOVE commands will set the century bit in the minidisk label accordingly.
    • Several ISMF help messages have been extended for 4-digit years.
    • Several reports have been enhanced to include 4-digit years.
    • Corrected problems occurring around the roll over to 2000-01-01.
    • Removed the ISMF restriction on the first character of a directory name must be alphabetic.

    Fixed Window Date Usage

    DFSMS/VM FL 221 uses dates quite extensively. It uses diagnose x'0C' to obtain the current system date then converts it to 10-character through a 1950-2049 fixed window. This means that all 2-digit years that are between 50 and 99 inclusive will be interpreted as 1950-1999. All 2-digit years that are between 00 and 49 inclusive will be interpreted as 2000-2049. This is applied when:
    • displaying a date to a panel
    • migrating or recalling files
    • determining file expiration
    • sorting based on date in panels
    • filtering
    • 10-character dates contained within reports.
    Warning!
    If running the space management portion of DFSMS/VM, the SFS filepool servers must be at least VM/ESA Version 2 Release 2.0 (or higher). The DFSMS/VM master and space management servers can be on an older release of VM/ESA. The problem is that a pre-year 2000 level of SFS does not update the last reference date past 12/31/1999.

    Saved ISMF Lists

    The DFSMS/VM ISMF application 'Saved ISMF Lists Panel' (panel ID DGTLLLA1) was displaying 8-character dates in the 'List Date' field. User written extensions can obtain the value of this field through the CLUDATE ISPF variable.

    The List Date field has been extended to display 10-character dates in the form yyyy/mm/dd. This date is contained within a new ISPF variable called CLU4DATE. The CLUDATE variable is still available as 8-characters.

    Table 1 within the "ISMF Variables" appendix of the DFSMS/VM FL 221 STORAGE ADMINISTRATION GUIDE AND REFERENCE manual has been enhanced to include the CLU4DATE variable. Table 1 lists available column variables for use in any user extensions written for operations against Saved ISMF Lists panel entries.
    Table 1. Column Variables for the Saved ISMF Lists Panel

    Column Variable Name Attribute Length
    Display flag CDISPFLG character 1
    Filter flag CFILTFLG character 1
    Hide flag CHIDEFLG character 1
    Line operator CLINEOP character 10
    List name COBJ character 8
    List type CLLTYPE character 8
    List date CLU4DATE character 10
    List time CLUTIME character 8
    List user CLLUSER character 8
    List row count CLLRCNT character 8
    List update CLLUPD character 8
    Short message CSMSG character 35
    Long message CLMSG character 79
    (Not Displayed) CLUDATE character 8

    The Saved Lists Filter Entry Panel (panel ID DGTDLFI1), which is reached by issuing the filter command without any operands on the Saved ISMF List Panel, has been enhanced to accept 10-character dates in the List Date Value fields. The filter panel will still accept 8-character dates as input, converting them to 10-character dates using the 1950-2049 fixed window.

    The following additional changes have been made for the Saved ISMF List panel:

    • Help files for the Saved Lists Filter Entry Panel have been updated to show that a 10-character value can be entered for the List Date fields.
    • Message DGTUV008, displayed when a date provided with the filter command on the Saved ISMF Lists Panel or File List Panel is not 8- or 10-characters long or when the date specified is not within the 1950-2049 fixed window, has been enhanced as follows:
      Short Message: INVALID DATE
      Long Message: Date must be of the form YY/MM/DD or YYYY/MM/DD
      Explanation: The date you specified is not in the correct format. The date must be in the form YY/MM/DD or YYYY/MM/DD, where YY is the 2-digit year or YYYY is the 4-digit year, MM is the numeric month of the year, and DD is the numeric day of the month. The date cannot be before the year 1950 or after the year 2049.
    • The sample PRNTMINI exec, used on the Saved ISMF Lists Panel to obtain information regarding a saved minidisk list, has been enhanced to use the CLU4DATE in the generated ISMFLIST file. In addition, the PRINTED field contained in the header portion of the ISMFLIST file is now 10-characters in the form yyyy/mm/dd. Figure 1 shows an an example of the extended date fields.

      Figure 1. Sample PRMTNINI EXEC Output


      ------------------------------------------------------------------------
--               ISMF MINIDISK LIST: GEERDISK                          -
--                                                                     -
--  PRINTED: 2000-01-05  AT: 04:59 HRS.                                -
--       BY: GEER                                                      -
--                                                                     -
--  UPDATED: 1998-01-16  AT: 13.02.34 HRS.                             -
--       BY: GEER                                                      -
------------------------------------------------------------------------
 LINE       MDISK    MDISK MDISK   MDISK   MDISK   MDISK   DEVICE DEVICE  DUPLEX   DASD FW  RD CACHE CACHE FW
 OPERATOR   OWNERID  ADDR   START    END    SIZE    GAP    VOLSER  TYPE    STATUS   STATUS   STATUS   STATUS
 ---(1)---- --(2)--- -(3)- --(4)-- --(5)-- --(6)-- --(7)-- --(8)- --(9)-  --(10)-- --(11)-- --(12)-- --(13)--
            GEER      191      158     162       5 "------ SYS001 3380    "------- "------- "------- "-------
 
------------------------------------------------------------------------------------------------------------
--                           END OF LIST                               -
--  MINIDISKS LISTED-1                                                 -
--                                                                     -
------------------------------------------------------------------------------------------------------------

    • The explanation portion of messages DGTUV011, DGTUV095, and DGTUV096 have been enhanced to indicate the date field can be entered in the form YY/MM/DD or YYYY/MM/DD.

    DFSMS COPY and MOVE commands

    When using the DFSMS MOVE command to move data from one minidisk to another, there is an option to keep the original create date for the minidisk. These commands have been enhanced to properly set the century bit field within the CMS minidisk label control block. The century bit is used by VM/ESA Version 2 Release 2.0 (or higher), and ignored on older releases.

    DFSMS/VM Generated Reports

    Date in some reports, but not all, were updated from 8-character to 10-character.

    DFSMS CHECK Command Report

    The date created and last changed fields of the report generated by the DFSMS CHECK command have been extended to 10-character dates in the form yyyy/mm/dd. Figure 2 shows an an example of the extended date fields. Figure 2. Sample DFSMS CHECK report


    Userid:  DGTSRV01  Date:  01/05/2000   Time:  05:21:15
CHECK   0500 ( FILE TYPE FOR GEER     AS 191
Address:  0500  Device Type:  3380  Date Created:  1997-09-23 10:41:06
Volid:  GEE019  Block size:  4096  Last Changed:  2000-01-05 05:21:00
Cyls:      5  Usable Cyls:      5
 
Total number of CMS blocks:       750
Number of CMS blocks used:        239   ( 32%)
CMS blocks counted:               239
Blocks in allocation map:         239
 
Lost CMS blocks:                    0
Invalid CMS blocks:                 0
Overlapping CMS blocks:             0
 
Disk origin pointer:                5
Files reported in directory:       19 (Including DIRECTOR and ALLOCMAP)
Number of files found:             19
 
Command CHECK  gave return code =   0

    Examples of the DFSMS CHECK command report can be found in "Sample Check Output" figure within the "Moving and Checking CMS minidisks" chapter and "Example of the DFSMS Command Output" figure within the "DFSMS/VM Commands" chapter of DFSMS/VM FL 221 STORAGE ADMINISTRATION GUIDE AND REFERENCE manual, and in "Step 1: Verify Code in the User's Machine" section within the "Verifying the Installation Process" chapter of DFSMS/VM FL 221 Installation and Customization manual.

    DFSMS REPORT Command Report

    The date migrated and date last referenced fields of the report generated by the DFSMS REPORT command have been extended to 10-character dates in the form mm/dd/yyyy. Figure 3 shows an an example of the extended date fields.

    Figure 3. Sample DFSMS REPORT report


    DFSMS Function Level 221                             01/05/2000 05:35:09
DFSMS REPORT SPACEMANAGEMENT FILESPACE, request identifier 114
 
DFSMS REPORT SPACEMANAGEMENT FILESPACE processing started for file pool DFSMS1 and userid TEST
 
 
Files migrated for this file space:                                        123
   Migration Level 1:                                           102
   Migration Level 2:                                            21
Logical 4K blocks currently in use by this file space:                     143
Physical 4K blocks in use by this file space:                              141
Physical 4K blocks in use by primary storage for this file space:           20
Physical 4K blocks in use by secondary storage for this file space:        121
   Migration Level 1:                                           100
   Migration Level 2:                                            21
Physical 4K blocks saved for this file space due to compaction:              2
 
 
The following files are migrated:
 
                    Primary   Management  Date Last      Date   Migration
Filename Filetype  4K Blocks    Class     Referenced   Migrated   Level
 
Directory DFSMS1:TEST.
 
TEST     TEST              1   MEDIUM     01/02/2000   01/05/2000   2
TEST2    TEST              1   MEDIUM     01/03/2000   01/05/2000   2
·
·
·
 
 
The following files are migrated but DFSMS has migrated data in both ML1 and ML2:
 
                    Primary   Management  Date Last      Date   Migration  Token for
Filename Filetype  4K Blocks    Class     Referenced   Migrated   Level    Delete Command
 
Directory DFSMS1:TEST.
 
TEST3    TEST              1   LONG       01/03/2000   01/05/2000  1&2     00030000000001DD
TEST4    TEST              1   LONG       01/03/2000   01/05/2000  1&2     00030000000001D9
 
 
The following files are migrated but no migrated data exists for them:
 
                    Primary   Management  Date Last
Filename Filetype  4K Blocks    Class     Referenced
 
Directory DFSMS1:TEST.
 
TEST     EXEC              1   LONG       01/02/2000
TEST     FILE              1   LONG       01/02/2000
 
DFSMS REPORT SPACEMANAGEMENT FILESPACE completed with no errors

    Examples of the DFSMS REPORT command reports can be found in "Example of Reporting on a File Space" section and "Example of Reporting on a Storage Group" section within the "Managing Storage Using DFSMS/VM" chapter, and the "DFSMS Report" section within the "DFSMS/VM Commands" chapter of DFSMS/VM FL 221 STORAGE ADMINISTRATION GUIDE AND REFERENCE manual.

    Removal of ISMF Alphabetic Restriction on Directory Names

    The ISMF component restricted the first character of a directory name to be alphabetic only, it could not be numeric. This restriction has been removed. The following ISMF help messages have been enhanced:

    • Message DGTVM037 issued when any character of a directory name is detected as not valid input on the ACS Test Case Define Panel or the ACS Test Case Alter Panel:
      Short Message: INVALID DIRECTORY
      Long Message: Must be 1 to 16 alphanumeric characters
      Explanation: You entered an invalid directory. The directory id can be from 1 to 16 characters. Each character can be alphabetic or numeric.
    • The explanation portion of messages DGTVM016, DGTVM017, DGTVM024, DGTVM036, DGTVM042, DGTVM043, and DGTVM045 have been enhanced to indicate a directory qualifier can be from 1 to 16 characters and each qualifier character can be alphabetic or numeric.