Definizione della risorsa TCPIPSERVICE CICS

Prima che gli utenti possano utilizzare la vista profilo o sviluppare applicazioni che utilizzano le API, è necessario definire la risorsa CICS TCPIPSERVICE e aggiungere una definizione URIMAP per ogni regione CICS® a cui gli utenti accedono.

Per facilitare le configurazioni, utilizzare il file di esempio IBM z/OS Debugger CICS CSD Resource Definitions EQAW.SEQASAMP (EQACCSD) e inviare il lavoro di esempio EQAW.SEQASAMP (EQAWCCSD) per creare le definizioni TCPIPSERVICE e URIMAP per ogni regione CICS. Per maggiori dettagli, vedere i passi 1 e 2 in Aggiunta del supporto per il debug in CICS. L'API Debug Profile Service può iniziare a comunicare con successo con la regione di destinazione CICS una volta completati questi passaggi.

Per maggiori dettagli, completare i passaggi seguenti per ogni regione a cui gli utenti accedono:

  1. Definire l'indirizzo TCP/IP e il nome host per il sistema z/OS® . Per impostazione predefinita, sono definiti in PROFILE.TCPIP e TCPIP.DATA .
  2. Assicuratevi che i seguenti parametri di inizializzazione del sistema CICS siano impostati per ogni regione CICS:
    GRPLIST
    Il gruppo definito nel servizio deve essere all'avvio GRPLIST, in modo che l'ascoltatore si avvii all'avvio di CICS. Ad esempio, se EQAW.SEQASAMP(EQACCSD) il nome del gruppo è EQA e il nome dell'elenco è EQALIST, EQALIST deve essere aggiunto a GRPLIST=(DFHLIST,TIVLIST,EQALIST).
    SEC
    Cambiare il simbolo SEC=YES per il supporto dell'autenticazione.
    SECURETCPIP
    Se si utilizza CICS TS versione 6.3 o successiva senza SSL abilitato, assicurarsi che sia specificato SECURETCPIP=NO .
  3. Aggiungere un listener TCP/IP a CICS. Utilizzare il seguente comando CEDA per definire un TCPIPSERVICE in un gruppo:
    CEDA DEF TCPIPSERVICE(service-name) GROUP(group-name)
    Il seguente elenco illustra i valori da utilizzare per alcuni campi chiave:
    TCpipservice (nome - servizio)
    Creare un nome composto da un massimo di otto caratteri. Ad esempio, EQADTCN.
    GROup (nome - gruppo)
    Creare un nome composto da un massimo di otto caratteri. Ad esempio, EQA.
    Urm
    Specificare EQADCAN0.
    PortNumber
    Specificare un numero di porta non utilizzato che il Servizio profilo di debug utilizza per la comunicazione dell'API.
    Per vedere i numeri di porta attivi utilizzati dalle regioni CICS, eseguite il seguente comando TSO. Modificare #cicsname con il modello di denominazione desiderato: TSO NETSTAT CO (CLI #cicsjobname*)
    Stato
    Specificare Open.
    Protocollo
    Specificare Http.
    Transazione
    Specificare CWXN.
    Arretrato
    Il numero di richieste TCP/IP accodate prima che TCP/IP inizi a rifiutare le richieste in entrata. Ad esempio, 30.
    RichiestaOcc
    Specificare No.
    Maxdatalen
    Specificare la dimensione massima, in byte, del corpo (il documento XML) della richiesta o della risposta HTTP. Ad esempio, 032768 rappresenta 32K byte.
    SSL
    Specificare Sì se si utilizza la crittografia SSL con il protocollo HTTPS.
    Esegui autenticazione
    • Per abilitare solo l'Autenticazione di base, utilizzare Authenticate(Basic).

    • Per abilitare l'autenticazione JWT, o sia Basic che JWT, usare Authenticate(No) e assicurarsi che venga utilizzato CICS TS versione 6.x o successiva. Questa impostazione disabilita l'autenticazione basata su CICS, consentendo invece a Debug Profile Service API (EQAPROF) di gestire l'autenticazione.

    GRPcritico
    Specificare No.
  4. Aggiungere una definizione URIMAP che corrisponda agli URL delle richieste HTTP in arrivo:
    CEDA DEF URIMAP(map-name) GROUP(group-name)
    Il seguente elenco spiega quali valori utilizzare per i campi chiave:
    URIMAP (nome - mappa)
    Creare un nome composto da un massimo di otto caratteri. Ad esempio, EQAURIM.
    GROUP (nome - gruppo)
    Specificare lo stesso nome - gruppo utilizzato nella definizione della risorsa TCPIPSERVICE.
    STATO
    Specificare Enabled.
    USO
    Specificare Server.
    Schema
    Specificare HTTP.
    HOST
    Specificare *.
    PERCORSO
    Specificare /dtcn/*.
    Analizzatore
    Specificare Yes.
  5. Verificare che TCPIPSERVICE(nome servizio) e URIMAP(nome mappa) siano definiti:
    CEDA DISPLAY GROUP(group-name)
  6. Verificare che il nome dell'elenco GRPLIST associato sia definito:
    CEDA DISPLAY LIST(list-name)
  7. Immettere i comandi seguenti per installare le definizioni TCPIPSERVICE e URIMAP:
    CEDA INS TCPIPSERVICE(service-name) GROUP(group-name)
    CEDA INS URIMAP(map-name) GROUP(group-name)
  8. Riavviare la regione CICS per rendere effettive le modifiche.
  9. Riavviare il servizio Profilo di debug per rendere effettive le modifiche.
    • Assicuratevi che il file di configurazione del Debug Profile Service API dtcn.port sia aggiornato con il nome della regione CICS di destinazione e il numero di porta su cui è in ascolto.
  10. Per verificare l'installazione fino a questo punto, accedi all'interfaccia utente Web di Gestione profili. L'interfaccia utente tenterà di interrogare il nome della regione CICS di destinazione. Se non vengono segnalati errori, il servizio profili di debug ha interrogato con successo un profilo di debug con CICS TCPIPSERVICE.
  11. Se si riscontrano problemi di connessione tra la workstation e il server HTTP nella regione CICS, eseguire il comando nella regione CICS per verificare se le impostazioni corrispondono alle definizioni.
    CEMT INQUIRE TCPIPSERVICE(service-name)
    CEMT INQUIRE URIMAP(map-name)
  12. Chiedere all'amministratore di sistema di fornire l'accesso alle transazioni CWBA e CWXN, perché sono utilizzate nell'elaborazione delle richieste di HTTP.