CHKTAP

La commande CHKTAP (Vérifier l'existence sur bande) permet de rechercher, sur la bande de l'unité indiquée, un identificateur de volume ou un label de fichier donné. Si la bande correcte est montée, vous pourrez traiter ce fichier en indiquant le numéro de séquence mentionné avec cette commande. Si le système ne trouve pas la bande correcte, il envoie un message d'arrêt programme à l'utilisateur.

Paramètres

Unité (DEV)

Indique le nom de l'unité sur laquelle se trouve le volume à vérifier.

Ce paramètre est obligatoire.

nom

Précisez le nom de l'unité de bande ou de la bandothèque.

Ce paramètre est obligatoire.

Identificateur de volume (VOL)

Indique si la bande fait l'objet d'une recherche d'identificateur de volume. Ceci n'est valable que pour une bande possédant un label standard.

Remarque :Si l'unité spécifiée est une unité de bandothèque ou une unité de bande virtuelle, le volume indiqué doit être l'identificateur de cartouche ou le nom de volume de bande virtuelle à monter et à utiliser.

*MOUNTED

L'identificateur de volume sur la bande n'est pas vérifié. Le volume présent sur l'unité est utilisé. Dans le cas d'une unité de médiathèque, le volume à utiliser correspond à la cartouche suivante de la catégorie montée à l'aide de la commande SETTAPCGY (Définir une catégorie de bande). Dans le cas d'une unité de bande virtuelle, le volume à utiliser correspond à celui qui est monté ou, en l'absence de volume monté, au volume suivant dont l'état est Chargé dans le catalogue d'images de CD-ROM.

valeur-alphanumérique

Si l'unité spécifiée au paramètre DEV est une unité de bande autonome, indiquez l'identificateur du volume avec label. Cette valeur est comparée à l'identificateur de volume figurant sur la bande. Si le système ne trouve pas sur la bande l'identificateur de volume indiqué, il envoie un message d'arrêt programme. Si l'unité spécifiée au paramètre DEV est une description d'unité de bandothèque, indiquez l'identificateur de cartouche du volume à utiliser. Si l'unité spécifiée au paramètre DEV est une unité de bande virtuelle, indiquez le nom de volume de bande virtuelle du volume à utiliser.

Numéro de séquence (SEQNBR)

Indique si un numéro de séquence spécifique d'un fichier est recherché sur la bande.

*NONE

Aucun fichier particulier n'est recherché sur le volume.

*FIRST

La vérification porte sur le premier fichier du volume.

*NEXT

La vérification porte sur le fichier suivant du volume. Si le numéro de séquence en cours se trouve au début du volume, cette valeur entraîne la vérification du premier fichier du volume.

*SEARCH

Une recherche est effectuée sur les fichiers de données ayant un identificateur correspondant à la valeur que vous avez indiquée pour le paramètre Label du fichier (LABEL). Si vous avez indiqué *SEARCH, le volume doit avoir un label et un label fichier doit figurer pour le paramètre Label du fichier (LABEL). Si le système ne trouve pas le fichier, il envoie un message d'arrêt programme.

entier

Indiquez le numéro de séquence du fichier à vérifier sur cette bande. Si le système ne trouve pas le numéro de séquence sur la bande, il envoie un message d'arrêt programme. Les valeurs admises sont comprises entre 1 et 16777215.

Label du fichier (LABEL)

Indique si un identificateur de label est vérifié. Si vous avez indiqué un label, vous devez également indiquer un numéro de séquence pour le paramètre Numéro de séquence (SEQNBR).

*NONE

Pas de vérification d'identificateur de label sur la bande. Cette valeur est obligatoire si vous avez indiqué *NONE pour le paramètre Date de création (CRTDATE) pour un volume sans label.

valeur-alphanumérique

Indiquez l'identificateur du fichier à vérifier. Vous pouvez entrer jusqu'à 17 caractères. Si vous avez indiqué un label, vous devez également indiquer *SEARCH ou un numéro de séquence pour le paramètre Numéro de séquence (SEQNBR). L'identificateur du fichier situé sur ce numéro de séquence est comparé au label identifié par ce paramètre. En cas de non-concordance, le système envoie un message d'arrêt programme.

Date de création (CRTDATE)

Indique si la vérification doit également porter sur la date de création du fichier. Si vous avez indiqué *NONE pour le paramètre Numéro de séquence (SEQNBR), vous devez également indiquer cette valeur ici.

*NONE

La date de création du fichier n'est pas vérifiée. Cette valeur est obligatoire si vous avez indiqué *NONE pour le paramètre Label du fichier (LABEL) pour un volume sans label.

date

Indiquez une date de création devant être comparée à celle du fichier. Elle doit être conforme au format de date du travail.

Option fin de bande (ENDOPT)

Indique si la bande est simplement rembobinée ou si elle est également déchargée une fois l'opération terminée.

*LEAVE

La bande n'est pas rembobinée. La prochaine opération portera sur le début du fichier où se trouve positionnée la bande. Ceci permet l'ouverture du fichier avec le numéro de séquence indiqué pour le paramètre Numéro de séquence (SEQNBR) sans avoir à repositionner la bande.

*REWIND

La bande est rembobinée, mais pas déchargée.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

Exemples

Exemple 1: vérification de l'identificateur de volume

CHKTAP   DEV(TAPE1)  VOL(TAPEVOL)

Cette commande vérifie l'identificateur du volume qui se trouve sur l'unité de bande TAPE1. Si l'identificateur de volume de la bande est TAPEVOL, la commande se termine normalement sans envoi de message. Si l'identificateur de volume de la bande n'est pas TAPEVOL, un message d'arrêt programme est envoyé.

Exemple 2: vérification d'un numéro de séquence spécifique

CHKTAP   DEV(TAPE2)  VOL(VOLID)  SEQNBR(5)
         LABEL(FILE5)  CRTDATE('1/9/84')

Cette commande recherche l'identificateur VOLID du volume qui se trouve sur l'unité de bande TAPE2. Si ce volume est détecté, le numéro de séquence 5 se trouve sur le bande (il doit s'agir d'une bande à label standard). Le numéro de séquence du label du fichier sert à positionner le numéro de séquence 5. Si le numéro de séquence est détecté et que le label d'en-tête contient l'identificateur de fichier FILE5 et la date 9/1/84, la bande et le fichier corrects ont été trouvés, et un message de fin est envoyé à l'utilisateur. L'opération de bande suivante peut indiquer le numéro de séquence 5 pour accéder à ce fichier sans positionner la bande. Si le volume indiqué n'est pas trouvé ou si la bande n'est pas un volume à label standard, un message d'arrêt programme est envoyé à l'utilisateur. Si le volume est trouvé mais que le numéro de séquence ne l'est pas, un message d'arrêt programme est envoyé à l'utilisateur. Si le label de fichier de ce numéro de séquence n'est pas FILE5, un message d'arrêt programme est envoyé à l'utilisateur. Si la date de ce numéro de séquence n'est pas 9/1/84, un message d'arrêt programme est envoyé à l'utilisateur.

Messages d'erreur

*ESCAPE Messages

CPF6708

Commande arrêtée par suite d'erreur.

CPF6718

Impossible d'allouer l'unité &1.

CPF6720

Volume &2 incorrect sur unité &1.

CPF6721

&1 n'est pas une unité de bande.

CPF6728

LABEL(*NONE) ou CRTDATE(*NONE) requis.

CPF6734

Fichier numéro de séquence &3 non trouvé sur volume &2.

CPF6735

ID label &6 non trouvé au numéro de séquence &3.

CPF6736

Date de création &6 non trouvée au numéro de séquence &3.

CPF6737

Label &4 non trouvé sur volume &2.

CPF6745

&1 n'est pas une médiathèque.

CPF6751

Incident de chargement sur unité &4.

CPF6752

SEQNBR(*FIRST) ou SEQNBR(*NEXT) incorrect.

CPF6760

L'unité &1 n'est pas prête.

CPF6772

Le volume chargé sur l'unité &1 ne peut pas être traité.

CPF67E6

Volume &2 incorrect

CPF9814

Unité &1 non trouvée.

CPF9825

Accès non autorisé à l'unité &1.