NetCOBOL V11.0 CBL Subroutines User's Guide

9.2 CBL_TOLOWER

This routine converts the characters of a string into lowercase characters.

Specification

Parameter data definition

01 conv-string   PIC X(n).
01 string-length PIC 9(4) COMP-5.
01 status-code   PIC S9(4) COMP-5.

Calling format

CALL "CBL_TOLOWER"
    USING conv-string
      BY VALUE string-length
    RETURNING status-code.

Interface

conv-string

Specifies the string to be converted. After conversion, the converted string is stored in the same area.

string-length

Specifies the length of the string to be converted.

Return code

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

status-code

• 0: Successful

• Other than 0: Failure