FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-46
PUTASSIGNTEXT Routine
The following table shows the meaning of the integer return values:
•
The ASSIGN message creation succeeds if space is available for both text and
the checkpoint message, the requested portion is the logical name, and the
requested logical file name does not conflict with that of another saved ASSIGN
message. All other parts are marked “not present in this message”.
•
Text values returned for PUTASSIGNTEXT
If you specify 'LOGICALNAME', text contains the program unit name and the
logical file name, formatted as “programunit.filename”, and can have a maximum of
63 characters. If the logical name part does not include the program unit name
component, the text is just “filename”.
If you specify 'TANDEMNAME', text contains the HP file name and can have a
maximum of 34 characters. The name can be all blanks. If it includes a node
name, it must be a node known to the node on which your program runs.
Return Value Meaning
≥0 A string of that many characters is assigned as the new message
part value. For TANDEMNAME, PUTASSIGNTEXT returns zero if
text is a null string.
-1 A failure due to a logic error. The message is unchanged. Possible
logic errors are:
•
The portion value is not correct or does not identify a defined
text part of the ASSIGN message.
•
The text string is not acceptable: either the logical file name or
the HP file name is incorrect.
•
messagenumber is not a positive integer.
•
The requested logical file name conflicts with the logical file
name of another saved ASSIGN message.
•
The contents of the checkpoint list parameter are inconsistent.
•
The specified ASSIGN message does not exist and the portion
parameter is not LOGICALNAME.
-2 Insufficient checkpoint list space to complete the operation. The
message is unchanged.
-3 Insufficient message storage space to complete the operation. The
message is unchanged.