NetCOBOL V11.0 CBL Subroutines User's Guide

6.3 CBL_WRITE_VFILE

This routine writes data in a map object.

Specification

Parameter data definition

01  heap-ID                   PIC 9(4) COMP-5.
01  relative-address-in-heap  PIC 9(4) COMP-5.
01  data-length               PIC 9(4) COMP-5.
01  strings                   PIC X(n).
01  status-code               PIC S9(4) COMP-5.

Calling format

CALL "CBL_WRITE_VFILE"
    USING BY VALUE heap-ID
          relative-address-in-heap
          data-length
          BY REFERENCE strings
    RETURNING status-code.

Interface

heap-ID

Specifies the heap-ID.

relative-address-in-heap

Specifies the relative address in a heap.

data-length

Specifies the length of data to be written.

strings

Specifies the string to be written.

Return code

The return code is set in the status-code specified in the RETURNING clause.

status-code

• 0: Successful

• Other than 0: Failure