CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-21
SMU_Assign_GetText_
SMU_Assign_GetText_
The SMU_Assign_GetText_ function retrieves a part of an ASSIGN message as text
and assigns it to a string variable.
message_number
is an integer expression that identifies the ASSIGN message from which to retrieve
text.
message_number must have a value greater than 0.
portion
identifies what you want to retrieve. portion is one of:
portion_bytes
is the size of portion, in bytes, and must have 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 a variable to contain the retrieved text. The function extends text with blanks
on the right side or truncates it as necessary to match the size of the variable.
INT PROC SMU_Assign_GetText_( message_number,
portion:portion_bytes,
text:max_text_bytes )
EXTENSIBLE;
INT message_number; ! in, required
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required
STRING .EXT text; ! out, optional
INT max_text_bytes; ! in, optional TNS,native
LOGICALNAME Retrieves the logical file name. If it includes a program
name, the text has the following form (maximum 63
characters):
programname.filename
If it omits a program name, the text has the following form
(maximum 31 characters):
filename
TANDEMNAME Retrieves the Guardian file name (maximum 34 characters),
which can be all blanks.
*ALL* Retrieves the entire ASSIGN message as a string (a
sequence of 108 characters).