CRE Programmer's Guide

Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-1
9
Common Language Utility (CLU)
Library Functions
This section presents a set of Common Language Utility (CLU) library functions
provided in the CRE. This section describes functions that enable:
•
COBOL and FORTRAN routines to create processes
•
COBOL and FORTRAN routines to locate and identify file connectors
•
COBOL, FORTRAN, TAL, and pTAL routines to save and manipulate messages
sent to a process by the process that initiated the process
CLU functions are separate and different from CRE functions:
•
TNS CRE functions are located in the file CRELIB. TNS CLU functions are located
in the file CLULIB.
•
TNS CRE functions are configured into the system library. TNS CLU functions
must be explicitly bound into programs that use them.
•
CRE functions work only in the CRE. CLU functions work in the CRE or in certain
language-specific run-time environments.
Two CLU routines are described in this section: CLU_Process_Create_
on page 9-1
and CLU_Process_File_Name_
on page 9-12.
The CLU routines are available only to processes running in the Guardian
environment. Processes running in the OSS environment can use the CRE_Getenv_
and CRE_Putenv_ functions, described in Section 6, CRE Service Functions
, to obtain
environment information.
The SMU functions are listed in Table 9-1
on page 9-18 and are described on the
pages following the table.
CLU_Process_Create_
The CLU_Process_Create_ function provides a facility that creates a process using the
conventions of the TACL RUN command.
Both the TNS CRE and the native CRE support this function. You can use this function
either in the CRE or in a COBOL or FORTRAN run-time environment.
CLU_Process_Create_ first calls the system procedure PROCESS_CREATE_,
passing through all specified parameters. If process creation is successful,
CLU_Process_Create_ sends appropriate process initialization messages, depending
upon the options specified in the parameter
clu_options. Most
PROCESS_CREATE_ functionality is available; however, CLU_Process_Create_
rejects a request for no-wait process creation.