GUIDELINE
4604.05

DISC
Bureau of
Information
Systems

 Effective
Date
01/04/2002
Review Date
01/2002

1.0 SUBJECT: Direct Access Storage Device (DASD) Listing Utility

2.0 DISTRIBUTION: All Current Users

3.0 FROM: Bruce Roberts, Director of DISC

4.0 PURPOSE: To provide information relative to the availability and use of direct access map listing utilities in the DISC OS/390 computer facility.

5.0 BACKGROUND: Presently, there exists a utility program named MAPUSER that allows agency users to list datasets stored on DISC maintained storage media. They do work for 3390s. The programs just don’t report space correctly if there are major extents involved.

6.0 PROCEDURE: To utilize the facilities of the DASD listing utilities, the following procedures are provided. Sample Job Control Language (JCL) is included following each of the descriptions.

    6.1 TSO ISMF panels can also be used to produce DASD dataset information.

    6.2 MAPUSER Utility Program - MAPUSER will read and list the VTOC information for any dataset or selected set of datasets which are referenced in the VTOC of any or all of the DASD volumes attached to the MVS computer system. All listings will be sorted alphabetically, in dataset name order.

    The MAPUSER program requires a PARM=’U=XX’ field, where XX is the qualifier used in the scan. The first two characters of that qualifier must be your agency’s 2 character qualifier as defined in Standard 4423. It may be followed by any number of subsequent qualifiers up to a maximum 44 characters. It must also match the first 2 characters of the job names on the JOB card. The U=XX field is positional and must be the last PARM entry if other keywords are included.

    The SYSOUT class defaults to the job card MSGCLASS parameter. You may override the PROC parameter, ‘SOUT=x, to change the SYSOUT class. Replace the x with desired output class.

    The PARM keywords available with the MAPUSER program include:

    PARM=’U=XX – This parm is required. It causes only those datasets beginning with XX to be listed. This is a positional keyword and must be the last entry in the PARM field. You must key a minimum 2 bytes but optionally may key a maximum 44 bytes to further restrict the listing.

    Example: PARM=’U=DA’

    PARMm=’CAT’ – Checks the catalog to see if this dataset is cataloged. The password R/W output column will be used to print the results of the catalog search. It will be blank if the dataset is not cataloged and "C" if cataloged. CAUTION: THIS REQUEST IS CPU INTENSIVE.

    Example: PARM=’CAT,U=DA’

    PARM=’JDATE’ – Lists the creation and expiration dates of datasets in Julian format.

    Example: PARM=’JDATE,U=DA’

    There are 2 PROCS available for use with this program. They are:

    MAPUSERA – Will include DASD volumes with user datasets on the states MVS system.

    Example:

    //USERVOL EXEC MAPUSERA, PARM=’CAT,U=DA’

    MAPUSER – This PROC is set up for a single volume search. PROC keywords are; V=VOLSER and U=UNIT. Multiple volumes may be specified by providing additional volume DD cards.

    Example: //USERVOL EXEC MAPUSER,V=KA0001,U=3380,

    // PARM=’CAT,U=DA’

    //VOLKA02 DD UNIT=3380,VOL=SER=KA0002,DISP=SHR

    //VOLKA03 DD UNIT=3380,VOL=SER=KA0003,DISP=SHR

7.0 HISTORY: This document was originally issued as Guideline 4604.00, effective 12/10/84. It was reissued on 03/01/91,11/10/91,06/02/95 and 04/25/96.

8.0 CONTACT PERSON: 
Deputy Director, Bureau of Information Services
785-296-3463