CREATE
CREATEコマンドは、指定したスプール・ファイルを読み込み、PDFドキュメントを作成します。
スプール・ファイルの各ページにより、新しいPDFページが作成されます。適切なフォント・サイズ、レディングおよびプリンター・ファイルのオプションを使用して、PDFドキュメントの単一ページにスプール・ファイルのページを合わせます。
ページ当たり132列と57行で構成されるスプール・ファイルは、フォント・サイズ8とレディング8.5を使用してA4の横長ページに合わせることができます。
多くのキーワードに対応するように、作業リストを使用してキーワードのリストを渡すことができます。2つのフィールドの作業リストを作成します。最初のフィールドにはキーワード、2番目のフィールドにはその値が含まれます。必要なキーワードごとにエントリーを追加します。コマンドで直接指定したキーワードは、作業リストの対応するキーワード・エントリーよりも優先されます。この機能については例を参照してください。
必須
CREATE ------- DOCUMENT -----ファイル・パス----------------------->
>-- APPEND ------- *NO ----------------------------->
*YES
>-- NAME ---------スプール・ファイル名----------------->
>-- JOBNAME ------スプール・ファイルのジョブ名------------->
>-- JOBUSER ------スプール・ファイルのジョブ・ユーザー------------->
>-- JOBNUMBER ----スプール・ファイルのジョブ番号----------->
任意
>-- NUMBER ------- 1 ------------------------------->
数値
>-- PASSWORD -----パスワード------------------------>
>-- MASTER -------マスター------------------------->
>-- AUTHOR -------作者-------------------------->
>-- TITLE --------タイトル--------------------------->
>-- SUBJECT ------件名------------------------->
>-- KEYWORDS -----キーワード------------------------>
>-- CREATOR ------作成者------------------------->
>-- ENCODING ----- *HPT ---------------------------->
*CSF
Cp37
Cp273
Cp277
Cp278
Cp280
Cp284
Cp285
Cp297
Cp420
Cp423
Cp424
Cp500
Cp838
Cp870
Cp871
Cp875
Cp880
Cp905
Cp930
Cp933
Cp935
Cp937
Cp939
Cp1025
Cp1026
Cp1112
Cp1122
Cp1123
Cp1130
Cp1140
Cp1141
Cp1142
Cp1143
Cp1144
Cp1145
Cp1146
Cp1147
Cp1148
Cp1149
Cp1153
Cp1154
Cp1155
Cp1156
Cp1157
Cp1158
Cp1160
Cp1164
Cp1371
Cp1388
Cp1399
Cp4971
Cp5026
Cp5035
>-- FONT --------- *AUTO --------------------------->
*COURIER
*COURIER2
*COURIER3
*COURIER4
*MINCHO
*GOTHIC
*SIMSUN
*DFKAISB
*MINGLIU
*BATANG
*COURIERNEW
*MTSANSWT
*MTSANSWTIN
*MTSANSWTJ
*MTSANSWTJEA
*MTSANSWTK
*MTSANSWTKEA
*MTSANSWTME
*MTSANSWTTC
*MTSANSWTTCEA
*MTSANSWTTCTWEA
*THRNDWT
*THRNDWTJ
*THRNDWTK
*THRNDWTME
*THRNDWTSC
*THRNDWTTC
>-- FONTSIZE ----- 10 ------------------------------>
数値
>-- LEADING ------ (fontsize * 1.5) ---------------->
数値
>-- PAGES -------- n,n-n --------------------------->
>-- PAGETYPE ----- *TEXT --------------------------->
*IMAGE
>-- PAGESIZE ----- *A4 ----------------------------->
*A0 -> *A10
*B0 -> *B5
*LETTER
*HALFLETTER
*LEDGER
*LEGAL
*NOTE
幅、高さ
>-- SCALING ------ n ------------------------------->
>-- MARGIN ------- 36ポイント----------------------->
左、右、上、下(ポイント)
>-- ORIENTATION -- *PORTRAIT ----------------------->
*LANDSCAPE
キーワード
DOCUMENT |
作成するPDFファイルまたは置き換えるPDFファイルの名前 例: <ドキュメント名>.pdfは、JSMインスタンスのルート・ディレクトリの下にPDFファイルを作成します。 documents/<ドキュメント名>.pdfは、JSMインスタンスのdocumentsサブディレクトリの下にPDFファイルを作成します。 /<ドキュメント名>.pdfは、ファイル・システムのルート・ディレクトリの下にPDFファイルを作成します。 |
APPEND |
作成したスプール・ファイル・ページを既存のドキュメントに付加します。省略値は*NOです。 |
NAME |
スプール・ファイル名。IBM i の指定した出力待ち行列の有効なスプール・ファイル名にします。 |
NUMBER |
スプール・ファイル番号。値が割り当てられない場合、省略値1が使用されます。System iの指定した出力待ち行列の有効なスプール・ファイル番号にします。 |
JOBNAME |
スプール・ファイルのジョブ名。IBM i の指定した出力待ち行列の有効なジョブ名にします。 |
JOBUSER |
スプール・ファイルのジョブ・ユーザー。IBM i の指定した出力待ち行列の有効なジョブ・ユーザーにします。 |
JOBNUMBER |
スプール・ファイルのジョブ番号。IBM i の指定した出力待ち行列の有効なジョブ番号にします。 |
PASSWORD |
生成されたPDFファイルにパスワードを関連付けて、ドキュメントの開始を制限できます。このパスワードは大文字/小文字を区別します。 |
MASTER |
PDFドキュメントにマスター・パスワードが関連付けられている場合、セキュリティ設定を設定または変更する前にこのパスワードを指定する必要があります。このマスター・パスワードは大文字/小文字を区別します。 |
AUTHOR |
PDFドキュメントの作者を示すテキスト値 |
TITLE |
生成されたPDFドキュメントのタイトルとして使用されるテキスト文字列 |
SUBJECT |
生成されたPDFドキュメントの内容を示すテキスト文字列 |
KEYWORDS |
PDFドキュメントを検索しやすいように、1つ以上の単語を指定できます。キーワードは、類似ドキュメントまたは関連ドキュメントのグループ化に使用されるカテゴリーと見なすことができます。 |
CREATOR |
PDFドキュメントの作成者を示すテキスト値 |
ENCODING |
自動ホスト印刷変換の転換を指定します。自動またはファイル変換をストリームするコピーを指定します。省略値は*HPTです。*CSFはファイル変換をストリームする自動コピー、もしくはコードページ値を使ってファイル変換ccsidをストリームするコピーを指定できます。 |
FONT |
スプール・ファイルのテキストの描画に使用されるフォントは、固定幅のCourier、Heisei Mincho、またはHeisei Kaku Gothicになります。省略値のフォントは*AUTOです。 次のフォントは省略値で使用可能なフォントです。 *AUTO フォント:選択されたエンコーディングにより決定 *COURIER フォント:Courier *COURIER2 フォント:Courier *COURIER3 フォント:Courier *MINCHO Heisei Mincho *GOTHIC Heisei Kaku Gothic その他のフォントをサポートするにはi5/OS 5761SS1 オプション43追加フォントのライセンス・プログラムがインストールされていなければなりません。 |
FONTSIZE |
ポイント単位のフォント・サイズ。省略値設定は10ポイントです。 |
LEADING |
PDFドキュメントの各行の前にあるブランク・スペースを制御できます。省略値は(FONTSIZE * 1.5)です。 |
PAGES |
コンマで区切られたページ番号とページ範囲のリストです。省略値は全てのページの選択です。 |
PAGETYPE |
生成するページタイプを指定できます。*IMAGEはTIFF G4フォーマットでページが生成されます。キーワードSCALINGはイメージの拡大・縮小率(パーセント)をコントロールします。省略値は*TEXTで、テキスト・フォーマットでページを生成します。キーワードFONT、FONTSIZE、LEADINGがテキスト出力をコントロールします。 |
PAGESIZE |
生成するPDFドキュメントのページ・サイズ。省略値は*A4です。 有効な値: *A0〜*A10 *B0〜*B5 *LETTER *HALFLETTER *LEDGER *LEGAL *NOTE 幅、高さ |
SCALING |
生成するページ・イメージに適用する拡大・縮小率をパーセントで指定します。省略値は18です。 |
MARGIN |
ページのマージンは、ページの境界周辺のブランク・スペースです。省略値は(すべての境界で)36ポイントですが、左、右、上、下の値を指定して各自のマージンを設定できます。 |
ORIENTATION |
省略値のオプションは*PORTRAITです。あるいは、*LANDSCAPEで生成するように指定できます。 |
コメント/警告
ホストへの接続に使用されるユーザーには、関連するスプール・ファイルを扱う権限が与えられるようにします。
例
RDML
特に、フィールド長の制限が256文字のRDMLでは、SERVICE_LISTキーワードを使用して、CREATEコマンドに必要なキーワードや値をすべて確保しておくと便利です。
注:この例では、SERVICE_LISTに指定したキーワードがコマンド値でオーバーライドされるため、方向は*PORTRAITになります。
DEF_LIST NAME(#PDFLST) FIELDS((#PDFKEY *INP) (#PDFVALUE *INP)) TYPE(*WORKING)
DEFINE FIELD(#PDFKEY) TYPE(*CHAR) LENGTH(20)
DEFINE FIELD(#PDFVALUE) TYPE(*CHAR) LENGTH(50)
CHANGE FIELD(#PDFKEY) TO(AUTHOR)
CHANGE FIELD(#PDFVALUE) TO('LANSA PTY LTD')
ADD_ENTRY TO_LIST(#PDFLST)
CHANGE FIELD(#PDFKEY) TO(TITLE)
CHANGE FIELD(#PDFVALUE) TO('ANNUAL SALES REPORT')
ADD_ENTRY TO_LIST(#PDFLST)
CHANGE FIELD(#PDFKEY) TO(PAGESIZE)
CHANGE FIELD(#PDFVALUE) TO(*A5)
ADD_ENTRY TO_LIST(#PDFLST)
CHANGE FIELD(#PDFKEY) TO(ORIENTATION)
CHANGE FIELD(#PDFVALUE) TO(*LANDSCAPE)
ADD_ENTRY TO_LIST(#PDFLST)
CHANGE FIELD(#JSMCMD) TO('CREATE ORIENTATION(*PORTRAIT) FONTSIZE(8) LEADING(8.5) SERVICE_LIST(PDFKEY,PDFVALUE)')
USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG #PDFLST)
RDMLX
#jsmcommand := 'CREATE DOCUMENT(' + #JSMPDFdoc + ') NAME(' + #file name + ') NUMBER(' + #filenumber + ') JOBNAME(' + #jobname + ') JOBUSER(' + #jobuser + ') JOBNUMBER(' + #jobnumber + ') AUTHOR(' + #JSMUserid + ') FONTSIZE(8) LEADING(8.5) ORIENTATION(*LANDSCAPE) SERVICE_LIST(PDFKEY,PDFVALUE)'
use builtin(jsmx_command) with_args(#jsmxhdle1 #jsmcommand) to_get(#jsmxsts #jsmxmsg #spoollst)
ILE RPG
c eval jsmcmd = 'CREATE'
c + ' DOCUMENT(PDFSPLF.PDF)'
c + ' NAME(' + %trim(spoolfnam) + ')'
c + ' JOBNAME(' + %trim(spooljnam) + ')'
c + ' JOBUSER(' + %trim(spooljusr) + ')'
c + ' JOBNUMBER(' + %trim(spooljnum) + ')'
c + ' NUMBER(' + %trim(spoolfnum) + ')'
c + ' FONTSIZE(8) LEADING(8.5)'
c + ' ORIENTATION(*LANDSCAPE)'
c callp p_jsmcmd(jsmcmd:jsmsts:jsmmsg)