OS (オブジェクトから順次データ)

目的
1 つ以上の OAM オブジェクトを、コレクションから、あるいは基本またはバックアップ光ディスク・ボリュームから、順次データ・セットにコピーします。
使用上の注意
オブジェクト内のデータだけをコピーするには、コレクションとオブジェクト名を指定し、見出しレコードは不要であることを指定します。

単一オブジェクトのバックアップを作成するには、コレクションとオブジェクト名を指定し、見出しレコードが必要であることを指定します。File Manager は、オブジェクトをそのディレクトリー情報と一緒に保管します。SO (順次データからオブジェクト) 機能を使用して、オブジェクトを復元します。

複数のオブジェクトのバックアップを、コレクション、基本光ディスク・ボリュームまたはバックアップ光ディスク・ボリュームから作成するには、汎用オブジェクト名を指定します。コレクション名、光ディスク・ボリュームのボリューム通し番号、またはその両方を指定します。File Manager は、コピーされたすべてのオブジェクトのディレクトリー情報を保管します。SO (順次データからオブジェクト) 機能を使用して、すべてのオブジェクト、または選択されたオブジェクトを復元します。

この機能の使用について詳しくは、OAM オブジェクトのバックアップを参照してください。

オプション
処理を DASD ストレージ、光ディスク・ストレージ・メディア、または特定の光ディスク・ボリュームに存在するオブジェクトに制限します。作成日の範囲を指定することもできます。

出力レコードに使用するブロック・サイズを指定します。デフォルトのブロック・サイズは 4096 バイト、最大サイズは 32760 バイトです。

関連機能
OO
オブジェクトを、同じまたは別のコレクションにコピーします。
OV
OAM データベースから VSAM データ・セットにオブジェクトをバックアップします。
SO
データ・セットをオブジェクト・データベースにコピーします。
図 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
出力データ・セットのブロック・サイズ。最大は 32 760 であり、デフォルトは 4 096 です。
コレクション (collection)
コレクション名。バッチ・モードを除くいずれのモードでも、ユーザーの TSO 接頭部 (通常は、ユーザー ID) が、引用符で入力されなかったすべての名前の高位修飾子として使用されます。

デフォルトは、すべてのコレクションであり、この場合は、LIMIT=VOLUME および volser を指定する必要があります。volser.

ddname
DD または TSO ALLOC ステートメントを参照します。デフォルトは QSAMOUT です。
disp
出力データ・セットの後処理。OLD、MOD、NEW、または CAT (NEW,CATLG の場合) を指定します。デフォルトは、NEW です。
注: SMS がシステムの新規データ・セットの割り振りを変更する可能性があります。詳しくは、SMS 管理者にお問い合わせください。
dsname
順次データ・セットの名前。DD ステートメントが指定されている場合は、使用されません。データ・セットについてさらに記述する場合には、構文図に示されている適切なキーワードを使用します。
fromdate
yyyymmdd 形式による一番古い作成日。デフォルトでは、この作成日に関係なく、全オブジェクトがコピーされます。
header
1 つのオブジェクトのみをコピーする場合には、見出しレコードが不要であれば NO を指定します。デフォルトでは、出力データ・セットの先頭に見出しレコードを付けます。
limit
オブジェクトがどこにあったかに基づき、コピーするオブジェクトを制限する場合、 次のいずれかを指定します。
DASD
DASD に格納されているオブジェクトのみ。
OPTICAL
光ディスクに格納されているオブジェクトのみ。
VOLUME
指定した光ディスクに格納されているオブジェクトのみ。光ディスクのボリューム通し番号も指定する必要があります。
member
PDS の場合、メンバー名。
objmask
オブジェクト名または総称オブジェクト名。その名前の中で、パーセント記号 (%) で 1 文字分を表し、アスタリスク (*) で 1 つの修飾子の中の任意の数の文字 (または、文字なし) を表し、2 つのアスタリスク (**) で任意の数の修飾子内の任意の数の文字 (または、文字なし) を表すことができます。

バッチ・モードを除くいずれのモードでも、ユーザーの TSO 接頭部 (通常は、ユーザー ID) が、引用符で入力されなかったすべての名前の高位修飾子として使用されます。

デフォルトは ** です。バッチ・モードでは、これは全オブジェクトを意味し、その他のモードでは、高位修飾子としてユーザーの TSO 接頭部を持つすべてのオブジェクトを意味します。

space
新規データ・セットに割り振られるトラックの数。n または (n,m) を指定します。ここで n は、1 次トラックの数、m は 2 次トラックの数です。
todate
yyyymmdd 形式での、最新の作成日。
unit
3 桁の 16 進数からなる装置番号、接頭部がスラッシュ (/) の 4 桁の 16 進数からなる装置番号、装置タイプ、またはインストール・システムで定義されたグループ名。
volser
入力の場合、limit に VOLUME を指定している場合は、光ディスクのボリューム通し番号。

出力の場合、新規または非カタログ・データ・セットのボリューム通し番号。

// 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
/*