CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-19
SMU_Assign_Delete_
name
is a logical file name of an ASSIGN message. If name includes a program name,
name must have one of the following forms (maximum 63 characters):
programname.filename
*.filename
If name does not include a program name, name must have the following form
(maximum 31 characters):
filename
name_bytes
is the size of name, 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
name_bytes exceeds the
number of characters in
name, the first unused character of name must be a
space character.
Return Value
SMU_Assign_CheckName_ returns one of the following values:
SMU_Assign_Delete_
The SMU_Assign_Delete_ function deletes a part or all of an ASSIGN message.
Return
Value Meaning
< 0 The negated message number of the first ASSIGN message whose logical file
name conflicts with the one supplied; that is, one is qualified and the other is not,
or one is qualified by
∗
and the other is qualified by a program name.
0 The operation failed because of a logic error, such as:
•
No ASSIGN message with the specified logical file name exists.
•
name_bytes is not greater than 0.
•
name does not follow the required format.
> 0 The operation is successful; the return value gives the message number of the
located ASSIGN message.
INT PROC SMU_Assign_Delete_ (message_number,
portion:portion_bytes )
EXTENSIBLE;
INT message_number; ! in, required
STRING .EXT portion; ! in, required
INT portion_bytes; ! in, required TNS,native