FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-21
Saved Message Utility
Saved Message Utility
The Saved Message Utility (SMU) is a collection of routines that are extensions to the
HP FORTRAN product. Table 15-2 lists the SMU routines. You use these routines to
save and modify the messages sent to your process by the operating system. The
Guardian Procedure Calls Reference Manual contains a complete description of these
messages.
The first part of this subsection describes how you use the SMU routines. The second
part lists all the SMU routines in alphabetical order, and includes the syntax and usage
considerations for each routine.
When TACL starts a process, it sends a series of messages to the process that
describe the following:
•
The IN file
•
The OUT file
•
The default volume and subvolume
•
Current ASSIGN values
•
Current PARAM values
•
Additional text specified with the RUN command
If you want to save these messages, you can use the SAVE directive to specify which
messages to save, and then use SMU routines to retrieve them. If your program
initiates other processes, you can use the SAVE directive to save the messages that
describe the startup environment of the parent process, and then use SMU routines to
customize the startup environment for the new processes.
Table 15-2. Saved Message Utility Routines (page 1 of 2)
Name Action
ALTERPARAMTEXT Creates or replaces the value for a specific parameter name, in
the PARAM message, with the option of trailing blanks in the new
value.
CHECKLOGICALNAME Checks whether an ASSIGN message with a given logical file
name exists.
CHECKMESSAGE Checks whether a specific message exists.
CREATEPROCESS Creates a new process and sends the initial ASSIGN, PARAM,
and startup messages.
DELETEASSIGN Deletes a portion or all of an ASSIGN message.
DELETEPARAM Deletes a portion or all the PARAM message.
DELETESTARTUP Deletes the entire startup message.
GETASSIGNTEXT Retrieves a portion of an ASSIGN message as text and assigns it
to a string variable.