CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-29
SMU_Param_PutText_
max_text_bytes
is the maximum size of text, in bytes, and must be a non-negative value. For
TAL, you must supply this value, if
text is present; for COBOL and FORTRAN,
the compiler implicitly computes and transmits this value to the function.
Return Value
SMU_Param_GetText_ returns one of the following values:
SMU_Param_PutText_
The SMU_Param_PutText_ function creates or replaces part of a PARAM message.
portion
is the name of the parameter you want to create or replace.
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 the new text to assign. The function truncates trailing spaces before assigning
the text.
text can have at most 255 characters excluding any trailing blanks.
Return
Value Meaning
> 0 The operation is successful. The return value gives the length, in bytes, of the
retrieved text before truncation or padding.
-1 The operation failed because of a logic error, such as:
•
portion_bytes or max_text_bytes has an invalid value.
•
The specified PARAM message does not exist.
•
portion identifies a parameter name that does not exist in the PARAM
message.
INT PROC SMU_Param_PutText_( portion:portion_bytes,
text:text_bytes )
EXTENSIBLE;
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required
STRING .EXT text; ! in, optional
INT text_bytes; ! in, optional TNS,native