CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-22
SMU_Assign_GetValue_
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_Assign_GetText_ returns one of the following values:
SMU_Assign_GetValue_
The SMU_Assign_GetValue_ function retrieves a part of an ASSIGN message as an
integer and assigns it to a numeric variable.
message_number
is an integer expression that identifies the ASSIGN message from which to retrieve
a value.
message_number must have a value greater than 0.
portion
is the identifier of an ASSIGN message integer part to retrieve. portion is one of:
Return
Value Meaning
0 The operation is successful. The retrieved Tandem file name is all blanks.
> 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:
•
message_number, portion_bytes, or max_text_bytes has an
invalid value.
•
The specified ASSIGN message does not exist.
•
portion does not identify a defined textual part of an ASSIGN message or
identifies a nonexistent part.
INT PROC SMU_Assign_GetValue_ ( message_number,
portion:portion_bytes, value )
EXTENSIBLE;
INT message_number; ! in, required
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required
INT .EXT value; ! out, optional 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
EXCLUSION Exclusion mode —0 for shared, 1 for protected, and 3 for
exclusive