CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-28
SMU_Param_GetText_
Return Value
SMU_Param_Delete_ returns one of the following values:
SMU_Param_GetText_
The SMU_Param_GetText_ function obtains a part of the PARAM message as text and
assigns it to a string variable.
portion
specifies what you want to retrieve. portion is one of:
portion_bytes
is the size of portion, in bytes, and must be a value greater than 0. For TAL, you
must supply this value; for COBOL and FORTRAN, the compiler implicitly
computes and transmits this value to the function. If
portion_bytes exceeds the
number of characters in
portion, the first unused character of portion must be
a space character.
text
is a variable to contain the retrieved text. The function extends the text with blanks
on the right side or truncates it as necessary to fit the size of the variable.
Return
Value Meaning
0 The operation is successful.
-1 The operation failed because portion-bytes has an invalid value.
-2 The operation failed because making changes would invalidate the backup
process.
INT PROC SMU_Param_GetText_( portion:portion_bytes,
text:max_text_bytes )
EXTENSIBLE;
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required
STRING .EXT text; ! out, optional
INT max_text_bytes; ! in, optional TNS,native
A parameter
name
Retrieves the text associated with the specified parameter
name (maximum 255 characters).
*ALL* Retrieves the entire PARAM message as a string (a
sequence of bytes).