Boîte de dialogue Créer un travail par lots

Cette boîte de dialogue permet de soumettre un fichier JCL défini par l'utilisateur. Cette demande d'action est plus flexible que les commandes de kit fournies par le produit.

L'Onglet Options de cette boîte de dialogue fournit les zones décrites ci-après. Pour savoir comment utiliser cette boîte de dialogue, voir Limites et conseils relatifs au Kit de stockage.

Pour en savoir plus sur les fonctions standard d'une boîte de dialogue, voir Onglets standard des boîtes de dialogue du Kit de stockage. Cette rubrique contient un lien vers le guide de référence des commandes utilisées dans le Kit de stockage.

Voir Conventions des fichiers JCL utilisés avec le Kit de stockage. Pour connaître l'autorisation requise pour les demandes d'action du Kit de stockage, voir aussi Authentification et autorisation d'exécution des commandes du Kit de stockage.

Fichier qualifié complet du grand système contenant le JCL de travail par lots : Indique le fichier qui contient le travail par lots. Le fichier doit être un fichier séquentiel ou un membre d'un fichier partitionné (PDS). La longueur des enregistrements logiques du fichier doit être 80 et le fichier doit avoir un format à longueur fixe. Pour modifier ou créer le fichier, cliquez sur le bouton Edition de JCL pour afficher la Boîte de dialogue Editer l'ensemble de données.
Remarque : L'ID utilisateur Tivoli Enterprise Portal que vous utilisez doit être autorisé à accéder au fichier au sein du grand système. S'il ne l'est pas, un message d'erreur s'affiche lorsque vous cliquez sur Edition de JCL. Pour plus d'informations, voir Authentification et autorisation d'exécution des commandes du Kit de stockage.
Variables de substitution et valeurs de remplacement à l'exécution : Indique les valeurs de remplacement à utiliser lors de l'exécution. Les valeurs de remplacement permettent au travail par lots de répertorier des objets spécifiques, comme les fichiers et les volumes. Par exemple, ces objets peuvent correspondre aux valeurs indiquées dans les lignes du tableau que vous sélectionnez avant d'appeler cette boîte de dialogue.
Dans la colonne Variable, vous pouvez saisir un nom unique pour chaque variable de substitution qui existe dans le fichier. Dans les cellules de la colonne Attribut ou chaîne, vous pouvez sélectionner l'un des noms disponibles. Ces noms reflètent les attributs des lignes du tableau que vous avez sélectionnées dans un espace de travail, avant d'appeler la boîte de dialogue Création de travail par lots. Vous pouvez également saisir manuellement des valeurs dans les cellules. Par exemple, vous pouvez saisir des valeurs telles que le nom du travail, la classe sysout et d'autres valeurs qui peuvent ne pas être présentes dans le tableau de l'espace de travail à partir duquel vous sélectionnez les lignes.
Conseil : Utilisez le signe pourcentage pour indiquer les variables de substitution (%nom%) présentes dans votre fichier JCL. Ainsi, cette boîte de dialogue recherche et répertorie automatiquement les variables de substitution JCL.

Pour connaître les instructions s'appliquant à l'utilisation des variables de substitution, voir Variables de substitution standard du kit de stockage.

Fichiers dont le contenu doit être copié pour une consultation ultérieure : Indique les fichiers et les noms de définition de données à conserver comme enregistrement des résultats du travail par lots. Les fichiers peuvent être visualisés dans l'espace de travail Caractéristiques des résultats du kit de stockage.

Dans la colonne Nom d'étape, indiquez le nom de l'étape dont vous souhaitez sauvegarder les données. Dans la colonne Nom de fichier ou de définition de données qualifié complet, indiquez les fichiers séquentiels, les membres de fichiers partitionnés ou les noms de définition de données que vous souhaitez copier. Le tableau ci-après contient des exemples de paramètre pour cette section de la boîte de dialogue :

Tableau 1. Exemples de paramètre pour "Fichiers dont le contenu doit être copié pour une consultation ultérieure"
Nom d'étape	Nom de fichier ou de définition de données
STEPX	USER02.LOG.LISTING
STEPY	SYSPRINT

La spécification de la ligne 1 conserve les données du fichier USER02.LOG.LISTING.

La spécification de la ligne 2 conserve le fichier SYSPRINT dans STEPY. Cette sortie est sauvegardée dans le fichier de points de contrôle. Les restrictions suivantes s'appliquent :

Seuls les fichiers séquentiels ou les membres d'un fichier partitionné sont admis.
Les fichiers VSAM ne sont pas admis.
Les fichiers contenant des caractères non imprimables (par exemple du code hexadécimal) risquent de ne pas s'afficher correctement dans l'espace de travail Caractéristiques des résultats du kit de stockage.
Les lignes de plus de 256 caractères sont tronquées.

Fichiers qualifiés complets nécessaires au travail et qui contiennent également des variables de substitution : Indique les fichiers qui se trouvent en dehors du flot de travaux JCL. Ces fichiers peuvent être nécessaires pour fournir de manière dynamique les variables de substitution qui correspondent aux objets (comme les fichiers et les volumes), requises lors de l'exécution du travail par lots. Ces fichiers supplémentaires peuvent être des fichiers séquentiels ou des membres de fichiers partitionnés. La longueur des enregistrements logiques de ces fichiers doit être 80 et ces fichiers doivent avoir un format à longueur fixe.

Par exemple, un travail IEHLIST peut utiliser une instruction SYSIN DD désignant un fichier DASD plutôt que des cartes de contrôle du flux. Ce fichier peut contenir des variables de substitution à remplacer lors de l'exécution.

Si aucun fichier contenant des variables de substitution n'est référencé dans le JCL, cette section de la boîte de dialogue peut rester vide.

Il se peut que vous receviez les codes retour suivant si la tentative d'accès aux fichiers échoue :

Code retour	Description
119 (erreur fichier)	Le serveur UDS (User Data Set) a échoué.
121 (incident autorisation)	Vous tentez d'accéder à un fichier pour lequel vous ne possédez pas d'autorisation RACF (Resource Access Control Facility).
123 (erreur fichier)	Le fichier n'existe pas ou le format et/ou la longueur d'enregistrement ne sont pas pris en charge.

Il se peut que vous receviez également le code retour (statut) 117 (JCL non valide). Ce statut indique généralement que le fichier JCL dépasse 72 caractères une fois les variables de substitution appliquées. Il peut également signaler d'autres erreurs en rapport avec le fichier JCL, notamment une carte JOB manquante, ou qu'un autre fichier nécessitant une substitution de variable excède 80 caractères lorsque les variables de substitution sont appliquées.

N'oubliez pas de consulter le journal RKLVLOG pour regarder si le système n'a pas consigné d'autres messages concernant ces résultats.

Lorsque la configuration du travail par lots est terminée, cliquez sur OK dans la boîte de dialogue Créer un travail par lots. A ce stade, le fichier JCL que vous fournissez et les autres fichiers contenant des variables de substitution sont copiés dans des fichiers temporaires. Ces fichiers temporaires sont utilisés lorsque le JCL du travail par lots est soumis.

Conventions des fichiers JCL utilisés avec le Kit de stockage

Le fichier correspondant au JCL créé ou modifié doit être un fichier séquentiel ou un membre d'un fichier partitionné (PDS). Tous les fichiers JCL utilisés avec le Kit de stockage doivent respecter certaines conventions pour permettre à Tivoli Enterprise Portal de remplacer les valeurs des données lors de l'exécution. Les éléments suivants (en gras dans la Figure 1) sont des variables de substitution qui seront modifiées par le kit de stockage lors de l'exécution du travail :

%job-name% (voir ligne 000100)
%sysout% (voir ligne 000100)
%my-volser% (voir ligne 000800)
%dsname% (voir ligne 000800)

Figure 1. Eléments variables des fichiers JCL utilisés avec le Kit de stockage

****** ***************************** Top of Data ******************************
000100 //%job-name% JOB (),'DHODS',REGION=4M,MSGCLASS=%sysout%,NOTIFY=&SYSUID, 
000200 //         CLASS=A
000300 //* ------------------------------------------------------------------- 
000400 //LISTVTOC EXEC PGM=IEHLIST                                             
000500 //SYSPRINT DD SYSOUT=*                                                  
000600 //SYSIN    DD *                                                         
000700 )DOT                                                                    
000800   LISTVTOC DUMP,VOL=3390=%my-volser%,DSNAME=(%dsname%)                  
000900 )ENDDOT
001000 /*                                                                      
001100 //                                                                      
****** **************************** Bottom of Data ****************************

Conseil : Utilisez le signe pourcentage pour indiquer les variables de substitution (%name%) présentes dans votre fichier JCL. Ainsi, cette boîte de dialogue recherche et répertorie automatiquement les variables de substitution JCL.

Les lignes )DOT et )ENDDOT de la Figure 1 indiquent le début et la fin du traitement de la table. Les lignes de code JCL situées entre les lignes )DOT et )ENDDOT sont répétées pour chaque ligne de la table transmise à l'agent du grand système lors de l'exécution du code JCL. En général, ces lignes contiennent des variables de substitution, qui sont remplacées par d'autres valeurs lors de l'exécution. Par exemple, la sortie générée par les lignes SYSIN JCL peut ressembler à ce qui suit :

000600 //SYSIN    DD *                                                         
000700   LISTVTOC DUMP,VOL=3390=TSO201,DSNAME=(SYS2.USER.CLIST)                    
000800   LISTVTOC DUMP,VOL=3390=TSO202,DSNAME=(SYS2.USER.PROCLIB)                    
000900   LISTVTOC DUMP,VOL=3390=MVSA12,DSNAME=(SYS2.PROD.LOADLIB)                    
001000 /*