CHGACGCDE
Modifier le code comptabilité
En bref
La commande CHGACGCDE (Modifier le code comptabilité) permet de modifier le code comptabilité d'un travail.
CHGACGCDE se lit CHG
(Modifier) + ACGCDE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGACGCDE
Paramètres
Astuce : dans une session 5250, tapez CHGACGCDE 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 : Sous conditions
La commande CHGACGCDE (Modifier le code comptabilité) permet de modifier le code comptabilité d'un travail. Ce dernier peut figurer dans une file d'attente de travaux ou il peut être actif dans un sous-système. Cette commande n'est pas effective si le travail figure dans une file d'attente en sortie. Si la commande est entrée lorsque la valeur système QACGLVL indiquait qu'une comptabilité des travaux (*JOB) doit être effectuée lors de l'entrée du travail sur le système, les informations de comptabilité sont journalisées et une nouvelle période comptable est démarrée pour le travail. Si la commande est entrée lorsque la valeur système QACGLVL n'indiquait pas la nécessité d'une comptabilité des travaux, le code comptabilité est modifié et aucun poste de journal n'est créé. Pour plus de détails, reportez-vous au manuel Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
Restrictions :
- La commande doit être émise depuis le travail en cours de modification, ou l'émetteur de la commande doit utiliser un profil utilisateur identique à celui de l'utilisateur du travail modifié ou un profil utilisateur disposant du droit spécial d'exploitation des travaux (*JOBCTL).
L'identité de l'utilisateur du travail correspond au nom du profil utilisateur permettant d'identifier un travail par rapport aux autres travaux. Pour plus d'informations sur l'identité de l'utilisateur du travail, reportez-vous au manuel Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
- Cette commande est à unités d'exécution protégées sous certaines conditions. L'accès est refusé si le travail modifié comporte des unités d'exécution secondaires actives. Cette commande peut être émise par l'unité d'exécution initiale ou une unité d'exécution d'un travail multitâche si le travail cible est à unité d'exécution unique.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| JOB | Travail | Valeurs uniques: * Autres valeurs: Nom de travail qualifié |
Facultatif, positionnel 1 |
| Qualificatif 1: Travail | Nom | ||
| Qualificatif 2: Utilisat | Nom | ||
| Qualificatif 3: Numéro | 000000-999999 | ||
| ACGCDE | Code comptabilité | Valeur caractère, *SAME, *BLANK, *USRPRF | Facultatif, positionnel 2 |
| DUPJOBOPT | Option pour travaux dupliqués | *SELECT, *MSG | Facultatif |
Travail (JOB)
Indiquez le nom du travail dont le code comptabilité est modifié.
Valeurs uniques
- *
- C'est le code comptabilité du travail contenant la commande qui est modifié.
Qualificatif 1 : Travail
- nom
- Indiquez le nom du travail dont le code comptabilité est modifié.
Qualificatif 2 : Utilisat
- nom
- Indiquez le nom de l'utilisateur qui identifie le profil utilisateur sous lequel le travail est démarré.
Qualificatif 3 : Numéro
- 000000-999999
- Indiquez le numéro de travail attribué par le système.
Remarque :Si aucun nom d'utilisateur ou numéro de travail n'est indiqué, le système recherche les noms de tous les travaux en cours. S'il trouve plus d'une occurrence du nom spécifié, un nom de travail qualifié doit être indiqué explicitement ou via l'écran de sélection. Pour en savoir plus, reportez-vous au paramètre DUPJOBOPT (Option pour travaux dupliqués).
Code comptabilité (ACGCDE)
Indique le code comptabilité du travail.
- *SAME
- Le code comptabilité reste inchangé. Les informations concernant la comptabilité sont enregistrées dans un journal et une nouvelle période comptable commence.
- *BLANK
- Le code comptabilité est remplacé par des blancs.
- *USRPRF
- Lorsque le travail modifié est le travail dans lequel la commande s'exécute, le code comptabilité pour la période comptable suivante est déterminé à partir du profil utilisateur sous lequel l'unité d'exécution s'exécutait initialement. Lorsque le travail modifié est un travail différent, le code comptabilité pour la période comptable suivante est déterminé à partir du profil utilisateur associé à ce travail.
- valeur-caractère
- Indiquez le code comptabilité (15 caractères alphanumériques ou blancs) pour la nouvelle période comptable. S'il comprend des blancs, le code doit être placé entre apostrophes.
Option pour travaux dupliqués (DUPJOBOPT)
Indique l'action effectuée lorsque des travaux en double sont détectés par cette commande.
- *SELECT
- L'écran de sélection s'affiche lorsque des travaux en double sont détectés lors d'une session interactive. Sinon, un message est émis.
- *MSG
- Un message est émis lorsque des travaux dupliqués sont détectés.
Exemples
CHGACGCDE JOB(123581/USER47/WS1) ACGCDE(123456789)
Cette commande permet de remplacer le code de comptabilité du travail WS1, profil utilisateur USER47 et numéro de travail 123581, par le code de comptabilité 123456789 pour le prochain segment de comptabilité. Un poste relatif à l'utilisation des ressources du travail est consigné dans le journal de comptabilité système QSYS/QACGJRN.
Messages d'erreur
Messages *ESCAPE
- CPF1314
- Valeur &1 non admise pour le paramètre &2.
- CPF1317
- Aucune réponse du sous-système pour le travail &3/&2/&1.
- CPF1321
- Travail &3/&2/&1 non trouvé.
- CPF1332
- Fin des noms dupliqués.
- CPF1334
- La modification demandée doit porter sur un travail interactif.
- CPF1336
- Erreurs dans la commande CHGJOB pour le travail &3/&2/&1.
- CPF1337
- &3/&2/&1 non autorisé à modifier paramètres.
- CPF1340
- Fonction de contrôle de travail non effectuée.
- CPF1341
- Lecteur/éditeur &3/&2/&1 non admis comme nom de travail.
- CPF1343
- Type du travail &3/&2/&1 incorrect pour la fonction.
- CPF1344
- Vous n'êtes pas autorisé à contrôler le travail &3/&2/&1.
- CPF1351
- Erreur dans le sous-système pour le travail &3/&2/&1.
- CPF1352
- Fonction non exécutée. &3/&2/&1 en transition.
- CPF180B
- Fonction &1 non admise.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.