Utilisation de la ligne de commande pour l'interaction avec z/OS

Pour installer le plug-in RSE CLI, voir la section Installation de IBM RSE API Plug-in for Zowe CLI dans la rubrique Configuration des intégrations.

Pour éviter de saisir les détails de connexion dans chaque commande, vous pouvez créer un ou plusieurs profils utilisateur et passer de l'un à l'autre si nécessaire. Pour créer un profil via la ligne de commande, exécutez la commande suivante dans le terminal :

zowe profiles create rse rseCLI --host host.company.com --port 6800 --user user --password password --base-path rseapi --reject-unauthorized false --protocol https --encoding IBM-1047

Notes:

• RseCLI: nom du profil RSE. Vous pouvez utiliser le nom de votre choix.

• -- protocole: pour remplacer la valeur par défaut par HTTP, indiquez -- protocole http. La valeur par défaut est Https.

::: avertissement Lors de la configuration de votre profil, vous devez spécifier le protocole à utiliser par l'API RESTful RSE. Assurez-vous que votre administrateur a configuré z/OS Explorer RSE pour utiliser https pour une sécurité renforcée. Pour plus de sécurité, définissez RejectUnauthorized: true pour rejeter les certificats auto-signés, qui ne doivent pas être sécurisés dans les environnements de production. :::

• -- rejet-non autorisé: pour rejeter les certificats auto-signés, indiquez True. La valeur par défaut est Faux.

• -- port: port sur lequel l'API RSE s'exécute sur l'hôte. La valeur par défaut est 6800. Si vous ne connaissez pas le numéro de port, adressez-vous à votre administrateur système.

• -- chemin-base: Chemin de base de l'API pour les opérations API REST. La valeur par défaut est Rseapi.

• -- codage: codage d'hôte par défaut pour le profil. La valeur par défaut est IBM-1047.

Une fois le profil RSE créé, vous pouvez tester si la connexion à l'API IBM Remote System Explorer fonctionne en tapant la commande pour répertorier les fichiers, par exemple, Zowe rse list data-set HLQ où HLQ est un qualificatif de haut niveau ou un ID utilisateur accessible par l'ID utilisateur dans le profil créé pour afficher les fichiers.

Après avoir installé le plug-in d'interface CLI RSE, vous pouvez l'utiliser dans une fenêtre de ligne de commande sur votre machine de développement. Lancez des commandes pour effectuer les tâches suivantes :

• Répertorier, créer, télécharger, transférer et supprimer des ensembles de données et des membres MVS, ainsi que des fichiers et des répertoires USS.

• Soumettre des travaux, afficher la liste des travaux et des fichiers spoule, télécharger ou afficher le contenu du spoule, afficher l'état d'un travail, et annuler ou supprimer un travail.

Par exemple, après avoir créé votre profil RSE pour l'utilisateur UTILISATEUR1 et un fichier avec vos programmes COBOL appelés UTILISATEUR1.SAMPLE.COBOL, vous pouvez travailler sur vos fichiers MVS avec les commandes suivantes:

• Afficher la liste des ensembles de données et des membres :

  zowe rse ls ds USER1
  zowe rse ls all-members USER1.SAMPLE.COBOL

• Télécharger les membres :

  zowe rse download ds "USER1.SAMPLE.COBOL(SAM1)"

  Vous constatez que de nouveaux dossiers apparaissent sur la gauche et que leur nom est basé sur l'ensemble de données qui contient le fichier SAM1. Vous pouvez le renommer en ajoutant une extension .cbl pour l'éditer dans l'éditeur COBOL, puis le télécharger ultérieurement à l'aide de la fonction glisser-déposer ou via la ligne de commande.

• Vérifier l'état de vos travaux :

  zowe rse ls js | grep ACTIVE

  La commande ci-dessus montre un exemple d'utilisation combinée des commandes de l'interface CLI RSE et d'autres commandes et scripts Linux®. Cet exemple renvoie la liste complète des travaux et des canaux de communication qui s'affichent dans la commande Linux Grep pour le filtrer pour n'afficher que les travaux actifs. Ce type de fonctionnalité permet de définir tous les types de travaux par lots et l'automatisation pour l'interaction à distance avec z/OS.

Pour obtenir la liste complète des commandes disponibles, voir Commandes IBM RSE API Plug-in for Zowe CLI.

Pour en savoir plus sur une commande et sur toutes les options de la commande, ajoutez -- help après la commande. Par exemple, en spécifiant Zowe rse list -- help, vous pouvez afficher tous les éléments pouvant être répertoriés et une réponse d'aide comme celle-ci dans le terminal:

DESCRIPTION
 -----------

   List uss file and folders, data sets and data set members, or jobs and spool
   files. Optionally, you can list their details and attributes.

 USAGE
 -----

   zowe rse-api-for-zowe-cli list <command>

   Where <command> is one of the following:

 COMMANDS
 --------

   all-members | am            List all members of a pds
   data-set | ds               List data sets
   jobs | js                   List z/OS jobs on JES spool/queues
   spool-files-by-jobid | sfbj List spool files of a z/OS job
   uss-files | uss             List USS files

GLOBAL OPTIONS
 --------------

   --response-format-json  | --rfj (boolean)

      Produce JSON formatted data from a command

   --help  | -h (boolean)

      Display help text

   --help-examples  (boolean)

      Display examples for all the commands in a the group

   --help-web  | --hw (boolean)

      Display HTML help in browser

Si vous souhaitez afficher la réponse d'aide dans un navigateur Web, entrez -- help-web, par exemple, Zowe rse list -- help-web.

Aide en ligne

Pour installer l'interface de ligne de commande Zowe, voir la section Installation de l'interface CLI de Zowe dans la rubrique Configuration des intégrations.

Avant d'utiliser l'interface CLI Zowe, vous devez créer un profil z/OSMF et vous connecter à z/OS. Pour créer un profil z/OSMF, procédez comme suit :

1. Exécutez cette commande avec votre nom d'hôte, le port z/OSMF, le nom d'utilisateur et le mot de passe :

   zowe profiles create zosmf-profile zoweCLI --host host.company.com --port 443 --user USER1 --pass password --reject-unauthorized false

   Remarque: une fois que vous avez créé ou ajouté un profil Zowe, vous devez recharger les vues de l'explorateur pour que le profil apparaisse dans les vues graphiques Zowe fournies par Zowe Explorer.

2. Testez le profil à l'aide de la commande suivante :

   zowe zosmf check status

Par exemple, une fois que vous avez créé votre profil Zowe CLI z/OSMF pour l'utilisateur UTILISATEUR1 et un fichier avec vos programmes COBOL appelés UTILISATEUR1.SAMPLE.COBOL, vous pouvez travailler sur vos fichiers MVS avec les commandes suivantes:

• Afficher la liste des ensembles de données et des membres :

  zowe files ls ds USER1
  zowe files ls all-members USER1.SAMPLE.COBOL

• Télécharger les membres :

  zowe files download ds "USER1.SAMPLE.COBOL(SAM1)"

  Vous constatez que de nouveaux dossiers apparaissent sur la gauche et que leur nom est basé sur l'ensemble de données qui contient le fichier SAM1. Vous pouvez le renommer en ajoutant une extension .cbl pour l'éditer dans l'éditeur COBOL, puis le télécharger ultérieurement à l'aide de la fonction glisser-déposer ou via la ligne de commande.

• Vérifier l'état de vos travaux :

  zowe jobs ls js | grep ACTIVE

  La commande ci-dessus montre un exemple d'utilisation combinée des commandes de l'interface CLI RSE et d'autres commandes et scripts Linux. Cet exemple renvoie la liste complète des travaux et des canaux de communication qui s'affichent dans la commande Linux Grep pour le filtrer pour n'afficher que les travaux actifs. Ce type de fonctionnalité permet de définir tous les types de travaux par lots et l'automatisation pour l'interaction à distance avec z/OS.

Pour une présentation des commandes CLI Zowe disponibles, entrez Zowe -- help.

Pour en savoir plus sur toutes les fonctions de l'interface de ligne de commande Zowe, voir Documentation en ligne de l'interface CLI Zowe.