COBOL Manual for TNS/E Programs (H06.03+)

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-20
Saved Message Utility (SMU) Overview
The SMU consists of these routines. For complete descriptions of these routines, see
the CRE Programmer’s Guide.
These routines operate upon copies of the process-creation messages that establish
the execution environment of the program. Copies of these messages are not saved
automatically and must be requested by a SAVE directive in the main program. For
information on the SAVE directive, see SAVE.
The SMU routines operate on the ASSIGN, PARAM, and startup messages, which
have standard sets of defined portions.
Routine Description
SMU_Assign_CheckName_ Checks whether a saved ASSIGN message with a given
logical file name exists
SMU_Message_CheckNumber_ Checks whether a specific saved message exists
SMU_Assign_Delete_ Deletes either a portion or all of a saved ASSIGN
message
SMU_Param_Delete_ Deletes either a portion or all of the saved PARAM
message
SMU_Startup_Delete_ Deletes the entire saved startup message
SMU_Assign_GetText_ Retrieves a portion of a saved ASSIGN message as text
and assigns it to a string variable
SMU_Assign_GetValue_ Retrieves a portion of a saved ASSIGN message as an
integer and assigns it to an integer variable
SMU_Param_GetText_ Retrieves a portion of the saved PARAM message as
text and assigns it to a string variable
SMU_Startup_GetText_ Retrieves a portion of the saved startup message as text
and assigns it to a string variable
SMU_Assign_PutText_ Creates or replaces a portion of a saved ASSIGN
message with text from a string variable
SMU_Assign_PutValue_ Creates or replaces a portion of a saved ASSIGN
message with a value from an integer variable
SMU_Param_PutText_ Creates or replaces a portion of the saved PARAM
message with text from a string variable
SMU_Startup_PutText_ Creates or replaces a portion of the saved startup
message with text from a string variable
Table 13-8. Portions of the ASSIGN Message (page 1 of 2)
Portion What It Identifies Portion Type
LOGICALNAME Logical unit name Text message portion
TANDEMNAME File-system file name Text message portion
PRIEXT Primary extent size Integer message portion
SECEXT Secondary extent size Integer message portion