|Version 3 (modified by AmigaPhil, 22 months ago) (diff)|
NewMailFile -- Return a valid, but unused message filename for a folder. (V2.0)
Returns a valid but still unused message filename for a folder, based on the current date. This is the filename that YAM will use when adding the next message to this folder.
VAR/K - alternative variable to put the results into instead of RESULT
STEM/K - base name used for the stem where the filename will be returned
FOLDER - optional, name or number of the folder; if none if supplied, the current folder will be used
VAR - filename returned, with path
<STEM>FILENAME - filename returned, with path
RC is set to 10 if the specified folder doesn't exist or a group is currently selected.
The command works by trying to lock the first message slot usable for the current date (e.g. Work:YAM/folder_name/09097.001 for Nov 28, 2002) and then working from there until the lock fails.