NetServer per tutti – parte 3

NetTools: gestire NetServer da riga comandi

Nei primi due articoli NetServer per tutti abbiamo configurato il servizio e condiviso le risorse di IFS. Abbiamo svolto queste operazioni utilizzando Navigator for i o tramite API del sistema operativo. I comandi disponibili per NetServer sono pochissimi. In breve si può avviare od arrestare il servizio tramite STRTCPSVR SERVER(NETSVR) oppure ENDTCPSVR SERVER(NETSVR).

Se ci si trova nella situazione di non poter accedere a Navigator for i, può essere un problema.

In questo articolo vedremo una ricca serie di comandi fruibili in una sessione 5250 per svolgere tutte le operazioni con NetServer: i NetTools.

Installare i NetTools

I NetTools sono disponibili dalla versione IBM V5R2. Occorre fare un piccolo sforzo per installare questi tool forniti as-is da IBM nella libreria QUSRTOOL.

Se sul proprio sistema non si trova la libreria QUSRTOOL occorre installare l’opz. 7 “Libreria programmi di esempio” del sistema operativo (prodotto 5770SS1).

Avendo a disposizione la libreria, con queste semplici istruzioni si procede ad installare i NetTools:

1. CRTLIB LIB(NETSRVCMD) TEXT('iSeries NetServer menu and commands')
2. CALL QUSRTOOL/UNPACKAGE PARM('*ALL ' 1)
3. CRTCLPGM NETSRVCMD/TZLSINST QUSRTOOL/QATTCL
4. CALL NETSRVCMD/TZLSINST NETSRVCMD

Questo è tutto. Adesso basta aggiungere alla lista librerie la libreria NETSRVCMD e visualizzare il menu NETS per avere a disposizione tutti questi comandi:

Sicuramente i comandi più utili sono 3. Add File Share (ADDNSVFSHR) per aggiungere risorse condivise, 12. Work with NetServer Users (WRKNSVUSR) per riabilitare gli utenti e 15. Work with NetServer Sessions (WRKNSVSSN) per controllare tutte le sessioni client attive su NetServer.

Approfondire

Inoltre questa libreria di utilities è molto interessante perché abbiamo a disposizione i sorgenti, quindi c’è dell’ottimo materiale per studiare le API di sistema operativo.

Il membro TZLSINFO nel file QATTINFO della libreria QUSRTOOL contiene la documentazione tecnica dei NetTools. Viene descritto lo scopo, le istruzioni di installazione e i dettagli per l’utilizzo. Nel capitolo “What is Created” sono elencati tutti i sorgenti che compongono i NetTools.

Le API di NetServer

Nei precedenti articoli abbiamo avuto occasione di citare alcune delle API per gestire e configurare NetServer. Di seguito trovate l’elenco completo:

• Impostazione ID utente ospite: CALL QZLSCHSG (guest-user-profile X'00000000')
• Change Server Information (QZLSCHSI)
• Change server name (QZLSCHSN)
• Avvio NetServer: CALL QZLSSTRS PARM('0' X'00000000')
• Arresto NetServer: CALL QZLSENDS PARM(X'00000000')
• Condivisione di una cartella: CALL QZLSADFS PARM(share-name 'folder-path' x'00000005' x'00000000' 'shared-description' x'00000001' x'ffffffff' x'00000000')
  il terzo parametro è la lunghezza della stringa ‘folder-path’
  il sesto parametro imposta l’autorizzazione della condivisione (2 per lettura/scrittura, 1 per sola lettura)
• Rimozione condivisione di una cartella: CALL QZLSRMS PARM(share-name x'00000000')
• Change File Server Share (QZLSCHFS)
• Add Print Server Share (QZLSADPS)
• Change Print Server Share (QZLSCHPS)
• List server information (QZLSLSTI)
• Open List of Server Information (QZLSOLST)
• End Server Session (QZLSENSS)

Bibliografia

La pagina principale della documentazione IBM su NetServer è consultabile a questo link: https://www.ibm.com/docs/en/i/7.5?topic=services-i-netserver. Altre risorse utili le trovate nel documento allegato:

Nel prossimo articolo parleremo di come accedere da un client alle risorse condivise.