DSN1PRNT 制御ステートメントのサンプル
以下の制御ステートメントのサンプルを、独自の DSN1PRNT 制御ステートメントを作成するためのモデルとして使用できます。
例 1: データ・セットを印刷し、出力をフォーマット設定する
次の例では、DSN1PRNT ユーティリティーが SYSUT1 DD ステートメントで示された データ・セットを印刷し、出力をフォーマット設定する指定を行っています。 データ・セットは、SYSPRINT DD ステートメントで示されるデータ・セットで印刷されます。データ・セット名の 5 番目のレベルの修飾子は、I0001 または J0001 のいずれかです。 この例では、I0001 が使用されています。
//jobname JOB acct info
//RUNPRNT EXEC PGM=DSN1PRNT,PARM='PRINT,FORMAT'
//STEPLIB DD DSN=prefix.SDSNLOAD
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DSN=DSNCAT.DSNDBC.DSNDB01.SYSUTILX.I0001.A001,DISP=SHR
例 2: 64 MB ピース・サイズの非パーティション索引を 印刷する
次の例では、DSN1PRNT が、ピース・サイズが 64 MB の非パーティション化索引の 61 番目の ピースの最初の 16 ページを印刷する指定を行っています。 印刷するページは、PRINT オプションで示されています。 これらのページ値は、サイズ 64 MB のデータ・セットには 4 KB のページが X'4000' あるということ に基づいて決められます。10 進数の 61 は X'3D' です。61 番目のピースの先頭ページのページ番号は、4000*(3D-1) = 4000*3C = F0000 です。61 番目のピースの最後の 16 ページを印刷するには、PARM=(PRINT(F3FF0,F3FFF), ...) と指定します。
データ・セット名の 5 番目のレベルの修飾子は、I0001 または J0001 のいずれかです。 この例では、I0001 を使用します。
//PRINT2 EXEC PGM=DSN1PRNT,
// PARM=(PRINT(F0000,F000F),FORMAT,PIECESIZ(64M))
//SYSUDUMP DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DISP=OLD,DSN=DSNCAT.DSNDBD.MMRDB.NPI1.I0001.A061
例 3: イメージ・コピーの 1 ページを印刷する
次の例では、DSN1PRNT がイメージ・コピーの 1 ページを印刷する指定を行っています。 イメージ・コピーは、SYSUT1 DD ステートメントによって示され ます。PRINT オプションは、印刷するページは X'1' のみであることを指定しています。
//STEP2 EXEC PGM=DSN1PRNT,
// PARM='PRINT(1),FORMAT,INLCOPY'
//STEPLIB DD DSN=DB2A.SDSNLOAD,DISP=SHR
//SYSUDUMP DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DSN=HUHYU205.L1.STEP1.DD2,DISP=SHR
例 4: 区分データ・セットを印刷する
次の例では、DSN1PRNT が、SYSUT1 DD ステートメントで示された データ・セットを印刷する指定を行っています。 このデータ・セットは LARGE オプションで定義された表スペースである ため、DSN1PRNT のパラメーター・リスト中に DSSIZE(4G) オプションが指定されています。代わりに、LARGE オプションをこのリストで指定できますが、DSSIZE(4G) を指定する方を お勧めします。 この表スペースには、NUMPARTS オプションで示されているように、260 のパーティションがあります。
//RUNPRNT1 EXEC PGM=DSN1PRNT,
// PARM='DSSIZE(4G),PRINT,NUMPARTS(260),FORMAT'
//STEPLIB DD DSN=DB2A.SDSNLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DSN=DSNCAT.DSNDBC.DBOM0301.TPOM0301.I0001.A259,DISP=SHR
/*
例 5: 特定のパーティションのページ範囲の印刷
パーティション化表スペースの特定のパーティションのページ番号を判別するのは困難です。
この例では、ページ番号を計算する必要がない、DSN1PRNT を使用する簡単な方法について説明します。
- PRINT 範囲を指定せずに、処理するパーティションで DSN1PRNT を実行します。FORMAT オプションを NODATPGS に設定します。データ・ページは印刷されず、スプール・スペースの使用量が減ります。
// EXEC PGM=DSN1PRNT, // PARM='FORMAT,NODATPGS,NUMPARTS(8)' //SYSUT1 DD DSN=DSNT6USR.DSNDBC.V9DS306.XV9D0000.I0001.A008,DISP=SHR印刷出力にはページ番号が含まれています。このページ番号を使用して、該当するページ番号によって別の DSN1PRNT ジョブをセットアップします。
- PRINT 範囲を指定して、パーティション 8 で DSN1PRNT を実行します。
// EXEC PGM=DSN1PRNT, // PARM='PRINT(xx000000,xx000020),FORMAT,NUMPARTS(8)' //SYSUT1 DD DSN=DSNT6USR.DSNDBC.V9DS306.XV9D0000.I0001.A008,DISP=SHRページ範囲は、16 進形式で指定する必要があります。
例 6: DSN1PRNT の Unicode 出力の指定
DSN1PRNT に対し UNICODE オプションを指定すると、日本語文字など、非ラテン Unicode 文字が出力で表示されなくなります。UNICODE オプションを指定すると、DSN1PRNT は、16 進データを取得し、それをデフォルトの EBCDIC ではなく ASCII としてフォーマットします。
DSN1PRNT で処理するデータが UTF-16 のとき、問題が発生する場合があります。UTF-16 データの場合、DSN1PRNT はデータの第 2 バイトのみ取得し、データのその部分を ASCII としてフォーマットします。したがって、出力は正しくない場合があります。例えば、UTF-16 の 16 進値である X'0030' と X'1130' は、どちらも 0 として出力されます。これは、それぞれの第 1 バイト (「00」および「11」) が無視されるためです。残りの部分 (「30」) は ASCII の 0 として解釈されます。UTF-16 では、X'0030' は 0 を示す 16 進値で、一方 X'1130' はハングル文字を示す 16 進値です。UTF-16 フォーマットの詳細については、UTFを参照してください。
次の DSN1PRNT の例では、3 つの太字の 16 進値 (X'0041'、X'0141'、および X'0241') に注意してください。これらの 3 つすべての値の出力は、それぞれが UTF-16 では異なる文字に対応しているのにも関わらず、A.A.A となります。(X'0041' は A、X'0141' は Ł、X'0241' は声門閉鎖音を示すラテン語の大文字です。)
//STEP1 EXEC PGM=DSN1PRNT,
// PARM='FORMAT,PRINT(002),UNICODE'
//STEPLIB DD DSN=DB2A.DSNLOAD,DISP=SHR
//SYSUDUMP DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//SYSOUT DD SYSOUT=A
//SYSABEND DD SYSOUT=A
//SYSUT1 DD DSN=TESTCAT.DSNDBC.DBED2101.TPED2101.I0001.A001,DISP=SHR
/*
DSN1999I START OF DSN1PRNT FOR JOB DSN1PRNT RUNPRNT9
DSN1989I DSN1PRNT IS PROCESSED WITH THE FOLLOWING OPTIONS:
4K/NO IMAGECOPY/NUMPARTS = 0/ FORMAT/NO EXPAND/ PRINT/NO VALUE/ / /
DSSIZE= /PIECESIZ= /UNICODE/
DSN1998I INPUT DSNAME = TESTCAT.DSNDBC.DBED2101.TPED2101.I0001.A001 , VSAM
PAGE: # 00000002 --------------------------------------------------------------------------------
DATA PAGE: PGCOMB='10'X PGLOGRBA='0000758C9455'X PGNUM='00000002'X PGFLAGS='00'X PGFREE=4041
PGFREE='0FC9'X PGFREEP=51 PGFREEP='0033'X PGHOLE1='0000'X PGMAXID='01'X PGNANCH=1
PGTAIL: PGIDFREE='00'X PGEND='N'
ID-MAP FOLLOWS:
01 0014
RECORD: XOFFSET='0014'X PGSFLAGS='02'X PGSLTH=31 PGSLTH='001F'X PGSOBD='0003'X PGSBID='01'X
80000001 00004101 41024100 20002000 20002000 20002000 20 ......A.A.A. . . . . . .
DSN1994I DSN1PRNT COMPLETED SUCCESSFULLY, 00000001 PAGES PROCESSED