NUMBER %GETTEMPFILENAME%
Scopo: Ottenere da Highway Application Server un nome di file univoco.

Descrizione: Consente di ottenere un nome di un file univoco, calcolato da Highway Application Server completo di percorso e di estensione
L'estensione č rappresentata dal parametro ext, mentre il percorso č calcolato in base a quello che viene riconosciuto da Highway Application Server come il direttorio per i file temporanei.
Di norma, per installazioni tipiche, nelle quali i servizi Highway Server e Highway Application Server condividono lo stesso direttorio dei temporanei, questo percorso č dato da %TEMPDIR%/hwtemp.
Il direttorio dei temporanei viene impostato da Highway Application Server all'atto dell'installazione del servizio omonimo.
Se esistono le variabili ambientali TEMP o TMP o TEMPDIR dell'utente System della macchina server su cui avviene l'installazione, il direttorio dei FILE temporanei diverrā <valorevariabileambientale>/HwTemp.
In alternativa č possibile impostare un direttorio dei temporanei dal file di impostazione dell'Highway Application Server, dall'Hicgi.ini, indicando nella sezione [Server] la chiave TEMP associata ad un percorso esistente.
Questo sistema viene utilizzato di norma quando non č consentito il riavvio della macchina server che consentirebbe di rendere attive le impostazioni rilevate durante l'installazione.
%GETTEMPFILENAME% non crea nessun file, ne calcola solo il nome.
Il parametro *dest rappresenta una variabile di tipo %STRING% che deve essere creata dal chiamante, e che verrā valorizzata con il nome + percorso + estensione del file generato dalla %GETTEMPFILENAME%.

Valore restituito: valore numerico.
Torna 0 in caso di errore generico.
Torna 1 in caso di successo

Vedere anche: %TEMPDIR%, %CREATEFILE%, Sistema

Esempio:
%STRING%(file,"")
%STRING%(ext,"tmp")
%NUMBER%(hf, 0)
%NUMBER%(ret, %GETTEMPFILENAME%(file, ext))
%IF%(ret)
 %NUMCPY%(hf, %CREATEFILE%(file))
 %IF%(hf)
  <!-- elaborazione -->
  %IF%(%CLOSEFILE%(hf) == 0)
   <!-- errore chiusura file -->
  %ENDIF%
 %ELSE%
  <!-- errore creazione file -->
 %ENDIF%
%ELSE%
 <!-- errore in gettempfilename -->
%ENDIF%