CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-25
SMU_Assign_PutValue_
Return Value:
•
SMU_Assign_PutText_ returns one of the following values:
SMU_Assign_PutValue_
The SMU_Assign_PutValue_ function creates or replaces an integer part of an
ASSIGN message with the value obtained from an integer variable.
message_number
is an integer expression that identifies the ASSIGN message in which to replace a
value.
message_number must have a value greater than 0.
portion
is the identifier of the ASSIGN message integer part to create or replace. portion
is one of:
Return
Value Meaning
0 The operation is successful. text contains a null string.
> 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:
•
message_number, portion_bytes, or text_bytes has an invalid
value.
•
The specified ASSIGN message does not exist and either portion is
not LOGICALNAME or the new logical file name conflicts with the logical
file name of an existing ASSIGN message.
•
portion does not identify a defined textual part of an ASSIGN message
or identifies a nonexistent part.
•
text has an invalid value for the specified part.
-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_Assign_PutValue_ ( message_number,
portion:portion_bytes, value )
EXTENSIBLE;
INT message_number; ! in, required
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required
INT value; ! in, required TNS,native
ACCESS Access mode—0 for read-write, 1 for read-only, 2 for write-only,
and 3 for extend
BLKSIZE Block mode size