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 を使用する簡単な方法について説明します。

  1. PRINT 範囲を指定せずに、処理するパーティションで DSN1PRNT を実行します。FORMAT オプションを NODATPGS に設定します。データ・ページは印刷されず、スプール・スペースの使用量が減ります。
    //    EXEC  PGM=DSN1PRNT,
    //    PARM='FORMAT,NODATPGS,NUMPARTS(8)'
    //SYSUT1   DD DSN=DSNT6USR.DSNDBC.V9DS306.XV9D0000.I0001.A008,DISP=SHR

    印刷出力にはページ番号が含まれています。このページ番号を使用して、該当するページ番号によって別の DSN1PRNT ジョブをセットアップします。

  2. 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