STRTCPFTP

La commande Démarrer le protocole de transfert de fichiers TCP/IP (STRTCPFTP) est utilisée pour démarrer l'application cliente FTP (File Transfer Protocol) qui transfère des fichiers entre des systèmes à l'aide du protocole TCP/IP (Transmission Control Protocol/Internet Protocol). FTP est un protocole d'application utilisé pour transférer des fichiers vers et depuis un système éloigné. FTP nécessite un ID utilisateur et, dans certains cas, un mot de passe pour accéder aux fichiers d'un système éloigné. The Start TCP/IP File Transfer Protocol (STRTCPFTP) command is used to start the File Transfer Protocol (FTP) client application that transfers files between systems using the Transmission Control Protocol/Internet Protocol (TCP/IP). FTP is an application protocol used for transferring files to and from a remote system. FTP requires a user ID, and in some cases a password, to gain access to files on a remote system.

Paramètres de mappage : Le mappage des données est utilisé pour toutes les données (par exemple, les données utilisateur et les informations de données de protocole) entre les systèmes local et éloigné, sauf lorsque la sous-commande EBCDIC ou la sous-commande BINARY est en vigueur. Dans ces cas, le mappage des données du fichier utilisateur n'est pas effectué. Mapping Parameters: Mapping of data is used for all data (for example, user data and protocol data information) between the local and remote systems, except when the EBCDIC subcommand or the BINARY subcommand is in effect. In these cases, mapping of user file data is not done.

La commande Modifier les attributs FTP (CHGFTPA) peut être utilisée pour indiquer les tables de mappage serveur pour FTP. The Change FTP Attributes (CHGFTPA) command can be used to specify server mapping tables for FTP.

Paramètres

Système éloigné (RMTSYS)Remote system (RMTSYS)

Indique le nom du système éloigné vers lequel ou depuis lequel les fichiers sont transférés. Pour que le transfert réussisse, le nom du système éloigné doit être valide et le système doit pouvoir communiquer avec le système local. L'utilisateur peut affecter des noms à une adresse Internet avec l'option Gestion des entrées de la table des hôtes TCP/IP du menu Configuration de TCP/IP (commande CFGTCP). Un serveur de noms éloigné peut également servir à faire correspondre les noms de systèmes éloignés à des adresses Internet. Vous pouvez utiliser l'option Modification du serveur de noms éloigné du menu CFGTCP pour indiquer un serveur de noms éloigné. Specifies the remote system name to which or from which the files are transferred. To be successful, the remote system name must be valid, and the system must be able to communicate with the local system. The user can assign names to an internet address with the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP command). Also, a remote name server can be used to map remote system names to internet addresses. You can use the Change remote name server option on the CFGTCP menu to specify a remote name server.

*INTNETADR

Le paramètre INTNETADR fait l'objet d'une invite. The INTNETADR parameter is prompted.

valeur-caractère

Indiquez le nom du système éloigné vers lequel ou depuis lequel le transfert de fichier a lieu. Specify the remote system name to which or from which the file transfer takes place.

Adresse Internet (INTNETADR)Internet address (INTNETADR)

Indique l'adresse Internet IPv4 ou IPv6 du système éloigné auquel l'application de transfert de fichiers est démarrée. Specifies the IPv4 or IPv6 internet address of the remote system to which the file transfer application is started.

Une adresse Internet IPv4 est indiquée sous la forme nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. Une adresse Internet IPv4 n'est pas valide si la partie identificateur de réseau ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 Internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.

Une adresse Internet IPv6 est indiquée sous la forme xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, où chaque x est un chiffre hexadécimal représentant 4 bits. Un chiffre hexadécimal est un nombre de 0 à 9 ou la lettre A, B, C, D, E ou F. Le "::" peut être utilisé une fois dans l'adresse IPv6 pour représenter un ou plusieurs groupes de 16 bits à zéro. Le "::" peut servir à compresser les zéros de début, intégrés ou de fin dans l'adresse. An IPv6 internet address is specified in the form xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, where each x is a hexadecimal digit representing 4 bits. A hexadecimal digit is a number from 0 to 9 or the letter A, B, C, D, E, or F. A "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

Si l'adresse Internet est entrée depuis une ligne de commande, elle doit être placée entre apostrophes. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

valeur-caractère

Indiquez l'adresse Internet du système éloigné. Specify the internet address of the remote system.

Identificateur de jeu de caractères codés (CCSID)Coded character set identifier (CCSID)

Indique l'identificateur de jeu de caractères codés (CCSID) ASCII utilisé pour les transferts de fichiers ASCII à jeu de caractères sur un octet (SBCS) lorsque le mode TYPE de FTP est ASCII. Les transferts de fichiers ASCII sont également supposés lorsqu'aucune sous-commande TYPE n'a été émise. La valeur CCSID choisie est celle utilisée par défaut par le client FTP pour le mappage ASCII vers EBCDIC et EBCDIC vers ASCII. Le mappage est déterminé à l'aide du CCSID ASCII indiqué et du CCSID EBCDIC du travail. Specifies the ASCII coded character set identifier (CCSID) that is used for single-byte character set (SBCS) ASCII file transfers when the FTP TYPE mode is set to ASCII. ASCII file transfers are also assumed when no TYPE subcommand has been issued. The CCSID value chosen is the default used by the FTP client for ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. Mapping is determined using the specified ASCII CCSID and the EBCDIC CCSID of the job.

Le mappage sortant et entrant peut être effectué facultativement à l'aide de tables de mappage définies dans les paramètres TBLFTPOUT et TBLFTPIN. Normalement, les paramètres TBLFTPOUT et TBLFTPIN ont pour valeur par défaut *CCSID ou *DFT. Les deux paramètres indiquent que la valeur du paramètre CCSID est utilisée pour le mappage. Si une table de mappage doit être utilisée pour le mappage sortant, un objet table peut être indiqué dans le paramètre TBLFTPOUT. L'objet table indiqué dans le paramètre TBLFTPOUT est utilisé à la place de la valeur CCSID. Outgoing and incoming mapping can be done optionally with mapping tables defined in the TBLFTPOUT and TBLFTPIN parameters. Normally the TBLFTPOUT and TBLFTPIN parameters are set to the default of *CCSID or *DFT. Both parameters indicate that the value used in the CCSID parameter is used for mapping. If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLFTPOUT parameter. The table object specified in the TBLFTPOUT parameter is used instead of the CCSID value.

Le mappage entrant peut être modifié pour utiliser une table de mappage en indiquant un objet table dans le paramètre TBLFTPIN. Cette table de mappage remplace la valeur CCSID indiquée et est utilisée pour le mappage entrant. Incoming mapping can be changed to use a mapping table by specifying a table object in the TBLFTPIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.

Les valeurs CCSID de jeu de caractères sur deux octets (DBCS) ne sont pas autorisées pour ce paramètre. Les valeurs DBCS peuvent être indiquées à l'aide de la sous-commande TYPE. Double-byte character set (DBCS) CCSID values are not permitted for this parameter. DBCS values can be specified using the TYPE subcommand.

Remarque :IBM inclut dans FTP une prise en charge de la conversion afin d'assurer la compatibilité avec les releases antérieures à la V3R1. L'utilisation de tables de conversion pour les transferts de fichiers TYPE A entrants entraîne la perte du marquage CCSID si le fichier cible doit être créé. IBM recommande vivement d'utiliser la prise en charge des CCSID pour les opérations normales. Remarque :IBM includes mapping support in FTP to ensure compatibility with releases prior to V3R1. Use of mapping tables for incoming TYPE A file transfers results in the loss of CCSID tagging if the target file must be created. IBM strongly recommends that you use CCSID support for normal operations.

*DFT

La valeur CCSID 00819 (ISO 8859-1 ASCII 8 bits) est utilisée. The CCSID value 00819 (ISO 8859-1 8-bit ASCII) is used.

1-65533

Specify the CCSID value to be used. This value is validated to ensure a valid SBCS CCSID was requested.

Les paramètres TBLFTPOUT et TBLFTPIN servent à indiquer des tables de mappage entrant et sortant définies par l'utilisateur. Les tables de mappage définies par l'utilisateur remplacent le mappage effectué par le client FTP lorsque le paramètre CCSID est indiqué. The TBLFTPOUT and TBLFTPIN parameters are used to specify user-defined incoming and outgoing mapping tables. The user-defined mapping tables replace the mapping done by the FTP client when the CCSID parameter is specified.

Port (PORT)

Indique le numéro de port à utiliser pour la connexion au serveur FTP. Specifies the port number to be used for connecting to the FTP server.

Normalement, la valeur de port "bien connue" 21 est utilisée pour se connecter au serveur FTP. Dans certaines circonstances, le serveur FTP peut être contacté sur un port autre que le port 21. Dans ce cas, le paramètre PORT peut être utilisé pour indiquer le port du serveur auquel se connecter. Normally the "well-known" port value of 21 is used to connect to the FTP server. Under some circumstances, the FTP server may be contacted at a port other than port 21. In those situations, the port parameter may be used to specify the server port to connect to.

Remarque :Les sous-commandes OPEN et SECOPEN du client FTP disposent chacune d'un paramètre facultatif 'port' qui peut servir à indiquer un port autre que le port 21. Remarque :The FTP client subcommands OPEN and SECOPEN each have an optional 'port' parameter which may be used to specify a port other than port 21.

*DFT

La valeur 00021 est utilisée. The value 00021 is used.

*SECURE

La valeur 00990 est utilisée. Le port 990 est réservé aux serveurs FTP sécurisés qui utilisent immédiatement les protocoles TLS (Transport Layer Security) ou SSL (Secure Sockets Layer) pour chiffrer les données. The value 00990 is used. Port 990 is reserved for secure FTP servers which immediately use Transport Layer Security (TLS) or Secure Sockets Layer (SSL) protocols to encrypt data.

1-65535

The requested port value is used. This value is validated to ensure it is in the proper range.

Remarque :Si 990 est indiqué, le client FTP exécutera les mêmes fonctions que si *SECURE était indiqué. Remarque :If 990 is specified, the FTP client will perform the same functions as if *SECURE were specified.

Connexion sécurisée (SECCNN)Secure connection (SECCNN)

Indique le type de mécanisme de sécurité à utiliser pour protéger les informations transférées sur la connexion de contrôle FTP (qui comprend le mot de passe utilisé pour authentifier la session auprès du serveur FTP). TLS (Transport Layer Security) et SSL (Secure Sockets Layer) sont des protocoles compatibles qui utilisent le chiffrement pour empêcher la visualisation des données pendant la transmission et pour vérifier qu'aucune perte ni altération de données ne se produit. Kerberos est également pris en charge pour assurer la protection. Specifies the type of security mechanism to be used for protecting information transferred on the FTP control connection (which includes the password used to authenticate the session with the FTP server). Transport Layer Security (TLS) and Secure Sockets Layer (SSL) are compatible protocols which use encryption to protect data from being viewed during transmission and verify that data loss or corruption does not occur. Kerberos is also supported to do the protection.

Remarque :La sous-commande SECOPEN du client FTP peut être utilisée pour ouvrir une connexion FTP protégée pendant une session client FTP. Remarque :The FTP client subcommand SECOPEN can be used to open a protected FTP connection during an FTP client session.

*DFT

Si le paramètre PORT indique *SECURE ou 990, *IMPLICIT est utilisé ; sinon, *NONE est utilisé. If the PORT parameter specifies *SECURE or 990, *IMPLICIT is used; otherwise, *NONE is used.

*IMPLICIT

Le client FTP tente immédiatement d'utiliser TLS/SSL lors de la connexion au serveur FTP indiqué (sans envoyer de sous-commande AUTH au serveur). Si le serveur ne prend pas en charge TLS/SSL implicite sur le port indiqué, ou si la négociation TLS/SSL échoue pour une raison quelconque, la connexion est fermée. The FTP client immediately attempts to use TLS/SSL when connecting to the specified FTP server (without sending an AUTH subcommand to the server). If the server does not support implicit TLS/SSL on the specified port, or the TLS/SSL negotiation fails for any reason, the connection is closed.

*SSL

Après la connexion au serveur FTP indiqué, le client FTP envoie une sous-commande AUTH (autorisation) demandant une session protégée par TLS/SSL. Si le serveur prend en charge TLS/SSL, une négociation TLS/SSL est effectuée. Si le serveur ne prend pas en charge TLS/SSL ou si la négociation TLS/SSL échoue, la connexion est fermée. After connecting to the specified FTP server, the FTP client sends an AUTH (authorization) subcommand requesting a TLS/SSL protected session. If the server supports TLS/SSL, a TLS/SSL negotiation performed. If the server does not support TLS/SSL or the TLS/SSL negotiation fails, the connection is closed.

*KERBEROS

After connecting to the specified FTP server, the FTP client sends an AUTH (authorization) subcommand requesting a Kerberos authentication. If the server supports Kerberos, a Kerberos authentication performed. If the server does not support Kerberos or the Kerberos authentication fails, FTP client will switch to normal logon session.

Remarque :Le fichier de cache des données d'identification par défaut de l'utilisateur en cours est utilisé pour localiser les tickets d'octroi de tickets Kerberos existants. La commande Ajouter un ticket Kerberos (ADDKRBTKT) ou l'outil kinit de Qshell peut être utilisé pour créer ou renouveler des tickets arrivés à expiration. Remarque :The default credentials cache file for the current user is used to locate existing Kerberos ticket-granting tickets. The Add Kerberos Ticket (ADDKRBTKT) command or the Qshell kinit tool can be used to create or refresh expired tickets.

*NONE

Le client FTP n'utilise pas le chiffrement lors de la connexion au serveur FTP indiqué. The FTP client does not use encryption when connecting to the specified FTP server.

Protection des données (DTAPROT)Data protection (DTAPROT)

Indique le type de protection des données à utiliser pour les informations transférées sur la connexion FTP. Si le mécanisme de sécurité TLS/SSL est activé, *DFT, *PRIVATE et *CLEAR sont des valeurs valides qui indiquent le niveau de protection de la connexion de données FTP. Le protocole FTP n'autorise pas la protection de la connexion de données si la connexion de contrôle n'est pas protégée. Si le mécanisme de sécurité Kerberos est activé, *DFT, *PRIVATE, *CLEAR et *SAFE sont toutes des valeurs valides qui indiquent le niveau de protection de la connexion de contrôle FTP et de la connexion de données FTP Specifies the type of data protection to be used for information transferred on the FTP connection. If security mechanism TLS/SSL is enabled, *DFT *PRIVATE and *CLEAR are valid values which indicate the protection level of FTP data connection. The FTP protocol does not allow protection of the data connection if the control connection is not protected. If security mechanism Kerberos is enabled, *DFT *PRIVATE *CLEAR and *SAFE are all valid value which indicates the protection level of both FTP control connection and FTP data connection

Remarque :Le paramètre DTAPROT contrôle l'utilisation de la sous-commande PROT (protection) du serveur FTP. La sous-commande SECDATA du client FTP peut être utilisée pour modifier la protection pendant une session client FTP. Remarque :The DTAPROT parameter controls the use of the PROT (protection) FTP server subcommand. The FTP client subcommand SECDATA can be used to change protection during an FTP client session.

*DFT

Si le paramètre SECCNN indique Kerberos comme mécanisme de sécurité, *CLEAR est utilisé ; sinon, *PRIVATE est utilisé. If the SECCNN parameter specifies Kerberos as security mechanism, *CLEAR is used; otherwise, *PRIVATE is used.

*PRIVATE

If the SECCNN parameter specifies TLS/SSL as security mechanism, it means information sent on the FTP data connection is encrypted. If the SECCNN parameter specifies Kerberos as security mechanism, it means information sent on both the FTP control connection and FTP data connection is integrity and confidentiality protected.

Remarque :Si le paramètre SECCNN indique le mécanisme de sécurité TLS/SSL et indique que la connexion de contrôle FTP n'est pas chiffrée, *PRIVATE ne peut pas être indiqué. Remarque :If the SECCNN parameter specifies security mechanism TLS/SSL and specifies that the FTP control connection is not encrypted, *PRIVATE cannot be specified.

*SAFE

Information sent on both the FTP control connection and the FTP data connection is integrity protected.

Remarque :*SAFE ne peut être indiqué que lorsque le paramètre SECCNN indique *KERBEROS Remarque :*SAFE can be only specified when the SECCNN parameter specifies *KERBEROS

*CLEAR

Information sent on the FTP data connection is not protected.

Remarque :Si le paramètre SECCNN indique Kerberos comme mécanisme de sécurité, *CLEAR est le niveau de protection par défaut. Remarque :If the SECCNN parameter specifies Kerberos as security mechanism, *CLEAR is the default protection level.

Table ASCII/EBCDIC sortante (TBLFTPOUT)Outgoing ASCII/EBCDIC table (TBLFTPOUT)

Indique l'objet table à utiliser pour le mappage de toutes les données sortantes dans le client FTP. Les données sortantes sont mappées d'EBCDIC vers ASCII. Specifies the table object that is to be used to map all outgoing data in the FTP client. Outgoing data is mapped from EBCDIC to ASCII.

Si un objet table est indiqué pour TBLFTPOUT, il est utilisé pour le mappage sortant. Sinon, le paramètre CCSID sert à déterminer le mappage sortant. If a table object is specified for TBLFTPOUT, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.

Valeurs uniques

*CCSID

Le paramètre CCSID sert à déterminer la conversion sortante. The CCSID parameter is used to determine outgoing mapping.

*DFT

Le paramètre CCSID sert à déterminer la conversion sortante. The CCSID parameter is used to determine outgoing mapping.

Qualificatif 1 : Table EBCDIC/ASCII sortante Qualificatif 1: Outgoing EBCDIC/ASCII table

nom

Indiquez le nom de l'objet table à utiliser par le client FTP pour le mappage des données sortantes. Specify the name of the table object to be used by the FTP client for mapping outgoing data.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

Toutes les bibliothèques des parties utilisateur et système de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the user and system portions of the job's library list are searched until the first match is found.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Table ASCII/EBCDIC entrante (TBLFTPIN)Incoming ASCII/EBCDIC table (TBLFTPIN)

Indique l'objet table à utiliser pour le mappage de toutes les données entrantes dans le client FTP. Les données entrantes sont mappées d'ASCII vers EBCDIC. Specifies the table object that is to be used to map all incoming data in the FTP client. Incoming data is mapped from ASCII to EBCDIC.

Si un objet table est indiqué pour TBLFTPIN, il est utilisé pour le mappage entrant. Sinon, le paramètre CCSID sert à déterminer le mappage entrant If a table object is specified for TBLFTPIN, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping

Valeurs uniques

*CCSID

Le paramètre CCSID sert à déterminer la conversion entrante. The CCSID parameter is used to determine incoming mapping.

*DFT

Le paramètre CCSID sert à déterminer la conversion entrante. The CCSID parameter is used to determine incoming mapping.

Qualificatif 1 : Table ASCII/EBCDIC entrante Qualificatif 1: Incoming ASCII/EBCDIC table

nom

Indiquez le nom de l'objet table à utiliser par le client FTP pour le mappage des données entrantes. Specify the name of the table object to be used by the FTP client for mapping incoming data.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

Toutes les bibliothèques des parties utilisateur et système de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the user and system portions of the job's library list are searched until the first match is found.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Identificateur d'application (APPID)Application identifier (APPID)

Indique le nom de l'identificateur d'application à utiliser avec la protection SSL (Secure Sockets Layer). L'identificateur d'application client doit être configuré dans la base de données d'applications de Digital Certificate Manager (DCM). Specifies the name of the application identifier to use when using Secure Sockets Layer (SSL) protection. The client application identifier must be configured in the Digital Certificate Manager (DCM) application database.

*DFT

L'identificateur d'application client par défaut fourni par le système, QIBM_QTMF_FTP_CLIENT, est utilisé. The system supplied default client application identifier QIBM_QTMF_FTP_CLIENT is used.

valeur-caractère

Indiquez l'ID d'application client configuré dans DCM. Le premier caractère de l'identificateur d'application doit être une lettre majuscule ('A' à 'Z') ; les autres caractères peuvent être alphanumériques (lettres majuscules 'A' à 'Z' ou chiffres '0' à '9'). Vous pouvez également utiliser un point ('.') ou un trait de soulignement ('_'). Specify the DCM configured client application ID. The first character of the application identifier must be an uppercase character ('A' to 'Z'); the remaining characters can be alphanumeric (uppercase 'A' to 'Z' or digits '0' to '9'). You can also use a period ('.') or underscore ('_').

Exemples

Exemple 1 : Démarrage de FTP vers une adresse Internet IPv4 Example 1: Starting FTP to an IPv4 Internet Address

STRTCPFTP   RMTSYS(*INTNETADR)  INTNETADR('1.2.3.4')

Cette commande démarre le client FTP vers le système indiqué par l'adresse IPv4 '1.2.3.4'. This command starts the FTP client to the system specified by IPv4 address '1.2.3.4'.

Exemple 2 : Démarrage de FTP vers une adresse Internet IPv6 Example 2: Starting FTP to an IPv6 Internet Address

STRTCPFTP   RMTSYS(*INTNETADR)  INTNETADR('2001:D88::1')

Cette commande démarre le client FTP vers le système indiqué par l'adresse IPv6 '2001:D88::1'. This command starts the FTP client to the system specified by IPv6 address '2001:D88::1'.

Messages d'erreur

Aucun None