VO (VSAM to Object)

Purpose
Copy data from a VSAM data set to one or more OAM objects.
Usage notes
Use this function to copy data from a VSAM data set to an object database. If the input is a backup data set created with the OV (Object to VSAM) function, the object header records are used for restoring.

If loading from an object backup data set the objects are restored with the original name into the original collection. To filter loading, specify a collection name, a generic object name, the location (DASD or OPTICAL, or a specific optical volume), and a creation date range. The filter applies to the object header information saved with the objects.

If the input does not contain backup copies of multiple objects, one object is created. You can specify a collection name and an object name. If the input data begins with an object header record, the default values are taken from it. The object is made up of the concatenated input records, excluding any object header.

For more information about using this function, see Restoring OAM objects.

Options
You can specify SMS storage class and management class values to be used for storing the object; these might, however, be overridden by your installation defaults. You can also specify whether an existing object with matching name is to be replaced in the output collection.
Related functions
OO
Copy an object to the same or another collection
OV
Backup objects from an OAM database to a VSAM data set
SO
Copy a data set to an object database
Read syntax diagramSkip visual syntax diagram
Syntax

       .-INPUT=VSAMIN-.  .-COLLECTION=**---------.   
>>-VO--+--------------+--+-----------------------+-------------->
       +-INPUT=ddname-+  '-COLLECTION=collection-'   
       '-DSNIN=dsname-'                              

   .-OBJNAME=**------.                          
>--+-----------------+--+-------------------+------------------->
   '-OBJNAME=objmask-'  '-STORCLAS=storclas-'   

>--+-------------------+--+-------------+--+---------------+---->
   '-MGMTCLAS=mgmtclas-'  '-LIMIT=limit-'  '-VOLSER=volser-'   

>--+-------------------+--+---------------+--------------------->
   '-FROMDATE=fromdate-'  '-TODATE=todate-'   

   .-REPLACE=NO------.   
>--+-----------------+-----------------------------------------><
   '-REPLACE=replace-'   

collection
If the data set contains one object with a header, you can optionally specify a collection name to override the collection name in the header.

If the data set contains one object with no header (or, equivalently, it contains data that was not previously an object), you must specify the collection where the object is stored.

If the data set contains one or more objects that were stored during a multiple-object backup, you can optionally specify a collection name to restore only objects from the specified collection.

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.

ddname
Refers to a DD or TSO ALLOC statement. The default is VSAMIN.
dsname
Name of a VSAM data set.
fromdate
The earliest creation date, in the form yyyymmdd. By default, all objects are copied regardless of their creation date.
limit
To limit the objects that are copied based on where the objects were located (before they were backed up to a data set), specify one of the following:
DASD
Only objects that were stored on DASD
OPTICAL
Only objects that were stored on optical disks
VOLUME
Only objects that were stored on a specified optical disk. You must also specify the volser of the optical disk.
mgmtclas
Name of an SMS management class.
objmask
If the data set contains one object with a header, you can optionally specify an object name to override the object name in the header.

If the data set contains one object with no header (or, equivalently, it contains data that was not previously an object), you must specify a name for the object.

If the data set contains one or more objects that were stored during a multiple-object backup, you can optionally specify an object name or generic object name to limit the objects that are restored based on 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) with 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.

replace
Specify YES to replace any existing objects with the same name in the collection. By default, the object is not copied.
storclas
Name of an SMS storage class.
todate
The latest creation date, in the form yyyymmdd.
volser
If you specified VOLUME for limit, the volume serial number of the optical disk.