ASG Software Solutions : Guide FTP

Utiliser le site FTP d’ASG

Préparation des fichiers à transférer

Utilisez la procédure décrite ci-dessous uniquement pour transférer les fichiers (en particulier les « dumps ») de format FB (fixed block) pour ordinateur central. Pour conditionner les gros fichiers ou les fichiers de format VB (variable block) dans un format acceptable pour un transfert en mode binaire, utilisez l’un des programmes suivants :

Le logiciel TRSMAIN d’IBM, un programme téléchargeable et gratuit
La commande TSO XMIT, un utilitaire couramment utilisé pour transférer un fichier d’un processeur à un autre

Pour accélerer l’analyse des fichiers que vous envoyez vers le site d’ASG, veuillez utiliser la nomenclature suivante :

######.type

où

###### est le numéro de ticket qu’ASG a attribué à votre incident et type désigne le type de fichier que vous envoyez.

Les types de fichier suivants sont supportés :

.TRS – Pour un fichier compressé avec le programme TRSMAIN, que vous pouvez télécharger. Il est recommandé de compresser ainsi tous les fichiers résidant sur ordinateur central. Cette compression réduit le temps de transfert et permet aux fichiers à restaurer d’avoir les mêmes attributs qu’avant la compression.

.XMI – Pour un fichier conditionné en utilisant la commande TRANSMIT (XMIT) de TSO, autre méthode pour traiter les fichiers résidant sur ordinateur central.

.TXT – Pour un fichier de texte brut.

Exemple : le nom de fichier 123456.TRS renvoie au numéro de ticket 123456 et à un fichier résidant sur ordinateur et compressé avec le programme TRSMAIN.

Remarque destinée aux utilisateurs de ASG-OASIS™/DMS, ASG-ZARA™, ASG-ZEBB™ et ASG-ZEKE™ : Lorsque vous transférez des copies de vos bases de données, veuillez les stocker dans le répertoire /zeke du serveur FTP.

**** Reportez-vous au paragraphe Site de remplacement pour le transfert des fichiers d’un ordinateur central, en fin de document, en vue de vous connecter à un site de remplacement si vous n’arrivez pas à accéder à notre serveur principal. ****

Transfert des fichiers

Suivez les instructions qui correspondent à votre environnement.

Depuis les systèmes MVS (OS/390 ou z/OS) en utilisant ISPF

Sélectionnez l’option 6 d’ISPF (Command)
Dans le shell de commandes d’ISPF, entrez :
FTP
Lorsque vous recevez l’invite CONNECT TO? (se connecter à ?), entrez :
ftpsupport.asg.com
ou bien
63.170.220.148
A l’invite NAME (63.170.220.148:tsoid) (nom), entrez :
------- L’identifiant d’utilisateur et le mot de passe à entrer sont à retirer sur le portail ISP sous FAQs en ou contactant votre Centre de Support
A l’invite PASSWORD (mot de passe), entrez :
-------
A l’invite COMMAND (commande), entrez :
binary (pour les fichiers binaires)
ebcdic (pour les fichiers texte)
Pour les fichiers binaires, le programme FTP renvoie alors le message d’information TYPE SET TO I (type fixé à I).
A l’invite COMMAND (commande) suivante, entrez :
sunique on name (sunique sur nom)
Si le fichier à transférer est une base de données ASG-OASIS/DM, ASG-ZARA, ASG-ZEBB ou ASG-ZEKE, entrez :
cd zeke
Si le fichier à transférer est sans rapport avec l’un de ces produits, vous pouvez sauter cette étape
A l’invite COMMAND (commande) suivante, entrez :
PUT 'fichier.à.envoyer' ######.type
où
'fichier.à.envoyer' (entre guillemets simples) est le dsname complet du fichier conditionné,
###### est le numéro d’incident attribué par ASG et type est le type du fichier cible.
A l’invite COMMAND (commande) suivante, entrez :
QUIT (quitter)

Depuis les systèmes MVS (OS/390, z/OS) en utilisant un job batch

Copiez, modifiez puis exécutez le JCL suivant :

//jobcard
//*
//*********************************************************************
//* CES CINQ ENTREES PEUVENT DEVENIR DES MODIFICATIONS PERMANENTES :
//*--------------------------------------------------------
//* 1. Ajout d’une carte job correcte
//* 2. Remplacement de "llllll" par le nom de la bibliothèque où le
//* module de chargement de TRSMAIN est stocké. Ce module est
//* téléchargeable depuis l’adresse d’IBM suivante :
//* http://techsupport.services.ibm.com/390/trsmain.html
//* 3. Remplacement de "tttttt" par le nom du fichier TCPIP.DATA de
//* votre site.
//* 4. Remplacement de "ffffff" par le nom du fichier FTP.DATA de
//* votre site.
//* 5. Remplacement de "ppp" et "sss" par les espaces primaire et
//* secondaire alloués au fichier de sortie de TRSMAIN.
//*
//* CES DEUX ENTREES DOIVENT ETRE MODIFIEES POUR CHAQUE FICHIER
//* TRANSFERE :
//*-----------------------------------------------------------------
//* 1. Remplacement de "pppppp" par le numéro d’incident attribué par
//* ASG.
//* 2. Remplacement de "dddddd" par le nom du fichier que vous
//* transférez chez ASG.
//*********************************************************************
//*
//*===================================================================
//* Compresser le fichier dump en utilisant TRSMAIN
//*===================================================================
//TERSE EXEC PGM=TRSMAIN,PARM='PACK'
//STEPLIB DD DISP=SHR,DSN=llllll
//INFILE DD DISP=SHR,DSN=dddddd
//SYSPRINT DD SYSOUT=*
//OUTFILE DD DISP=(NEW,PASS),UNIT=SYSALLDA,
// DSN=&&TRSFILE,
// SPACE=(CYL,(ppp,sss),RLSE)
//*
//*===================================================================
//* Envoyer le dump concis (‘tersed’) chez ASG
//*===================================================================
//SEND EXEC PGM=FTP,REGION=0K,
// PARM='63.170.220.148 (EXIT'
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//SYSTCPD DD DISP=SHR,DSN=tttttt
//SYSFTPD DD DISP=SHR,DSN=ffffff
//SENDFILE DD DISP=(OLD,DELETE),DSN=&&TRSFILE
//INPUT DD *
-------
-------
L’identifiant d’utilisateur et le mot de passe à entrer sont à retirer sur le portail ISP sous FAQs
en ou contactant votre Centre de Support
sunique on name
bin
put //DD:SENDFILE pppppp.TRS
quit
/*

Depuis Windows

Dans la barre des tâches, cliquez sur démarrer puis Exécuter…
Dans le champ Ouvrir de la boîte de dialogue Exécuter, entrez :
ftp
Cliquez sur OK
A l’invite FTP>, entrez :
open ftpsupport.asg.com
ou bien
open 63.170.220.148
Dans l’espace vide à l’intérieur de l’invite USER (..........(NONE)), entrez :
------
A l’invite PASSWORD (mot de passe), entrez :
------- L’identifiant d’utilisateur et le mot de passe à entrer sont à retirer sur le portail ISP sous FAQs en ou contactant votre Centre de Support
A l’invite FTP>, entrez :
binary (pour les fichiers binaires)
ascii (pour les fichiers de texte)
Pour les fichiers binaires, le programme FTP renvoie alors le message d’information TYPE SET TO I (type fixé à I).
A l’invite FTP> suivante (qui vient après le message d’information), entrez :
sunique on name (sunique sur nom)
Si le fichier à transférer est une base de données ASG-OASIS/DM, ASG-ZARA, ASG-ZEBB ou ASG-ZEKE, entrez :
cd zeke
A l’invite FTP> suivante, entrez :
PUT 'fichier.à.envoyer' ######.type
où
'fichier.à.envoyer' (entre guillemets simples) est le dsname complet du fichier conditionné,
###### est le numéro d’incident attribué par ASG et type est le type du fichier cible.

Utiliser TRSMAIN

TRSMAIN est un logiciel gratuit que vous pouvez télécharger depuis le site FTP d'IBM. Il permet de conditionner un ou plusieurs fichiers à transférer vers le site FTP d’ASG.
TRSMAIN compresse fortement le fichier à transférer, ce qui a pour effet de réduire le temps de transfert et l’espace disque nécessaire pour stocker le fichier.

Reportez-vous à la documentation disponible sur le site FTP d’IBM pour savoir comment télécharger, installer et utiliser TRSMAIN.

Utiliser la commande XMIT de TSO

La commande XMIT de TSO est couramment utilisée pour transférer un fichier d’un processeur à un autre. Elle permet de conditionner un fichier dans un format acceptable pour un transfert par FTP. Le fichier d’origine peut avoir n’importe quel format de fichier (par exemple séquentiel ou PDS) et d’enregistrement (par exemple, F, FB, U, V ou VB). Notez toutefois que les enregistrements du fichier de sortie sont toujours de format FB. Pour utiliser la commande XMIT en vue de conditionner un fichier, sélectionnez l’option 6 (COMMAND) d’ISPF et soumettez la commande suivante :
XMIT nomdenode.userid DSNAME(‘inpfile’) OUTDSNAME(‘outfile.XMI’)
où nomdenode est le nom de node JES2 de votre système, userid est votre identifiant d’utilisateur TSO, inpfile est le dsname complet du fichier que vous voulez transférer à ASG et outfile.XMI est le dsname du fichier qui va être effectivement envoyé par FTP au Support d’ASG. Notez que le qualifiant de niveau inférieur (l’extension) du fichier expédié doit être .XMI et que les fichiers d’extension .XMI doivent être transférés en mode binaire.

Site de remplacement pour le transfert des fichiers d’un ordinateur central :

Si vous ne parvenez pas à accéder au site ftpsupport.asg.com ou si la connexion est rompue au cours du transfert d’un gros fichier, veuillez vous connecter à ftp2.asg.com (ou bien 63.170.220.158). Ce serveur n’est pas derrière le pare-feu et admet les transferts de très gros fichiers. Identifiant d’utilisateur et mot de passe sont nécessaires pour y accéder :

userid = ------
password = ------ L’identifiant d’utilisateur et le mot de passe à entrer sont à retirer sur le portail ISP sous FAQs en ou contactant votre Centre de Support

Une fois connecté, tapez BIN pour passer en mode binaire (si vous envoyez un fichier binaire) puis utilisez la commande PUT pour envoyer le fichier vers notre serveur (voir les instructions détaillées ci-dessus).

Remarque : Avant de transférer les fichiers vers ce site, veuillez préparer les fichiers comme décrit ci-avant. Après le transfert, envoyez un courriel à support@asg.com, indiquant l’emplacement et les attributs DCB de votre fichier, afin qu’il puisse être chargé sur l’ordinateur central.

Instructions pour envoyer des fichiers non MVS :

Pour envoyer des fichiers qui ne sont pas issus d’un ordinateur central, veuillez suivre cette procédure :

Connectez-vous à ftp.asg.com. Identifiant d’utilisateur et mot de passe sont nécessaires pour accéder à ce site :

userid = --------
password = ----- L’identifiant d’utilisateur et le mot de passe à entrer sont à retirer sur le portail ISP sous FAQs en ou contactant votre Centre de Support

Une fois connecté, remplacez les noms de répertoires par celui du dossier Incoming (Entrant) puis transférez votre fichier. Après le transfert, envoyez un courriel à support@asg.com, indiquant l’emplacement et les attributs DCB de votre fichier, afin qu’il puisse être chargé sur l’ordinateur central.