CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-26
SMU_Message_CheckNumber_
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.
value
is a new value for the message part specified in portion. The new value must be
appropriate for the message part it creates or replaces.
Return Value
SMU_Assign_PutValue_ returns one of the following values:
SMU_Message_CheckNumber_
The SMU_Message_CheckNumber_ function determines whether a message exists or
reports the number of the highest-numbered saved ASSIGN message.
EXCLUSION Exclusion mode—0 for shared, 1 for protected, and 3 for
exclusive
FILECODE File code
PRIEXT Primary extent size
RECSIZE Record size
SECEXT Secondary extent size
Return
Value Meaning
0 The operation is successful.
-1 The operation failed because of a logic error, such as:
•
message_number or portion_bytes has an invalid value.
•
The specified ASSIGN message does not exist.
•
portion does not identify a defined integer part of an ASSIGN message.
•
value is invalid for the specified part.
-2 Making changes would invalidate the backup process.
-3 The environment has insufficient allocatable space to complete the operation.
INT PROC SMU_Message_CheckNumber_ ( message_number )
EXTENSIBLE;
INT message_number; ! in, required TNS,native