call "CBL_ALLOC_DYN_MEM" using mem-pointer by value mem-size flags returning status-code
呼び出しプロトタイプ使用時 (「説明の読み方」を参照) | PIC | |
---|---|---|
mem-pointer | cblt-pointer | USAGE POINTER。レベル 01 にする必要があります。 |
mem-size | cblt-os-size | pic x(4) comp-5
または pic x(8) comp-5 (64 ビットのネイティブ プログラムのみ) |
flags | cblt-os-flags | pic x(4) comp-5
または pic x(8) comp-5 (64 ビットのネイティブ プログラムのみ) |
status-code | 「説明の読み方」を参照 |
ビット 0 から 1 | 予約済み。0 に設定する必要があります。 |
ビット 2 | いずれの呼び出し元プログラムからも独立したメモリとして割り当てます。 |
上記以外のビット | 予約済み。0 に設定する必要があります。 |
0 | 割り当て成功。 |
157 | メモリを割り当てることができない。 |
181 | flags の指定が矛盾している。 |
説明:
割り当てられたメモリについて、特定値への初期化は実行されません。
割り当てられるメモリの最大サイズはオペレーティング システムにのみ制限されます。
CBL_ALLOC_DYN_MEM でビット 2 を設定せずに割り当てられたメモリは、直接的または間接的な呼び出し元である COBOL プログラムがある場合、割り当てを行ったプログラムが論理的または物理的にキャンセルされると解放されます。ビット 2 を設定した場合は、CBL_FREE_DYN_MEM によって解放されていなければ、対応する実行単位が終了したときに解放されます。
このルーチンは、AMODE 指令を有効にしてコンパイルされたサブプログラム内では使用できません。