AcuCobol Runtime per Windows

NOTE OPERATIVE DI RELEASE Il presente documento costituisce un integrazione al manuale utente del prodotto ed evidenzia le variazioni apportate con la release. CONTENUTO DEL RILASCIO RELEASE Versione 8.1.2-20160100 Applicativo: AcuCobol Runtime per Windows Oggetto: Versione: Rilascio versione completa 8.1.2-20160100 (Versione completa) Data di rilascio: 29.02.2016 Riferimento: Contenuto del Rilascio Classificazione: Guida utente Avvertenze Gli eseguibili in ambiente SysInt vengono installati nel direttorio $SYSINT/acucobol Non è supportato l ambiente AcuServer (fare riferimento alla circolare 2010.02.32 Software Partner TeamSystem Pesaro, 15 Novembre 2010) CONFIGURAZIONE ED INSTALLAZIONE AMBIENTE WINDOWS Il modulo può essere installato in diverse modalità a seconda di come viene distribuito : 1. Modulo autoesplodente autoinst : Cliccare sul bottone installa 2. CDROM applicativi TeamCD : Seguire la procedura standard di installazione da applicativo TeamCD 3. File salvati in una cartella o cdrom : Eseguire il programma install.exe Per verificare se l installazione ha avuto un buon esito si possono eseguire le seguenti operazioni: 1. Dal menù principale scegliere Setup 2. Cliccare Impostazioni menu nel sottomenù che verrà visualizzato 3. Scegliere Si 4. Premere il pulsante Test Runtime ACU Cobol Integrazione alla guida utente 8.1.2-20160100 1

NOTE OPERATIVE DI RELEASE Il presente documento costituisce un integrazione al manuale utente del prodotto ed evidenzia le variazioni apportate con la release. Sistemi Operativi Windows supportati al 29/02/2016 Sistema Operativo Versione Windows (1) P Professional SP3 (2) 2003 Server SP2 (3) SBS 2003 Server SP2 (3) 2008 Server SP2 (4) 2008 R2 SP1 (4) SBS 2008 Server SP2 Windows 7 Professional SBS 2011 Server Server 2012, 2012 R2 8.1 Pro 64bit 10 Pro 64bit e 32bit (1) Sono escluse tutte le versioni dei sistemi operativi destinate ad un utenza Home. (2) Supporto al Sistema Operativo in fase di dismissione (termine improrogabile: Giugno 2016) ATTENZIONE: Sistema già dismesso da Microsoft (3) Supporto al Sistema Operativo in fase di dismissione (termine previsto: Giugno 2016) ATTENZIONE: Sistema già dismesso da Microsoft (4) ATTENZIONE: Le esperienze d uso presso nostri Clienti e Partner ci danno indicazioni che in Terminal Server si possono presentare casuali rallentamenti nella visualizzazione/interazione di alcuni componenti grafici nelle maschere. A parità di hardware, impianto e operatività utente, il problema non si riscontra con S.O. Windows 2012R2 (Windows 2012R2, Remote Desktop Services Overview: https://technet.microsoft.com/en-us/library/hh831447.aspx) Release Software di base richieste: - Sysint/W 20140100 o superiore Integrazione alla guida utente 8.1.2-20160100 2

AcuCobol Runtime ANOMALIE CORRETTE ANOMALIE CORRETTE RELEASE Versione 8.1.2-20160100 Applicativo: Oggetto: AcuCobol Runtime per Windows Rilascio versione completa Versione: 8.1.2-20160100 (Versione completa) Data di rilascio: 29.02.2016 Riferimento: Classificazione: Anomalie Corrette Guida utente ANOMALIE CORRETTE Corretta anomalia in visualizzazione di alcuni controlli grafici su tab-folder. Corretta anomalia nella copia di file con dimensione superiore a 2GB. Integrazione alla guida utente 8.1.2-20160100 1

Applicativo: Oggetto: AcuCobol Runtime per Windows Rilascio versione completa Versione: 8.1.2-20160100 (Versione completa) Data di rilascio: 29.02.2016 Riferimento: Classificazione: Guida utente RISPOSTE A DOMANDE FREQUENTI Moduli Acucorp

INDICE 1 Runtime... 3 2 Acurcl/Acuconnect... 14 3 Acuserver... 17 2

1 Runtime Quesito Come devo impostare i permessi in ambiente Windows 2003 per il corretto funzionamento degli applicativi TeamSystem? Dai test eseguiti si è rilevato quanto segue: - La sicurezza di Windows 2003 risulta essere più restrittiva delle precedenti release di Windows. - In ambiente di rete la presenza di postazioni client Windows 9x potrebbe causare un degrado delle prestazioni. 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 Da tali considerazioni è consigliato operare nel seguente modo: Definire una risorsa (partizione, disco) dove tutti gli utenti che fanno uso delle applicazioni TeamSystem (GECOM/GAMMA Plus) abbiano il permesso di FULLACCESS. Dove è possibile è preferibile aggiornare le postazioni client a Windows 2000 o superiore. In Windows 2003 i permessi di default per i dischi fissi risultano essere piuttosto restrittivi, impostati in modo da poter essere rivisitati dall'amministratore di sistema. Dopo la creazione di un unità disco, i permessi di default sono di lettura ed esecuzione per gli utenti del gruppo "USERS", mentre il controllo completo è associato solo ed esclusivamente al gruppo "Administrators". Per far girare correttamente gli applicativi TeamSystem, l'utente deve avere accesso completo al disco fisso dove sono locati i file degli applicativi stessi. Il gruppo di cui fanno parte gli utenti che utilizzano gli applicativi deve quindi avere permessi FULLACCESS come il gruppo Administrators. Una procedura consigliabile potrebbe essere quella di creare un gruppo Teamsystem con i permessi necessari. IMPORTANTE Se un utente appartiene a due o più gruppi varranno sempre le condizioni più restrittive nel caso sia indicato Nega su alcuni permessi. Quindi per poter utilizzare gli applicativi TeamSystem i gruppi di cui fa parte devono avere tutti permessi FULL ACCESS (o al massimo permessi FULL ACCESS su un gruppo e non negati sugli altri). Se la risorsa utilizzata per gli applicativi fosse il disco di sistema tale procedura causa problemi di sicurezza, di conseguenza si consiglia di installare in un disco logico a se stante. Esempio per definire correttamente i permessi: 1) Creare un gruppo Teamsystem di cui facciano parte tutti gli utenti che utilizzano gli applicativi. 3

2) Codividere la risorsa (disco/partizione), andare su Start -> Risorse del computer selezionare con il tasto destro del mouse l unità disco interessata e scegliere la voce Proprietà 3) Nella finestra che appare selezionare il folder Condivisione 4) Nella finestra che appare selezionare Consenti su tutte le voci e premere OK. 5) Si torna nella finestra delle Proprietà dell unità disco; selezionare il folder Protezione e premere Aggiungi per aggiungere il gruppo Teamsystem. 4

6) Si apre una nuova finestra. Nella casella di testo è possibile scrivere direttamente il nome del gruppo, ad esempio Teamsystem (in questo caso andare al punto 8). In alternativa, per selezionare il gruppo da un elenco, selezionare Avanzate... 7) Se si è scelto di cercare il gruppo da un elenco di quelli disponibili, utilizzare il tasto Trova della finestra relativa selezionare il gruppo interessato e premere OK. 8) Premere OK per aggiungere il gruppo. 9) Selezionare il gruppo Teamsystem, selezionare tutti i campi relativi alla colonna Consenti e premere l tasto OK. 5

ANNOTAZIONI Da prove effettuate, in presenza di Acuserver, l unità disco che contiene gli archivi deve essere accessibile con permessi FULLACCESS dal gruppo everyone. Nota Bene: La configurazione che abbiamo consigliato è la più semplice possibile per avere un corretto funzionamento, si noti però che è anche una configurazione poco sicura concedendo a tutti gli utenti accesso completo alla risorsa condivisa. E possibile con le dovute conoscenze sistemistiche realizzare una rete maggiormente sicura e parimenti funzionante. In ambiente SysIntWeb o Acuserver, se si devono applicare politiche restrittive la soluzione è dare permessi di "Full Controll" all'utente "SYSTEM", dato che i servizi (acurcl ed acuserver) girano come utente SYSTEM 6

e permessi di accesso completo agli utenti normali sui direttori archivi. Quesito Posso effettuare test di funzionaita dei moduli acucorp presenti nell ambiente in cui si sta operando? 5.2.1 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 Per effettuare test mirati per l ambiente su cui si opera è stata realizzata l utility ACUTEST. I test a disposizione si dividono nelle seguenti categorie: test prestazionali grafici test prestazionali su archivi test di connessione con AcuServer Test prestazionali grafici Attraverso questi test è possibile constatare il funzionamento di colori, oggetti grafici statici (label), tabcontrol, check-box, Alcuni di essi permettono di calcolarne i tempi. Test di connessione ACUSERVER Permettono di verificare se la connessione con AcuServer è funzionante. Test prestazionali su archivi Eseguono differenti operazioni su file. Essi operano sia in modalità multiutenza, che monoutenza, gestendo il lock sul file o sul singolo record. 7

5.2.1 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 Quesito Su un sistema linux non riesco a riavviare il servizio acushare Verificare se ci sono delle shared memory non rilasciate. Da console come utente root: - Per visualizzare tutte le info utilizzare il comando ipcs -a - Tramite il comando ipcrm rimuovere la shared memory usata ipcrm shm xxxxxxx e riavviare acushare - Se si hanno ancora problemi rimuovere anche la coda dei messaggi ipcrm msg xxxxx e riavviare acushare Quesito Sui sistemi operativi Linux/Unix supportati è possibile visualizzare la versione del rilascio TeamSystem relativa alla Runtime installata? Si, tramite il comando RUNTIME (maiuscolo). 7.0.0 7.2.1 7.2.2 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 Quesito In ambiente SunOS sparc 5.6 si verificano errori 94,10 ( Too many files open by the current process. ) Modificare i parametri di sistema operativo riportati nel file /etc/system Impostando i seguenti: set rlim_fd_cur = 1024 set rlim_fd_max = 8192 Riavviare il sistema. 8

Quesito Si verifica un errore ACUCOBOL-GT Runtime xx,yy. Dove posso trovare informazioni corrispondenti al codice di errore visualizzato? Segue una tabella sintentica degli errori. Per maggiori dettagli fare riferimento alla documentazione Acucorp. Cod. 00 Operation successful. 02 The current key of reference in the record just read is duplicated in the next record. (read next) 02 The operation added a duplicate key to the file where duplicates were allowed. (write, rewrite) 5.2.1 6.0.0 00 Optional file missing. If the open mode is I-O or ETEND, then the file has been created. This is also returned by DELETE FILE if the file is not found. (open, delete file) 6.1.0 7.0.0 7.2.1 7.2.2 00 A CLOSE UNIT/REEL statement was executed for a file on a non-reel medium. The operation was successful. 0M The operation was successful, but some optional feature was not used. For example, if you opened a file that specified an alternate collating sequence, but the host file system did not support that feature, then the open would succeed, but it would return this status. 10 End of file. (read next) 00 A sequential READ statement was attempted for a relative file, and the number of digits in the relative record number is larger than the size of the relative key data item. (read next) 21 Primary key was written out of sequence, or the primary key on a rewrite does not match the last record read. This error occurs only for an indexed file open with the sequential access mode. (write, rewrite) 22 Duplicate key found but not allowed. (write, rewrite) 23 Record not found. 24 Disk full for relative or indexed file. (write) 9

00 A sequential WRITE statement was executed for a relative file, and the number of digits in the relative record number was larger than the size of the relative key data item. (write) 30, xx Permanent error. This is any error not otherwise described. The secondary code value is set to the host system's status value that caused the error. See your operating system user manual for an explanation, and C$RERR in Appendix I. 34 Disk full for sequential file or sort file. (write, sort) 94, 20 File not found. (open, sort) 95, 01 The file being opened is not on a mass-storage device which is required for the file type or the requested open mode. (open) 95, 02 Attempt to open a sequential file with fixed-length records as a Windows spool file. 90, 07 User does not have appropriate access permissions to the file. (open) 95, 08 Attempt to open a print file for INPUT. (open) 95, 09 Attempt to open a sequential file for I/O and that file has automatic trailing space removal specified. (open) 95, 99 A Windows or Windows NT runtime that is not networkenabled tried to access a file on a remote machine. 93, 03 File previously closed with LOCK by this run unit. (open) 94, xx Existing file conflicts with the COBOL description of the file. (open) The secondary error code may have any of these values: 01 - mismatch found but exact cause unknown (this status is returned by the host file system) 02 - mismatch found in file's maximum record size 03 - mismatch found in file's minimum record size 04 - mismatch found in the number of keys in the file 10

05 - mismatch found in primary key description 06 - mismatch found in first alternate key description 07 - mismatch found in second alternate key description The list continues in this manner for each alternate key. 92 File is already open. (open) 91 File not open. (close) 91 File not open. (unlock) 90, 02 No current record defined for a sequential access mode file. (rewrite, delete) 97 Record size changed. The record being rewritten is a different size from the one existing in the file, and the file's organization does not allow this. (rewrite) This status code can also occur if the record is too large or too small according to the RECORD CONTAINS clause for the file. (write, rewrite) 96 No current record. This usually occurs when the previous operation on the file was a START that failed, leaving the record pointer undefined. (read next) 90, 01 File not open for input or I-O. (read, start) 91, 02 File not open. (read, start) 90, 01 A file that is defined to be access mode sequential is open for I-O, or the file is open for INPUT only. (write) 91, 02 File not open. (write) 90, 01 File not open for I-O. (rewrite, delete) 91, 02 File not open. (rewrite, delete) 93 File locked by another user. (open) 94, 10 Too many files open by the current process. (open) 94, 62 One of the LINAGE values for this file is illegal or out of range. (open, write) 11

94, 62 Key not specified (specifying a table whose size is zero) in a SORT or MERGE statement 98, xx Indexed file corrupt. An internal error has been detected in the indexed file. The secondary status code contains the internal error number. The file should be reconstructed with the appropriate utility. 99 Record locked by another user. 9A Inadequate memory for operation. This most commonly occurs for the SORT verb, which requires at least 64K bytes of free space. (any) 9B The requested operation is not supported by the host operating system. For example, a deferred file system initialization failed, or a READ PREVIOUS verb was executed and the host file system does not have the ability to process files in reverse order. (any) If you are using AcuML, this error results when the program tries to open a file ETEND or I-O. With AcuML, programs are able to open files INPUT or OUTPUT only. 9C There are no entries left in one of the lock tables. The secondary error code indicates which table is full: 01 - operating system lock table 02 - internal global lock table (see the MA_LOCKS configuration variable) 03 - internal per-file lock table (see the LOCKS_PER_FILE configuration variable) 9D, xx This indicates an internal error defined by the host file system. The "xx" is the host system's error value. This is similar to error "30", except that "xx" is specific to the host file system instead of the host operating system. For example: 02 - In Acu4GL or AcuML, 9D,02 indicates that an FD file is corrupt. This could be the result of a parsing error. 03 - In Acu4GL or AcuML, 9D,03 indicates that an FD file is missing. This could be the result of a parsing error. 05 - In AcuML, 9D,05 indicates that there was an FD parsing error, so AcuML was unable to read a record. Refer to the specific Acucorp product documentation for more details on the host file system's error codes. 12

9E, xx This indicates an error occurred in the transaction system. The exact nature of the error is shown by the contents of TRANSACTION-STATUS. For more information, see section "Transaction Error Codes." 9Z This indicates that you are executing the program with a runtime that has a restriction on the number of records it can process. You have exceeded the record limit. 13

2 Acurcl/Acuconnect Acucobol Acurcl Quesito In ambienti Windows 2003 con Acurcl si verificano Errori 93 6.1.0 7.0.0 7.2.1 7.2.2 Il problema si presenta nel caso in cui l'amministratore di sistema non da i permessi "Full Control" sulle cartelle degli archivi a tutti gli utenti. Se si devono applicare politiche restrittive la soluzione è dare permessi di "Full Controll" all'utente "SYSTEM" (dato che il servizio Acurcl gira come utente SYSTEM) e permessi di accesso completo agli utenti normali sui direttori archivi. Per maggiori dettagli sulla corretta impostazione dei permessi sul server Windows fare riferimento alla faq relativa nella sezione del presente documento. 6.1.0 7.0.0 7.2.1 7.2.2 Quesito Dopo aver effettuato il login in SysIntWeb non si riesce ad eseguire alcun applicativo. Nel caso in cui non si riuscissero ad eseguire gli applicativi, dopo aver effettuato il login in SysIntWeb, una delle cose da verificare sul server riguarda i permessi dei file acurcl.acc ed acurcl.vix (nel direttorio $SYSINT\acucobol\) che devono avere, su sistemi operativi Windows, il controllo completo da parte degli utenti SYSTEM ed Administrator. Selezionando i due file con il tasto destro, verificare che nelle proprietà di protezione tali permessi siano impostati. Sui sistemi Linux/Unix tali file devono avere chmod 600 e chown 0:0 (utente root). 7.0.0 6.1.0 Quesito Quesito Eseguendo un comando applicativo da SysIntWeb ho l'errore seguente: ACUCOBOL-GT Thin Client "Connection failed. Incompatible server version" Questo errore si verifica se presente SysIntWeb versione precedente alla 20050300, che non gestisce il file degli accessi nel formato xml. Per risolvere aggiornare SysIntWeb a versione 20050300 o superiore. Eseguendo un comando applicativo da SysIntWeb ho l'errore seguente: ACUCOBOL-GT Thin Client "Connection failed. Alias does not exist" Questo errore viene dato quando il file acurcl.ini e' corrotto (es. a zero byte). Tale condizione si verifica ad esempio se si retrocede la versione acurcl 700 alla 610. L'eseguibile acurcl legge il file acurcl.ini (in formato xml) e lo azzera! Per risolvere reinstallare SysIntWeb. 14

Acucobol Acurcl Quesito In SysIntWeb server Windows su impianti con elevato numero di processi concorrenti, eseguendo un programma ottengo il seguente errore: Il problema potrebbe essere legato ad una limitazione del numero massimo di processi concorrenti gestiti del sistema operativo. Dal menu di SysInt sul server verificare con il comando ACURCL ---> Informazioni di stato Acurcl se ci sono molti processi attivi. 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 15

Acucobol Acurcl In questo caso modificare la chiave: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\SubSystems Il parametro da modificare e' "Windows". Il valore di default e' il seguente: %SystemRoot%\system32\csrss.exe ObjectDirectory=\Windows SharedSection=1024,3072,512 Windows=On SubSystemType=Windows ServerDll=basesrv,1 ServerDll=winsrv:UserServerDllInitialization,3 ServerDll=winsrv:ConServerDllInitialization,2 ProfileControl=Off MaxRequestThreads=16 Sostituire il valore 512 con 1024 e riavviare il sistema. Se il problema persiste ripristinare il valore originale e riavviare il sistema perche' tale modifica potrebbe influenzare altri servizi. 16

3 Acuserver Acucobol Acuserver 5.2.1 Quesito In ambienti Windows 2003 con acuserver si verificano Errori 93 6.0.0 6.1.0 7.0.0 7.2.1 7.2.2 Il problema si presenta nel caso in cui l'amministratore di sistema non da i permessi "Full Control" sulle cartelle degli archivi a tutti gli utenti. Se si devono applicare politiche restrittive la soluzione è dare permessi di "Full Controll" all'utente "SYSTEM" (dato che il servizio acuserver gira come utente SYSTEM) e permessi di accesso completo agli utenti normali sui direttori archivi. Per maggiori dettagli sulla corretta impostazione dei permessi sul server Windows fare riferimento alla faq relativa nella sezione del presente documento. 17