SETTAPCGY

Définir une catégorie de bande

En bref

La commande SETTAPCGY permet de définir une catégorie pour une unité de bande dans une médiathèque donnée.

SETTAPCGY se lit SET (Définir) + TAPCGY. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SETTAPCGY DEV(…) OPTION(…)

Paramètres

DEV Unité de médiathèque obligatoire
OPTION Option obligatoire
CGY Catégorie
CTGORDER Ordre des cartouches
TGTCGY Catégorie cible
TGTCGYOPT Option de catégorie cible
MNTID ID de montage

Astuce : dans une session 5250, tapez SETTAPCGY puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande SETTAPCGY permet de définir une catégorie pour une unité de bande dans une médiathèque donnée. Le système charge automatiquement les cartouches de la catégorie spécifiée dans l'ordre indiqué au paramètre CTGORDER.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité de médiathèque	Nom	Obligatoire, positionnel 1
OPTION	Option	MOUNTED, DEMOUNTED, ASSIGN, RELEASE	Obligatoire, positionnel 2
CGY	Catégorie	Valeurs uniques: SHARE400 Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Nom de la catégorie	Valeur caractère, NOSHARE, IPL, NL, CNV
	Élément 2: Système de la catégorie	Valeur caractère, *CURRENT
CTGORDER	Ordre des cartouches	SEQ, NEXTAVAIL	Facultatif
TGTCGY	Catégorie cible	Valeurs uniques: SHARE400 Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Nom de la catégorie	Valeur caractère, CGY, NOSHARE, IPL, NL
	Élément 2: Système de la catégorie	Valeur caractère, *CURRENT
TGTCGYOPT	Option de catégorie cible	MOUNT, UNLOAD, *EOV	Facultatif
MNTID	ID de montage	Nom, *NONE	Facultatif

Unité de médiathèque (DEV)

Indique la bandothèque pour laquelle la catégorie est définie.

Ce paramètre est obligatoire.

nom: Indiquez le nom de l'unité de bandothèque.

Option (OPTION)

Indique l'option qui est définie pour l'unité de médiathèque.

Ce paramètre est obligatoire.

*MOUNTED: La catégorie spécifiée au paramètre CGY est considérée comme étant montée et toute opération sur bande pour laquelle VOL(*MOUNTED) est indiqué, utilise les cartouches de la catégorie qui est montée.
*DEMOUNTED: La catégorie indiquée au paramètre CGY n'est plus montée. L'utilisation de VOL(*MOUNTED) est incorrecte pour l'unité de médiathèque.
*ASSIGN: La session de catégorie montée indiquée dans le paramètre MNTID est affectée au travail lancé à partir de la commande SETTAPCGY. Cette session doit avoir été précédemment montée et libérée.
*RELEASE: La session de catégorie montée indiquée dans le paramètre SETTAPCGY est libérée, puis devient accessible pour un autre travail.

Catégorie (CGY)

Indique la catégorie à monter.

Valeurs uniques

*SHARE400: L'identificateur de cartouche peut être partagé par d'autres systèmes connectés à l'unité de bibliothèque. Elles sont montées dans l'ordre spécifié au paramètre CTGORDER.

Elément 1 : Nom de la catégorie

*NOSHARE: Les cartouches ne peuvent pas être partagées avec d'autres systèmes connectés à la même unité. Elles sont montées dans l'ordre spécifié au paramètre CTGORDER.
*IPL: Les cartouches peuvent être utilisées pour un IPL secondaire (bande) du système. Elles sont montées dans l'ordre spécifié au paramètre CTGORDER.
*NL: La cartouche est utilisée comme bande sans label. Elles sont montées dans l'ordre spécifié au paramètre CTGORDER.
*CNV: Les cartouches proviennent de la catégorie spéciale libre-service. Elles sont montées dans l'ordre spécifié au paramètre CTGORDER.
valeur-alphanumérique: Indiquez le nom d'une catégorie définie par l'utilisateur. Les cartouches de cette catégorie sont montées dans l'ordre spécifié au paramètre CTGORDER.

Elément 2 : Système de la catégorie

La deuxième partie du paramètre indique le nom du système auquel la catégorie appartient. Le nom du système provient de la zone relative au nom du système en instance indiqué par la commande DSPNETA (Afficher les attributs du réseau). S'il n'existe aucun système en instance, l'attribut du nom du système en cours est utilisé.

* * * Attention * * *
Si un nom de système est modifié, les cartouches de bande placées dans
les bandothèques comportant l'attribut du nom de système avant
modification ne sont plus admises.

*CURRENT: La catégorie appartient au système sur lequel s'exécute actuellement la commande.
valeur-alphanumérique: Indiquez le nom du système auquel appartient la catégorie.

Ordre des cartouches (CTGORDER)

Indique l'ordre dans lequel les cartouches sont montées.

*SEQ: Les cartouches sont montées dans l'ordre de leur ajout ou de leur modification dans la catégorie spécifiée. L'opération se termine si la cartouche suivante dans l'ordre séquentiel n'est pas disponible.
*NEXTAVAIL: Les cartouches sont montées dans l'ordre séquentiel, mais si une cartouche n'est pas disponible, la cartouche disponible suivante est utilisée.

Catégorie cible (TGTCGY)

Indique la catégorie dans laquelle est classée une cartouche après son utilisation. Ce paramètre peut être utile lorsqu'une catégorie de travail doit être utilisée lors d'une opération de sauvegarde. Chaque cartouche est automatiquement classée dans la catégorie cible spécifiée une fois qu'elle a été utilisée.

Valeurs uniques

*SHARE400: Les cartouches sont placées dans la catégorie *SHARE400.

Elément 1 : Nom de la catégorie

*CGY: Les cartouches restent dans la catégorie spécifiée au paramètre CGY.
*NOSHARE: Les cartouches sont placées dans la catégorie *NOSHARE.
*IPL: Les cartouches sont placées dans la catégorie *IPL.
*NL: Les cartouches sont placées dans la catégorie *NL.
valeur-alphanumérique: Indiquez le nom d'une catégorie définie par l'utilisateur. Les identificateurs de cartouche sont modifiés dans la catégorie spécifique définie par l'utilisateur.

Elément 2 : Système de la catégorie

La deuxième partie de ce paramètre identifie le système auquel appartient la catégorie. Il s'agit du nom du système en instance indiqué par la commande DSPNETA (Afficher les attributs du réseau). S'il n'existe aucun système en instance, l'attribut du nom du système en cours est utilisé.

* * * Attention * * *
Si un nom de système est modifié, les cartouches de bande placées dans
les bandothèques comportant l'attribut du nom de système avant
modification ne sont plus admises.

*CURRENT: Le système qui exécute la commande en cours est utilisé.
valeur-alphanumérique: Indiquez le nom du système auquel appartient la catégorie.

Option de catégorie cible (TGTCGYOPT)

Indique à quel moment la catégorie est remplacée par la catégorie cible.

*MOUNT: La catégorie cible est modifiée lorsque la cartouche est montée.
*UNLOAD: La catégorie cible est modifiée lorsque la cartouche est déchargée.
*EOV: La catégorie cible est modifiée lorsque la cartouche atteint la fin de volume.

ID de montage (MNTID)

Indique l'identificateur à l'aide qui servira à la reconnaissance de la session de catégorie montée. Ce paramètre est correct seul que si OPTION(*MOUNTED) ou OPTION(*ASSIGN) est indiqué.

*NONE: Cette session de catégorie montée n'est affectée à aucun travail et sera utilisée par le premier travail libérant une commande vers la médiathèque à l'aide d'un identificateur de volume de *MOUNTED. vous ne pouvez pas indiquer l'identificateur de montage *NONE à l'aide d'OPTION(*ASSIGN).
nom: Indiquez un nom unique permettant d'identifier la session de catégorie montée. Cette session reconnue par l'identificateur de montage est créée, puis affectée lors du montage. L'identificateur est ensuite utilisé lors de l'affectation de la session à un autre travail. La session reconnue par l'identificateur est alors supprimée lors du démontage de la catégorie. L'identificateur de montage peut être réutilisé lors du montage d'une autre catégorie dans la médiathèque.

Exemples

Exemple 1: utilisation d'une catégorie montée sans identificateur de montage

SETTAPCGY   MLB(LIB01)  OPTION(*MOUNTED)  CGY(*NOSHARE *CURRENT)
            CTGORDER(*SEQ)  TGTCGY(*IPL)

Cette commande définit la catégorie de la bande à *NOSHARE pour une ressource de l'unité de bandothèque LIB01 sur le système qui utilise actuellement cette commande. Chaque cartouche utilisée prend la catégorie *IPL. L'ordre d'utilisation des cartouches est l'ordre exact dans lequel elles ont été ajoutées ou modifiées dans la catégorie. Chaque cartouche étant utilisée et déchargée à partir de la ressource, le système choisit et charge automatiquement la cartouche suivante de la catégorie *NOSHARE.

Exemple 2: utilisation de la catégorie montée avec un identificateur de montage

SETTAPCGY DEV(LIB01) OPTION(*MOUNTED) CGY(*NOSHARE *CURRENT)
          CTGORDER(*SEQ) TGTCGY(DAILY1) MNTID(DAILY)

Cette commande définit la catégorie de la bande à *NOSHARE pour une ressource de l'unité de bandothèque LIB01 sur le système qui utilise actuellement cette commande. La session de la catégorie montée est identifiée par l'identificateur de montage DAILY. Chaque cartouche utilisée prend la catégorie DAILY1. L'ordre d'utilisation des cartouches est l'ordre exact dans lequel elles ont été ajoutées ou modifiées dans la catégorie. Chaque cartouche étant utilisée et déchargée à partir de la ressource, le système choisit et charge automatiquement la cartouche suivante de la catégorie *NOSHARE.

Exemple 3: libération d'une session de catégorie

SETTAPCGY   MLB(LIB01)  OPTION(*RELEASE)

Cette commande libère la session de catégorie affectée au travail qui émet la commande. La catégorie reste définie vers une ressource de l'unité de bandothèque LIB01 et elle peut être affectée à un autre travail.

Exemple 4: affectation d'une session de catégorie

SETTAPCGY   MLB(LIB01)  OPTION(*ASSIGN)  MNTID(DAILY)

Cette commande affecte la session de catégorie montée identifiée par l'identificateur de montage DAILY au travail qui émet la commande.

Exemple 5: démontage d'une catégorie montée

SETTAPCGY   MLB(LIB01)  OPTION(*DEMOUNTED)

Cette commande démonte la catégorie montée d'une ressource de l'unité de bandothèque LIB01. L'identificateur de montage DAILY peut à présent être utilisé pour nommer une autre session de catégorie montée.

Exemple 6: utilisation de la catégorie montée avec un identificateur de montage et report du changement de la catégorie cible

SETTAPCGY DEV(LIB01) OPTION(*MOUNTED) CGY(*NOSHARE *CURRENT)
          CTGORDER(*SEQ) TGTCGY(DAILY1) TGTCGYOPT(*EOV)
          MNTID(DAILY)

Cette commande définit la catégorie de la bande à *NOSHARE pour une ressource de l'unité de bandothèque LIB01 sur le système qui utilise actuellement cette commande. La session de la catégorie montée est identifiée par l'identificateur de montage DAILY. Chaque cartouche utilisée prend la catégorie DAILY1 une fois la fin de volume atteinte. L'ordre d'utilisation des cartouches est l'ordre exact dans lequel elles ont été ajoutées ou modifiées dans la catégorie. Chaque cartouche étant utilisée et déchargée à partir de la ressource, le système choisit et charge automatiquement la cartouche suivante de la catégorie *NOSHARE.

Messages d'erreur

*ESCAPE Messages

CPF6711: Commande non admise
CPF6712: Catégorie &4 non montée.
CPF6713: Catégorie non déchargée.
CPF6745: &1 n'est pas une médiathèque.
CPF67A6: Catégorie inexistante
CPF67AD: Catégorie non attribuée.
CPF67AE: Catégorie non libérée.
CPF67E4: Echec de la fonction d'unité de bandothèque
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &1.