CBL_JOIN_FILENAME

ファイル名の構成要素、つまり、パス名、基本名および拡張子を結合してファイル名を形成する。

構文:
call "CBL_JOIN_FILENAME" using     sj-param
                                   join-buffer
                                   path-buffer
                                   basename-buffer
                                   extension-buffer
                         returning status-code
Parameters:
呼び出しプロトタイプ使用時 ( 説明の読み方) PIC (32bitシステム)
sj-param A group item predefined as cblt-splitjoin-buf, containing the following subordinate items: Group containing:
  cblte-sj-param-length   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-split-join-flag1   cblt-x1-compx   pic x comp-x.
  cblte-sj-split-join-flag2   cblt-x1-compx   pic x comp-x.
  cblte-sj-device-offset   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-device-length   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-basename-offset   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-basename-length   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-extension-offset   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-extension-length   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-total-length   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-split-buf-len   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-join-buf-len   cblt-x2-compx   pic x(2) comp-x.
  cblte-sj-first-component-length   cblt-x2-compx   pic x(2) comp-x.
join-buffer pic x(n). pic x(n).
path-buffer pic x(n). pic x(n).
basename-buffer pic x(n). pic x(n).
extension-buffer pic x(n). pic x(n).
status-code 説明の読み方 参照
入力パラメタ:
cblte-sj-param-length

sj-paramの長さ（バイト）で、cblte-sj-param-length用の2バイトを含む。cblte-sj-param-lengthの通常の値は24。
cblte-sj-split-join-flag1

次のように設定する

1
1

文字列はナル終了
0

文字列はスペース終了
0
1

新しいファイル名は大文字にフォールドされる
0

元の大文字・小文字がそのまま保存される
cblte-sj-split-join-flag2 次のように設定する

2
1

cblte-sj-split-join-flag11のビット1が0に設定されている場合、各ファイル名の構成要素の長さが、cblte-sj-path-length、cblte-sj-basename-length、およびcblte-sj-extension-lengthにより正確に与えられていることを意味する。このフラグは、ファイル名の構成要素の1つに既知の意味のあるスペースがある場合に使用できる。

cblte-sj-split-join-flag1のビット1が1の場合は無視される。
0

ファイル名の構成要素の長さは、cblte-sj-split-join-flag1のビット1によって決まる。
1 予約済み。
0 予約済み。
cblte-sj-device-offset

path-buffer内でのパス名の先頭の相対番地（1から指標付け）
cblte-sj-device length

スペース終了でもナル終了でもない場合の装置名の長さ
cblte-sj-basename-offset

basename-buffer内での基本名の先頭の相対番地（1から指標付け）
cblte-sj-basename-length

スペース終了でもナル終了でもない場合の基本名長
cblte-sj-extension-offset

extension-buffer内での拡張子の先頭の相対番地（1から指標付け）
cblte-sj-extension-length

スペース終了でもナル終了でもない場合の拡張子長
path-buffer

パス名
basename-buffer 基本名
extension-buffer 拡張子
cblte-sj-join-buf-len join-bufferの長さ
出力パラメタ:
cblte-sj-total-length

ファイル名の合計文字数
join-buffer

結合ファイル名
status-code

戻り状態:

0

成功
1

join-bufferには大きすぎるファイル名
4

違法ファイル名
説明:

新しいファイル名は以下の項目を結合して形成される。