sdtcm_convert permette di convertire il formato dei dati dell'Agenda, di eliminare gli appuntamenti e di controllare l'integrità dei dati. Può essere usato per convertire di dati della versione 3 (OpenWindows) nella versione 4 (il formato di dati estendibile dell'agenda).
sdtcm_convert viene eseguito automaticamente durante l'aggiornamento del sistema operativo alla versione 2.6.
sdtcm_convert deve essere eseguito dal superutente o dal proprietario dell'agenda. Il superutente può eseguire sdtcm_convert su tutte le agende mentre gli utenti normali possono eseguirlo solo sulla propria agenda. Si noti che sdtcm_convert può essere utilizzato solo sulle agende disponibili sul sistema locale.
Il formato dati della versione 3 è fisso e limitato. Per sfruttare i vantaggi e le funzionalità della nuova API dell'agenda, le agende in formato 3 devono essere convertite nel formato 4.
Qui di seguito sono elencate le opzioni disponibili per sdtcm_convert.
Usare l'opzione -v per specificare il formato di dati per l'output.
I valori ammessi sono 3 (il formato dei dati di OpenWindows) e 4 (il nuovo formato). Se non viene specificata questa opzione, il formato dei dati resterà quello dell'agenda specificata e non verrà eseguita nessuna conversione.
La versione dei dati dell'agenda viene visualizzata nella finestra di dialogo “Informazioni sull'Agenda” accessibile dal menu Guida.
Usare l'opzione -s per specificare la data in cui troncare il calendario.
Gli appuntamenti che iniziano prima della data specificata verranno eliminati. Gli appuntamenti singoli con una data iniziale uguale o posteriore a quella indicata vengono conservati. Gli appuntamenti ripetuti vengono troncati in questo modo: gli appuntamenti precedenti alla data specificata vengono eliminati, mentre quelli successivi vengono mantenuti. Se questa opzione non viene specificata, non viene eseguito alcun troncamento.
Usare l'opzione -c per specificare l'impostazione del set di caratteri.
Il valore indicato deve essere una versione locale Sun corretta (C o it, ad esempio). Nell'agenda viene memorizzato l'equivalente CDE della versione locale, che è indipendente dalla piattaforma. Se questa opzione non viene specificata, viene utilizzato il nome CDE della versione locale associato al processo in uso. Questa opzione viene usata solo per la conversione dei dati dal formato 3 al formato 4 e ignorata in tutti gli altri casi.
Usare l'opzione -d per specificare la directory in cui salvare l'agenda originale, con il nome calorig.calendar.
Se questa opzione non viene specificata, il file di backup viene creato nella directory /var/spool/calendar.
Per maggiori informazioni sull'utilizzo e le opzioni di sdtcm_convert(1), consultare la relativa pagina man.
Per convertire l'agenda utente1 alla versione 4 e eliminare una parte degli appuntamenti:
% sdtcm_convert -v 4 -s 1/1/94 utente1
Per controllare l'integrità dei dati dell'agenda utente1:
% sdtcm_convert utente1
Se non viene specificata alcuna opzione, sdtcm_convert esegue il controllo di integrità.