$UPPER (convert string)

$UPPER converts the alphabetic characters specified in the argument character string to upper case.

Organization of this page

Syntax

return-value=$UPPER(character-string)

return-value

Specifies the name of the variable into which the character string that has been converted to upper case is set.
character-string

Specifies the character string to be converted, either as a constant or a variable. A constant must be enclosed in single quotation marks ('').

The following table lists and describes the possible statuses:

Status	Description
`NORMAL`	Normal end
`NODATA`	—
`ERROR`	—
Script execution interrupted	An invalid argument was specified, or an error other than the above occurred.

The following example converts the contents of the variable NAME to upper case, and outputs the result:

[SET_VALUE]
  NAME = 'computer name'
  VAL = $UPPER(NAME)
  MSG = 'UPPER = ' + VAL
  $ECHO(MSG)