Utilisation de CMCI pour créer une définition de ressource

Créez une définition de ressource BAS ou CSD à l'aide de l'interface CMCI ( CICS® Management Client Interface).

Avant de commencer

Vous devez disposer d'une connexion à CMCI. Pour plus d'informations, voir Configuration de CMCI.

À propos de cette tâche

Utilisez une demande POST pour créer une définition de ressource. Pour la demande, spécifiez l'URI et un corps XML contenant les paramètres et les attributs de la ressource, comme indiqué dans la procédure ci-dessous.

Pour plus d'informations sur les demandes POST, voir Demandes CMCI POST.

Procédure

  1. Indiquez l'URI de la demande, en suivant les instructions de la rubrique CMCI POST request URI.
    Remarque :
    • Si vous créez une ressource BAS, le paramètre SCOPE , s'il est spécifié dans l'URI, est ignoré.
    • Si vous créez une ressource CSD, indiquez SCOPE dans l'URI. SCOPE doit être le système CICS dans lequel vous créez la ressource.
  2. Ajoutez un corps XML contenant les paramètres et les attributs de la ressource.
    Le corps XML comprend un élément < create> dans un élément < request>. Spécifiez les attributs de la nouvelle ressource dans l'élément < create>.

    Pour plus d'informations sur les éléments XML CMCI, voir CMCI XML.

    Remarque :
    • Si vous créez une ressource BAS, vous devez inclure un attribut defver dans le corps XML.
    • Si vous créez une ressource CSD, vous devez spécifier le paramètre CSD et un attribut csdgroup dans le corps XML. N'incluez pas d'attribut defver .

Exemple

L'exemple suivant montre comment créer une définition de transaction BAS.
POST http://exampledomain.com:12345/CICSSystemManagement/
     CICSDefinitionTransaction/<CONTEXT>/

<request>
   <create>
      <attributes name="NAME" defver="1" program="test"/>
   </create>
</request>
Cet exemple montre comment créer une définition de transaction CSD. Notez que le paramètre CSD et l'attribut csdgroup sont ajoutés au XML et que l'attribut defver est exclu.
POST http://exampledomain.com:12345/CICSSystemManagement/
     CICSDefinitionTransaction/<CONTEXT>/<SCOPE>/

<request>
   <create>
      <parameter name="CSD"/>
      <attributes name="resourceName" program="test" csdgroup="CSDGR"/>
   </create>
</request>
Les deux exemples, la création d'une définition de ressource BAS et la création d'une définition de ressource CSD, renvoient une sortie similaire lorsqu'ils aboutissent. Une création réussie renvoie un message de réponse de l'API CICSPlex SM qui contient api_response1="1024" et api_response1_alt="OK" , comme illustré ci-dessous:
<response xmlns:...>
   <resultsummary api_response1="1024" api_response1_alt="OK".. />
   <records>
         ...
   </records>
</response>