OS (Object to Sequential Data)
- Purpose
- Copy one or more OAM objects from a collection, or a primary or backup optical volume, to a sequential data set.
- Usage notes
- To copy only the data within an object, specify the collection
and the object name, and that you do not want a header record.
To create a backup of a single object, specify the collection and the object name, and that you want the header record. File Manager saves the object together with its directory information. Use the SO (Sequential Data to Object) function to restore the object.
To create a backup of multiple objects from a collection, a primary or backup optical volume, specify a generic object name. Specify the collection name, the volser of an optical volume, or both. File Manager saves the directory information of all objects copied. Use the SO (Sequential Data to Object) function to restore all, or selected, objects.
For more information about using this function, see Backing up OAM objects.
- 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.
Specify the block size to be used for the output records. The default block size is 4096 bytes, the maximum is 32760 bytes.
- 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
- blksize
- Block size for the output data set. The maximum is 32 760; the default is 4 096.
- 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.
- ddname
- Refers to a DD or TSO ALLOC statement. The default is QSAMOUT.
- disp
- Disposition of the output data set. Specify OLD, MOD, NEW, or
CAT for NEW,CATLG. The default is NEW. Note: SMS might modify the allocation of new data sets on your system. For details, contact your SMS Administrator.
- dsname
- Name of a sequential data set. If any DD statements are specified, they are not used. To further describe the data set, use the appropriate keywords as shown in the syntax diagram.
- fromdate
- The earliest creation date, in the form yyyymmdd. By default, all objects are copied regardless of their creation date.
- header
- If you are copying only one object, specify NO if you do not want a header record. The default is to put a header record at the beginning of the output data set.
- limit
- To limit the objects that are copied 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.
- member
- For a PDS, the member name.
- 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.
- space
- The number of tracks to be allocated for a new data set. Specify n or (n,m), where n is the number of primary tracks, and m is the number of secondary tracks.
- todate
- The latest creation date, in the form yyyymmdd.
- unit
- A 3 hexadecimal digit device number, a 4 hexadecimal digit device number prefixed by a slash (/), a device type, or an installation-defined group name.
- volser
- On input: if you specified VOLUME for limit,
the volume serial number of the optical disk.
On output: the volume serial number for a new or non-cataloged data set.
// JOB (acct),'name',Save collection on tape
//S1 EXEC PGM=FILEMGR
//BACKUP DD DSN='OBJECT.BACKUP',UNIT=CARTR,
// DISP=(NEW,CATLG)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
$$FILEM OS COLLECTN=SYSU.OAM.CLLCT000,
$$FILEM OUTPUT=BACKUP
$$FILEM EOJ
/*