CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-30
SMU_Startup_Delete_
text_bytes
is the 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.
If the specified parameter name exists, the function assigns
text as the associated
parameter value. If the parameter name does not exist, the function creates the
parameter (or PARAM message if necessary) and assigns
text as the associated
parameter value.
Return Value
SMU_Param_PutText_ returns one of the following values:
SMU_Startup_Delete_
The SMU_Startup_Delete_ function deletes the entire startup message.
portion
is the following value:
Return
Value Meaning
0 The operation is successful. A null string is assigned.
> 0 The operation is successful. The return value gives the length, in bytes, of the
assigned text after blank truncation.
-1 The operation failed because of a logic error, such as:
•
portion_bytes or text_bytes has an invalid value.
•
text contains more than 255 characters after blank truncation.
•
portion contains a name that does not follow PARAM name rules.
•
The total length of the new PARAM message exceeds the maximum length
permitted.
-2 The operation failed because making changes would invalidate the backup
process.
-3 The environment has insufficient allocatable space to complete the operation.
INT PROC SMU_Startup_Delete_( portion:portion_bytes)
EXTENSIBLE;
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required TNS,native
*ALL* Deletes the entire startup message.