Convert Character String to Upper Case

This Subprogram converts a source Character String into a destination Character String where all characters will be converted to upper case.

Short Name Calling Sequence

LENGTH = UIUPCA(SRCCHA,DSTCHA)

Long Name Calling Sequence

LENGTH = UI_UPPER_CASE(...)

Input Arguments

SRCCHA (Character) Source String

Output Arguments

DSTCHA (Character) Destination String

Function Value

LENGTH (Integer) Length of String

Note:

1. The Function Value is set to the occupied length (i.e. ignoring trailing spaces or tabs) of the destination string (after any truncation).
2. The source and destination strings may be the same variable. thus:-

   LENGTH = UI_UPPER_CASE(STRING,STRING)

   is valid.