ODL (Object Directory List)

Purpose
Work with a list of OAM objects from the specified collection or optical disk.
Usage notes
You can print the list.

Select the objects by a fully-qualified or a generic object name. Specify the collection name, the volser of an optical volume, or both.

The information listed by ODL includes:
  • Object name
  • Creation timestamp
  • Object size
  • Storage location (DASD or Library)
  • Volser information (if known)
  • Storage class
  • Management class
  • Expiration date
Options
Limit processing to objects residing in DASD storage, on optical storage media, or on a specific optical volume. You can also specify a range for the creation date. The information displayed can be sorted by name, creation date, size or expiration date.
Related functions
OE
Erase an OAM object
OO
Copy an object to the same or another collection
OP
Print an object in character or hexadecimal dump format
OS
Backup objects from an OAM database to a data set
OV
Backup objects from an OAM database to a VSAM data set
Read syntax diagramSkip visual syntax diagram
Syntax

        .-COLLECTN=**---------.  .-OBJNAME=**------.   
>>-ODL--+---------------------+--+-----------------+------------>
        '-COLLECTN=collection-'  '-OBJNAME=objmask-'   

>--+-------------+--+---------------+--+-------------------+---->
   '-LIMIT=limit-'  '-VOLSER=volser-'  '-FROMDATE=fromdate-'   

                      .-SORTBY=NAME---.   
>--+---------------+--+---------------+------------------------->
   '-TODATE=todate-'  '-SORTBY=sortby-'   

   .-FUNCTION=LIST-----.   
>--+-------------------+---------------------------------------><
   '-FUNCTION=function-'   

collection
A collection name. In any mode except batch mode, the user's TSO prefix (normally the user ID) is used as the high-level qualifier for any name that is not entered in quotation marks.

The default is all collections; in this case, you must specify LIMIT=VOLUME and a volser.

fromdate
The earliest creation date, in the form yyyymmdd. By default, all objects are listed regardless of their creation date.
function
The command that you want to execute:
LIST
Display the list (the default)
PRINT
Print the list.
limit
To limit the list based on where objects are located, specify one of the following:
DASD
Only objects that are stored on DASD
OPTICAL
Only objects that are stored on optical disks
VOLUME
Only objects that are stored on a specified optical disk. You must also specify the volser of the optical disk.
objmask
An object name or generic object name. Within the name, you can include a percent sign (%) to represent exactly one character, an asterisk (*) to represent any number of characters (or no characters) within a qualifier, or two asterisks (**) to represent any number of characters (or no characters) within any number of qualifiers.

In any mode except batch mode, the user's TSO prefix (normally the user ID) is used as the high-level qualifier for any name that is not entered in quotation marks.

The default is **. In batch mode, this means all objects; in any other mode, this means all objects that have the user's TSO prefix as high-level qualifier.

sortby
One of the following:
NAME
Sorts by object name (the default)
DATE
Sorts by creation date
EDATE
Sorts by expiration date
SIZE
Sorts by object size.
todate
The latest creation date, in the form yyyymmdd.
volser
If you specified VOLUME for limit, the volume serial number of the optical disk.
//JOB (acct),'name',Optical Volume Contents
//S1       EXEC PGM=HFMMAIN
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
$$FILEM ODL LIMIT=VOLUME,VOLSER=VBKUP6
$$FILEM EOJ
/*