CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-13
CLU_Process_File_Name_
tdm_file_name
•
If call_type is 0, tdm_file_name is a variable to contain the retrieved
Guardian file name of the located FCB.
The retrieved file name is in external format; for example, $A.B.C or =XYZ. If
the variable is larger than the file name, the function left-justifies the name and
fills the remainder of the variable with space characters. If the variable is
smaller than the name, the function truncates the name on the right and
returns a value of -1. (Any COBOL JUSTIFIED clause in the variable
declaration is ignored.) If the current name is a DEFINE name, the function
returns its text, not the associated disk file name or device name, if any.
•
If call_type is 1, tdm_file_name is a new Guardian file name to assign
to the located FCB.
Specify a valid Guardian file name in external format; for example, $A.B.C or
=XYZ. If the variable is larger than the name, you must fill the remainder of the
variable with space characters. The function ignores trailing space characters.
tdm_file_name_size
is the size, in bytes, of tdm_file_name. For TAL, you must specify this value.
For COBOL and FORTRAN, the compiler implicitly computes and transmits this
value to the function.
file_name
•
If call_type is 0, file_name is a variable to contain the retrieved logical
file name of the located FCB.
•
If call_type is 1, file_name is ignored.
file_name_size
is the size, in bytes, of file_name. For TAL, you must specify this value if
file_name is present. For COBOL and FORTRAN, the compiler implicitly
computes and transmits this value to the function.