Enestecapítuloseproporcionainformaciónderesolucióndeproblemasquese puedeutilizarparaidentificarysolucionarproblemas.Consulte elApéndiceBpara verunalista desucesosconerrorysu descripcióncorrespondiente.
Lostemasincluidosenestecapítuloson:
v “Cómoevitartiempos deprocesolargosendocumentosAScifradosdegran
tamaño”enlapágina157
v “Cómoevitartiempos deprocesolargosendocumentos cifradosdegran
tamaño”enlapágina157
v “Cómoevitarerrores defaltadememoria”enlapágina157
v “Clasificacióndedatosdemúltiplesidiomas”enlapágina158
v “CómogarantizarlamemoriavirtualsuficienteparaagentesdeDB2”enla
página159
v “Exportaciónde laconfiguración actualparaelsoporte”enlapágina160
v
“Resolucióndeerroresde DB2SQL”enlapágina160
v “Registrodeservicio IBMilegible”enlapágina162
v “MensajesinformativosdeWebSphereApplicationServer”enlapágina162
v “Aumentodelvalordetiempodeesperadelreceptor”enlapágina163
v “Optimizacióndelrendimientodeconsultadebasededatos”enlapágina163
v “Resolucióndelsuceso210031” enlapágina 163
v “Documentosdireccionadosdosvecescuando sepierde laredoelservidorde
gestorde documentossecierrerepentinamente”enlapágina164 v “0A1generadoconerroresde validacióndedatos”enlapágina 164
v “LosinformesdeEDIexportansólolosprimeros1000registros” enlapágina
164 v
“Laconsolanoseiniciadespuésdereiniciarseelservidor”enlapágina164
v “ElreceptorFTPScriptingrecibeStringIndexOutofBoundsException”enla
página165
v “Anomalíadelreceptoralleerelarchivodeconfiguración”enlapágina165
v “Configuracióndeusuariospararecibir notificacióndealertas” enlapágina 166
v “ResolucióndeClassNotFoundExceptionparalasclasesde salidadeusuario”en
lapágina 166
v “Reprocesode sucesosydocumentos deempresaquenosepuedenregistraren
labase dedatos”enlapágina 167
v “InhabilitacióndeJITenWebSphereApplicationServercuandoWebSphere
PartnerGatewayproduceunjavacore”enlapágina167 v
“Definicióndeuntipo detransportepersonalizado” enlapágina 168
v “ResolucióndeerroresBCG210031y BCG240415deWebSpherePartner
Gateway”enlapágina168
v “CreacióndeWebSpherePartnerGatewayenunaunidadquenoseaC:”enla
página169
v “EvitarqueWebSpherePartner Gatewayproceselastransaccionesdesocios”en
lapágina 169
v “Solucióndelerrordenavegador:500”enlapágina 169
v “DescargadeCRLparatransaccionesSSL”enlapágina170
v “Vinculacióndedatosenlasimportaciones/exportacionesdeJMSdel
WebSphereProcess Server”enlapágina 170
v “ReparacióndelaconexióndesociodepruebaparaconexionesSSL”enla
página171
v “ResolucióndeerroresBCGEDIEV0O56 yBCG210001”enlapágina171
v
“ResolucióndelerrorORA-00988”enlapágina 172
v “ConfiguracióndeatributoContent-Typesparalosmanejadoresde flujode
trabajofijo” enlapágina172
v “ResolucióndelerrorBCG210013”enlapágina173
v “Aumentodeltamañodelalmacenamientointermedioparaevitarelbajo
rendimientoenlatransmisiónde documentos”enlapágina 174
v “MensajesdeerrordelregistrodelinstaladordeconcentradordeWebSphere
PartnerGateway”enlapágina174
v “Errordecontraseñadebasede datosnecesariaenbcgHubInstall.log”enla
página174
v “Usode lacomprobación derevocación yusodelsoporteparaCRLDP”enla
página174 v
“Devolucióndeinformacióndebúsquedadeinformedevolumende
documentossobrelaconsola”enlapágina175 v “Cargadelabibliotecanativa”enlapágina 175
v “ResolucióndeloserroresTCPC0003EyCHFW0029E”enlapágina176
v “Caducidaddecertificados deentidademisorade certificados”enlapágina177
v “VCBaseExceptionenSystemOut.log”enlapágina178
v “Informede tamañodearchivoparadocumentos conuntamañosuperiora
2 GB”enlapágina 178
v “ElreconocimientoSSLfallaporquenoseharecibidoningúncertificado”enla
página178 v
“Resolucióndelavisodehebrascolgadas”enlapágina179
v “Excepcióndedetencióndelgestorde documentos”enlapágina 180
v “Resolucióndemensajesde WebSphereMQ” enlapágina 179
v “java.security.InvalidKeyException:Tamañodeclaveoparámetro
predeterminadonopermitidos”enlapágina 180
v “Aumentodeltamañodelalmacenamientodinámico”enlapágina 181
v “Estadode MDNde'desconocido'paratransaccionesAS”enlapágina181
v “Losservidoresnoseiniciandespués delaaplicacióndearreglos”enlapágina
181
v “Correccióndepuertos deatajoparaWebSphereApplicationServer”enla
página182
v “Correccióndepuertos deatajoparaWebSphereApplicationServer”enla
página182
v “Cómoevitar laentrega dedocumentosduplicadoscuandohaymásdeun
direccionador”enlapágina 182
v “Representacióndecabecerasdeseparadoresenvisualizacionesconuna
resoluciónsuperiora 1024”enlapágina183
v “DocumentosnoprocesadosalutilizarOracle9iRelease2”enlapágina183
v “Procesamientodedocumentos cuandolabasededatosseinactiva”enla
v “java.lang.NoClassDefFoundErrorconreprocessDbLoggingErrors.bat”enla
página184
v “Procesode recuperacióncuando lacolayeldiscoestánllenosono
disponibles”enlapágina184
Cómo
evitar
tiempos
de
proceso
largos
en
documentosAS
cifrados
de
gran
tamaño
LosdocumentosAScifradosde grantamañopuedentardarmuchotiempoen procesarseenalgunasconfiguracionesdehardwaredegamainferior.Paraevitar losretrasos,llevea cabolas accionessiguientes:
1. SeleccioneelatributoAScomprimidoenSíparadisminuireltamañodel
documentoqueseenvía.
2. Sigalospasosdelapartado″Cómoevitarerroresdefalta dememoria″ para
aumentareltamañode lamemoriayacelerarelprocesodelosdocumentos cifrados.
Cómo
evitar
tiempos
de
proceso
largos
en
documentos
cifrados
de
gran
tamaño
Losarchivosgrandessepueden comprimirantesdeenviarlos.Elsoportede archivosgrandesconunordende tamañoenGBseha ampliadoparaAS2yAS3. Enlaversión6.1.1,eltamañomáximode archivoprocesadomediantematricesde bytesesconfigurable.Cuandolacantidaddememoriaasignadaessuperioral tamañode almacenamientodinámicodisponible,seproduceunerrordefalta de memoria. Sieltamañode datosesinferioralamemoriadisponible,esposibleque sigaproduciéndoseunerrordefalta dememoriasilamemoriaasignada aumenta lamemoriadisponible.Entiempodeejecución sedeterminasieltamañode archivo configuradosepuedesoportarenfuncióndelamemoriade
almacenamientodinámico disponible.Puedeespecificareltamañomáximode archivo quesepuedeutilizarconmatricesdebytesmediantelapropiedad
bcg.maximumFileSizeForByteArrays.Sieltamañodearchivoessuperioralvalor de estapropiedad,seprocesamediantesecuencias.Sieltamañodearchivoes inferioralvalordeestapropiedad,ysinohaysuficientememoriadisponible,se generará unsucesodeerrorBCG210050.Cuandoiniciesesióncomooperadorde concentrador, vayaa lapestañaAdministradordelsistema>Atributoscomunes. Sobrescriba elvalorpredeterminado delapropiedad
bcg.maximumFileSizeForByteArraysparaespecificareltamañode archivo máximo queseutilizaráconlas matricesdebytes.Aumenteelvalor deesta propiedad paramejorar elrendimiento.Paraevitar erroresdefaltadememoria, el valor delapropiedadbcg.maximumFileSizeForByteArrayssedebeestablecerde modoquelosarchivosmuygrandesseprocesenmediantesecuenciasenlugarde matricesde bytes.Por ejemplo,sieltamañodelaRAMesde 512MB,elvalorde lapropiedadbcg.maximumFileSizeForByteArrayssepuedeestableceren20MB. Todoslosdocumentosconuntamañosuperiora 20MBseprocesaránutilizando secuenciasy nomediante matricesdebytes.Losdocumentos conuntamaño inferiora20MB seprocesaránenmemoria.
Cómo
evitar
errores
de
falta
de
memoria
Lassiguientessonáreasquepuedencontribuira lascondicionesde faltade memoria:
v Configuracióndelamemoriadelgestordedocumentos
Estaconfiguración especificalacantidaddememoriaquelaaplicaciónJava subyacentehaasignadoparatrabajarconella.
v Cargadetrabajodelgestordedocumentos
Puedeconfigurarelnúmerodesubcomponentesde hebraquepuedeutilizar. Si elnúmerodehebrasconfiguradoesaltoyexisteuna grancargadetrabajo,será necesariamásmemoriaparamanejar todoslosdocumentos.
v Estructuradedocumentodelosdocumentos queseestánprocesando
Enfuncióndelaestructurade documento,puedequeseanecesariamás
memoriaparaprocesarundocumento,especialmenteparadocumentos grandes. Lasáreasafectadasson seguridad(cifrado, descifrado,firma,verificaciónde firma)ylospasosdeprocesode transformaciónyvalidaciónXML
(especialmenteparalosdocumentosconvaloresgrandesdetexto).
Paraobtener másinformaciónsobreerroresdefaltade memoriadebido aarchivos de grantamaño,consulteelapartado“Cómoevitartiemposdeproceso largosen documentos cifradosdegran tamaño”enlapágina157.
Configuración
de
la
memoria
del
gestor
de
documentos
Paramejorar elrendimientoyevitarerroresde faltadememoria,puedeaumentar eltamañoinicialyeltamañomáximodelalmacenamientodinámicoparalos componentes deWebspherePartnerGateway.Desde laconsolade administración de WebsphereApplicationServer:
1. Desplácesehastalosservidoresdeaplicaciones.
2. SeleccioneelcomponentedeWebspherePartnerGateway.
3. SeleccioneJava ygestióndeprocesos>Definicióndeprocesos>JavaVirtual
Machine.
4. ActualicelosvaloresdeTamañoinicialdealmacenamientodinámicoy
Tamañomáximodealmacenamientodinámico
5. ReinicieWebspherePartnerGateway.
Carga
de
trabajo
del
gestor
de
documentos
Elnúmerodehebrasenprocesoutilizadassepuedeconfigurarparavarios subcomponentesestableciendolaspropiedadesdelsistema.Losvalores
predeterminadosparaestaspropiedadessonbajos,peropueden sermodificados por eladministrador.Busquelaspropiedadesqueimplicanconfiguración dehebra enlastablasde configuracióndelapartadoApéndiceC, “Atributosdelsistema específicos decomponente”,enlapágina221.
Estructura
de
documento
Losdocumentos grandespuedeprocederdelsocioexternoodelsociointerno (aplicacionesdefondo).Determinesihayalgunaformadereducirlostamañosde losdocumentos, porejemplo,tamañosreducidosdelotesolautilizaciónde documentos máspequeños.
Clasificación
de
datos
de
múltiples
idiomas
WebSpherePartnerGatewaydependedelasbasesdedatossubyacentes parala clasificacióndedatos.Sisu instalacióndasoportea variosidiomas ylosdatosde Unicodenoestánordenadoscorrectamente,reviseesteapartado.
Apartirdelaversión6.0,WebSpherePartnerGatewayconfiguraDB2parautilizar elvalorde clasificaciónUCA400_NO.DB2versión8.2nodasoporteatodoslos casosespeciales(como seespecificaenUnicodeStandardversión4.00 Technical Standard #10)paratodoslosidiomas.Enestoscasos,póngaseencontacto directamente conDB2.
Oracle
Lasbasesdedatosde Oracleutilizanelcambiodinámicoparalassecuenciasde clasificación. Parautilizarestafuncionalidad, WebSpherePartnerGatewaycambia elvalorde lavariable desesiónNLS_SORTenfuncióndelentornolocaldel usuario actual.LaTabla40contienelosentornoslocalesde usuarioposibles,los idiomasde WebSpherePartnerGateway soportadosy losvaloresdeNLS_SORT correspondientes. Estainformaciónestáalmacenadaenlatablade basesde datos PR_LOCALE.
Tabla40.Informacióndeentornolocal
Entornolocaldelnavegador Idioma ValorNLS_SORT
pt_BR Brasil/Portugués BINARIO
zh Chino SCHINESE_RADICAL_M
en_US Inglés BINARIO
fr Francés FRENCH_M de Alemán XGERMAN it Italiano BINARIO ja Japonés JAPANESE_M ko Coreano KOREAN_M es Español SPANISH_M
zh_TW Chinotradicional TCHINESE_RADICAL_M
Otros Otros BINARIO
Cómo
garantizar
la
memoria
virtual
suficiente
para
agentes
de
DB2
Elsiguienteerror, queseencuentraenlosregistrosdeWebSpherePartnerGateway, indicaquenohaysuficientememoriavirtual disponibleparaelagentedebasede datosparaelprocesodeclasificación.Paracorregir estasituación,disminuyael valor delparámetroSORTHEAPparalabase dedatosqueha creadoparaWebSpherePartnerGateway.Póngase encontactoconeladministradordelabase de datosparaobtenerinformaciónsobrecómoestablecer dichoparámetroenel entorno.
Acontinuaciónsemuestraunejemplodeunerrordememoriavirtualinsuficiente:
Error[DBChannelCheck] [hebra principal 2] - Error en la comprobación del canal para com.ibm.bcg.channel.CheckChannelParameters@ebda9664
com.ibm.ejs.cm.portability.ResourceAllocationException: Error SQL DB2: SQLCODE: -955, SQLSTATE:57011, SQLERRMC: null
ERROR [BPEEngine] [hebra principal 2] - BPE:
ERROR [BPEEngine] [hebra principal 2] - java.lang.ArrayIndexOutOfBoundsException: 0
ERROR [BPEEngine] [hebra principal 2] - Error al cerrar
transConn.com.ibm.ejs.cm.exception. WorkRolledbackException: Se ha retrotraído el trabajo pendiente de esta conexión que el usuario no había comprometido ni retrotraído.
Exportación
de
la
configuración
actual
para
el
soporte
Es posiblequeelpersonaldesoportedeIBMlesolicitequeexportelainformación de configuraciónparaquepuedanrevisarla.Paraello,puedeutilizarlas
herramientas BCGConfigurationExporty BCG_DBConfigurationExport,queestán ubicadaseneldirectorio{DIRINSTAL}\bin.
v BCGConfigurationExport
Esteprogramade utilidadcopialosarchivosderegistroydepropiedades.La salidaseráunarchivo denominado
BCGConfigurationExport.output.<nombre_host>.jar,donde<nombre_host> esel nombredelhost delaestaciónde trabajoenlaqueseejecutaWebSpherePartner Gateway.Secrearáenundirectorioqueespecifique.Elprogramadeutilidad espera3parámetros:
– directorio raízderegistrodeWebSphereApplicationServer({DIR
INSTAL}\was)
– directorio raíz deWebSpherePartner Gateway({DIR INSTAL}\)
– ubicacióndedestino
v BCG_DBConfigurationExport
Esteprogramade utilidadcopialosdatosdeconfiguración delabasededatos deWebSpherePartnerGateway.Lasalidaseráunarchivo denominado
BCGDB_ConfigurationExport.DB.output.<nombre_bd>.jar,donde<nombre_bd> es elnombrede labase dedatos.Secrearáenundirectorioqueespecifique.El programadeutilidadespera5parámetros:
– directorio dedestino
– distintivodebase dedatos(DB2oORA)
– nombre debasededatos
– IDdeiniciodesesiónde basededatos
– contraseñadebasede datos
Antesdeejecutarcualquieradelosdosprogramasde utilidad,asegúresedequela vía deaccesoincluyaeldirectoriode jredeJava (esdecir,<DIR
INSTAL>\was\java\bin\).CuandoejecuteBCG_DBConfigurationExportconDB2, utiliceunalíneade mandatosdeDB2.ParaOracle,asegúresedequetieneel entornoconfiguradoparaejecutarherramientasdeOracle.
Nota: SiWebSpherePartnerGatewayestáinstaladoenvariasestacionesdetrabajo,
debeejecutarestosprogramasdeutilidadencadaestaciónde trabajo. Cuandolosarchivosdeexportaciónsehayancreado elpersonalde soporte deIBM leindicaráncomoentregarlos.
Resolución
de
errores
de
DB2
SQL
Consulte lasseccionessiguientesparasolucionarmensajesespecíficosdeDB2 SQL: v “ErrorSQLCODE-444”enlapágina 161
v “ErrorSQLCODE-289”enlapágina 161
v “SQL0964CErrorderegistrode transaccionesllenoenlabasede datosde
BCGMAS”enlapágina162
Error
SQLCODE
-444
Si seencuentraconmensajesde errorSQLCODE-444 aliniciarcualquieradelos componentes deWebSpherePartner Gateway(bcgconsole,bcgreceiver, bcgdocmgr), debeaumentarelvalordelparámetroSHEAPTHRESde DB2DatabaseManager. EsteparámetrodebesercomomínimodosvecesmayorqueelvalorSORTHEAP másaltodefinidoparacualquier basededatosdentrodelainstanciadeDB2. Consulte aladministradordelabasededatosoconsulte laguíadeladministrador de DB2antesde cambiarestevalor.Acontinuaciónsemuestraunmandatode ejemplo:
db2 UPDATE DBM CFG USING SHEAPTHRES xxxxx IMMEDIATE
Si SQLCODE-444 persistedespuésde cambiarelvalor deSHEAPTHRES,puede disminuir losvaloresde STMTHEAPyAPPLHEAPSZdelabasededatos WebSpherePartnerGateway.Acontinuaciónsemuestraunmandatodeejemplo:
db2 UPDATE DB CFG FOR <nombre_bd> USING STMTHEAP xxxxx db2 UPDATE DB CFG FOR <nombre_bd> USING APPLHEAPSZ xxxxx
Consulte aladministradordelabasededatosoconsulte laguíadeladministrador de DB2antesde cambiarningúnvalor.
Tambiénsepuedeencontrarenelarchivo <inicio_DB2>\SQLLIB\bin\db2diag.log.
Error
SQLCODE
-289
Un códigodeerrordeDB2-289 indicaquelabasededatossehaquedadosin espacio enelsistemadearchivos.Compruebeconeladministradordebase de datoslaposibilidadde añadircapacidadadicionalenelservidorde basededatos. Como alternativa,pueden archivarselosdatosdeWebSpherePartnerGatewayen una ubicaciónde almacenamientodistintaparaliberarespaciode disco.
Error
SQLCODE
-1225
PuederecibirelerrorSQLCODE-1225seguidodeunrastreode pilaenlos registrosdelservidorWebSpherePartnerGatewaycuandolosrecursos deDB2se estén agotandoenelsistema.Acontinuaciónsemuestraunejemplodeunerror SQLCODE.
java.sql.SQLException: com.ibm.db2.jcc.c.SqlException:
DB2 SQL error: SQLCODE: -1225, SQLSTATE: 57049, SQLERRMC: null
Esteerrorseproducenormalmentecuandolasvelocidades detransacciónson altas (gran cantidaddedocumentosporsegundo)y DB2nopuedemanteneresta velocidad.Es posiblequeeladministradorde basededatosdeseesupervisary ajustarlabasededatosparaacomodar estosperiodos demuchastransacciones. Paramejorar elrendimientodelregistrocronológicode labase dedatos,puede ajustarlossiguientesparámetrosdeDB2:
v LOGPRIMARY
v LOGSECOND
v LOGFILESIZ
SQL
0964C
Error
de
registro
de
transacciones
lleno
en
la
base
de
datos
de
BCGMAS
WebSpherePartnerGatewaycrealabasede datosdeBCGMASconlossiguientes valorespredeterminadosdeconfiguración:
LOGFILSIZ=1024 LOGPRIMARY=13 LOGSECOND=4
Lacantidaddeespacionecesarioparaelregistrodetransaccionesde DB2depende de unaseriedefactores,queincluyenlavelocidadmáximade documentosque procesa WebSpherePartner Gatewayduranteunperiododetiempodeterminado. Si notaqueparece queWebSpherePartnerGatewayentraenpausamientraslos documentos aúnestánenlacola, compruebelosregistrosdeFFDCparael servidor BCGMAS.Si encuentraqueelservidor BGMAShafalladoconelerror SQL0964C,aumenteeltamaño(LOGFILESIZ)yelnúmero(LOGPRIMARY, LOGSECOND)delosregistrosdetransaccionesparalabasede datosde BCGMAS.
Registro
de
servicio
IBM
ilegible
EnreleasesanterioresdeWebSpherePartnerGateway,podíanvisualizarselos registrosmedianteuneditordetextooelmandatomore.Enelreleaseactual, variosdeestosregistrossonenformatobinarioy nosepuedenleerconuneditor de textoomedianteelmandatomoreenlalíneademandatos.Si susalidade registrodeservicio semuestraincomprensibleutilizandocualquieradeestosdos métodos,conviertaelregistrodeservicio deformatobinarioentextosinformato emitiendo elmandatoshowlog desdelaestacióndetrabajoenlaqueseencuentra laherramientaquesemuestraa continuación.
showlog -format CBE-XML-1.0.1 nombre_archivo
Dondenombre_archivo eselnombredearchivo delarchivo deregistrodeservicio. Tenga encuentaquesielregistrodeservicio noseencuentraeneldirectorio predeterminado deberáescribirelnombredelarchivo deregistrocompleto. Estemandatoshowloggeneraunasalida enformatoXMLdesucesobasecomún. Paravermásejemplosdescripts Showlog,vayaa lapágina http://
publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/ com.ibm.websphere.base.doc/info/aes/ae/ttrb_viewsvclog.html.