CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-12
CLU_Process_File_Name_
CLU_Process_File_Name_
The CLU_Process_File_Name_ function processes COBOL and FORTRAN file
connectors. The native CRE does not support this function. You can use this function
either in the TNS CRE or in a COBOL or FORTRAN run-time environment.
The function declaration is presented first, followed by COBOL and FORTRAN
considerations. Here is the function declaration:
call_type
identifies the purpose of the call. call_type must be either:
fcb_address
is the address of an FCB. The input value must be either:
The output value is the address of the located FCB. The ordering of FCBs for the
TNS CRE, however, differs from the ordering for a COBOL or FORTRAN run-time
environment; the first or next FCB might differ depending on the environment. If no
first or next FCB exists, the output is -1.
INT PROC CLU_Process_File_Name_( call_type, fcb_address,
tdm_file_name:tdm_file_name_size,
file_name:file_name_size, open_flag )
extensible;
INT call_type; ! in, required
INT(32) .EXT fcb_address; ! in/out, required
STRING .EXT tdm_file_name; ! in/out, required
INT tdm_file_name_size;! in, required
STRING .EXT file_name; ! out, optional
INT file_name_size; ! in, optional
INT .EXT open_flag; ! out, optional
! TNS only
0 Retrieves current attribute information.
1 Specifies new attribute information; the specified File Control Block (FCB)
must be closed and a valid backup process must not exist.
Input Value call_type Meaning
0 0 Retrieves current information about first
FCB in run unit
FCB address obtained from a
previous call to this function
0 Retrieves current information about next
FCB in run-unit
FCB address obtained from a
previous call to this function
1 Specifies information about next FCB in
run-unit