TahiTECversin0.

1Beta (ManualdeUsuario)

Creadores: AlejandroAmaroFlores(alex_link00@hotmail.com) OmarAbarcaArriaga(omaru_77@hotmail.com) AhmetAlainAlfaroCuevas(ahmet_alain@hotmail.com)

MoreliaMichoacn,(Mxico)20082009

ndice:

I.CmoIniciar?.........................................................................................3

II.EjecutandoTahiTEC.............................................................................4

III.DescripcindeFuncionesdeTahiTEC...............................................5

IV.Recomendaciones..................................................................................7

I.Cmoiniciar? InstalarJavaconsuJDKenelSistemaOperativoelegido(Windows/Linux). PosteriormenteagregaralPATHdelSistemaOperativoelcompiladorjavac.Como hacerestoenWindowsXPporejemplo,laruta: C:\Archivosdeprograma\Java\jdk1.6.0_07\bin AgregaralPATHlarutaquetenganuestrocompilador(nosiempreeslamismaquela usadaenelejemplo,puedevariardependiendodelJDKqueestemosutilizando).El PATH se encuentra en: Panel de Control\Sistem\Opciones Avanzadas\Varialbes de Entorno\VariablesdelSistema\Path\modificaresavariableyagregarlaruta(Figura 1).

1 3

Figura1.PathdeWindowsXP. Como hacerlo en Linux, la versin fcil descargar e instalar NetBeans 6.1 full version,elcualalinstalarseagregaraautomticamentealPATHelcompiladordeJava. Otrasformas:
PARA EL shell C (csh), EDITAR EL ARCHIVO DE INICIO (~/.cshrc): set path=(/usr/local/jdk1.6.0_07/bin $path) PARA ksh, bash or sh EDITAR EL ARCHIVO (~/.profile): PATH=/usr/local/jdk1.6.0_07/bin:$PATH Usando el commando export para el JDK y JRE: export PATH=$PATH:/home/usuario/jdk1.6.0_07/bin

export PATH=$PATH:/home/usuario/jre1.6.0_07/bin

ParacomprobarenambosSistemasOperativosusarelcomandojavacdentrodeuna terminaldeconsola.

Figura2.Comprobacindelpath. Deber aparecerunlistadodecomandossimilaralaFigura2.Conellosecomprueba queestacorrectamenteagregadoalPATHelcompiladordeJava.

II.EjecutandoTahiTEC Para instalar TahiTEC version 0.1 Beta se tiene que descomprimir el archivo TahiTECv01B.rarencualquiercarpetaenelSistemaOperativoelegido. Abrir unaterminal deconsola(NOserecomienda utilizar cualquier herramienta de ProgramacinenJava,talescomoNetBeansoEclipse,aexcepcindeJCreator,yaque puedencausarunmalfuncionamientodeTahiTEC),situarseenlacarpetadondese encuentraTahiTEC,compilarlojavacTahiTEC.javayejecutarlojavaTahiTEC,se realizaestospasosparaquelaversindelcompiladornoafecteaTahiTEC(Figura3).

Figura3.EjecucindeTahiTECenmodoconsola.

III.DescripcindeFuncionesdeTahiTEC A continuacin aparecer lainterfaz grafica deTahiTEC, enlacual poseediversas funcionesqueserndescritasacontinuacindeacuerdoalanumeracinqueapareceen laFigura4. 10 1

4 6

5 8

Figura4.InterfazGraficadeTahiTECysusfuncionesenumeradas. 1. BarradeHerramientas: EstabarracontienelosmensArchivoyAyuda,enel men ArchivoseencuentranlasopcionesAbrirySalir.LaopcindeAbrir tiene la misma funcionalidad que el Botn llamado de igual manera (Figura 4 Nmero2)yquesedescribirmsadelante.LaopcinSaliresparacerrardemanera

adecuadaTahiTECyborrarlosarchivosquefueronutilizadosporTahiTEC(nodeben estar contenidos enlamismacarpeta queTahiTEC, delocontrario,sernborrados completamente), est debe ser la opcin que deba utilizarse siempre para cerrar TahiTEC(NOsedebeusarcomandoscomoCtr+C ocerrarlaterminaldeconsola paracerrarelprograma,yaquepuedeocasionarunmalfuncionamientolaprximavez queseutilice).EnelmenAyudaseencuentralaopcinAcercadelacualmuestra uncuadrodedialogoendondemuestrainformacinacercadeTahiTEC. 2. BotnAbrir: Elbotnabriralpresionarloapareceunexploradordearchivosen dondeseseleccionar elarchivo.javaquesedeseeutilizarcomoagente,tambinse puedenabrirarchivosdetexto,peroestosnopodrnserejecutados.Solosepueden abrirhasta5archivosalavez,as quenosedebeexcederesenmero.Elarchivo elegidounavezabiertoaparecer listado(Figura4Nmero6),locualindicar que esta listo para usarse. NO es necesario que los archivos que se quieran abrir se encuentren enlacarpeta dondeest TahiTEC, seRECOMIENDAusarotra carpeta diferentealaqueseencuentraTahiTEC. 3. Bot nEjecutar: Estebotnalpresionarloejecutar elarchivo.javaabierto,sihay msdeunarchivoabiertosetendr queseleccionardellistado( Figura4Nmero6) paraserejecutado, encasocontrarioejecutar pordefectoelultimoarchivoquese abri.Losarchivos.javadebensercorrectos,esdecir,estosNOdebentenererrores decompilacinniejecucin,yaqueTahiTECnomostrar esoserroresencasodeque lostengan,porlotanto,serecomiendacompilaryejecutarlosprogramaspreviamente antesdequeseanutilizadosporTahiTEC.Losarchivosdetextonotendrnningn efectoalpresionarestatecla. 4. Bot nBorrar: Estebotnalpresionarloeliminar elarchivodelalista(Figura4 Nmero6)ysisedeseavolverautilizartendr queabrirsedenuevoconelbotn Abriroconelmen ArchivoylaopcinAbrir(Figura4Nmero2y1).Este botneliminatambinlosarchivosdetextoquesehayanabierto. Encasodequeun archivoabiertoseencuentreenlamismacarpetaendondeseencuentraTahiTEC,este botnloborrar,asqueseaprecavido. 5. Bot nEnviar: EstebotnalpresionarlosolicitarlaIPdestinoalaqueseenviarel archivoqueseencuentreseleccionado(Figura4Nmero6),dichoarchivopuedeser detextoo.java. DebehaberunTahiTECabiertoenlamquinareceptoradeeste archivo, adems las computadoras debenestarconectas enredconIPsvlidas para poderenviar/recibirarchivos.Elarchivoqueseenvedebecontenerenlaprimerlnea el nombre del archivo en forma de comentario, seguido de un espacio en blanco ( ejemplo://Hola_Agente.javao/*Hola_Agente.java*/ ),paraquesearenombradocon el mismo nombre una vez que sea recibido por el receptor, en caso contrario ser nombradocomoagente.java,estoaplicatantoparaarchivosdetextocomoarchivos .java. Una vez que el archivo sea recibido por el receptor ste ser ejecutado inmediatamenteyvisualizadoenellistado(Figura4Nmero6),encasodequesea unarchivodetexto,solosevisualizar enellistado(Figura4 Nmero6),enel emisordichoarchivoser eliminadoporcompletodeTahiTECyborradodellistado

(Figura4Nmero6),porelloserecomiendaquenoseencuentreenlamismacarpeta queTahiTEC. 6. ListadodeArchivos( ListBox ): Enestalistadebenseleccionarselosarchivosquese quieranutilizarparalasfuncionesdeTahiTEC(Figura4Nmero1,2,3,4y5),el archivoseleccionadoaparecerenelreadetexto(Figura4Nmero7)indicandoque estlistoparausarse. 7. Visualizacin deresultados (TextArea): Enest readetextosevisualizar que archivosestnsiendoseleccionadosenlalista(Figura4Nmero6)parasuuso,en casodequenohayaningunoenseleccinseindicar.SilacasilladeVerSalidaest seleccionada(Figura4Nmero8),mostrar losresultadosquepresenteelprograma .javaqueseaejecutado(Solosidichosresultadossonmostradosenconsola,encaso contrariosisonmostradosgrficamenteaparecerndeesamaneraynoenestarea).La leyendaSalidaAgentesemostrarcuandolacasillaesteseleccionadayseejecuteun programaconelbotndeejecucin(Figura4Nmero3). 8. Casilla de Visualizacin de las salidas en consola de los programas ejecutados (CheckBox):Alestarseleccionadamostrarlasalidaquedebiexhibirunprogramaen laconsolaalejecutarse.Lasalidadelprogramasemostrar enResultados(Figura4 Nmero 7) con la leyenda Salida Agente. Cuando esta casilla no se encuentre seleccionada, solo se visualizarn los archivos que sean seleccionados en la lista (Figura4Nmero6)ycuandoseanejecutadosnosemostrarsusalidaenelreade resultados(Figura4Nmero7),amenosqueestseaenformagrfica. 9. Bot nLimpiar: EstebotnalserpresionadolimpiarelreaResultados(Figura4 Nmero7), es decir eliminar todo el historial que hasido desplegado hasta ese momento. 10. Barra estndar de ventanas: Los botones en est barra realizan las funciones comunesdecualquierventana:minimizar,maximizarycerrar.Almaximizarlainterfaz graficaseverafectada,loselementosdelaventanatendrnposicionesdiferentesalas mostradasenestemanual,noesrecomendableusaresebotn.Elbotndecerradoal igualqueelmenArchivo/Salir(Figura4Nmero1)cierrademaneraadecuadael programaTahiTEC,ladiferenciadeesteesquenohar lalimpiezadelosarchivos utilizados,esdecir,noborra,losarchivosqueseencuentranenlacarpetadondeesta almacenadoTahiTEC. IV.Recomendaciones 1. ElcompiladordejavadebeestaragregadoalPATH. 2. Elarchivoquesedeseeenviardebecontenerenlaprimeralneasunombre completo,anteponiendounespacioenblanco.EjemploArchivo.txtotambin //Archivo.txt.Despusdelprimerespacioser elnombrequesetomepara renombrarelarchivoenviado. 3. No usar herramientas de programacin Java como NetBeans o Eclipse para ejecutarTahiTEC,utiliceelmodoconsola.LanicaexcepcinesJCreator. 7

4. NocolocarlosarchivosquesedeseanejecutarconTahiTECenlacarpetaquelo contiene. 5. No utilizar nombres de archivos o carpetas con espacios en blanco o con caracteresilegales. 6. No cerrar la consola de ejecucin de TahiTEC o utilizar comandos como Ctr+C o Ctr+Z para cerrar TahiTEC. Utilice solo los mens que se encuentranenlaventanadeTahiTEC. 7. Tenerelpuerto9000sinusar,yaqueeselpuertoqueutilizaTahiTECpara recibirarchivos,encasocontrario,cerrarlaaplicacinqueloestutilizando. 8. TenercorrectamenteformadalaredendondeserusadoTahiTEC,esdecir,que contengandireccionesIPsvlidasyenpertenezcanalamismaclase. 9. DebehaberunTahiTECactuandocomoemisor/receptorporcadanododela red,esdecir,unTahiTECabiertoencadamquinaqueviajarelagente. 10. Utilizarprogramas.javasimplesparaqueseanusadoscomoagentes,esdecir, queseanmiembrosdeunproyecto,nitenganalgunaligaduraconalgnarchivo, encasodetenerligaduras,tomarlasmedidasnecesariasparasuuso. 11. En caso de que los agentes que sean utilizados por TahiTEC requieran de elementosextrascomounConectorounarchivo,colocarlosenlacarpetadonde deTahiTEC.(*Nota:EstaversincontieneelConectorparaMySQL,elJDBC). 12. Tenga visualizados los elementos que le hagan comprender como se esta comportandoelagente,talescomolacarpetadeTahiTECoelemisor/recptor. Estaversincontieneejemplossimplesquepuedenserutilizadosparaenviarsey ejecutarse,tantogrficamentecomomodoconsola. EstemanualfueescritoporAlejandroAmaroFlores(2009).