At line 1 added 303 lines |
%%(display:none) |
{{{ |
WikiUp |
}}} |
/% |
[{TableOfContents }]\\ |
!!! Configurazione dell'AS/400\\ |
\\ |
!! Configurazione comunicazione\\ |
! Breve descrizione\\ |
La comunicazione tra il lato Client (PC) e il lato Server (AS400) avviene tramite appositi processi che vengono attivati al momento della connessione con il sistema stesso.\\ |
La comunicazione tra AS400 e Client PC avviene tramite code dati (oggetto AS400 *DTAQ).\\ |
La configurazione del lato server consiste di fatto nella configurazione dell'ambiente di questi processi.\\ |
I processi di comunicazione sono a tutti gli effetti dei lavori di tipo batch, e per poter funzionare hanno bisogno di definire la coda lavori nella quale vengono lanciati.\\ |
Viene qui descritta una procedura per creare il tipico ambiente di esecuzione sul Server.\\ |
I nomi dei sottosistemi e delle code lavoro utilizzati non sono vincolanti, ma si consiglia di utilizzarli per maggior coerenza con le altre configurazioni di LoocUp.\\ |
Nota:\\ |
Per l'effettiva operazione di configurazione, __consigliamo di leggere questa documentazione direttamente tramite client access (non tramite versioni cartacee, pdf e loocup), in quanto così si avrà la possibilità di eseguire direttamente i comandi indicati senza doverli impostare manualmente.__\\ |
\\ |
! Sottosistema\\ |
E' preferibile che i processi di comunicazione siano attivi in un sottosistema dedicato, anche se non ci sono controindicazioni nell'utilizzo di un sottosistema già esistente (Es. QINTER o QBATCH)\\ |
Si consiglia di creare un sottosistema denominato QBATCHUI.\\ |
Normalmente i sottosistemi vengono creati nella libreria SMESYS.\\ |
\\ |
! Parametri di creazione del sottosistema\\ |
%%quote |
. Descrizione sottosistema . . . . > QBATCHUI Nome |
. Libreria . . . . . . . . . . . SMESYS Nome, *CURLIB |
. Lotti di memoria: |
. Identificativo di lotto . . . > 1 1-10 |
. Ampiezza memoria . . . . . . . > *BASE Numero, *BASE, *NOSTG... |
. Livello attività . . . . . . . Numero |
. + per altri valori |
. Numero massimo di lavori . . . . *NOMAX 0-1000, *NOMAX |
. Testo 'descriz.' . . . . . . . . 'Looc.up batch subsystem' |
/% |
---- |
! Comando di creazione sottosistema\\ |
CRTSBSD SBSD(SMESYS/QBATCHUI) POOLS((1 *BASE)) TEXT('Looc.up batch subsystem')\\ |
%%quote |
Creazione sottosistema |
|
?CRTSBSD SBSD(SMESYS/QBATCHUI) POOLS((1 *BASE)) TEXT('Looc.up batch subsystem') |
/% |
---- |
\\ |
Dopo aver creato il sottosistema è necessario definire il passo di instradamento.\\ |
! Parametri del passo di instradamento\\ |
%%quote |
. Descrizione sottosistema . . . . > QBATCHUI Nome |
. Libreria . . . . . . . . . . . SMESYS Nome, *LIBL, *CURLIB |
. Num. seq. spec. instradamento . > 9999 1-9999 |
. Dati di confronto: |
. Valore confronto . . . . . . . > *ANY |
. |
. Posizione iniziale . . . . . . 1-80 |
. Programma da richiamare . . . . > QCMD Nome, *RTGDTA |
. Libreria . . . . . . . . . . . *LIBL Nome, *LIBL, *CURLIB |
. Classe . . . . . . . . . . . . . QBATCH Nome, *SBSD |
. Libreria . . . . . . . . . . . Nome, *LIBL, *CURLIB |
. Num. max passi instrad. attivi *NOMAX 0-1000, *NOMAX |
. ID lotto memoria . . . . . . . . 1 1-10 |
/% |
---- |
! Comando di creazione del passo di instradamento\\ |
ADDRTGE SBSD(SMESYS/QBATCHUI) SEQNBR(9999) CMPVAL(*ANY) PGM(QCMD) CLS(QBATCH)\\ |
%%quote |
Creazione passo di instradamento |
|
?ADDRTGE SBSD(SMESYS/QBATCHUI) SEQNBR(9999) CMPVAL(*ANY) PGM(QCMD) CLS(QBATCH) |
/% |
---- |
\\ |
__ATTENZIONE:__ Il parametro Classe viene impostato di default al valore *SBSD, modificarlo al valore QBATCH.\\ |
\\ |
__IMPORTANTE:__ La principale causa del mancato funzionamento di LoocUp è dovuta alla mancanza della definizione del passi di instradamento.\\ |
\\ |
! Coda lavori\\ |
Creare una coda lavori specifica per i processi di comunicazione, si consiglia di denominrla QBATCHUI.\\ |
Si consiglia di creare le code lavori nella libreria SMESYS. Bisogna però assicurarsi che\\ |
tale libreria sia in lista librerie (normalmente essa è inserita tra la librerie di sistema).\\ |
\\ |
! Parametri della coda lavori\\ |
%%quote |
. Coda lavori . . . . . . . . . . > QBATCHUI Nome |
. Libreria . . . . . . . . . . . > SMESYS Nome, *CURLIB |
. Testo 'descriz.' . . . . . . . . 'Looc.Up batch subsystem jobq' |
/% |
---- |
! Comando di creazione coda lavori\\ |
CRTJOBQ JOBQ(SMESYS/QBATCHUI) TEXT('Looc.Up batch subsystem jobq')\\ |
%%quote |
Creazione coda lavori |
|
?CRTJOBQ JOBQ(SMESYS/QBATCHUI) TEXT('Looc.Up batch subsystem jobq') |
/% |
---- |
__IMPORTANTE:__ Il nome dalla coda lavori creata deve essere riportata nella tabella UI1\\ |
\\ |
%%quote |
Modifica della tabella |
|
CALL B£AM30 PARM('UI1' ' ' '* ') |
/% |
---- |
! Esempio di tabella UI1 compilata\\ |
%%quote |
. Sme.Up V3R2 ** MANUTENZIONE TABELLE ** S44256CA B£AM30 |
. 8/07/05 Gestione elemento QPADEV0051 AS |
. Set. UI1 Main User Interface |
. Ele. * Archivio 0 |
. Descrizione Personalizzazione UI |
. Ambiente SM SME_up |
. Coda lavoro QBATCHUI Looc.Up batch subsystem jobq |
. Chiusura Job Emulat. NO |
/% |
---- |
\\ |
! Assegnazione della coda lavori al sottosistema\\ |
Occorre associare la coda lavori creata al sottosistema precedentemente definito.\\ |
! Parametri del comando\\ |
%%quote |
. Descrizione sottosistema . . . . QBATCHUI Nome |
. Libreria . . . . . . . . . . . SMESYS Nome, *LIBL, *CURLIB |
. Coda lavori . . . . . . . . . . QBATCHUI Nome |
. Libreria . . . . . . . . . . . SMESYS Nome, *LIBL, *CURLIB |
. Num. massimo lavori attivi . . . *NOMAX 0-1000, *NOMAX |
. Numero sequenza . . . . . . . . 10 1-9999 |
. Massima priorità attiva 1 . . . *NOMAX 0-99, *NOMAX |
. Massima priorità attiva 2 . . . *NOMAX 0-99, *NOMAX |
. Massima priorità attiva 3 . . . *NOMAX 0-99, *NOMAX |
. Massima priorità attiva 4 . . . *NOMAX 0-99, *NOMAX |
. Massima priorità attiva 5 . . . *NOMAX 0-99, *NOMAX |
/% |
---- |
__IMPORTANTE:__ Prestare particolare attenzione al valore *NOMAX del parametro Num. massimo lavori attivi.\\ |
! Comando di associazione della coda lavori al sottosistema\\ |
ADDJOBQE SBSD(SMESYS/QBATCHUI) JOBQ(SMESYS/QBATCHUI) MAXACT(*NOMAX)\\ |
%%quote |
Assegnazione coda lavori al sottosistema |
|
?ADDJOBQE SBSD(SMESYS/QBATCHUI) JOBQ(SMESYS/QBATCHUI) MAXACT(*NOMAX) |
/% |
---- |
\\ |
! Avvio del sottosistema\\ |
E' necessario avviare il sottosistema precedentemente creato.\\ |
!! Parametri del comando\\ |
%%quote |
. Descrizione sottosistema . . . . QBATCHUI Nome |
. Libreria . . . . . . . . . . . SMESYS Nome, *LIBL, *CURLIB |
/% |
---- |
! Comando di avvio del sottosistema\\ |
STRSBS SBSD(SMESYS/QBATCHUI)\\ |
%%quote |
Avvio del sottosistema |
|
?STRSBS SBSD(SMESYS/QBATCHUI) |
/% |
---- |
\\ |
__IMPORTANTE:__ I sottosistemi NON vengono automaticamente avviati all'accensione dell'AS400. Modificare quindi il programma di avvio dell'AS400 (QSTRUP) e avviare esplicitamente il sottosistema.\\ |
\\ |
! Libreria code dati\\ |
Gli oggetti *DTAQ che vengono utilizzati per la comunicazione vengono creati nella libreria SMEUPUIDQ, la quale deve essere creata appositamente.\\ |
!! Parametri del comando di creazione della libreria\\ |
%%quote |
. Libreria . . . . . . . . . . . . > SMEUPUIDQ Nome |
. Tipo libreria . . . . . . . . . *PROD *PROD, *TEST |
. Testo 'descriz.' . . . . . . . . > 'Sme_Up V3R2 - Libreria standard code' |
/% |
---- |
__NOTA:__ Il nome della libreria è fisso e non può essere modificato.\\ |
! Comando di creazione della libreria\\ |
CRTLIB LIB(SMEUPUIDQ) TEXT('Sme_Up V3R2 - Libreria standard code')\\ |
%%quote |
creazione della libreria SMEUPUIDQ |
|
CRTLIB LIB(SMEUPUIDQ) TEXT('Sme_Up V4R1 - Libreria standard code') |
/% |
---- |
\\ |
! Controlli finali\\ |
__A questo punto tutto il necessario sul lato Server è stato configurato.__\\ |
In caso di mancato funzionamento, controllare che tutti i passi siano stati eseguiti correttamente:\\ |
*Sottosistema avviato\\ |
*Passi di instradamento definiti\\ |
*Coda lavori associata al sottosistema (con numero lavori *NOMAX)\\ |
*Tabella UI1 corretta\\ |
\\ |
Per verificare il corretto funzionamento della coda lavori e del sottosistema creato provare a lanciare una procedura batch nella coda QBATCHUI.\\ |
\\ |
__NOTA:__ L'utilizzo di Looc_Up prevede la corretta compilazione delle tabelle MEA relative ai menù.\\ |
Per verificare la corretta impostazione delle tabelle MEA è possibile utilizzare il comando (da linea comandi della normale emulazione 5250) __UP SER__, impostando i parametri come evidenziato:\\ |
%%quote |
. Sme.Up V3R2 ** Set - Play Funzioni ** S44256CA JASEP2 |
. Q80705 QPADEV0033 AS |
. |
. Servizio *MNU Menù completo Fornito da: JATRE_01C |
. Funzione.Metodo |
. Componente TRE Albero |
. |
. Oggetto Tipo Parametro Codice Descrizione |
. 1 |
. 2 |
. 3 |
. 4 |
. 5 |
. 6 |
. |
. Parametro |
. |
. Modo grafico |
. |
. Risultato F(TRE;*MNU;) |
/% |
---- |
\\ |
Dovrà apparire una videata come la seguente:\\ |
%%quote |
. Sme.Up V3R2 ** ANALISI XML DI UN PROGRAMMA ** 18/07/05 S44256CA TSTJASX |
. Sviluppo di dettaglio 16:18:49 QPADEV0033 AS |
. |
. |
. |
. ? |
. |
. Albero di oggetti in XML |
. Albero di oggetti in XML |
. |
. 1 < Oggetto Nome= Tipo= Parametro= Codice= Testo= User List |
. 2 < Oggetto Nome= Tipo= Parametro= Codice= Testo= Arrighini Ste ... |
. 3 < Oggetto Nome= Tipo= Parametro= Codice= Testo= Ultime esegu ... |
. 3 < Oggetto Nome= Tipo= Parametro= Codice= Testo= Dipendente |
. ... |
/% |
---- |
\\ |
! Alcuni utili suggerimenti\\ |
Nella libreria SMEUPUIDQ vengono creati continuamente oggetti di tipo *DTAQ che in alcuni casi particolari (malfunzionamenti) potrebbero non venire eliminati. Si consiglia quindi di attivare periodicamente (inserendola ad esempio nelle procedure di spegnimento dell'As400) una procedura di "pulizia".\\ |
! Esempio di procedura per l'eliminazione degli oggetti *DTAQ dalla libreria SMEUPUIDQ\\ |
__chiusura del sottosistema x chiudere tutti i lavori attivi__\\ |
ENDSBS SBS(QBATCHUI) OPTION(*IMMED)\\ |
__attesa di completamento dell'operazione di chiusura__\\ |
DLYJOB DLY(60)\\ |
__eliminazione di tutte le code dati__\\ |
CLRLIB LIB(SMEUPUIDQ)\\ |
__riavvio (eventuale) del sottosistema__\\ |
STRSBS SBSD(SMESYS/QBATCHUI)\\ |
\\ |
!!! Simulazione funzioni AS/400\\ |
Condizione necessaria per il funzionamento di Looc.up è che la parte AS/400 sia funzionante. A tale fine sono state predisposte delle funzioni per verificare che la parte server sia correttamente attivata. Ad esempio Looc.up non parte se mancano i menù oppure il profilo utente non consente l'accesso al programma di START.\\ |
\\ |
Si consiglia pertanto, una volta verificati i prerequisiti di procedere nel modo seguente:\\ |
\\ |
!! Verificare il collegamento\\ |
* Programma = TSTJAC ( T JAC)\\ |
* Messaggio = DATSES\\ |
* Funzione = CON\\ |
\\ |
# Si vede un numero di 6 cifre in OUTPUT D2\\ |
# Verificare l'inizio dei lavori per l'utente\\ |
# Verificare la creazione delle code con tale nome nella libreria SMEUPUIDQ\\ |
# Funzione = DIS (se si è usciti fornire nei parametri il numero ricavato in precedenza)\\ |
# Verificare la fine dei lavori per l'utente\\ |
# Verificare l'assenza delle code create prima\\ |
\\ |
!! Verifiche di esecuzione delle funzioni estese\\ |
- Immettere "UP SER" nella linea comandi\\ |
- Inserire "F(TRE;*MNU;)" nel campo risultato e premere F21 poi F20 e scegliere un ambiente\\ |
- La funzione JS deve presentare il formato XML della lista dei menù.\\ |
\\ |
Se la lista non si presenta significa che manca un prerequisito, oppure il programma è in errore.\\ |
\\ |
\\ |
Per versioni molto vecchie di sistema operativo (non più supportate da Sme.UP) era necessario installare una PTF correttiva ed effettuare alcune operazioni per velocizzare la lettura code\\ |
\\ |
!!! Descrizione del problema\\ |
A causa di un problema del supporto SLIC, nelle versioni V4R3, V4R4, V4R5, V5R1 e V5R2 del sistema operativo OS/400, si verifica un ritardo di 2 secondi su tutte le letture da code dati effettuate dall'esterno del sistema. Questo ritardo, pur non pregiudicando il funzionamento di Looc.Up, porta ad un rallentamento generale dell'interfaccia grafica.\\ |
\\ |
!!! Come procedere\\ |
Per le release V4R3, V4R4, V4R5 e V5R1 è necessario\\ |
# Installare su AS/400 la corretta PTF\\ |
# Disabilitare il ritardo SLIC\\ |
\\ |
Per la release V5R2 è necessario semplicemente Disabilitare il ritardo SLIC.\\ |
\\ |
Le PTF sono le seguenti:\\ |
*MF24942 - se V4R3\\ |
*MF24475 - se V4R4\\ |
*MF24728 - se V4R5\\ |
*MF27269 - se V5R1\\ |
\\ |
Per disabilitare il supporto SLIC collegarsi come QSECOFR (o con un utente con pari autorizzazioni) ed immettere il comando\\ |
__call qskmaint parm(20 x'80')__\\ |
\\ |
Nel caso il supporto SLIC debba essere riattivato per qualche motivo, immettere il comando:\\ |
__call qskmaint parm(20 x'81')__\\ |
\\ |
!!! Ulteriori informazioni\\ |
Per informazioni più dettagliate su queste PTF vedere il seguente link IBM:\\ |
[http://www-01.ibm.com/support/docview.wss?uid=nas8N1017346]\\ |