印刷装置書き出しPGM開始 (STRPRTWTR)

印刷装置書き出しプログラム開始(STRPRTWTR)コマンドは,指定された印刷装置に対してスプール書き出しプログラムを開始します。システム・ジョブである書き出しプログラムは,出力待ち行列からスプール・ファイルを取り出して印刷装置上で出力を作成します(書き出します)。このコマンドでは,印刷装置の名前,使用する出力待ち行列とメッセージ待ち行列の名前,および書き出しプログラムの名前を指定します。

同時に複数の書き出しプログラムを活動状態にすることができ(スプーリング・サブシステム記述で決められる),同じ出力待ち行列に対して最大10個の書き出しプログラムを活動状態にすることができます。各書き出しプログラムは固有の書き出しプログラム名および独自の装置を持っていなければならず,1つの出力待ち行列に対して1つのタイプの書き出しプログラム(印刷,リモート,またはディスケット)を活動状態にすることができます。開始された書き出しプログラムは,出力を活発に書き出したり,あるいは出力待ち行列にファイル項目が入れられるのを待機することができます。書き出しプログラム変更(CHGWTR)コマンド,書き出しプログラム保留(HLDWTR)コマンド,あるいは書き出しプログラム終了(ENDWTR)コマンドを使用することにより,書き出しプログラムを変更,保留,または取り消すことができます。各書き出しプログラムはそれを開始したジョブとは独立して実行するので,書き出しプログラムの開始後,システムで他の作業を続行することができます。

パラメーター

キーワード 記述 選択項目 ノーツ
DEV 印刷装置 名前, *ALL, *SYSVAL 必須, 定位置 1
OUTQ 出力待ち行列 単一値: *DEV
その他の値: 修飾オブジェクト名
オプショナル, 定位置 2
修飾子 1: 出力待ち行列 名前
修飾子 2: ライブラリー 名前, *LIBL, *CURLIB
MSGQ 書出プログラムMSG用待ち行列 単一値: *DEVD, *REQUESTER
その他の値: 修飾オブジェクト名
オプショナル, 定位置 4
修飾子 1: 書出プログラムMSG用待ち行列 名前
修飾子 2: ライブラリー 名前, *LIBL, *CURLIB
FORMTYPE 用紙タイプ・オプション 要素リスト オプショナル
要素 1: 用紙タイプ 文字値, *ALL, *STD, *FORMS
要素 2: メッセージ・オプション *INQMSG, *MSG, *NOMSG, *INFOMSG
FILESEP ファイル区切り 0-9, *FILE オプショナル
SEPDRAWER 区切りページの用紙入れ 1-255, *DEVD, *FILE オプショナル
WTR 書き出しプログラム 名前, *DEV オプショナル, 定位置 3
AUTOEND 自動終了オプション 要素リスト オプショナル, 定位置 5
要素 1: 書き出しプログラムの自動終了 *NO, *YES
要素 2: 終了条件 *NORDYF, *FILEEND
ALWDRTPRT 直接印刷可能 *NO, *YES オプショナル
ALIGN ページの位置合わせ *FILE, *WTR, *FIRST オプショナル
INIT 印刷装置初期設定 *WTR, *FIRST, *ALL オプショナル
FILE スプール・ファイル 名前, *NONE, *LAST オプショナル
JOB ジョブ名 単一値: *
その他の値: 修飾ジョブ名
オプショナル
修飾子 1: ジョブ名 名前
修飾子 2: ユーザー 名前
修飾子 3: 番号 000000-999999
SPLNBR スプール・ファイル番号 1-999999, *ONLY, *LAST, *ANY オプショナル
JOBSYSNAME ジョブ・システム名 名前, *ONLY, *CURRENT, *ANY オプショナル
CRTDATE 作成されたスプール・ファイル 単一値: *ONLY, *LAST
その他の値: 要素リスト
オプショナル
要素 1: 作成日 日付
要素 2: 作成時刻 時刻, *ONLY, *LAST
PAGE 開始ページ 整数, *BEGIN オプショナル

印刷装置 (DEV)

スプール・ファイルの印刷に使用する印刷装置を指定します。装置は,書き出しプログラムを開始する前に使用可能でなければなりません。

これは必須パラメーターです。

*ALL
システムで構成されたすべての印刷装置に印刷装置書出プログラムを開始します。
*SYSVAL
システムの省略時の印刷装置に印刷装置書出プログラムを開始します。
名前
開始されている印刷装置を識別する名前を指定します。

出力待ち行列 (OUTQ)

書き出しプログラムが処理するスプール・ファイルの出力待ち行列を指定します。

単一値

*DEV
印刷装置 (DEV)パラメーターに指定された印刷装置と関連した省略時の出力待ち行列を使用します。

修飾子1: 出力待ち行列

名前
書き出しプログラムが処理するスプール・ファイルの出力待ち行列の名前を指定します。

修飾子2: ライブラリー

*LIBL
最初に一致するものが見つかるまで,現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。
*CURLIB
出力待ち行列を見つけるために,ジョブの現行ライブラリーが使用されます。ライブラリー・リストに現行ライブラリー項目がない場合には,QGPLが使用されます。
名前
出力待ち行列が入っているライブラリーの名前を指定してください。

書出プログラムMSG用待ち行列 (MSGQ)

このユーザーによって使用されるメッセージ待ち行列を指定します。

単一値

*DEVD
メッセージは,印刷装置の装置記述で指定されているメッセージ待ち行列に送られます。
*REQUESTER
メッセージは,処理を開始したユーザーのワークステーションのワークステーション・メッセージ待ち行列に送られます。この値をバッチ・ジョブに指定する場合には,*DEVDを使用します。

修飾子1: 書出プログラムMSG用待ち行列

名前
書き出しプログラム・メッセージを送信する必要があるメッセージ待ち行列の名前を指定します。

修飾子2: ライブラリー

*LIBL
最初に一致するものが見つかるまで,現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。
*CURLIB
メッセージ待ち行列を見つけるために,ジョブの現行ライブラリーが使用されます。ライブラリー・リストに現行ライブラリー項目がない場合には,QGPLが使用されます。
名前
メッセージ待ち行列が入っているライブラリーの名前を指定してください。

用紙タイプ・オプション (FORMTYPE)

印刷のために選択する用紙タイプを指定します。このパラメーターは,この時点でこの用紙タイプのファイルだけが処理されることを指定します。他のすべてのファイルは使用可能なファイルとして出力待ち行列に残されます。書き出しプログラムの開始後に,印刷する用紙のタイプを変更したい場合には,書き出しプログラム変更(CHGWTR)コマンドを使用してください。

注: 印刷されるスプール・ファイルの用紙タイプが装置で印刷された最後のスプール・ファイルの用紙タイプと異なっている時には,用紙装てんメッセージが出されます。最後に印刷された用紙タイプは最後に出されたSTRPRTWTR, CHGWTR,またはVRYCFG以降のものが保持されます。

次の例を考慮してください。

  1. 印刷装置PRT01で最後に印刷されたスプール・ファイルの用紙タイプは*STDです。
  2. ユーザーは,次のコマンドを使用してPRT01の用紙タイプをXYZに変更します。

    CHGWTR  PRT01  FORMTYPE(XYZ)
    

  3. 用紙タイプXYZのスプール・ファイルはPRT01で印刷されません。
  4. その後ユーザーは,用紙タイプ*STDのスプール・ファイルをPRT01に送ります。PRT01で最後に印刷されたスプール・ファイルの用紙タイプは印刷中のスプール・ファイルの用紙タイプと同じであるので,介在するCHGWTRコマンドにもかかわらず,用紙装てんメッセージが出されません。

    用紙タイプXYZのスプール・ファイルが実際にPRT01で印刷される場合には,用紙装てんメッセージが出されることになります。

要素1: 用紙タイプ

*ALL
用紙タイプにかかわりなく出力待ち行列上の使用可能なすべてのファイルが処理されます。
*FORMS
出力待ち行列上で同じ用紙タイプの使用可能なすべてのファイルは,書き出しプログラムが次の用紙タイプに進む前に1グループとして処理されます。書き出しプログラムは,まず待ち行列上で最初に使用可能なファイルを選択します。最初のファイルが完了すると,同じ用紙タイプのすべてのファイルが処理されます。書き出しプログラムは,次にもう一度待ち行列上の最初の使用可能なファイルを選択し,その用紙タイプについて処理を反復します。
*STD
書き出しプログラムは,用紙タイプ*STDのスプール・ファイルを処理します。
用紙タイプ
処理したいスプール・ファイルの用紙のタイプを指定してください。

要素2: メッセージ・オプション

*INQMSG
スプール・ファイルの用紙タイプが印刷装置の用紙タイプと異なっている時には,照会メッセージがメッセージ待ち行列に送られます。
*INFOMSG
この用紙タイプを必要とするスプール・ファイルが出力待ち行列に残っていない時には,通知メッセージがメッセージ待ち行列に送られます。
*MSG
スプール・ファイルの用紙タイプが印刷装置の用紙タイプと異なっている時には,照会メッセージがメッセージ待ち行列に送られ,この用紙タイプを必要とするスプール・ファイルが出力待ち行列に残っていない時には,通知メッセージが送られます。
*NOMSG
照会メッセージも,通知メッセージもメッセージ待ち行列に送られません。

ファイル区切り (FILESEP)

各ファイルの前に印刷されるファイル区切りページの数を制御する方法を指定します。

*FILE
各個別のファイルに指定された区切りの数が使用されます。
0から9
印刷する区切りページの数を指定します。新しい用紙タイプが印刷装置に入れられたことを示す用紙タイプ変更メッセージに応答する時はいつでも,書き出しプログラムは,新しい用紙タイプで印刷する必要があるファイル区切りページ数を尋ねるメッセージを出します。

区切りページの用紙入れ (SEPDRAWER)

ジョブおよびファイル区切りの印刷のために選択する用紙入れを指定します。

*DEVD
印刷装置の装置記述に記憶された値が使用されます。
*FILE
区切りページはスプール・ファイルと同じ用紙入れから印刷されます。
1
区切りページは用紙入れ1から印刷されます。
2
区切りページは用紙入れ2から印刷されます。
3
区切りページは用紙入れ3から印刷されます。
1から255
区切りページを印刷する用紙入れを指示する番号を指定してください。

注: 一部の印刷装置の場合には,SEPDRAWER(3)は封筒引き出しを暗黙のうちに指定します。

書き出しプログラム (WTR)

開始するスプール書き出しプログラムの名前を指定します。各書き出しプログラム名は固有でなければなりません。

*DEV
書き出しプログラムの名前は,印刷装置 (DEV)パラメーターに指定された印刷装置の名前と同じです。
名前
開始する書き出しプログラムを識別する名前を指定してください。

自動終了オプション (AUTOEND)

書き出しプログラムを自動的に終了するかどうかを指定します。

要素1: 書き出しプログラムの自動終了

*NO
出力待ち行列から最後に使用可能なファイルが取り出されても,書き出しプログラムは終了しません。別のスプール・ファイルの項目が待ち行列に入れられるのを待機します。
*YES
書き出しプログラムは,このパラメーターの2番目の部分で指定された状態に達した後に,自動的に終了します。

要素2: 終了条件

*NORDYF
書き出しプログラムは,実行可能なファイルがなくなった(出力待ち行列から使用可能なすべてのファイルが除去された)時点で自動的に終了します。
*FILEEND
書き出しプログラムは,1つのスプール・ファイルの処理を完了した後で停止します。

直接印刷可能 (ALWDRTPRT)

印刷装置に直接印刷するファイルの印刷装置書出プログラムを可能にするかどうか指定します。ファイルの直接印刷は印刷装置に印刷装置ファイルのSPOOL(*NO)を指定することによって作成されます。直接印刷が許可されており,印刷装置が使用可能な場合には,非スプールの印刷ファイルがすぐに印刷されます。印刷装置が使用中の場合には,非スプール印刷ファイルは印刷装置が使用可能になるまで待機します。最大の待ち時間は印刷装置ファイルのWAITFILEパラメーターに指定した時間の長さであり,その後ではジョブは自動的に取り消されます。ユーザーはジョブ終了(ENDJOB)コマンドによって非スプール印刷装置ファイルだけを取り消すことができます。

*NO
印刷装置では装置に印刷する非スプール印刷装置ファイルは許可されません。
*YES
印刷装置は,スプールおよび非スプール出力を印刷するために使用することができます。WAITFILEパラメーターの値を設定するためには,印刷ファイルの作成,変更,または一時変更(CRTPRTF, CHGPRTF,またはOVRPRTF)コマンドを参照してください。

注: WAITFILEパラメーターに指定されている値が30秒より少ないかどうかにかかわらず,非スプール・ファイルは最大30秒まで待機します。

ページの位置合わせ (ALIGN)

用紙位置合わせの制御方法を指定します。

*WTR
書き出しプログラムは印刷される出力を記憶して,用紙の位置合わせが必要であると判別した時には,用紙位置合わせメッセージを出します。
*FILE
*YESがページの位置合わせプロンプト(ALIGNパラメーター)に指定されたすべてのファイルに対して,用紙位置合わせメッセージが出されます。書き出しプログラムによって提供される自動用紙位置合わせ制御機能で必要な結果が得られない時には,このオプションを選択する必要があります。
*FIRST
最初に印刷されるファイルの場合にだけ用紙位置合わせメッセージが出されます。印刷装置で後続のエラーが起こっても,用紙位置合わせメッセージは出されません。

印刷装置初期設定 (INIT)

印刷装置を初期設定する頻度を指定します。

注: 印刷装置記述でTRANSFORM(*YES)またはユーザー・データ変換プログラムが指定されていると,このパラメーターは無視されます。

*WTR
書き出しプログラムは,必要な時に印刷装置を初期設定します。
*FIRST
書き出しプログラムが印刷装置を初期設定するのは,最初のファイルを印刷する前,または入出力装置エラーが起こった後だけです。
*ALL
書き出しプログラムは,各ファイルおよびファイルの各コピーを印刷する前に印刷装置を初期設定します。

スプール・ファイル (FILE)

印刷装置で印刷する最初の(または唯一の)スプール・ファイルを指定します。出力待ち行列に複数の使用可能なファイルがある場合には,次に作成されるファイルは優先順位が最高の最初に使用可能なファイルです。

*NONE
スプール・ファイル名は指定されません。出力待ち行列で最初に使用可能なスプール・ファイルが最初に処理されます。
*LAST
書き出しプログラムの終了時に印刷中であったスプール・ファイルは,書き出しプログラムが再始動されると開始されます。
名前
印刷装置に書き出される最初の(または唯一の)ファイルであるスプール・ファイルの名前を指定してください。

ジョブ名 (JOB)

スプール・ファイルを作成したジョブの名前を指定します。このパラメーターが有効なのは,スプール・ファイル名がスプール・ファイル (FILE)パラメーターに指定された場合だけです。

単一値

*
この印刷装置書き出しプログラム開始(STRPRTWTR)コマンドが出されたジョブは,そのスプール・ファイルを作成したジョブです。

修飾子1: ジョブ名

名前
スプール・ファイルを作成したジョブの名前を指定してください。別のジョブ修飾子を指定しない場合には,そのジョブの単純名を見つけるために,システムに現在あるすべてのジョブが検索されます。

修飾子2: ユーザー

名前
ジョブの実行で使用されるユーザー・プロファイルを識別するユーザー名を指定してください。

修飾子3: 番号

000000から999999
システム割り当てジョブ番号を指定してください。

スプール・ファイル番号 (SPLNBR)

最初に処理されるスプール・ファイルの番号を指定します。このパラメーターが有効なのは,スプール・ファイル名がスプール・ファイルプロンプト(FILEパラメーター)に指定された場合だけです。

*ONLY
ジョブ内の1つのスプール・ファイルだけが指定されたファイル名をもっています。したがって,スプール・ファイルの番号は不要です。
*LAST
指定されたファイル名で最高の番号が付いているスプール・ファイルが使用されます。
*ANY
使用するスプール・ファイルを決定するのに,スプール・ファイル番号は使用されません。スプール・ファイルの選択時に,スプール・ファイル番号よりジョブ・システム名パラメーターまたはスプール・ファイル作成日時パラメーターが優先されるようにする時には,この値を使用してください。
1から999999
指定された出力待ち行列のジョブで,最初に処理したい指定のファイルの番号を指定してください。

ジョブ・システム名 (JOBSYSNAME)

スプール・ファイルを作成したジョブ(JOBパラメーター)が実行されたシステムの名前を指定します。このパラメーターは,ジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,およびスプール・ファイル番号のパラメーター要件が一致した後に考慮されます。

*ONLY
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,およびスプール・ファイル作成日時を持つスプール・ファイルは,1つです。
*CURRENT
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,および作成日時を持つ現行システム上で作成されたスプール・ファイルが使用されます。
*ANY
使用するスプール・ファイルを決定するのに,ジョブ・システム名は使用されません。スプール・ファイルの選択時に,ジョブ・システム名よりスプール・ファイル作成日時パラメーターが優先されるようにする時には,この値を使用してください。
名前
スプール・ファイルを作成したジョブが実行されたシステムの名前を指定します。

作成されたスプール・ファイル (CRTDATE)

スプール・ファイルが作成された日時を指定します。このパラメーターは,ジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,およびジョブ・システム名のパラメーター要件が一致した後に考慮されます。

単一値

*ONLY
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,およびジョブ・システム名を持つスプール・ファイルは,1つです。
*LAST
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,およびジョブ・システム名の最後の作成日時を持つスプール・ファイルが使用されます。

要素1: 作成日

日付
スプール・ファイルが作成された日付を指定します。

要素2: 作成時刻

*ONLY
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,ジョブ・システム名,およびスプール・ファイル作成日を持つスプール・ファイルは,1つです。
*LAST
指定されたジョブ名,ユーザー名,ジョブ番号,スプール・ファイル名,スプール・ファイル番号,ジョブ・システム名,およびスプール・ファイル作成日の最後の作成時刻を持つスプール・ファイルが使用されます。
時刻
スプール・ファイルが作成された時刻を指定します。

開始ページ (PAGE)

最初のファイルから印刷する最初のページのページ番号を指定します。このパラメーターが有効なのは,スプール・ファイル名がスプール・ファイルプロンプト(FILEパラメーター)に指定された場合だけです。

*BEGIN
スプール・ファイルの再始動ページが最初に印刷するページです。

注: この値がスプール・ファイル属性変更(CHGSPLFA)コマンドを使用して変更されなかった場合には,この値が*BEGINである時と同じ方法でファイルを印刷します。

整数
印刷の最初のページの番号を指定します。この番号は,有効なファイルのページの範囲内でなければなりません。

STRPRTWTR   DEV(QSYSPRT)  OUTQ(QPRINTS)  WTR(TOM)

このコマンドは,TOMという名前のスプーリング書き出しプログラムを開始します。この書き出しプログラムは,QPRINTSという名前の出力待ち行列から出力データを取り出し,その出力データをQSYSPRTという名前の印刷装置で印刷します。書き出しプログラム・メッセージがシステム操作員のメッセージ待ち行列に送られ,待ち行列が空になっている場合には,書き出しプログラムは追加の出力データを待機します。

エラー・メッセージ

*ESCAPE メッセージ

CPF0906
名前&3/&2/&1の重複ジョブが見つかった。
CPF1338
SBMJOBコマンドでエラーが起こった。
CPF1764
装置&1に対して,書き出しプログラムは既に開始されている。
CPF1842
システム値&1をアクセスすることができない。
CPF2115
&2のタイプ*&3のオブジェクト&1に損傷がある。
CPF2207
ライブラリー&3のタイプ*&2のオブジェクト&1の使用を認可されていない。
CPF3303
ファイル&1はジョブ&5/&4/&3に見つからなかった。
CPF3305
ライブラリー&2の出力待ち行列&1は,別の書き出しプログラムに割り当てられている。
CPF3309
&1という名前のファイルは活動状態でない。
CPF3310
書き出しプログラム&1は既に開始されている。
CPF3330
必要な資源が使用できない。
CPF3340
指定された名前のファイルが,ジョブ&5/&4/&3で複数個見つかった。
CPF3342
ジョブ&5/&4/&3が見つからない。
CPF3343
重複したジョブ名が見つかった。
CPF3347
装置&1が見つからない。
CPF3357
ライブラリー&2に出力待ち行列&1が見つかりません。
CPF3362
QTEMPのオブジェクトは,パラメーター値には正しくない。
CPF3363
ライブラリー&2のメッセージ待ち行列&1が見つからなかった。
CPF3369
装置&1は印刷装置ではない。
CPF336B
ライブラリー&2のドライバー出口プログラム&1が見つからないか,認可されていない。
CPF3418
ジョブに重複したファイル&1番号&2が見つかった。
CPF346A
ライブラリー&2の変形出口プログラム&1が見つからないか,ユーザーが認可されていない。
CPF346B
ライブラリー&2のドライバー出口プログラム&1が見つからないか,ユーザーが認可されていない。
CPF3463
装置&1の出力待ち行列が見つからない。
CPF3464
ライブラリー&2の出力待ち行列&1に対する権限がない。
CPF3478
ファイル&1はライブラリー&7の出力待ち行列&6のジョブ&5/&4/&3に見つからなかった。