CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-24
SMU_Assign_PutText_
message_number
is an integer expression that identifies the ASSIGN message in which to replace
text.
message_number must be a value greater than 0.
portion
is the identifier of a message part. portion is one of:
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.
text
is new text for the specified message part. The text format must be appropriate for
the message part:
text_bytes
is the size of text, in bytes, and must have a non-negative value. For TAL, you
must supply this value; for COBOL and FORTRAN, the compiler implicitly
computes and transmits this value to the function.
If the specified ASSIGN message exists, the function assigns
text as the specified
message part. If the ASSIGN message does not exist and the message part is the
logical file name, the function creates an ASSIGN message, assigns
text as the
logical name part, and marks all other message parts as not present. In either case,
the function truncates any trailing blanks in the supplied text before assigning it.
LOGICALNAME Creates or replaces the logical file name.
TANDEMNAME Creates or replaces the Guardian file name.
LOGICALNAME If a program name is included, the logical file name must be
in one of the following formats (maximum 63 characters):
programname.filename
*.filename
If program name is omitted, the logical file name must be in
the following format (maximum 31 characters):
filename
TANDEMNAME The Guardian file name must be in external format
(maximum 34 characters) and can be all blanks. The
function does not fill in any missing file name components.