FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-36
DELETEASSIGN Routine
You cannot delete the message portion value associated with LOGICALNAME.
'*ALL*'
specifies that FORTRAN delete the entire ASSIGN message.
cplist
is a checkpoint list in which DELETEASSIGN records the changes to the message
storage data space. DELETEASSIGN uses a maximum of three elements in
cplist. For additional detail, see the Checkpoint Considerations for Saved
Message Utility Routines on page 15-28.
messagenumber
is an integer expression that identifies a specific ASSIGN message to delete.
messagenumber must be a positive integer, 0, -1, or -3.
Considerations
Values returned by DELETEASSIGN
Example
?GUARDIAN DELETEASSIGN
INTEGER error
error = DELETEASSIGN ('RECSIZE', 0, j)
Return Value Meaning
0 The specified ASSIGN message or message portion is deleted.
-1 A failure occurred due to a logic error. Nothing is deleted. Possible
logic errors are:
•
portion is not correct or does not identify a part of the
ASSIGN message that can be deleted.
•
messagenumber is not a positive integer.
•
The contents of the checkpoint list parameter are inconsistent.
-2 Insufficient checkpoint list space is available to complete deletion;
the message is unchanged.