DMPTAP

La commande DMPTAP (Clicher une bande) permet de clicher des informations label ou/et des blocs de données à partir de bandes avec ou sans label standard dans le fichier spoule QPTAPDMP. Cette commande permet à l'utilisateur de clicher un ou plusieurs fichiers de données à partir du volume de bande, en écrivant les informations dans un fichier imprimante.

Le volume de bande à clicher doit se trouver sur l'unité indiquée. Une fois la commande DMPTAP entrée, la quantité de bande nécessaire est lue avant l'impression des informations demandées.

Les fichiers de données des bandes sécurisées peuvent être clichés uniquement par le responsable de la sécurité ; tout utilisateur peut clicher des informations label des bandes sécurisées

Lors de l'utilisation des valeurs par défaut des paramètres de la commande DMPTAP, les zones label de la bande et une quantité minimale des données du premier fichier sont imprimées. Cette commande permet de déterminer le format d'enregistrement d'un fichier de données sur une bande sans label, ou le contenu exact de toutes les informations label d'un fichier de données avec label.

Restrictions :

1. Vous devez disposer du droit spécial *ALLOBJ pour effectuer un cliché d'une bande de TYPE(*HEX).

Paramètres

Unité (DEV)

Indique l'unité de bande sur laquelle se trouve le volume faisant l'objet d'un cliché. Ce volume peut ne pas avoir de label. Précisez le nom de l'unité de bande ou de la bandothèque.

Ce paramètre est obligatoire.

nom

Indiquez le nom de l'unité de bande.

Identificateur de volume (VOL)

Indique l'objet du cliché : le volume de bande qui se trouve sur l'unité ou l'identificateur de volume d'une bande avec label.

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 virtuel à monter et à utiliser.

*MOUNTED

Le volume sur l'unité désignée fait l'objet du cliché. Ce volume peut ne pas avoir de label. Dans le cas d'un volume sans label, *MOUNTED doit figurer pour le paramètre VOL et *NONE doit être indiqué pour le paramètre Label du fichier (LABEL). 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

Indiquez l'identificateur du volume avec label faisant l'objet du cliché. Vous ne pouvez indiquer cette valeur que si le volume à clicher possède un label. Si la bande placée sur l'unité indiquée possède un identificateur de volume différent de celui indiqué ou s'il s'agit d'un volume sans label, le système envoie un message d'erreur à l'utilisateur qui a émis la commande DMPTAP (Clicher une bande) et l'exécution de celle-ci est interrompue.

Plage de numéros de séquence (SEQNBR)

Indique la plage des numéros de séquence des fichiers faisant l'objet d'un cliché. Notez que les fichiers de données clichés peuvent être encore restreints en utilisant le paramètre Label du fichier (LABEL).

Valeurs uniques

*ALL

L'ensemble des fichiers figurant sur le volume placé sur l'unité indiquée fait l'objet d'un cliché.

*SEARCH

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

Elément 1 : Début au no séquence fichier

*FIRST

La liste des fichiers faisant l'objet d'un cliché débute par le premier fichier sur le volume bande, quel que soit son numéro de séquence.

1 à 16777215

La plage des fichiers faisant l'objet d'un cliché débute par le fichier dont le numéro de séquence est précisé. Indiquez un nombre inférieur ou égal à la valeur fin-au-n°-séquence-fichier.

Elément 2 : Fin au no séquence fichier

*ONLY

Seul le fichier désigné par la valeur début-au-n°-séquence-fichier fait l'objet d'un cliché.

*LAST

La plage des fichiers de données faisant l'objet d'un cliché débute par le fichier correspondant au numéro de séquence de fichier de début et se termine par le dernier fichier figurant sur la bande.

1 à 16777215

La plage des fichiers faisant l'objet d'un cliché se termine par le fichier ayant le numéro de séquence désigné. Indiquez un nombre supérieur ou égal au numéro de séquence de fichier de début.

Label du fichier (LABEL)

Indique les identificateurs de fichiers spécifiques faisant l'objet d'un cliché. L'identificateur d'un fichier bande est stocké dans les labels placés avant et après les données du fichier.

*NONE

L'ensemble des fichiers du volume figurant sur la liste SEQNBR désignée fait l'objet d'un cliché. Dans le cas d'un volume sans label, *MOUNTED doit figurer pour le paramètre Identificateur de volume (VOL) et *NONE doit être indiqué pour le paramètre LABEL.

identificateur

Indiquez l'identificateur des fichiers faisant l'objet d'un cliché. Le système compare cet identificateur avec l'identificateur de fichier figurant dans les labels de chaque fichier appartenant à la plage indiquée par le paramètre Plage de numéros de séquence (SEQNBR). Tous les fichiers possédant un identificateur correspondant à celui-ci font l'objet d'un cliché, les autres ne sont pas concernés par l'opération.

identificateur-générique

Indique une chaîne de caractères représentant un identificateur de générique et comprenant un ou plusieurs caractères suivi d'un astérisque (*). Tout fichier bande possédant un identificateur ayant le même préfixe que celui de l'identificateur de fichier générique fait l'objet d'un cliché.

Informations fichier à clicher (TYPE)

Indique le type d'informations faisant l'objet d'un cliché. Le cliché pourra être constitué des labels de début, des labels de fin ou des blocs issus de la partie données du fichier, ou encore de ces trois éléments réunis. Si un volume de bande sans label figure sur l'unité, vous ne pouvez indiquer que les valeurs d'informations *BASIC, *ALL, *HEX ou *DTABLK pour ce paramètre ; sinon, vous recevrez un message d'erreur et aucun cliché du volume ne sera effectué.

Valeurs uniques

*BASIC

Pour un volume avec label standard, le cliché se compose des labels de début et des blocs de données indiqués par le paramètre Blocs de données à clicher (DTABLK). Dans le cas d'un volume sans label, seuls les blocs de données font l'objet d'un cliché.

*ALL

Pour un volume avec label standard, le cliché se compose des labels de début, des labels de fin et des blocs de données. Dans le cas d'un volume sans label, seuls les blocs de données font l'objet d'un cliché lorsque vous indiquez *ALL.

*NONE

Aucun fichier ne fait l'objet d'un cliché. Si *NONE est indiqué, le volume de bande cliché doit posséder un label, et *YES doit être indiqué pour le paramètre Clicher label volume (VOLLBL) ; sinon, le système envoie un message d'erreur à l'utilisateur qui a émis la commande DMPTAP (Clicher une bande.

*HEX

Pour un volume de bande avec label, un cliché des données est pris comme si le volume est une bande sans label. Les labels de début, les blocs de données et les labels de fin pour un fichier avec label apparaissent comme trois fichiers de bande sans label séparés. Pour un volume sans label, un cliché des données est pris comme si *DTABLK était indiqué.

Autres valeurs (jusqu'à 3 répétitions)

*HDRLBL

Les labels de début des fichiers (y compris ceux indiqués par l'utilisateur) font l'objet d'un cliché. Dans le cas de volumes sans label, la valeur *HDRLBL ne peut pas être indiquée.

*DTABLK

Un ou plusieurs blocs de données du fichier font l'objet d'un cliché. Indiquez les blocs du fichier concernés par le paramètre Blocs de données à clicher (DTABLK).

*TLRLBL

L'ensemble des labels de fin de fichiers (y compris ceux indiqués par l'utilisateur) fait l'objet d'un cliché. Dans le cas de volumes sans labels, la valeur *TLRLBL ne peut pas être indiquée.

Blocs de données à clicher (DTABLK)

Indique les blocs de données faisant l'objet d'un cliché. Ce paramètre permet de limiter la quantité de données de fichier bande imprimée. Si vous n'avez indiqué ni *BASIC ni *ALL pour le paramètre Informations fichier à clicher (TYPE), et que le paramètre TYPE n'inclut pas *DTABLK, ce paramètre est ignoré.

Valeurs uniques

*ALL

L'ensemble des blocs de données des fichiers indiqués sur ce volume fait l'objet d'un cliché. Si un fichier débute ou se termine sur un autre volume, seule la partie du fichier stockée sur le présent volume fait l'objet d'un cliché.

*LAST

Seul le dernier bloc de données du fichier fait l'objet d'un cliché.

Elément 1 : Début au numéro de bloc

*FIRST

La liste des blocs de données débute par le premier bloc du fichier.

1-2147483647

Indiquez le numéro du premier bloc de données de chaque fichier faisant l'objet d'un cliché. Si ce numéro est supérieur au numéro de la fin du bloc de données, le système envoie un message d'erreur à l'utilisateur et le cliché de bande n'est pas effectué. Si le numéro du début de bloc de données est supérieur au nombre de blocs du fichier, le dernier bloc de données du fichier fait l'objet d'un cliché sans que le système envoie de message d'erreur.

Elément 2 : Fin au numéro de bloc

*ONLY

Seul le bloc de données spécifié comme bloc de début fait l'objet d'un cliché.

*LAST

La plage de blocs de données faisant l'objet d'un cliché débute par le bloc désigné par la valeur de numéro de début de bloc de données et se termine par le dernier bloc du fichier.

1-2147483647

Indiquez le numéro du dernier bloc de données pour chaque fichier à clicher. Si ce numéro est inférieur au numéro du début du bloc de données, le système envoie un message d'erreur à l'utilisateur et le cliché de bande n'est pas effectué. Si le numéro de la fin de bloc de données est supérieur au nombre de blocs de données du fichier, l'ensemble des blocs à partir du numéro du début de bloc de données jusqu'à la fin du fichier fait l'objet d'un cliché sans que le système n'envoie de message d'erreur.

Clicher label volume (VOLLBL)

Indique si les labels de volume font l'objet d'un cliché. Ce paramètre est ignoré pour les volumes sans labels ou lorsque *HEX est indiqué pour le paramètre Informations fichier à clicher (TYPE) pour une bande avec label standard.

*YES

L'ensemble des labels de volume (y compris ceux indiqués par l'utilisateur) fait l'objet d'un cliché.

*NO

Aucun label de volume ne fait l'objet d'un cliché. Toutefois, la sortie papier du volume comporte l'identificateur d'un volume avec label et des informations concernant toute bande faisant l'objet d'un cliché.

Code (CODE)

Indique le type de code caractères utilisé pour les données enregistrées sur la bande. Dans le cas d'un volume avec label, ce paramètre n'est pas pris en compte car les labels de la bande déterminent si les données sont enregistrées en code EBCDIC ou ASCII.

*EBCDIC

La bande comporte des données en code EBCDIC. Le cliché comporte la valeur hexadécimale et le caractère EBCDIC correspondant à chaque octet.

*ASCII

Le code caractères ASCII est utilisé.

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.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD

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

Exemples

DMPTAP   DEV(QTAPE2)  SEQNBR(5)  TYPE(*DTABLK)  DTABLK(3 7)

Cette commande permet de clicher les informations du volume de bande qui se trouvent sur l'unité QTAPE2. Les blocs de données 3 à 7 du fichier de données indiqués par le numéro de séquence 5 sont clichés vers un fichier d'imprimante.

Messages d'erreur

*ESCAPE Messages

CPF222E

Le droit spécial &1 est requis.

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.

CPF6723

Fichier non trouvé sur volume &2 de l'unité &1.

CPF6724

Label fichier &5 non trouvé sur volume &2.

CPF6725

Numéro de séquence de fin inférieur au numéro séquence de début.

CPF6726

Numéro bloc de fin inférieur au numéro bloc de début.

CPF6727

Type de cliché non admis pour volume sans label sur unité &1.

CPF6728

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

CPF6729

Non autorisé à utiliser les données du volume &2 sur unité &1.

CPF6730

Non autorisé à accéder au fichier numéro de séquence &5.

CPF6731

Label fichier &5 non trouvé sur volume &2.

CPF6745

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

CPF6751

Incident de chargement sur unité &4.

CPF6760

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

CPF6772

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

CPF9814

Unité &1 non trouvée.

CPF9825

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

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9850

Substitution non admise pour fichier imprimante &1.