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
Figure 1. Syntax

1 OS
1! COLLECTN=**
1 COLLECTN=collection
1! OBJNAME=**
1 OBJNAME=objmask
3? LIMIT=limit
3? VOLSER=volser
3? FROMDATE=fromdate
3? TODATE=todate
1! OUTPUT=QSAMOUT
1 OUTPUT=ddname
1 DSNOUT=dsname?(member) %Output data set parameters
1! HEADER=YES
1 HEADER=header
1! BLKSIZE=4096
1 BLKSIZE=blksize
Output data set parameters

1? VOLSEROUT=volser? UNITOUT=unit
1! DISP=NEW
1 DISP=disp
2? SPACE=space
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
/*