CRE Programmer's Guide

Using the Common Language Utility (CLU) Library
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
5-8
Using SMU Routines to Manipulate Messages
•
Specify the message parts to retrieve.
Table 5-7
on page 5-8 lists the message parts you can retrieve and the SMU function
you use for each.
The Get subset of SMU functions enables your program to examine the names of files
and their specified overrides before it tries to open the files. The program can thus be
selective about the files it opens; it can choose among file descriptions according to the
overrides it finds.
You can also use the Get subset of SMU functions to retrieve run-time parameters to a
program. A program can take different actions based on the values specified in
PARAM messages and command line information.
Changing the Environment Information
You can use the Put subset of SMU functions to change the stored values and text in
ASSIGN, PARAM, and startup messages. You can pass different environment
information to descendant processes without changing the environment for subsequent
RUN commands.
Each function in the Put subset is the exact counterpart of a function in the Get subset.
Table 5-7. Retrievable Message Parts
SMU Function Message Part Returns
SMU_Assign_GetText_ LOGICALNAME Logical file name
TANDEMNAME Guardian file name
SMU_Assign_GetValue_ ACCESS Access mode
BLKSIZE Block size
EXCLUSION Exclusion mode
FILECODE File code
PRIEXT Primary disk extent
RECSIZE Record size
SECEXT Secondary extent
SMU_Param_GetText_ The name of a parameter The value of that parameter
SMU_Startup_GetText_ IN Guardian file name of IN file
OUT Guardian file name of OUT file
STRING Value following command run-
option
VOLUME Default volume and subvolume
names