Caché ObjectScript リファレンス -...

730
Caché ObjectScript リファ レンス Version 5.1 2006-03-14 InterSystems Corporation 1 Memorial Drive Cambridge MA 02142 www.intersystems.com

Transcript of Caché ObjectScript リファレンス -...

  • Caché ObjectScript リファレンス

    Version 5.12006-03-14

    InterSystems Corporation 1 Memorial Drive Cambridge MA 02142 www.intersystems.com

  • Caché ObjectScript リファレンス

    Caché Version 5.1 2006-03-14

    Copyright © 2006 InterSystems Corporation.

    All rights reserved.

    このドキュメントは、 Sun Microsystems、RenderX Inc.、 アドビ システムズ および ワールドワイド・ウェブ・コンソーシアム

    (www.w3c.org)のツールと情報を使用して、Adobe Portable Document Format (PDF)で作成およびフォーマットされました。

    主要ドキュメント開発ツールは、InterSystemsが構築したCaché と Javaを使用した特別目的のXML処理アプリケーションで

    す。

    Caché 製品とロゴは InterSystems Corporation の登録商標です。

    Ensemble 製品とロゴは InterSystems Corporation の登録商標です。

    InterSystems という名前とロゴは InterSystems Corporation の登録商標です

    このドキュメントは、インターシステムズ社(住所:One Memorial Drive, Cambridge, MA 02142)あるいはその子会社が所有す

    る企業秘密および秘密情報を含んでおり、インターシステムズ社の製品を稼動および維持するためにのみ提供される。こ

    の発行物のいかなる部分も他の目的のために使用してはならない。また、インターシステムズ社の書面による事前の同意

    がない限り、本発行物を、いかなる形式、いかなる手段で、その全てまたは一部を、再発行、複製、開示、送付、検索可能

    なシステムへの保存、あるいは人またはコンピュータ言語への翻訳はしてはならない。

    かかるプログラムと関連ドキュメントについて書かれているインターシステムズ社の標準ライセンス契約に記載されている

    範囲を除き、ここに記載された本ドキュメントとソフトウェアプルグラムの複製、使用、廃棄は禁じられている。インターシス

    テムズ社は、ソフトウェアライセンス契約に記載されている事項以外にかかるソフトウェアプログラムに関する説明と保証を

    するものではない。さらに、かかるソフトウェアに関する、あるいはかかるソフトウェアの使用から起こるいかなる損失、損害

    に対するインターシステムズ社の責任は、ソフトウェアライセンス契約にある事項に制限される。

    前述は、そのコンピュータソフトウェアの使用およびそれによって起こるインターシステムズ社の責任の範囲、制限に関する

    一般的な概略である。完全な参照情報は、インターシステムズ社の標準ライセンス契約に記され、そのコピーは要望によっ

    て入手することができる。

    インターシステムズ社は、本ドキュメントにある誤りに対する責任を放棄する。また、インターシステムズ社は、独自の裁量

    にて事前通知なしに、本ドキュメントに記載された製品および実行に対する代替と変更を行う権利を有する。

    Caché および InterSystems Caché、Caché SQL、 Caché ObjectScript および Caché Object は、インターシステムズ社の

    商標です。

    ここで使われている他の全てのブランドまたは製品名は、各社および各組織の商標または登録商標です。

    インターシステムズ社の製品に関するサポートやご質問は、以下にお問い合わせください:

    InterSystems ワールドワイド カスタマサポート

    +1 617 621-0700Tel:

    +1 617 374-9391Fax:

    [email protected]:

  • 目次

    記号および省略形 ....................................................................................................... 1

    Caché ObjectScript で使用する記号 ......................................................................... 1

    Caché ObjectScript で使用する省略形 ...................................................................... 8

    Caché ObjectScript コマンド ........................................................................................ 13

    BREAK ............................................................................................................... 14

    CLOSE ............................................................................................................... 18

    CONTINUE ........................................................................................................ 20

    DO .................................................................................................................... 21

    DO WHILE ......................................................................................................... 29

    ELSE ................................................................................................................. 32

    ELSEIF ............................................................................................................... 33

    FOR .................................................................................................................. 34

    GOTO ............................................................................................................... 41

    HALT ................................................................................................................ 45

    HANG ................................................................................................................ 47

    IF ...................................................................................................................... 49

    JOB ................................................................................................................... 52

    KILL .................................................................................................................. 67

    LOCK ................................................................................................................ 72

    MERGE .............................................................................................................. 81

    NEW .................................................................................................................. 85

    OPEN ................................................................................................................ 90

    PRINT ................................................................................................................ 97

    QUIT ................................................................................................................. 99

    READ ............................................................................................................... 104

    SET .................................................................................................................. 113

    TCOMMIT ........................................................................................................ 121

    TROLLBACK .................................................................................................... 123

    TSTART ........................................................................................................... 127

    USE ................................................................................................................. 129

    VIEW ............................................................................................................... 135

    WHILE ............................................................................................................. 140

    WRITE ............................................................................................................. 143

    XECUTE ........................................................................................................... 153

    Caché ObjectScript 関数 ........................................................................................... 159

    $ASCII .............................................................................................................. 160

    Caché ObjectScript リファレンス                                                                                                     iii

  • $BIT ................................................................................................................. 163

    $BITCOUNT ..................................................................................................... 165

    $BITFIND ......................................................................................................... 166

    $BITLOGIC ....................................................................................................... 168

    $CASE .............................................................................................................. 170

    $CHAR ............................................................................................................. 171

    $DATA ............................................................................................................. 174

    $EXTRACT ....................................................................................................... 178

    $FACTOR ......................................................................................................... 183

    $FIND .............................................................................................................. 184

    $FNUMBER ....................................................................................................... 186

    $GET ............................................................................................................... 189

    $INCREMENT ................................................................................................... 192

    $INUMBER ........................................................................................................ 195

    $ISOBJECT ....................................................................................................... 201

    $ISVALIDNUM .................................................................................................. 202

    $JUSTIFY ......................................................................................................... 206

    $LENGTH ......................................................................................................... 207

    $LIST ............................................................................................................... 209

    $LISTBUILD ...................................................................................................... 213

    $LISTDATA ...................................................................................................... 216

    $LISTFIND ........................................................................................................ 218

    $LISTFROMSTRING ........................................................................................... 220

    $LISTGET ......................................................................................................... 221

    $LISTLENGTH .................................................................................................. 223

    $LISTNEXT ....................................................................................................... 225

    $LISTSAME ....................................................................................................... 226

    $LISTTOSTRING ............................................................................................... 229

    $NAME ............................................................................................................. 231

    $NEXT ............................................................................................................. 234

    $NORMALIZE ................................................................................................... 235

    $NUMBER ......................................................................................................... 239

    $ORDER ........................................................................................................... 242

    $PIECE ............................................................................................................. 245

    $QLENGTH ...................................................................................................... 252

    $QSUBSCRIPT .................................................................................................. 253

    $QUERY ........................................................................................................... 254

    $RANDOM ........................................................................................................ 257

    $REVERSE ........................................................................................................ 258

    $SELECT .......................................................................................................... 259

    iv                                                                                                    Caché ObjectScript リファレンス

  • $SORTBEGIN .................................................................................................... 261

    $SORTEND ....................................................................................................... 262

    $STACK ........................................................................................................... 263

    $TEXT ............................................................................................................. 266

    $TRANSLATE ................................................................................................... 269

    $VIEW .............................................................................................................. 271

    数学関数と時間関数 ................................................................................................. 277

    $ZABS .............................................................................................................. 277

    $ZARCCOS ....................................................................................................... 278

    $ZARCSIN ......................................................................................................... 279

    $ZARCTAN ....................................................................................................... 280

    $ZCOS ............................................................................................................. 281

    $ZCOT ............................................................................................................. 282

    $ZCSC .............................................................................................................. 283

    $ZDATE ........................................................................................................... 284

    $ZDATEH ......................................................................................................... 294

    $ZDATETIME .................................................................................................... 303

    $ZDATETIMEH ................................................................................................. 313

    $ZEXP .............................................................................................................. 322

    $ZHEX ............................................................................................................. 323

    $ZLN ................................................................................................................ 325

    $ZLOG ............................................................................................................. 326

    $ZPOWER ......................................................................................................... 328

    $ZSEC .............................................................................................................. 329

    $ZSIN ............................................................................................................... 330

    $ZSQR .............................................................................................................. 331

    $ZTAN ............................................................................................................. 332

    $ZTIME ............................................................................................................ 333

    $ZTIMEH .......................................................................................................... 336

    ルーチン、デバッグ、および他のコマンド ...................................................................... 339

    ZBREAK ........................................................................................................... 340

    ZINSERT ........................................................................................................... 343

    ZKILL .............................................................................................................. 346

    ZLOAD ............................................................................................................. 348

    ZNSPACE ......................................................................................................... 350

    ZPRINT ............................................................................................................ 353

    ZREMOVE ........................................................................................................ 355

    ZSAVE ............................................................................................................. 357

    ZSYNC ............................................................................................................. 359

    ZTRAP ............................................................................................................. 360

    Caché ObjectScript リファレンス                                                                                                     v

  • ZWRITE ............................................................................................................ 363

    ZZDUMP ........................................................................................................... 366

    Caché ObjectScript 特殊変数 .................................................................................... 371

    $DEVICE .......................................................................................................... 371

    $ECODE ........................................................................................................... 372

    $ESTACK ......................................................................................................... 374

    $ETRAP ............................................................................................................ 377

    $HALT ............................................................................................................. 380

    $HOROLOG ..................................................................................................... 383

    $IO .................................................................................................................. 386

    $JOB ................................................................................................................ 388

    $KEY ............................................................................................................... 389

    $PRINCIPAL ..................................................................................................... 392

    $QUIT .............................................................................................................. 393

    $ROLES ............................................................................................................ 394

    $STACK ........................................................................................................... 395

    $STORAGE ....................................................................................................... 397

    $SYSTEM .......................................................................................................... 398

    $TEST .............................................................................................................. 400

    $TLEVEL .......................................................................................................... 401

    $USERNAME ..................................................................................................... 402

    $X ................................................................................................................... 403

    $Y .................................................................................................................... 405

    $ZA .................................................................................................................. 407

    $ZB .................................................................................................................. 411

    $ZCHILD .......................................................................................................... 414

    $ZEOF ............................................................................................................. 415

    $ZERROR ......................................................................................................... 416

    $ZHOROLOG .................................................................................................... 420

    $ZIO ................................................................................................................ 421

    $ZJOB .............................................................................................................. 422

    $ZMODE .......................................................................................................... 424

    $ZNAME ........................................................................................................... 425

    $ZNSPACE ........................................................................................................ 426

    $ZORDER ......................................................................................................... 427

    $ZPARENT ........................................................................................................ 428

    $ZPI ................................................................................................................. 428

    $ZPOS .............................................................................................................. 429

    $ZREFERENCE .................................................................................................. 430

    $ZSTORAGE ..................................................................................................... 433

    vi                                                                                                    Caché ObjectScript リファレンス

  • $ZTIMESTAMP .................................................................................................. 434

    $ZTIMEZONE .................................................................................................... 437

    $ZTRAP ............................................................................................................ 440

    $ZVERSION ...................................................................................................... 443

    構造化システム変数 ................................................................................................. 445

    ^$GLOBAL ........................................................................................................ 446

    ^$JOB ............................................................................................................... 449

    ^$LOCK ............................................................................................................ 451

    ^$ROUTINE ....................................................................................................... 454

    システム関数と他の関数 ............................................................................................ 457

    $ZBOOLEAN .................................................................................................... 457

    $ZCONVERT ..................................................................................................... 463

    $ZCRC ............................................................................................................. 467

    $ZCYC ............................................................................................................. 469

    $ZF .................................................................................................................. 470

    $ZF(-1) ............................................................................................................. 476

    $ZF(-2) ............................................................................................................. 477

    $ZF(-3) ............................................................................................................. 478

    $ZF(-4) ............................................................................................................. 480

    $ZF(-5) ............................................................................................................. 482

    $ZF(-6) ............................................................................................................. 483

    $ZINCREMENT .................................................................................................. 484

    $ZISWIDE ......................................................................................................... 484

    $ZLASCII .......................................................................................................... 485

    $ZLCHAR ......................................................................................................... 487

    $ZNAME ........................................................................................................... 488

    $ZNEXT ........................................................................................................... 491

    $ZORDER ......................................................................................................... 492

    $ZPOSITION ..................................................................................................... 493

    $ZPREVIOUS .................................................................................................... 494

    $ZSEARCH ....................................................................................................... 495

    $ZSEEK ............................................................................................................ 499

    $ZSORT ............................................................................................................ 500

    $ZSTRIP ........................................................................................................... 501

    $ZUTIL(4) ......................................................................................................... 503

    $ZUTIL(5) ......................................................................................................... 505

    $ZUTIL(9) ......................................................................................................... 507

    $ZUTIL(12) ....................................................................................................... 509

    $ZUTIL(15) ....................................................................................................... 513

    $ZUTIL(18) ....................................................................................................... 513

    Caché ObjectScript リファレンス                                                                                                    vii

  • $ZUTIL(20) ....................................................................................................... 516

    $ZUTIL(22) ....................................................................................................... 518

    $ZUTIL(39) ....................................................................................................... 520

    $ZUTIL(49) ....................................................................................................... 522

    $ZUTIL(55) ....................................................................................................... 527

    $ZUTIL(56,2) ..................................................................................................... 530

    $ZUTIL(62,1) ..................................................................................................... 530

    $ZUTIL(67) ....................................................................................................... 532

    $ZUTIL(68) ....................................................................................................... 533

    $ZUTIL(68,1) ..................................................................................................... 535

    $ZUTIL(68,2) ..................................................................................................... 536

    $ZUTIL(68,3) ..................................................................................................... 537

    $ZUTIL(68,5) ..................................................................................................... 539

    $ZUTIL(68,6) ..................................................................................................... 540

    $ZUTIL(68,7) ..................................................................................................... 541

    $ZUTIL(68,11) ................................................................................................... 542

    $ZUTIL(68,15) ................................................................................................... 543

    $ZUTIL(68,22) ................................................................................................... 544

    $ZUTIL(68,25) ................................................................................................... 545

    $ZUTIL(68,26) ................................................................................................... 547

    $ZUTIL(68,27) ................................................................................................... 549

    $ZUTIL(68,28) ................................................................................................... 551

    $ZUTIL(68,30) ................................................................................................... 552

    $ZUTIL(68,32) ................................................................................................... 553

    $ZUTIL(68,34) ................................................................................................... 555

    $ZUTIL(68,39) ................................................................................................... 556

    $ZUTIL(68,40) ................................................................................................... 557

    $ZUTIL(68,42) ................................................................................................... 558

    $ZUTIL(68,43) ................................................................................................... 559

    $ZUTIL(68,45) ................................................................................................... 560

    $ZUTIL(68,51) ................................................................................................... 561

    $ZUTIL(68,63) ................................................................................................... 562

    $ZUTIL(69) ....................................................................................................... 563

    $ZUTIL(69,0) ..................................................................................................... 566

    $ZUTIL(69,1) ..................................................................................................... 568

    $ZUTIL(69,2) ..................................................................................................... 570

    $ZUTIL(69,3) ..................................................................................................... 571

    $ZUTIL(69,4) ..................................................................................................... 572

    $ZUTIL(69,5) ..................................................................................................... 574

    $ZUTIL(69,6) ..................................................................................................... 575

    viii                                                                                                   Caché ObjectScript リファレンス

  • $ZUTIL(69,7) ..................................................................................................... 576

    $ZUTIL(69,8) ..................................................................................................... 577

    $ZUTIL(69,10) ................................................................................................... 578

    $ZUTIL(69,11) ................................................................................................... 579

    $ZUTIL(69,13) ................................................................................................... 580

    $ZUTIL(69,14) ................................................................................................... 581

    $ZUTIL(69,15) ................................................................................................... 582

    $ZUTIL(69,19) ................................................................................................... 584

    $ZUTIL(69,20) ................................................................................................... 585

    $ZUTIL(69,21) ................................................................................................... 586

    $ZUTIL(69,22) ................................................................................................... 587

    $ZUTIL(69,24) ................................................................................................... 588

    $ZUTIL(69,26) ................................................................................................... 589

    $ZUTIL(69,27) ................................................................................................... 590

    $ZUTIL(69,28) ................................................................................................... 592

    $ZUTIL(69,30) ................................................................................................... 593

    $ZUTIL(69,31) ................................................................................................... 594

    $ZUTIL(69,32) ................................................................................................... 595

    $ZUTIL(69,34) ................................................................................................... 597

    $ZUTIL(69,35) ................................................................................................... 598

    $ZUTIL(69,37) ................................................................................................... 599

    $ZUTIL(69,39) ................................................................................................... 600

    $ZUTIL(69,40) ................................................................................................... 601

    $ZUTIL(69,42) ................................................................................................... 602

    $ZUTIL(69,43) ................................................................................................... 603

    $ZUTIL(69,44) ................................................................................................... 604

    $ZUTIL(69,45) ................................................................................................... 605

    $ZUTIL(69,49) ................................................................................................... 606

    $ZUTIL(69,51) ................................................................................................... 607

    $ZUTIL(69,60) ................................................................................................... 608

    $ZUTIL(69,63) ................................................................................................... 609

    $ZUTIL(71) ....................................................................................................... 610

    $ZUTIL(78,21) ................................................................................................... 611

    $ZUTIL(78,22) ................................................................................................... 613

    $ZUTIL(78,23) ................................................................................................... 615

    $ZUTIL(78,28) ................................................................................................... 616

    $ZUTIL(78,29) ................................................................................................... 617

    $ZUTIL(82,12) ................................................................................................... 617

    $ZUTIL(86) ....................................................................................................... 619

    $ZUTIL(90,4) ..................................................................................................... 619

    Caché ObjectScript リファレンス                                                                                                    ix

  • $ZUTIL(90,10) ................................................................................................... 620

    $ZUTIL(94) ....................................................................................................... 621

    $ZUTIL(96) ....................................................................................................... 622

    $ZUTIL(96,4) ..................................................................................................... 623

    $ZUTIL(96,5) ..................................................................................................... 624

    $ZUTIL(96,9) ..................................................................................................... 624

    $ZUTIL(96,10) ................................................................................................... 625

    $ZUTIL(96,14) ................................................................................................... 625

    $ZUTIL(110) ...................................................................................................... 626

    $ZUTIL(114) ...................................................................................................... 627

    $ZUTIL(128,1) ................................................................................................... 630

    $ZUTIL(130) ...................................................................................................... 631

    $ZUTIL(131) ...................................................................................................... 633

    $ZUTIL(132) ...................................................................................................... 634

    $ZUTIL(140) ...................................................................................................... 636

    $ZUTIL(140,7) ................................................................................................... 640

    $ZUTIL(147) ...................................................................................................... 643

    $ZUTIL(158) ...................................................................................................... 644

    $ZUTIL(168) ...................................................................................................... 645

    $ZUTIL(186) ...................................................................................................... 646

    $ZUTIL(188) ...................................................................................................... 649

    $ZUTIL(189) ...................................................................................................... 650

    $ZUTIL(193) ...................................................................................................... 651

    $ZWASCII ......................................................................................................... 654

    $ZWCHAR ........................................................................................................ 656

    $ZWIDTH ......................................................................................................... 657

    $ZWPACK と $ZWBPACK ................................................................................... 658

    $ZWUNPACK と $ZWUNBPACK .......................................................................... 660

    $ZZENKAKU ..................................................................................................... 661

    %ZLANG 言語拡張ライブラリ ...................................................................................... 663

    %ZLANG ........................................................................................................... 663

    従来のコマンドと関数 ................................................................................................ 667

    DO (従来のバージョン) ........................................................................................ 668

    FOR (従来のバージョン) ...................................................................................... 672

    IF (従来のバージョン) ......................................................................................... 679

    ZQUIT (従来のコマンド) ...................................................................................... 680

    $ZBITAND (従来の関数) ..................................................................................... 683

    $ZBITCOUNT (従来の関数) ................................................................................ 684

    $ZBITFIND (従来の関数) .................................................................................... 684

    $ZBITGET (従来の関数) ..................................................................................... 685

    x                                                                                                     Caché ObjectScript リファレンス

  • $ZBITLEN (従来の関数) ..................................................................................... 686

    $ZBITNOT (従来の関数) ..................................................................................... 687

    $ZBITOR (従来の関数) ....................................................................................... 687

    $ZBITSET (従来の関数) ...................................................................................... 688

    $ZBITSTR (従来の関数) ...................................................................................... 689

    $ZBITXOR (従来の関数) ..................................................................................... 690

    $ZUTIL(67,0) (従来の関数) ................................................................................. 691

    $ZUTIL(67,1) (従来の関数) ................................................................................. 692

    $ZUTIL(67,4) (従来の関数) ................................................................................. 693

    $ZUTIL(67,5) (従来の関数) ................................................................................. 696

    $ZUTIL(67,6) (従来の関数) ................................................................................. 697

    $ZUTIL(67,7) (従来の関数) ................................................................................. 699

    $ZUTIL(67,8) (従来の関数) ................................................................................. 700

    $ZUTIL(67,9) (従来の関数) ................................................................................. 701

    $ZUTIL(67,10) (従来の関数) ................................................................................ 702

    $ZUTIL(67,11) (従来の関数) ................................................................................ 704

    $ZUTIL(67,12) (従来の関数) ................................................................................ 705

    $ZUTIL(67,13) (従来の関数) ................................................................................ 706

    $ZUTIL(67,14) (従来の関数) ................................................................................ 707

    $ZUTIL(67,15) (従来の関数) ................................................................................ 710

    $ZUTIL(100) (従来の関数) .................................................................................. 711

    $ZUTIL(113) (従来の関数) .................................................................................. 712

    $ZUTIL(133) (従来の関数) .................................................................................. 713

    Caché ObjectScript リファレンス                                                                                                    xi

  • 図一覧

    非並行モードおよび並行モードのクライアント/サーバ接続 ................................................ 64

    ^X と ^Y の初期構造 ................................................................................................... 83

    ^X および ^Y の MERGE コマンドの結果 ........................................................................ 84

    マルチバイトのリトル・エンディアン形式またはビッグ・エンディアン形式への文字列の変換 .... 659

    シングル・バイト文字列へのマルチバイトのリトル・エンディアン形式文字列またはビッグ・エンディア

    ン形式文字列の変換 ................................................................................................ 660

    xii                                                                                                    Caché ObjectScript リファレンス

  • 記号および省略形

    Caché ObjectScript で使用する記号

    Caché ObjectScript で演算子として使用される文字の表です。

    記号の表以下は、Caché ObjectScript で使用されるリテラル記号の表です (この表には、言語の一部ではな

    い形式規約を示す記号は含まれていません)。別途、Caché SQL で使用する記号を示した表もあり

    ます。

    各記号の名前の後には、ASCII 10 進数コード値が続きます。

    名前と使用法記号

    空白 (タブ (9) またはスペース (32)) : コマンドは、最初の引数の前に

    スペースが 1 つ必要です。

    ラベル以外の各コード行の行頭に 空白 (タブあるいはスペース) が必

    要です。

    最後のコマンドの引数と、同じ行にある後続のコマンドまたはコメントと

    の間には空白 (スペースあるいはタブ) が必要です。

    左中括弧 ( { ) の前には、最低 1 つのスペースが必要です。

    [スペース]、または

    [タブ]

    2 つの空白 :引数のないコマンドと、同じ行の次のコマンドの間には、

    2 つの空白が必要です。

    [2 つのスペース、2

    つのタブ、またはス

    ペースとタブ 1つず

    つ]

    感嘆符 (33) : 二項 OR 論理演算子。

    READ コマンドと WRITE コマンドでは、新規の行。

    ターミナル・プロンプトで インタラクティブなサブシェルをロードします。

    !

    引用符 (34) : 文字列リテラルを囲みます。"

    二重引用符 : NULL 文字列 ("") を指定します。

    引用符付きの文字列内では、リテラル引用符文字を指定します。

    ""

    Caché ObjectScript リファレンス                                                                                                     1

  • 名前と使用法記号

    シャープ記号 (35) : 二項モジュロ除算演算子。

    READ コマンドおよび WRITE コマンドでは改ページ。固定長の READ

    では読み取る文字数。

    クラス内からクラス・パラメータの値を参照するための接頭語 (例)

    #ParameterName

    マクロ指示接頭語 (例) #Define、#Include、#If

    実行時式の区切り文字 (例) #(expr)# (expr は Caché ObjectScript 式)

    #

    二重シャープ記号 : オブジェクト・クラス・メソッド呼び出し接頭語 (例)

    DO ##class(method)。SQL シェル呼び出し接頭語 (例) ##sql(SQL

    command)

    コンパイル時式の区切り文字 (例) ##(expr)## (expr は Caché

    ObjectScript 式)

    ##

    ドル記号 (36) : 内部 (システム)関数接頭語 (例) $name(parameters)。

    特殊変数接頭語 (例) $name

    ZBREAK コマンドとともに使用します。

    $

    二重ドル記号 : 外部 (ユーザ記述) 関数接頭語 (例) $$name(parame-

    ters)。コンテキストが外部関数参照によって構築されたとき、$$ は

    $STACK によって返されます。

    ルーチンを直接呼び出すためのルーチン名の接頭語。

    $$

    三重ドル記号 : マクロ呼び出し接頭語。$$$

    パーセント記号(37) :以下で、名前の最初の文字として使用できます。

    (1) 特殊な有効範囲のルールを持つ "% variable" を示し、ロックに使用

    するローカル変数名。(2) 一般にシステム・ユーティリティを示すルーチ

    ン名。(3) %SYSTEM..class や %Library.class などのパッケージ・クラス

    名。(4) %New() や %OpenId(value) などのメソッド名。(5) ラベル。

    マクロ引数 の最初に記述する必要があります。

    $ZSEARCH の VMS 単一文字ワイルドカード。

    埋め込みSQL変数の接頭語 (例) %msg、%ROWCOUNT。SQLキーワー

    ドの接頭語 (例) %STARTSWITH。

    %

    2                                                                                                     Caché ObjectScript リファレンス

    記号および省略形

  • 名前と使用法記号

    二重パーセント記号 : 擬似フィールド参照変数キーワードの接頭語

    (例) %%CLASSNAME、%%CLASSNAMEQ、%%ID、%%TABLENAME。Caché

    ObjectScriptの計算フィールド・コードおよびトリガ・コードで使用されま

    す。

    %%

    アンド記号 (38) :二項And論理演算子。$BITLOGICビット文字列And

    演算子。

    埋め込みコードのシェル呼び出し接頭語(例) &sql(SQL コマンド)、

    &js、&html。

    UNIX バッチ・コマンド。

    &

    二重アンド記号 : 二項 And 論理演算子。&&

    アポストロフィ (39) : 単項Not演算子。論理演算子 '& (Not And)、'!(Not

    Or)、リレーショナル演算子 '= (not equal to)、'< (not less than)、'> (not

    greater than)、パターン・マッチ '(operand?pattern) を組み合わせて使

    用できます。

    ヨーロッパ式 数値グループ・セパレータ。

    '

    括弧 (40,41) : プロシージャや関数のパラメータ・リストを囲みます。空

    白の場合でも括弧は必須です。

    式を入れ子にします。入れ子によって Caché の既定である演算子の

    左から右への評価をオーバーライドし、式に優先順位を指定することが

    できます。

    ローカル変数 : a(1,1)、またはグローバル変数 : ^a(1,1) の配列添え字

    を指定します。

    代替パターン・マッチ (? に続く) を囲みます。

    NEW と KILL コマンドにより排他的に表示します。

    後置条件にスペースを含む場合に必要です。

    &sql シェル呼び出しコマンドに続く埋め込み SQL コードを囲みます。

    (例) &sql(SQL コマンド)

    ( )

    Caché ObjectScript リファレンス                                                                                                     3

    Caché ObjectScript で使用する記号

  • 名前と使用法記号

    アスタリスク (42) : 乗算演算子。

    $ZSEARCH では、0、1、または複数の文字のワイルドカード。

    WRITE コマンドでは、整数式を指定します。

    $ZTRAP文字列値の接頭語として、コール・スタック・レベルが変更され

    ないように指定します。

    *

    二重アスタリスク : 二項指数演算子。**

    アスタリスク・スラッシュ 複数行コメントの末端文字。コメントは、/* で

    開始します。

    */

    プラス記号 (43) : 単項算術プラス演算子。

    加算演算子。

    行オフセット文字 (例) label+offset

    LOCK と ZBREAK コマンドで、インジケータを有効にし/インクリメントし

    ます。

    +

    コンマ (44) : 関数およびプロシージャでは複数のパラメータの分離記

    号。

    コマンドでは複数の引数の区切り文字。

    配列変数では添え字レベルの分離記号。

    アメリカの数値グループ・セパレータまたはヨーロッパの 10 進小数点

    文字 (設定可能)。

    $ECODE ではエラー・コードを囲みます。(例) ,M7,

    ,

    二重コンマ :関数では、未指定の位置パラメータ (既定値を取る)のプ

    レースホルダ。

    ,,

    マイナス記号 (45) : 単項算術マイナス演算子。

    減算演算子。

    LOCK と ZBREAK コマンドで、インジケータをディクリメント、または削

    除します。

    二重マイナス記号 : ZBREAK コマンドとともに使用します。– –

    4                                                                                                     Caché ObjectScript リファレンス

    記号および省略形

  • 名前と使用法記号

    ピリオド (46) : アメリカの 10 進小数点文字またはヨーロッパの数値グ

    ループ・セパレータ (設定可能)。

    オブジェクトのメソッドやプロパティの参照に使用するオブジェクト・ドッ

    ト構文 (例) person.Name

    WindowsおよびUNIX :パス名またはパス名の一部として、現在のディ

    レクトリを指定します。$ZSEARCHや $ZUTIL(12) などで使用されます。

    パターン・マッチの繰り返し文字。

    グローバル名やルーチン名 に組み込まれる場合があります。

    参照渡しを指定する変数または配列名の接頭語 (例) .name

    引数なしの DO コマンドの後の、コードのブロック構造の行接頭語。

    .

    二重ピリオド : Windows および UNIX : パス名またはパス名の一部と

    して、現在のディレクトリの親ディレクトリを指定します。$ZSEARCH や

    $ZUTIL(12) などで使用されます。

    ..

    スラッシュ (47) : 除算演算子 (残余あり)。

    OPEN、CLOSE、USEコマンドでは、入出力キーワード・パラメータ接頭

    語。READ と WRITE コマンドでは、デバイス・コントロール・ニーモニッ

    ク接頭語。

    ZBREAK コマンドとともに使用します。

    /

    二重スラッシュ : 単一の行のコメント文字。//

    スラッシュ・アスタリスク : 複数行コメント の開始文字。コメントは、*/

    で終了します。

    /*

    コロン (58) : コマンドでの 後置条件文字 (例) WRITE:x=0 "nothing"

    コマンドでの パラメータ付きの引数 (例) lockvar:timeout

    SQL トリガ・コードなど、埋め込み ObjectScript コード内の Caché

    ObjectScript ラベルを示す接頭語。この場合、1 列目でラベルをコード

    化することはできません。

    :

    セミコロン (59) : 単一の行のコメント文字。;

    二重セミコロン : 維持されたコメント文字。;;

    Caché ObjectScript リファレンス                                                                                                     5

    Caché ObjectScript で使用する記号

  • 名前と使用法記号

    より小さい (60) : より小さい演算子。

    &js または &html シェル呼び出しコマンドに続く埋め込み JavaScript

    コードまたは埋め込み HTML コードを囲みます。(例) &js

    <

    以下記号 : 以下演算子。

    以上記号 : 以上演算子。>=

    Not 演算子、より大きい : 以下演算子。'>

    疑問符 (63) : パターン・マッチ演算子。

    $ZSEARCH では、単一文字のワイルドカード。

    READ コマンドや WRITE コマンドでは行開始文字。

    ZBREAK コマンドではヘルプ・テキスト。

    ?

    アット記号 (64) : 間接演算子。添え字間接演算子の場合、

    @array@(subscript) のようになります。

    @

    文字 "A" (65,97) : パターン・マッチ・コード (? に続く)。A, a

    文字 "C" (67,99) : パターン・マッチ・コード (? に続く)。C, c

    文字 "E" (69,101) : 指数演算子。大文字 "E" は標準の指数演算子

    で、小文字 "e" は設定可能な指数演算子です。"$ZUTIL(69,63)" を参

    照してください。

    パターン・マッチ・コード (? に続く)。

    E, e

    文字 "I" (73,105) : $NUMBER 関数では整数文字。I, i

    文字 "L" (76,108) : パターン・マッチ・コード (? に続く)。L, l

    文字 "N" (78,110) : パターン・マッチ・コード (? に続く)。N, n

    文字 "P" (80,112) : パターン・マッチ・コード (? に続く)。P, p

    6                                                                                                     Caché ObjectScript リファレンス

    記号および省略形

  • 名前と使用法記号

    文字 "U" (85,117) : パターン・マッチ・コード (? に続く)。U, u

    角括弧 (開始) (91) : 二項包含関係演算子。[

    角括弧 (91,93) : 拡張グローバル参照では、ネームスペース名を囲み

    ます。(例) ^["namespace"]global。構造化システム変数 (SSVNs) で使

    用します。(例) ^$["namespace"]GLOBAL()。

    [ ]

    バックスラッシュ (92) : 整数除算演算子 (残余なし)。\

    角括弧 (終了) (93) : 二項後続関係演算子。]

    二重角括弧 (終了) : 二項前後関係演算子。]]

    キャレット (94) : グローバル変数名接頭語 (例) ^myglobal(i)

    ルーチン呼び出し接頭語 (例) DO ^routine や DO label^routine

    暗黙のネームスペース接頭語 (例) ^system^dir

    ^

    二重キャレット : 現在のシステムに対する暗黙のネームスペース接頭

    語 (例) ^^dir

    ^^

    キャレット・ドル記号 : 構造化システム変数の接頭語 (例) ^$GLOBAL^$

    キャレット・パーセント :システム・グローバル変数接頭語 (例) ^%utility

    や ^%qStream

    ^%

    キャレット括弧:ネイキッド・グローバル参照。最新の添え字付きグロー

    バル名は暗黙です。(例) ^(1,2)

    ^(

    アンダースコア (95) : 二項結合演算子。_

    中括弧 (123,125) : IF、FOR、DO WHILE、WHILE コマンドを持つプロ

    シージャで使用されるコード・ブロック・デリミタ。

    SQL 計算コードでは、フィールド名を囲みます。この場合、空白スペー

    スを使用することはできません。(例) SET {Age}=18

    { }

    中括弧内のアスタリスク : SQL 計算コードでは、現在の SQL フィール

    ド名を指定します。

    {*}

    垂直バー (124) : $BITLOGIC ビット文字列 OR 演算子。

    拡張グローバル参照では、ネームスペース名を囲みます。(例)

    ^["namespace"]global。構造化システム変数 (SSVNs) で使用します。

    (例) ^$["namespace"]GLOBAL()。

    |

    二重垂直バー : 二項 OR 論理演算子。||

    Caché ObjectScript リファレンス                                                                                                     7

    Caché ObjectScript で使用する記号

  • 名前と使用法記号

    チルダ (126):$BITLOGIC ビット文字列 NOT (1 の補数) 演算子。~

    Caché ObjectScript で使用する省略形

    Caché ObjectScript で使用可能なコマンド、関数、および特殊変数の省略形の表

    省略形の表以下は、Caché ObjectScript で使用される略名です。すべてではありませんが、ほとんどの Caché

    ObjectScript コマンド、関数、および特殊変数には、略名があります。コード文字として使用するそ

    の他の文字の使用法は、"Caché ObjectScript で使用する記号" の表を参照してください。

    完全名省略形

    $ASCII 関数$A

    BREAK コマンドB

    CLOSE コマンドC

    $CHAR 関数$C

    DO コマンドD

    $DATA 関数$D

    ELSE コマンド (従来のバージョンのみ)E

    $EXTRACT 関数$E

    $ECODE 特殊変数$EC

    $ESTACK 特殊変数$ES

    $ETRAP 特殊変数$ET

    FOR コマンドF

    $FIND 関数$F

    $FNUMBER 関数$FN

    GOTO コマンドG

    $GET 関数$G

    ^$GLOBAL 構造化システム変数^$G

    HALT コマンド (引数なし) または HANG コマンド (引数あり)H

    8                                                                                                     Caché ObjectScript リファレンス

    記号および省略形

  • 完全名省略形

    $HOROLOG 特殊変数$H

    IF コマンドI

    $INCREMENT 関数 (引数あり) または $IO 特殊変数 (引数なし)$I

    $INUMBER 関数$IN

    JOB コマンドJ

    $JUSTIFY 関数 (引数あり) または $JOB 特殊変数 (引数なし)$J

    ^$JOB 構造化システム変数^$J

    KILL コマンドK

    $KEY 特殊変数$K

    LOCK コマンドL

    $LENGTH 関数$L

    ^$LOCK 構造化システム変数^$L

    $LISTBUILD 関数$LB

    $LISTDATA 関数$LD

    $LISTFIND 関数$LF

    $LISTFROMSTRING 関数$LFS

    $LISTGET 関数$LG

    $LIST 関数$LI

    $LISTLENGTH 関数$LL

    $LISTSAME 関数$LS

    $LISTTOSTRING 関数$LTS

    MERGE コマンドM

    NEW コマンドN

    $NEXT 関数$N

    $NAME 関数$NA

    $NUMBER 関数$NUM

    OPEN コマンドO

    Caché ObjectScript リファレンス                                                                                                     9

    Caché ObjectScript で使用する省略形

  • 完全名省略形

    $ORDER 関数$O

    PRINT コマンドP

    $PIECE 関数 (引数あり) または $PRINCIPAL 特殊変数 (引数なし)$P

    QUIT コマンドQ

    $QUERY 関数 (引数あり) または $QUIT 特殊変数 (引数なし)$Q

    $QLENGTH 関数$QL

    $QSUBSCRIPT 関数$QS

    READ コマンドR

    $RANDOM 関数$R

    ^$ROUTINE 構造化システム変数^$R

    $REVERSE 関数$RE

    SET コマンドS

    $SELECT 関数 (引数あり) または $STORAGE 特殊変数 (引数なし)$S

    $STACK 関数 (引数あり) または $STACK 特殊変数 (引数なし)$ST

    $TEXT 関数 (引数あり) または $TEST 特殊変数 (引数なし)$T

    TCOMMIT コマンドTC

    $TLEVEL 特殊変数$TL

    $TRANSLATE 関数$TR

    TROLLBACK コマンドTRO

    TSTART コマンドTS

    USE コマンドU

    VIEW コマンドV

    $VIEW 関数$V

    WRITE コマンドW

    XECUTE コマンドX

    $X 特殊変数 (省略形なし)$X

    $Y 特殊変数 (省略形なし)$Y

    10                                                                                                   Caché ObjectScript リファレンス

    記号および省略形

  • 完全名省略形

    $ZA 特殊変数 (省略形なし)$ZA

    ZBREAK コマンドZB

    $ZBOOLEAN 関数 (引数あり) または $ZB 特殊変数 (引数なし、省略

    形なし)

    $ZB

    $ZCYC 関数 (引数あり) または $ZCHILD 特殊変数 (引数なし)$ZC

    $ZCONVERT 関数$ZCVT

    $ZDATE 関数$ZD

    $ZDATEH 関数$ZDH

    $ZDATETIME 関数$ZDT

    $ZDATETIMEH 関数$ZDTH

    $ZERROR 特殊変数$ZE

    $ZF関数 (省略形なし)。$ZF(-1)、$ZF(-2)、$ZF(-3)、$ZF(-4)、$ZF(-5)、

    および $ZF(-6) 関数も参照。

    $ZF

    $ZHEX 関数 (引数あり) または $ZHOROLOG 特殊変数 (引数なし)$ZH

    ZINSERT コマンドZI

    $ZIO 特殊変数$ZI

    $ZISWIDE 関数$ZIS

    ZKILL コマンドZK

    ZLOAD コマンドZL

    $ZLASCII 関数$ZLA

    $ZLCHAR 関数$ZLC

    ZNSPACE コマンドZN

    $ZNAME 特殊変数$ZN

    $ZORDER 特殊変数$ZO

    ZPRINT コマンドZP

    $ZPREVIOUS 関数 (引数あり) または $ZPARENT 特殊変数 (引数な

    し)

    $ZP

    ZQUIT コマンド (省略が有効な場合のみ)ZQ

    Caché ObjectScript リファレンス                                                                                                   11

    Caché ObjectScript で使用する省略形

  • 完全名省略形

    ZREMOVE コマンドZR

    $ZREFERENCE 特殊変数$ZR

    ZSAVE コマンドZS

    $ZSTORAGE 特殊変数$ZS

    $ZSEARCH 関数$ZSE

    $ZTIME 関数 (引数あり) または $ZTRAP 特殊変数 (引数なし)$ZT

    $ZTIMEH 関数$ZTH

    $ZTIMESTAMP 特殊変数$ZTS

    $ZTIMEZONE 特殊変数$ZTZ

    $ZVERSION 特殊変数$ZV

    $ZUTIL 関数$ZU

    ZWRITE コマンドZW

    $ZWASCII 関数$ZWA

    $ZWBPACK 関数$ZWBP

    $ZWBUNPACK 関数$ZWBUNP

    $ZWCHAR 関数$ZWC

    $ZWPACK 関数$ZWP

    $ZWUNPACK 関数$ZWUNP

    12                                                                                                   Caché ObjectScript リファレンス

    記号および省略形

  • Caché ObjectScript コマンド

    この章では、Caché ObjectScript がサポートしているコマンドについて、詳しく説明します。このマ

    ニュアルでは、Caché ObjectScript コマンドが以下の 3 つのグループに分類されています。

    • 汎用的なコマンド

    • ルーチンおよびデバッグ・コマンド (名前が "Z" で始まるコマンド)

    • 従来の (差し替えられた) コマンド

    各グループ内のコマンドの説明はアルファベット順になっています。

    ObjectScript コマンドに関する全般的な詳細は、"Caché ObjectScript の使用法" の "コマンド" の

    章を参照してください。

    ほとんどのコマンドには省略形があります。通常は、コマンド名の最初の文字が省略形となりますが、

    文字 Z で始まるコマンドの場合はコマンド名の最初の 2 文字が省略形となります。各コマンドの概

    要では、最初に完全名を使用した構文が示され、その下に略名を使用した構文が示されます (略

    名がある場合)。

    各コマンドの概要には、実際に構文に使用される句等点文字のみが含まれます。構文中のオプショ

    ン要素を明確にするなど、形式規約のための句等点は使用されていません。その種の情報は、概

    要の直後にある引数の表で説明されます。

    1つの例外は省略記号(...)です。コンマの後の省略記号は、コンマの前の引数(または引数グルー

    プ) が、コンマ区切りリストとして複数回繰り返し可能であることを示します。中括弧 { . . . } の中の省

    略記号は、1つ以上のコマンドを含むコード・ブロックを中括弧内に記述できることを示します。中括

    弧はコード内で指定する必要のあるリテラル文字です。

    ほとんどのコマンドは、1 つ以上の引数を取ります。引数とは、コマンドのアクションを定義または制

    御する式(例えば、関数とそのパラメータ、変数、演算子とそのオペランド、オブジェクト・プロパティ、

    オブジェクト・メソッドなど) です。コマンドで複数の引数が使用される場合は、一般的に引数リストと

    して参照されます。一部のコマンドでは、その引数自体が引数パラメータを取る場合があります。例

    えば、DOコマンドの各引数はパラメータ・リストを取ることができます。これらの情報は構文に示され

    ます。

    一部のコマンドは引数なしです。つまり、引数をまったく取らずに実行できます。また、どのような状

    況でも引数を取らないコマンドもあれば、特定の状況でのみ引数を取るコマンドもあります。後者の

    コマンドでは、引数のない場合と、引数リストがある場合で、その意味が異なります。

    ほとんどのコマンドは、コマンド実行の可否を決定する条件を指定する、オプションの後置条件式を

    取ることができます。後置条件式は、コマンド名の後にコロン (:) を使用して追加します。コマンド名

    とその後置条件式の間に、スペースや改行を挿入することはできません。厳密に言うと、後置条件

    Caché ObjectScript リファレンス                                                                                                   13

  • 式はコマンド引数ではありませんが、このマニュアルでは引数と一緒に説明されます。引数なしコマ

    ンドも後置条件式を取ることができます。

    ほとんどの Caché ObjectScript コマンドは、すべてのハードウェア・プラットフォーム上で同様に機

    能します。プラットフォーム固有のコマンド機能には、それがサポートされるプラットフォームの種類

    が明示されています (Windows、UNIX、OpenVMS など)。プラットフォームの制限が記載されていな

    いコマンドは、すべてのプラットフォームでサポートされます。

    BREAK

    引数がない場合は、現在のルーチンの実行を中断し、プログラマ・モードに制御を戻します。引数

    がある場合は、中断を有効、または無効にします。

    BREAK:pc statusB:pc status

    BREAK:pc "extend"B:pc "extend"

    引数

    オプション — 後置条件式。pc

    オプション — 中断の有効、または無効を切り換えます。有効な値は 0 (中断

    の無効化) および 1 (中断の有効化) です。extend 引数と一緒に使用するこ

    とはできません。

    status

    オプション — 引用符付きの文字列として指定された、有効化または無効化

    対象の中断の種類を示すコード。有効な値は、"BREAK の拡張引数" に一

    覧表示されています。status 引数と一緒に使用することはできません。

    extend

    概要BREAK コマンドには、以下の 2 つの基本形式があります。

    • 引数なし

    • 引数付き

    引数なしの BREAK

    ルーチン・コードに挿入された引数なしの BREAK は、処理中のルーチンの実行を中断し、デバッ

    グ目的のプログラマ・モードに制御を戻します。

    14                                                                                                   Caché ObjectScript リファレンス

    Caché ObjectScript コマンド

  • コードに含まれる引数なしの BREAKは、ブレークポイントを設定します。ブレークポイントはルーチ

    ンの実行を中断し、プロセスをプログラマ・モードに戻します。しかし、BREAKを使用してブレークポ

    イントを設定するよりも、ZBREAKコマンドを使用してCachéデバッガを実行することを推奨します。

    引数付きの BREAK

    BREAK status によって、中断を有効、または無効にすることができます。

    BREAK extendによって、ブレークポイントの指定されたタイプを有効、または無効にすることができ

    ます。詳細は、"BREAK の拡張引数" を参照してください。

    引数

    pc

    オプションの後置条件式。Caché は、後置条件式が真 (0 以外の数値) の場合に BREAK コマンド

    を実行します。Caché は、後置条件式が偽 (0) の場合はコマンドを実行しません。詳細は、"Caché

    ObjectScript の使用法" の "コマンド後置条件式" を参照してください。

    status

    中断の有効、または無効を切り替えます。0 の場合、中断は無効です。1 の場合、中断は有効で

    す。

    例プログラマ・プロンプトで実行された場合、またはソース・コードに入力された以下の例の場合、ユー

    ザは CTRL-C で処理を中断できます。

    B 1 ; Enable user interrupts with

    メモ

    BREAK コマンドの構文

    Caché ObjectScript の従来のバージョンでは、BREAK コマンドの省略形 (B) だけが使用されてい

    ました。現在のバージョンは、どちらの形式も使用されています。

    引数なしの BREAK コマンド

    引数なしの BREAK コマンドは、プログラムのソース・コードで使用できます。後置条件式は付けて

    も付けなくてもかまいません。このコマンドは、プログラムの実行を中断し、プログラマ・プロンプトに

    戻ります。

    引数なしの BREAK をルーチン内に含めると、その位置にブレークポイントが設定されます。コード

    にブレークポイントを挿入することによって、特定のコンテキスト単位でデバッグを行うことができま

    す。実行中に BREAK に出会うと、Caché はルーチンを中断し、プログラマ・プロンプトに戻ります。

    そして、他のCaché ObjectScript コマンドを使用して、デバッグを実行できます。例えば、WRITE コ

    Caché ObjectScript リファレンス                                                                                                   15

    BREAK

  • マンドを使用して、中断中の箇所の変数値を調べたり、SET コマンドを使用して、その変数やそれ

    以外の変数に新しい値を指定したりすることができます。ルーチン行エディタ (XECUTE ^%) を呼び

    出して、ルーチンを修正することもできます。BREAK を使用してルーチンの実行を中断した後、引

    数なしの GOTO を使用して、通常の実行を再開することができます。または、GOTO コマンドの引

    数で異なる場所を指定して、他の場所から実行を再開することもできます。

    注釈: コード内では BREAK コマンドではなく、ZBREAK コマンドを使用して Caché デバッガを

    呼び出すことを推奨します。デバッガには、多彩なデバッグ機能があります。

    引数なしの BREAK を条件付きで使用する

    コード内の引数なしの BREAK コマンドに条件を指定すると、ルーチンを変更しなくても、単に変数

    を設定するだけで同じコードを再実行できるので便利です。例えば、以下のルーチンを考慮してみ

    ましょう。

    BREAK:$DATA(debug)

    変数 debug を設定すると、ルーチンを中断し、ジョブをプログラマ・モードに戻すことができます。ま

    た、変数 debug をクリアすると、ルーチンの実行を継続できます。

    BREAK コマンドでユーザからの中断を設定する

    BREAK status を使用して、CTLR-C などのユーザによるルーチンの中断を制御できます。status

    の有効値は、1 (有効)、または 0 (無効) です。

    • BREAK 1 と指定すると、そのプロセスを所有している端末からの中断が有効になります。

    • BREAK 0 と指定すると、そのプロセスを所有している端末からの中断が無効になります。

    関連する OPEN コマンド、または USE コマンドの引数リストで指定されている端末に対して、中断

    を特に有効にしなかった場合でも、振る舞いは同じです。

    注釈: 中断を有効にする OPEN コマンドを実行した後で BREAK 0 を実行しても、Caché

    ObjectScript では無効になります。

    BREAK の拡張引数

    中断したいルーチンのすべての位置に、引数なしBREAKコマンドを置く必要はありません。BREAK

    には "拡張された"一連の引数 (extend) があり、この引数を使用してコードのいたるところに引数な

    しの BREAK コマンドを挿入した場合と同じように、一定間隔を空けてルーチンを中断させることが

    できます。以下の表は、さまざまな BREAK コマンド拡張引数です。

    16                                                                                                   Caché ObjectScript リファレンス

    Caché ObjectScript コマンド

  • 概要引数

    BREAK "S" (シングル・ステップ) を使用すると、Caché ObjectScript コマン

    ドごとに処理が中断され、コードのコマンドを一度に 1 つずつ実行します。

    システムが DO コマンド、XECUTE コマンド、FOR ループ、またはユーザ定

    義関数を処理するときは中断されませんが、これらのコマンドやループの処

    理が終わると、コマンドごとに処理が中断されます。

    "S"

    BREAK "S-"を使用すると、現在のレベルでのシングル・ステップ処理が無

    効になり、1 つ前のレベルでのコマンド・ステップ処理が可能になります。

    "S-"

    BREAK "S+" は BREAK "S" と同じように、コマンドごとに処理を中断しま

    す。ただし、BREAK "S" と異なり、DOコマンド、XECUTEコマンド、FORルー

    プ、またはユーザ定義関数に遭遇した場合も処理が中断されます。

    "S+"

    BREAK "L" (行ブレーク) を使用して、各行の最初で処理を中断しながら、

    コードを単一ルーチン行ごとに実行します。DOコマンド、XECUTEコマンド、

    またはユーザ定義関数に遭遇した場合、システムはブレークを停止し、コマ

    ンドあるいは関数の終了後にブレークを再開します。

    "L"

    BREAK "L-"を使用すると、現在のレベルでのシングル・ステップ処理が無

    効になり、1 つ前のレベルでの行ステップ処理が可能になります。

    "L-"

    BREAK "L+" は BREAK "L" と同じように動作します。ただし、BREAK "L"

    と異なり、DOコマンド、XECUTEコマンド、またはユーザ定義関数に遭遇す

    ると、各ルーチン行の最初で処理を中断します。

    "L+"

    ブレークを停止するには、BREAK "C" (クリア・ブレーク) を使用します。

    BREAKが、上位のルーチン・レベルで有効になっている場合は、そのジョブ

    が QUIT を実行した後、そのレベルで処理の中断が再開されます。

    "C"

    BREAK "OFF"は、プロセスに対して構築されたすべてのデバッグを削除し

    ます。これは、すべてのブレークポイントとウォッチポイントを削除し、すべて

    のプログラム・スタック・レベルでステップを無効にします。また、デバックと

    トレース・デバイスに関連するものも削除しますが、それらをクローズしませ

    ん。

    "OFF"

    上記の引数に関する詳細は、"Caché ObjectScript の使用法" の "デバッグ" を参照してください。

    BREAK "OFF" コマンドの使用法は、以下の一連のコマンドの使用法と類似しています。

    ZBREAK /CLEAR ZBREAK /TRACE:OFF ZBREAK /DEBUG:"" ZBREAK /ERRORTRAP:ON BREAK "C" ; applied to all stack levels

    関連項目

    • ZBREAK コマンド

    Caché ObjectScript リファレンス                                                                                                   17

    BREAK

  • • OPEN コマンド

    • USE コマンド

    • "$ZUTIL(68,5) 引数のない BREAK プロセスのスイッチ" 関数

    • "$ZUTIL(69,5) 引数のない BREAK のシステムの既定" 関数

    • "Caché ObjectScript の使用法" の "デバッグ"

    • "Caché 入出力デバイス・ガイド" の "ターミナル入出力"

    CLOSE

    デバイスをシャットダウンします。

    CLOSE:pc closearg,...C:pc closearg,...

    closearg には、以下を指定できます。

    device:parameters

    引数

    オプション — 後置条件式。pc

    クローズされるデバイス。device

    オプション — デバイスの特性を設定するのに使用されるパラメータの

    リスト。

    parameters

    概要CLOSE device は、指定されたデバイスの所有権を解放し、オプションで特定のデバイス特性を設

    定し、それを利用可能デバイス・プールに返します。プロセスが指定されたデバイスを所有していな

    い場合、システムはこの CLOSE を無視します。

    引数

    pc

    オプションの後置条件式。Caché は、後置条件式が真 (0 以外の数値) の場合に CLOSE コマンド

    を実行します。Caché は、後置条件式が偽 (0) の場合はコマンドを実行しません。詳細は、"Caché

    ObjectScript の使用法" の "コマンド後置条件式" を参照してください。

    18                                                                                                   Caché ObjectScript リファレンス

    Caché ObjectScript コマンド

  • device

    クローズされるデバイス。�