CPYSPLF

La commande CPYSPLF permet de copier dans un fichier base de données physique défini par l'utilisateur ou dans un fichier STREAM les enregistrements de données du fichier spoule indiqué. Cela vous permet d'utiliser les fichiers spoule pour des applications faisant appel aux microfiches, à la transmission de données ou au traitement de l'information.

Lors de la copie d'un fichier spoule dans un fichier STREAM, le fichier spoule peut éventuellement être converti à l'aide d'un objet de personnalisation de poste de travail. Cela permet de convertir le fichier spoule dans d'autres formats tels que le format PDF. Pour que la conversion d'un fichier spoule soit possible à l'aide du paramètre Objet de personnalisation (WSCST), le paramètre DEVTYPE associé au fichier spoule doit être défini avec la valeur *SCS ou *AFPDS.

Lorsque vous copiez un fichier spoule dans un fichier physique ou dans un fichier STREAM (sans conversion), certaines informations sont perdues ou modifiées. Il peut arriver, par exemple, que :

• Les lignes d'impression entièrement blanches ne sont pas copiées.
• Des données graphiques soient perdues.
• Des données de code à barres soient perdues.

Lorsque vous copiez un fichier spoule dans un fichier STREAM (sans conversion), les informations conservées et le format de la sortie varient en fonction de l'objet de personnalisation de poste de travail spécifié.

Paramètres

Fichier spoule (FILE)

Indique le fichier spoule à copier dans un fichier base de données ou dans un fichier STREAM.

Ce paramètre est obligatoire.

nom

Indiquez le nom de fichier du fichier spoule.

Fichier BD de destination (TOFILE)

Indique si les enregistrements du fichier spoule seront copiés dans un fichier base de données physique défini par l'utilisateur ou dans un fichier STREAM. Si l'utilisateur spécifie le nom d'un fichier base de données qui n'existe pas au moment de la copie, cette dernière échoue.

Ce paramètre est obligatoire.

Valeurs uniques

*TOSTMF

Le fichier spoule sera converti en fonction de l'objet de personnalisation de poste de travail spécifié au paramètre Objet de personnalisation (WSCST) et la sortie sera envoyée dans le fichier STREAM spécifié au paramètre Fichier STREAM de destination (TOSTMF).

Qualificatif 1 : Fichier BD de destination

nom

Indiquez le nom du fichier physique qui recevra la copie.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours pour le travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Indiquez la bibliothèque dans laquelle se trouve le fichier.

Travail (JOB)

Indique le travail ayant créé le fichier spoule dont les enregistrements doivent être copiés.

Valeurs uniques

*

Cette commande a été émise par le travail qui a créé le fichier spoule.

Qualificatif 1 : Travail

nom

Indiquez le nom du travail ayant créé le fichier spoule.

Qualificatif 2 : Utilisat

nom

Indiquez le nom d'utilisateur qui identifie le profil utilisateur sous lequel le travail est exécuté.

Qualificatif 3 : Numéro

000000-999999

Indiquez le numéro de travail attribué par le système.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du fichier spoule dont les enregistrements doivent être copiés.

*ONLY

Un seul fichier spoule du travail porte le nom indiqué ; il n'est donc pas nécessaire de préciser son numéro.

*LAST

Le fichier spoule avec le nom indiqué et dont le numéro est le plus élevé est utilisé.

*ANY

Le numéro du fichier spoule n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre du nom du système de travail ou à celui de la date et heure de création du fichier spoule par rapport au le numéro de ce dernier lors de la sélection d'un fichier spoule.

1-999999

Indiquez le numéro du fichier spoule dont les enregistrements doivent être copiés.

Nom de système de travail (JOBSYSNAME)

Indique le nom du système où s'exécute le travail ayant créé le fichier spoule (paramètre JOB). Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule sont satisfaites.

*ONLY

Il y a un fichier spoule correspondant aux noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, date et heure de création de fichier spoule précisés.

*CURRENT

Le fichier spoule, créé sur le système en cours, avec ce nom de travail, d'utilisateur, ce numéro de travail, ce nom et numéro de fichier spoule, ces date et heure de création de fichier spoule, est utilisé.

*ANY

Le nom du système de travail n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre de date et heure de création du fichier spoule par rapport au nom du système de travail lors de la sélection d'un fichier spoule.

nom

Indiquez le nom du système où s'exécute le travail ayant créé le fichier spoule.

Fichier spoule créé (CRTDATE)

Indique la date et l'heure de création du fichier spoule. Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule et nom du système de travail sont satisfaites.

Valeurs uniques

*ONLY

Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés.

*LAST

Le fichier spoule, correspondant à la dernière date et heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés, est utilisé.

Elément 1 : Date de création

date

Indiquez la date de création du fichier spoule.

Elément 2 : Heure de création

*ONLY

Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du fichier de travail et date de création de fichier spoule précisés.

*LAST

Le fichier spoule, correspondant à la dernière heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du système de travail et date de création de fichier spoule précisés, est utilisé.

heure

Indiquez l'heure de création du fichier spoule.

Membre de destination (TOMBR)

Indique le nom du membre de fichier qui reçoit les enregistrements copiés.

*FIRST

Le premier membre du fichier indiqué est utilisé.

nom

Indiquez le nom du membre du fichier physique. Si celui-ci n'existe pas, un membre est créé et le traitement continue.

Remplacement ou ajout enregs (MBROPT)

Indique si les nouveaux enregistrements remplacent ou sont ajoutés aux enregistrements existants.

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Caractère de contrôle (CTLCHAR)

Indique, le cas échéant, les caractères de contrôle d'impression devant remplacer les caractères de contrôle d'impression internes du fichier spoule. Ce paramètre est ignoré si le paramètre Objet de personnalisation (WSCST) est spécifié avec une valeur autre que *NONE.

*NONE

Aucun caractère de contrôle d'impression n'est créé.

*FCFC

Indique que le premier caractère de chaque enregistrement contient l'un des codes de contrôle de saut ANSI. Cette option peut être utilisée pour la production de microfiches. Pour plus d'informations sur les codes de contrôle de saut ANSI, voir l'ensemble de rubriques Basic printing dans le manuel Catégorie Impression de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*PRTCTL

Indique que les quatre premiers caractères de chaque enregistrement contiennent des valeurs de saut-avant et des valeurs d'espaces-avant utilisables dans des programmes en langage évolué. Ce code peut être représenté par les lettres SSSL, SSS désignant la valeur de saut avant la ligne et L la valeur d'espaces-avant.

*S36FMT

Indique que le format des enregistrements qui doivent être copiés dans un fichier base de données est identique au format créé sur l'IBM 36 pour COPYPRT. Cette valeur n'est pas admise pour les fichiers spoule résidant sur des ASP principaux ou auxiliaires.

Valeurs canal (CHLVAL)

Indique une liste de numéros de canal avec les numéros de lignes qui leur sont attribués. Entrez ce paramètre uniquement si *FCFC est indiqué au paramètre CTLCHAR (Caractère de contrôle). La méthode des numéros de canal permet de déterminer les sauts de ligne pour les impressions. A chaque canal attribué doit correspondre un numéro de ligne afin que le positionnement du papier soit correct lors de l'impression.

Valeurs uniques

*NORMAL

Indique que le canal 1 est le seul numéro de canal attribué. Le numéro de ligne qui lui est attribué est 1.

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

Elément 1 : Canal

numéro-canal

Indiquez les canaux utilisés pour contrôler les sauts à l'impression. Les valeurs correctes pour ce paramètre sont comprises entre 1 et 12. Chaque numéro de canal ne peut être indiqué qu'une seule fois par la commande CPYSPLF (Copier un fichier spoule).

Elément 2 : Ligne

1-255

Numéro de ligne attribué au numéro de canal dans la même liste. Pour les numéros de ligne, vous pouvez utiliser tous les nombres compris entre 1 et 255. Chaque numéro de ligne ne peut être indiqué qu'une seule fois par la commande CPYSPLF (Copier un fichier spoule).

Fichier STREAM de destination (TOSTMF)

Indique le fichier STREAM dans lequel les données en sortie doivent être écrites. Tous les répertoires indiqués dans le chemin doivent exister. Aucun nouveau répertoire n'est créé. Ce paramètre doit spécifier une valeur autre que *NONE si le paramètre Fichier BD de destination (TOFILE) a pour valeur *TOSTMF.

*NONE

La sortie est envoyée vers un fichier physique défini par l'utilisateur. Cette valeur n'est valide que si le paramètre Fichier BD de destination (TOFILE) indique un fichier base de données physique défini par l'utilisateur.

nom-chemin

Indiquez le chemin d'accès au fichier STREAM où les données en sortie doivent être écrites. Cette valeur n'est valide que si le paramètre Fichier BD de destination (TOFILE) a pour valeur *TOSTMF.

Remarque :Si le fichier STREAM existe, le CCSID associé à ce fichier ne change pas.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Objet de personnalisation (WSCST)

Indique l'objet de personnalisation de poste de travail à utiliser pour transformer la sortie du fichier spoule au format final avant son écriture dans un fichier STREAM. Si le paramètre Fichier BD de destination (TOFILE) indique un base de données physique, le paramètre WSCST est ignoré.

Valeurs uniques

*NONE

Indique qu'aucun objet de personnalisation de poste de travail ne sera utilisé.

Si le paramètre Fichier BD de destination (TOFILE) a pour valeur *TOSTMF et que le type d'unité du fichier spoule est *AFPDS ou *USERASCII, les données de fichier spoule seront copiées directement dans le fichier STREAM. Si le fichier STREAM n'existe pas, le CCSID associé à ce fichier prend la valeur 65535.

Pour les autres types de fichier spoule, les données de fichier spoule seront copiées dans le fichier STREAM à l'aide du paramètre Caractère de contrôle (CTLCHAR) pour formater les données. Les lignes seront terminées par des commandes de retour chariot et de saut de ligne pour indiquer les limites d'enregistrement. Si le fichier STREAM n'existe pas, un CCSID obtenu auprès des attributs de fichier spoule sera associé au fichier STREAM. Si l'attribut CHRID du fichier spoule est autre que *DEVD, cet attribut sera utilisé pour sélectionner le CCSID à associer au fichier STREAM. Si l'attribut CHRID du fichier spoule est *DEVD, le CCSID du travail qui a créé le fichier spoule sera utilisé.

*PDF

La sortie est transformée au format PDF avant son écriture dans un fichier STREAM. Si le fichier STREAM n'existe pas, le CCSID associé à ce fichier prend la valeur 65535.

Qualificatif 1 : Objet de personnalisation

nom

Indiquez le nom de la personnalisation. Lorsqu'un objet de personnalisation nommé est utilisé et que le fichier STREAM n'existe pas, le CCSID associé à ce fichier prend la valeur 65535.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

L'objet de personnalisation est recherché dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant l'objet de personnalisation.

Option pour fichier STREAM (STMFOPT)

Indique si la copie échoue ou si elle effectue le remplacement des enregistrements dans un fichier STREAM si un fichier de ce nom existe. Si le fichier STREAM n'existe pas, il est créé.

*NONE

Aucun enregistrement n'est copié et l'opération échoue.

*REPLACE

Les enregistrements copiés remplacent ceux du fichier STREAM.

Copier fichier spoule ouvert (OPNSPLF)

Indique si la copie est effectuée ou non lorsque le fichier spoule indiqué au paramètre FILE est encore ouvert.

*NO

Aucun enregistrement n'est copié si le fichier spoule est ouvert et la copie n'aboutit pas.

*YES

Un message de diagnostic est émis si le fichier spoule est ouvert et les enregistrements sont copiés.

Exemples

Exemple 1 : Remplacement de données

CPYSPLF   FILE(QPRINT)  JOB(PAYROLL01)  SPLNBR(4)
          TOFILE(MYFILE)  TOMBR(MYMBR)  CTLCHAR(*PRTCTL)

Dans cet exemple, le fichier QPRINT (quatrième fichier généré par le travail PAYROLL01) est copié dans le membre MYMBR du fichier physique MYFILE (résidant dans une bibliothèque recherchée dans la liste des bibliothèques). Les données copiées remplacent toutes les anciennes données du membre car les anciens enregistrements ont été mis à blanc. Le code de contrôle d'impression de 4 octets est créé.

Exemple 2 : Ajout de données

CPYSPLF   FILE(QPRINT)  TOFILE(MYLIB/MYFILE)  JOB(PAYROLL02)
          MBROPT(*ADD)  CTLCHAR(*FCFC)  CHLVAL((1 3) (4 15))

Dans cet exemple, le fichier QPRINT (dernier fichier portant ce nom dans le travail PAYROLL02) est copié dans le premier membre du fichier physique trouvé dans la bibliothèque MYLIB. Les données copiées sont ajoutées aux données existantes du membre. Le caractère de contrôle d'impression de 1 octet FCFC est utilisé et s'appuie sur les valeurs de canaux attribuées lors du formatage des données en sortie. Les valeurs de canaux attribuées spécifiées dans la commande sont les suivantes :

• Ligne 3 attribuée au canal 1
• Ligne 15 attribuée au canal 4

Exemple 3: Conversion au format PDF

CPYSPLF   FILE(EMAIL)  JOB(123456/BARON/EMAIL01)  SPLNBR(1)
          TOFILE(*TOSTMF)  TOSTMF('/emailpdfs/email01.pdf')
          WSCST(*PDF) STMFOPT(*REPLACE)

Dans cet exemple, le fichier spoule EMAIL (qui est le premier fichier spoule produit par le travail 123456/BARON/EMAIL01) est converti au format PDF et stocké dans le répertoire '/emailpdfs' avec le nom mail01.pdf où il peut être utilisé par une autre application. Si le fichier STREAM existe déjà, les données qu'il contient seront remplacées.

Exemple 4: Copie d'un fichier spoule AFPDS dans un fichier STREAM

CPYSPLF   FILE(MYDOC)  JOB(*)  SPLNBR(*LAST)  TOFILE(*TOSTMF)
          TOSTMF(mydoc.afp)  WSCST(*NONE)  STMFOPT(*NONE)

Dans cet exemple, le dernier fichier spoule nommé MYDOC produit par le travail en cours est copié, sans être converti, dans un fichier STREAM nommé 'mydoc.afp' qui se trouve dans le répertoire de travail en cours. Le type d'unité (paramètre DEVTYPE) du fichier spoule est *AFPDS. Si le fichier STREAM existe déjà, la commande CPYSPLF échoue.

Exemple 5: Conversion d'un fichier spoule SCS en fichier STREAM texte ASCII

CPYSPLF   FILE(MYDOC)  JOB(*)  SPLNBR(*LAST)  TOFILE(*TOSTMF)
          TOSTMF(/textfiles/mydoc.txt)  WSCST(QSYS/QWPDEFAULT)

Dans cet exemple, le dernier fichier spoule nommé MYDOC produit par le travail en cours est converti en texte ASCII et placé dans le répertoire '/textfiles' avec le nom 'mydoc.txt'. Le type d'unité (paramètre DEVTYPE) du fichier spoule est *SCS. Si le fichier STREAM existe déjà, la commande CPYSPLF échoue.

Messages d'erreur

Messages *ESCAPE

CPF2207

Non autorisé à utiliser objet &1 de &3 type *&2.

CPF3CF2

Une ou plusieurs erreurs se sont produites pendant l'exécution de l'API &1. Error(s) occurred during running of &1 API.

CPF3207

Membre non ajouté. Des erreurs se sont produites.

CPF3303

Fichier &1 non trouvé dans travail &5/&4/&3.

CPF3309

Aucun fichier portant le nom &1 n'est actif.

CPF3311

La demande de copie a échoué pour le fichier &6 dans &7. Copy request failed for file &6 in &7.

CPF3330

Ressource nécessaire non disponible.

CPF3340

Plusieurs fichiers du nom indiqué dans travail &5/&4/&3.

CPF3342

Travail &5/&4/&3 non trouvé.

CPF3343

Plusieurs travaux portant le même nom.

CPF3344

Le fichier &1 numéro &8 n'est plus dans le système.

CPF338A

Caractère de contrôle *S36FMT non admis.

CPF3394

Impossible de convertir les données du fichier spoule.

CPF3429

Le fichier &1 numéro &7 ne peut pas être affiché, copié ou envoyé.

CPF3482

La demande de copie a échoué : fichier spoule &1 ouvert.

CPF3483

La demande de copie a échoué pour fichier &6 de &7.

CPF3486

Valeur du paramètre CHLVAL incorrecte.

CPF3492

Non autorisé à utiliser le fichier spoule.

CPF3493

Paramètre CTLCHAR incorrect pour le fichier &1.

CPF3499

Enreg du fichier &1 précédant toutes les valeurs de canaux assignées.

CPF5812

Membre &3 existe déjà dans le fichier &1 de &2.

CPF6DF2

Le flux de données AFP de l'espace utilisateur &1 n'est pas valide. AFP data stream in user space &1 not valid.

CPF6DF4

Données non reconnues dans objet &2 de &3.

CPF6DF8

Les données ne peuvent pas être transformées. Data cannot be transformed.

CPF6DFB

Une erreur s'est produite pendant la conversion des données.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9804

Objet &2 dans bibliothèque &3 endommagé.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9837

Tentative de substitution du fichier &1 avec MBR(*ALL).

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

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

CPF9872

Programme ou programme de service &1 de la bibliothèque &2 arrêté. Code raison : &3.

CPFA09C

Aucun droit sur l'objet. L'objet est &1.

CPFA0A0

L'objet existe déjà. L'objet est &1.

CPFA0A1

Erreur d'entrée ou de sortie.

CPFA0A9

Objet introuvable. L'objet est &1.

CPFCE01

Option de produit requise indisponible.

CPFCE02

Impossible d'accéder au travail Transform Services requis.

CPFCE03

Erreur de flux de données détectée.

CPFCE05

Tâche de transformation annulée en raison d'une erreur de fidélité d'impression.

CPFCE06

Erreur lors de la transformation des données d'impression.

CPFCE07

Travail Transform Services arrêté suite à une erreur critique.

CPFCE09

Le flot de données SCS n'est pas correct.