![[z/OS]](../images/ngzos.gif)
APIs de Adaptadores Locais Otimizados para z/OS
Os adaptadores locais otimizados do WebSphere Application Server para z/OS são suportados por um conjunto de serviços de chamada de idioma nativo de z/OS ou interface de programação de aplicativos (APIs), e pelo Java™ EE Connector Architecture (JCA).
- Cobol
- C/C++
- PL/I
- High Level Assembler
Um responsável pela chamada executando em AMODE 64 pode usar as versões de AMODE 31 das APIs, desde que a lista de parâmetros esteja abaixo da barra e passe o parâmetro usando convenções de 31 bits (cada ponteiro do parâmetro é um endereço de 31 bits). Responsáveis pela chamada em execução em 64 bits devem ser C, C++ ou assembler e executar no modo de endereçamento de 64 bits. Ao usar as APIs BBGA1* de 64 bits a partir de aplicativos do assembler, uma área de salvamento no formato 4, oy F4SA, de 64 bits é necessária, a qual é usada pelos stubs de adaptadores locais otimizados para salvar e restaurar os registros do responsável pela chamada. Ao chamar de C ou C++, o cabeçalho da amostra em <Prod_FS_root>/util/zos/OLASamples/bboaapi.h define as APIs de 64 bits como OS_NOSTACK externo, o que garante que sejam chamados com as convenções corretas de área de ligação e salvamento.
Quando o termo conexão local é usado nessa documentação de API, uma referência está sendo feita para um link de memória cruzada que é criado para comunicação entre um espaço de endereço externo no sistema z/OS e o WebSphere Application Server no mesmo sistema z/OS. O espaço de endereço do cliente deve estar em execução na mesma imagem do z/OS. A API do adaptador gerencia essas conexões locais em conjuntos que são associados a cada um dos responsáveis pela chamada registrados exclusivamente. O nome de registro de 12 caracteres pode ser usado apenas para um grupo de conjuntos de conexões por espaço de endereço. Não há limite para o número de registros exclusivos em um único espaço de endereço. Ele é limitado somente pela quantidade de armazenamento disponível.
- Registrar - BBOA1REG/BBGA1REG
- Cancelar Registro - BBOA1URG/BBGA1URG
- Obtenção de Conexão - BBOA1CNG/BBGA1CNG
- Liberação de Conexão - BBOA1CNR/BBGA1CNR
- Enviar Solicitação - BBOA1SRQ/BBGA1SRQ
- Enviar Resposta - BBOA1SRP/BBGA1SRP
- Enviar Exceção da Resposta - BBOA1SRX/BBGA1SRX
- Receber Solicitação Qualquer - BBOA1RCA/BBGA1RCA
- Receber Solicitação Específica - BBOA1RCS/BBGA1RCS
- Receber Comprimento da Resposta - BBOA1RCL/BBGA1RCL
- Obter Dados da Mensagem - BBOA1GET/BBGA1GET
- Chamar - BBOA1INV/BBGA1INV
- Serviço do Host - BBOA1SRV/BBGA1SRV
- APIs do Adaptador JCA
Registro
Usando APIs BBOA1REG (para responsáveis pela chamada de 31 bits) e BBGA1REG (para responsáveis pela chamada de 64 bits), é possível registrar-se em um WebSphere Application Server local para grupo daemon e servidor do z/OS. As APIs BBOA1REG e BBGA1REG solicitam que um grupo de conexões otimizadas para um grupo daemon e servidor do WebSphere Application Server local seja alocado e registrado sob o "registername" especificado.
API | Sintaxe |
---|---|
BBOA1REG ou BBGA1REG | BBOA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) BBGA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) |
Parâmetros
daemongroupname (entrada)Uma variável de entrada ou constante de entrada contendo o nome do grupo de daemons do WebSphere Application Server para z/OS para a junção. O nome do grupo daemon deve ser o mesmo que o nome abreviado da célula, não o nome da tarefa do daemon.
Esta variável ou constante de entrada deve ser uma sequência terminada em nulo de exatamente 8 caracteres e deve ser passada por referência. O daemon do WebSphere Application Server for z/OS deve estar em execução e ser inicializado no sistema local.
nodename (entrada)Uma variável de entrada ou constante de entrada contendo o nome do nó do WebSphere Application Server para z/OS (nome abreviado) para a junção. A variável ou constante de entrada deve ser passada por referência. O servidor WebSphere Application Server z/OS deve estar em execução e inicializado no sistema local. Deve ser uma sequência preenchida em branco de exatamente 8 caracteres.
servername (entrada)Uma variável de entrada ou constante de entrada contendo o nome do servidor WebSphere Application Server para z/OS (nome abreviado) para a junção. A variável ou constante de entrada deve ser passada por referência. O servidor WebSphere Application Server z/OS deve estar em execução e inicializado no sistema local. Deve ser uma sequência preenchida em branco de exatamente 8 caracteres.
registername (entrada)Uma variável de entrada ou constante de entrada contendo o nome a ser usado para registrar um conjunto de conexões locais. Chamadas posteriores exigem este nome para identificar o conjunto de conexões a ser usado. Essa deve ser uma sequência preenchida em branco com exatamente 12 caracteres e não pode ser usada no espaço de endereço atual.
minconn (entrada)Um número inteiro contendo o número máximo de conexões para alocar para este registro. O adaptador tenta ampliar o conjunto de conexões locais até este número durante o pedido Obter Conexão quando o número mínimo das conexões estiver em uso.
registerflags (entrada)- reg_flag_trans - bit 30
Contém um 1 se a recuperação transacional será suportada em conexões sob este registro e um 0 (zero) se a recuperação transacional não será suportada.
Quando o parâmetro transacional é ativado, a API do adaptador tenta se registrar com o z/OS Resource Recovery Services (RRS) e uma transação global suportando two-phase commit é criada entre o WebSphere Application Server e o ambiente do explorador de API.
A partir da Versão 8.5.0.2, se você estiver executando em uma região dependente do IMS e configurar esse sinalizador como 1, assegure-se de estar executando o ambiente do IMS com RRS=YES, e o servidor, ou que a variável de ambiente no nível do nó ola_rrs_context_propagate tenha sido incluída na configuração e configurada como true (ou 1). Em IMS, o contexto de RRS estará em vigor no encadeamento quando Chamar ou Enviar Solicitação de chamada de API WOLA for propagado e declarado no contêiner EJB do WebSphere Application Server for z/OS.
Evitar Problemas: Se precisar incluir a variável ola_rrs_context_propagate em suas definições de configuração ou alterar a configuração nessa variável para true, você deverá reiniciar o servidor depois de fazer essa mudança na configuração. gotcha
- reg_flag_W2Cprop - 31 bits ou 64 bits
O reg_flag_W2Cprop controla WebSphere Application Server para a propagação de segurança da transação de saída do CICS.
- reg_flag_C2Wprop - bit 29Propaga a identidade na tarefa de chamada do CICS para o WebSphere Application Server. Para transações que chegam do CICS para o WebSphere Application Server, o sinalizador de registro reg_flag_C2Wprop controla como a identidade é determinada. Quando esse bit for ativado, a identidade da tarefa do aplicativo CICS será usada no processo de autorização do servidor WebSphere Application Server. Quando este bit for desativado, a identidade de região CICS será usada.Atenção: Você deve ativar a segurança de nível de aplicativo WebSphere Application Server para CICS a ser solicitado. Configure a variável de ambiente do WebSphere, ola_cicsuser_identity_propagate, para 1 por meio do console administrativo para definir esse tipo de propagação de segurança.
- reg_flag_trcmod - bit 0
Configure reg_flag_trcmod se desejar modificar as configurações de rastreio de adaptadores locais otimizados para o registro solicitado. Se você não configurar este sinalizador, não será feita nenhuma mudança na configuração de rastreio e os padrões do sistema ou configurações de rastreio predefinidas aplicáveis ao nome do registro ou nome da tarefa serão usadas.
- reg_flag_trcmore - bit 1 e reg_flag_trcsome -
bit 2
Com reg_flag_trcmod configurado como 1, configure reg_flag_trcmore ou reg_flag_trcsome para especificar uma configuração de rastreio, se desejar um rastreio detalhado ou um rastreio de nível simples para o registro. Deixar os dois configurados como "off", com reg_fla g_trcmod configurado para 1 não força nenhum rastreio para o registro, independentemente de quais predefinições ou padrões estão configurados.
Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- As conexões mínimas solicitadas são validadas com relação às conexões máximas do servidor, que podem ser configuradas com o uso do console administrativo do WebSphere Application Server. Um valor de conexão mínimo (minconn) de 3 significa que três conexões são reservadas durante a chamada
de registro. Se mais de três conexões são solicitadas em um determinado momento, o conjunto de conexões pode aumentar para o valor máxima de conexão (maxconn). Quando o número de todas as conexões de um
servidor atingir o máximo permitido, todos os pedidos de API de Obter Conexão
subsequentes para esse servidor serão rejeitados, mesmo se o valor maxconn ainda não
foi atingido.
Importante: Tenha cautela ao configurar o valor mínimo de conexões. Exceto em instâncias específicas, não é recomendado fazer uma configuração grande, já que os recursos na região de controle do WebSphere Application Server são reservadas para cada conexão.
- Diversas chamadas para a API de Registro podem ser feitas sob o mesmo espaço de endereço, encadeamento ou tarefa do Customer Information Control System (CICS), entretanto, eles não podem compartilhar o mesmo nome de registro. O nome do registro deve ser um nome exclusivo.
- Configurar o parâmetro transacional para 1 resulta em todas as conexões para esse registro executar com transacionalidade. Isto significa que o RRS é anexado a partir do espaço de endereço atual. Consulte a seção sobre Propagando Transações para obter mais detalhes sobre os requisitos e para configurar isso. A transacionalidade só é suportada entre o WebSphere Application Server e o CICS. As solicitações para transactional(1) a partir de outros ambientes resultam em um aviso durante a chamada de registro, o sinalizador é ignorado e o processamento continua.
- Use a chamada da API Cancelar Registro para remover este registro e liberar o conjunto de conexões associado a ele.
- Quando o espaço de endereço que faz uma chamada de registro termina, o registro é automaticamente terminado e as conexões são liberadas.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
4 | O sinalizador do registro transacional foi definido para 1 em um ambiente no qual o adaptador não suporta transações globais. | Esta configuração é ignora e o processamento continua. | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | É necessário cancelar o registro deste nome antes de chamar a API de Registro para ele. | |
10 | O parâmetro de conexões máximas excede o número máximo de conexões permitidas para qualquer registro único. | O pedido de API de Registro é rejeitado. Certifique-se de que o valor máximo do adaptador local otimizado do servidor de destino é grande o suficiente para acomodar esta e todas as outras solicitações. Para obter informações adicionais sobre a variável de ambiente WAS_DAEMON_ONLY_adapter_max_conn, consulte o tópico, Propriedades customizadas dos adaptadores locais otimizados, e o tópico, Ativando o ambiente do servidor para uso de adaptadores locais otimizados. | |
12 | O parâmetro de conexões mínimo especificado é maior que o máximo. | Certifique-se de que a configuração das conexões mínimas é menor ou igual à configuração máxima. | |
14 | Falta de memória compartilhada ao tentar criar o registro. | Aumente a alocação da memória compartilhada para o adaptador local otimizado ou emita chamadas de cancelamento de registro para reduzir o consumo de recursos. | |
21 | Ocorreu um erro ao tentar estabelecer contato com o WebSphere Application Server local. | Se você configurar o bit reg_flag_C2Wprop (bit 29) como 1, certifique-se de que a variável de ambiente do WebSphere, ola_cicsuser_identity_propagate, esteja configurada como 1. | |
25 | O gerenciador de transações não pode ser iniciado. | Entre em contato com o Suporte IBM® para obter assistência. | |
70 | Falta de memória compartilhada durante uma tentativa de criar uma conexão. | Aumente a alocação da memória compartilhada para o adaptador local otimizado. | |
74 | Nome de registro de entrada contém um nulo. | Preencha o nome do registro em branco antes de iniciar a API de Registro. | |
12 | 4 | Ocorreu um erro ao localizar o módulo BBOACALL. | Certifique-se de que o conjunto de dados que contém o módulo BBOACALL do WebSphere Application Server esteja disponível no STEPLIB, LNKLST. |
10 | Não é possível localizar o grupo de daemons do WebSphere Application Server selecionado. | Certifique-se de que o servidor de destino e o daemon do WebSphere Application Server estejam iniciados, verifique se suporte aos adaptadores locais otimizados está ativo e tente novamente. | |
14 | O ID do usuário não é autorizado para o WebSphere Application Server solicitado. | Certifique-se de que o ID do usuário esteja autorizado para a classe CBIND SAF para o WebSphere Application Server solicitado. | |
16 | O nome do nó ou o nome do servidor não foi localizado. | Certifique-se de que os parâmetros de nome do nó e nome do servidor que estão sendo transmitidos sejam válidos e de que o servidor esteja ativo. | |
23 | Ocorreu um erro durante tentativa de nomenclatura do token. | Entre em contato com o Suporte IBM para obter assistência. | |
24 | Ocorreu um erro ao estabelecer a conexão de comunicação local do WebSphere Application Server inicial. | Consulte os logs de região do WebSphere Application Server para obter detalhes sobre a chamada de conexão de comunicação local. | |
28 | O registro identificado com este nome não é válido. | O nome do registro especificado já está registrado, mas o RGE está ausente. Entre em contato com o suporte IBM e relate o erro. Uma solução alternativa é chamar a API de Cancelamento de Registro e tentar chamar a API de Registro novamente. | |
30 | O grupo de daemons não está em execução com a propriedade WAS_DAEMON_ONLY_enable_adapter configurada como 1. | Inclua variable:WAS_DAEMON_ONLY_enable_adapter=1 por meio do console administrativo do WebSphere Application Server. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
68 | Um anexo na memória compartilhada falhou. | Entre em contato com o Suporte IBM para obter assistência. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Cancelar o Registro
Cancele o registro do WebSphere Application Server local para o grupo daemon e servidor do z/OS usando as APIs BBOA1URG (para responsáveis pela chamada de 31 bits) e BBGA1URG (para responsáveis pela chamada de 64 bits).API | Sintaxe |
---|---|
BBOA1URG ou BBGA1URG | BBOA1URG (registername, unregflags, rc, rsn) BBGA1URG (registername, unregflags, rc, rsn) |
Parâmetros:
registername (entrada)Uma variável de entrada ou uma constante de entrada contendo o nome a ser usado para cancelar o registro de um conjunto de conexões locais. Isso deve ter exatamente 12 caracteres, preenchidos com espaços em branco e o mesmo nome usado no BBOA1REG.
unregisterflags (entrada)- Reservado - bit 0 a 30
- Forçar (0|1) - 31 bits ou 64 bits
Contém 1 se o pedido de cancelamento de registro tiver que ser forçado. Por padrão, um pedido de cancelamento de registro será concluído se todas as conexões forem retornadas para o conjunto de conexões. Se todas as conexões não forem retornadas para o conjunto, um aviso será retornado para o responsável pela chamada. O processo de cancelamento de registro é concluído quando a última conexão for retornada para o conjunto. Uma segunda solicitação de cancelamento de registro pode ser feita com o bit force configurado para 1, que força o processo de cancelamento de registro a ser concluído e todas os identificadores de conexões restantes para esse registro são inválidos.
Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Se a API de Cancelamento de Registro não for chamada e o espaço de endereço que faz uma chamada de registro for terminada, o cancelamento de registro será chamado automaticamente e as conexões serão liberadas.
- Quaisquer identificadores de conexões para esse registro que estão ativos quando ocorre uma chamada de cancelamento de registro podem continuar sendo válidos até serem retornados ao conjunto de conexões usando a API BBOA1CNR. Para forçar a limpeza dos identificadores de conexão, uma segunda chamada de cancelamento de registro deve ser feita, especificando o sinalizador de força. Isso invalida todos os identificadores de conexão pendentes.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
66 | A chamada de cancelamento de registro é atrasada até todas as conexões serem retornadas para o conjunto. | O cancelamento do registro é concluído quando a última conexão for retornada para o conjunto livre. | |
8 | - | Erro - consulte o código de razão | |
8 | O nome do token de registro não existe. | Você deve registrar este nome antes de chamar a API de Cancelamento de Registro para ele. | |
64 | A opção force não pode ser especificada até o cancelamento de registro normal ser emitido. | Chame a API de Cancelamento de Registro sem especificar a opção force. | |
76 | Uma tentativa de se comunicar com o servidor falhou porque o servidor não está mais em execução. | Inicie o servidor e tente a comunicação novamente. | |
82 | Já foi feita uma tentativa de cancelar o registro deste registro. | Espere a conclusão do pedido de cancelamento de registro anterior ou emita novamente este cancelamento de registro com a opção force . | |
96 | Essa API não pode ser direcionada durante a inicialização do Sistema de Gerenciamento de Informações (IMS) ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Obter Conexão
Essa API solicita que uma conexão disponível do conjunto criada com o nome de registro selecionado seja retornada.API | Sintaxe |
---|---|
BBOA1CNG ou BBGA1CNG | BBOA1CNG ( registername, connectionhandle, waittime, rc, rsn ) BBGA1CNG ( registername, connectionhandle, waittime, rc, rsn ) |
Parâmetros:
registername (entrada)Uma variável de entrada ou uma constante de entrada contendo o nome a ser usado para localizar o conjunto de conexões a partir do qual uma conexão deve ser recuperada. Este deve ser uma cadeia preenchida com espaços em branco com exatamente 12 caracteres.
connectionhandle (saída)Um identificador de conexões de 12 bytes que deve ser passada nas solicitações posteriores para as ações nessa conexão.
waittime (entrada)Um número inteiro contendo o número de segundos a ser aguardado pela conclusão da conexão antes de retornar um código de razão indisponível de conexão. Um valor de 0 implica que não há nenhum tempo de espera e que a API aguarda indefinidamente.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Certifique-se de que uma chamada de registro com sucesso (BBOA1REG) esteja concluída no espaço de endereço atual com um nome correspondente antes de usar a API Obter Conexão.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro não existe. | Certifique-se de ter registrado este nome antes de tentar chamar o nome com a API Obter Conexão. | |
10 | A conexão está indisponível. O tempo de espera expirou antes que o pedido de conexão pudesse ser obtido. | O comportamento do aplicativo varia. Aguarde e tente novamente ou encerre de forma anormal essa conexão. Outra opção é aumentar a configuração do máximo de conexões na chamada de API Registro. | |
24 | Depois de uma chamada de registro com sucesso, ocorreu um erro ao obter uma conexão a partir do conjunto. | Verifique se o servidor foi iniciado. Se ele não estiver funcionando, reinicie o servidor e tente a solicitação de API novamente. | |
28 | O registro foi localizado, mas está inativo. | ||
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 10 | Não é possível localizar o servidor ou grupo de daemons do WebSphere Application Server. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente novamente. |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Liberação de Conexão
A API de Liberação de Conexão solicita que uma conexão seja retornada ao conjunto que foi recuperado e está disponível para outro solicitante.API | Sintaxe |
---|---|
BBOA1CNR ou BBGA1CNR | BBOA1CNR ( connectionhandle, rc, rsn ) BBGA1CNR ( connectionhandle, rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexões de 12 bytes indicando que a conexão obtida anteriormente deve ser liberada de volta para o conjunto de conexões.
rc (saída)Um código de retorno de número inteiro que indica sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão da falha da chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Antes de usar a API de Liberação da Conexão, assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) seja concluída no espaço de endereço atual com um nome correspondente e uma chamada bem-sucedida de Obtenção de Conexão (BBOA1CNG ou BBGA1CNG) concluída para obter a conexão que agora deve ser liberada.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Não é possível localizar o servidor e o grupo de daemons do WebSphere Application Server. Quaisquer recursos que estiverem relacionados a esta conexão foram removidos. | Nenhum(a) |
8 | - | Erro - consulte o código de razão | |
36 | O estado da conexão não é válido. | O identificador de conexão que é usado para este pedido está em um estado incorreto. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente que é usado para este pedido não é válido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Enviar Pedido
Essas APIs enviam uma solicitação para o WebSphere Application Server local para processamento.API | Sintaxe |
---|---|
BBOA1SRQ ou BBGA1SRQ | BBOA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) BBGA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexão de 12 bytes que deve ser usado para essa solicitação.
requesttype (entrada)Um número inteiro contendo o tipo de solicitação que indica o tipo de solicitação de serviço a ser processado. Valores de tipo suportados: 1 = solicitações de serviço EJB locais, 2 = Solicitações de serviço EJB remotas.
requestservicename (entrada)Uma sequência de caracteres EBCDIC de até 256 bytes de comprimento contendo o nome do serviço a ser chamado. Para Type=1, EJB e Type 2, EJB remoto, esse é o nome do Home do JNDI para o destino.
requestservicenamel (entrada)Um número inteiro contendo o comprimento do nome de serviço para iniciar ou 0 (zero) se o nome de serviço for terminado em nulo.
requestdata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início dos dados da solicitação a serem enviados.
requestdatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados a serem enviados.
async(0|1) (entrada)Um valor de número inteiro que quando configurado como 1 indica que o responsável pela chamada quer o controle de volta imediatamente, mesmo que o comprimento da resposta ainda não seja conhecido. Para o async(0), o encadeamento atual é solicitar o aguardo da resposta a ser retornada a partir do WebSphere Application Server e o comprimento da resposta é retornado no argumento de saída do responsedatalen.
responsedatalen (saída)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits que contém o comprimento da resposta. Este comprimento pode ser usado pelo responsável pela chamada para adquirir armazenamento antes de chamar a API Obter Dados para copiar nele. Quando async for configurado para 1, indicando que o responsável pela chamada quer o controle de volta imediatamente, isso poderá ser configurado para todos os 0xFFs se a resposta ainda não for recebida.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Certifique-se de que uma chamada de registro com sucesso (BBOA1REG) esteja concluída no espaço de endereço atual com um nome correspondente antes de usar a API Enviar Pedido.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
14 | Uma condição de falta de memória ocorreu ao salvar a mensagem. | Não há memória suficiente disponível para que Enviar Pedido processe a mensagem. O espaço de endereço atual está fora do armazenamento privado. | |
16 | O comprimento do nome de serviço do pedido não é válido. | Corrija o programa e tente novamente. | |
18 | O comprimento do pedido excede os limites do sistema. | O tamanho da mensagem é maior que o tamanho que o WebSphere Application Server pode suportar. Verifique se o tamanho é válido. Se o tamanho for válido, certifique-se de que o tamanho do WebSphere Application Server seja grande o suficiente para acomodar o tamanho de mensagem. | |
26 | A transação global não pôde ser iniciada. | ||
32 | O tipo de pedido da chamada da API não é válido. | O tipo de pedido não é válido. Corrija o programa e tente a chamada novamente. | |
34 | O serviço de destino não foi localizado. | Certifique-se de que o aplicativo que contém o enterprise bean de destino esteja instalado e iniciado no servidor de destino para o WebSphere Application Server. | |
36 | O estado da conexão não é válido. | O identificador de conexão que é usado para o pedido está em um estado incorreto. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente que é usado para o pedido não é válido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
44 | Uma exceção ou condição inesperada ocorreu no enterprise bean de destino. | Consulte os logs do WebSphere Application Server para revisar os dados de exceção. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
98 | O início do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
100 | O término do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
12 | 10 | Não é possível localizar o servidor ou grupo de daemons do WebSphere Application Server. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo. Tente localizar novamente o servidor e o grupo de daemons do WebSphere Application Server. |
14 | O vetor de chamada da API que usa o identificador de conexões fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Enviar Resposta
Essa API envia uma resposta para uma solicitação de volta para o WebSphere Application Server local.API | Sintaxe |
---|---|
BBOA1SRP ou BBGA1SRP | BBOA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) BBGA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexão de 12 bytes que deve ser usado para essa resposta.
responsedata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início dos dados de resposta para envio.
responsedatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados para envio.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar a API Enviar Resposta.
- Assegure que uma chamada de obtenção de conexão bem-sucedida (BBOA1CNG ou BBGA1CNG) seja concluída e a manipulação seja fornecida como entrada nesta chamada.
- Certifique-se de que uma chamada Receber Qualquer Solicitação, Receber Solicitação Específica ou API do Host foi emitida e retornou com os dados solicitados para o identificador de conexões. A conexão deve estar em um estado em que a API Enviar Pedido esteja válido.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
14 | Uma condição de falta de memória ocorreu ao salvar a mensagem. | Não há memória suficiente disponível para que Enviar Resposta processe a mensagem. O espaço de endereço atual está fora do armazenamento privado. | |
18 | O comprimento da resposta excede os limites do sistema. | O tamanho da mensagem é maior que o tamanho que o WebSphere Application Server pode suportar. Verifique se o tamanho é válido. Se o tamanho for válido, certifique-se de que o tamanho do WebSphere Application Server seja grande o suficiente para acomodar o tamanho de mensagem. | |
34 | O serviço de destino não foi localizado. | Certifique-se de que o aplicativo contendo o EJB de destino esteja instalado e iniciado no WebSphere Application Server de destino. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido está em um estado incorreto. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido não é válido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
102 | O início do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
104 | O término do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
12 | 10 | Não é possível localizar o servidor ou grupo de daemons do WebSphere Application Server. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Exceção de Envio de Resposta
Essa API envia dados de uma resposta excepcional de volta para o responsável pela chamada de JCA no WebSphere Application Server local. A resposta é uma ResourceAdapterException com os dados da resposta excepcional especificados retornados.
API | Sintaxe |
---|---|
BBOA1SRX ou BBGA1SRX | BBOA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) BBGA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexão de 12 bytes que é usado para a resposta.
excresponsedata (entrada)Especifica um ponteiro de 31 bits ou 64 bits para o endereço do início dos dados de resposta excepcional para envio.
excresponsedatalen (entrada)Especifique um valor sem sinal de 32 bits em modo de 31 bits ou um valor sem sinal de 64 bits em modo de 64 bits do comprimento dos dados de resposta excepcional a serem enviados. Os dados de resposta de exceção é uma cadeia EBCDIC que descreve o erro.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGAREG) seja concluída no espaço de endereço atual com um nome correspondente antes de usar a chamada de envio da resposta.
- Assegure que uma chamada de obtenção da conexão bem-sucedida (API BBOA1CNG ou BBGA1CNG) seja concluída e que a manipulação para isto seja fornecida como entrada nesta chamada.
- Certifique-se de que uma chamada Pedido Qualquer de Recebimento, Pedido Específico de Recebimento ou API do Host com sucesso seja emitida e retornada com dados do pedido para o identificador de conexão. A conexão deve estar em um estado em que as APIs Enviar Resposta e Exceção de Envio de Resposta estejam válidas.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
10 | O identificador de conexão está em um estado liberado ou inválido. | Certifique-se de que um identificador de conexões válido seja transmitido. | |
14 | Uma condição de falta de memória ocorreu ao salvar a mensagem. | Não há memória suficiente disponível para que a Exceção de Envio de Resposta processe a mensagem. O espaço de endereço atual está fora do armazenamento privado. | |
16 | Um ou mais parâmetros não são válidos. | Verifique se todos os parâmetros são válidos e tente a chamada novamente. | |
18 | O comprimento da resposta excede os limites do sistema. | O tamanho da mensagem é maior que o tamanho que o WebSphere Application Server pode suportar. Verifique se o tamanho é válido. Se o tamanho for válido, certifique-se de que o tamanho do WebSphere Application Server seja grande o suficiente para acomodar o tamanho de mensagem. | |
20 | Um ou mais parâmetros não são válidos. | Verifique se todos os parâmetros são válidos e tente a chamada novamente. | |
28 | O registro com o qual o identificador de conexão está associado não está mais ativo. | Chame o registro com o nome de registro novamente antes de fazer as chamadas de obtenção de conexão e enviar pedido. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido está em um estado incorreto. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido não é válido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
102 | O início do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
104 | O término do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
12 | 10 | Não é possível localizar o servidor ou grupo de daemons do WebSphere Application Server. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Pedido Qualquer de Recebimento
Receba uma solicitação de um WebSphere Application Server local em qualquer conexão. Receber um pedido e dados relacionados em qualquer conexão disponível no conjunto para o nome de registro transmitido. Retorna o comprimento de dados de pedido como um parâmetro de saída. Um identificador de conexão também é um parâmetro de saída retornado para o responsável pela chamada. Uma chamada de API Obter Dados com o identificador de conexão retornado retorna os dados de mensagem recebidos.
API | Sintaxe |
---|---|
BBOA1RCA ou BBGA1RCA | BBOA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) BBGA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) |
Parâmetros:
registername (entrada)Uma variável de entrada ou uma constante de entrada contendo o nome a ser usado para localizar o conjunto de conexões a partir do qual uma conexão deve ser recuperada. Este deve ser uma cadeia preenchida com espaços em branco com exatamente 12 caracteres.
connectionhandle (saída)U m identificador de conexão de 12 bytes que deve ser retornado e que deve ser passado nas solicitações posteriores para as ações nessa conexão.
requestservicename (entrada/saída)Uma cadeia de caracteres EBCDIC de até 256 bytes contendo o nome do serviço. Esse é o nome do serviço de destino especificado em InteractionSpec pelo aplicativo WebSphere Application Server. Um valor * indica uma solicitação de recebimento para todos os nomes de serviço que chegam no nome de registro atual.
requestservicenamel (entrada/saída)Um número inteiro contendo o comprimento do nome de serviço para iniciar ou 0 se o nome de serviço for terminado em nulo.
requestdatalen (saída)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits é retornado contendo o comprimento dos dados a serem recebidos.
waittime (entrada)Um número inteiro contendo o número de segundos a ser aguardado pela conclusão da conexão antes de retornar um código de razão indisponível de conexão. Um valor de 0 indica que não há nenhum tempo de espera e que a API aguarda indefinidamente.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar esta API.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
11 | Dados inválidos foram enviados do WebSphere Application Server | ||
16 | O comprimento do nome de serviço do pedido não é válido. | Corrija o programa e tente a chamada novamente. | |
19 | Falha de dados existentes de comunicação local | ||
21 | Falha de dados de visualização de comunicação local | ||
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido foi declarado inválido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
76 | Uma tentativa de se comunicar com o servidor falhou porque o servidor não está mais em execução. | Inicie o servidor e tente a comunicação novamente. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server estejam iniciados e de que o suporte a conexões locais esteja ativo e tente a chamada novamente. |
24 | Depois de uma chamada de registro com sucesso, ocorreu um erro ao obter uma conexão a partir do conjunto. | Verifique se o servidor foi iniciado. Se o servidor não estiver iniciado, reinicie o servidor e tente a solicitação de API novamente. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
44 | Construção de CP inválida para a chamada de serviço | ||
46 | Obtenção de CP inválida para a célula de serviço | ||
48 | Liberação de CP inválida para a célula de serviço | ||
60 | Não é possível obter o bloqueio SRVQ | ||
62 | Não é possível desbloquear o bloqueio SRVQ | ||
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Pedido Específico de Recebimento
Receba uma solicitação de um WebSphere Application Server local em uma conexão específica. Receba um pedido e dados relacionados para o identificador de conexão de entrada fornecido. Retorna o comprimento de dados de pedido. Uma chamada de API Obter Dados com o identificador de conexão retornado retorna os dados de mensagem recebidos.API | Sintaxe |
---|---|
BBOA1RCS ou BBGA1RCS | BBOA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) BBGA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Identificador de conexão de 12 bytes que deve ser usado para a solicitação de recebimento.
requestservicename (entrada/saída)Uma cadeia de caracteres EBCDIC de até 256 bytes contendo o nome do serviço. Esse é o nome do serviço de destino especificado em InteractionSpec pelo aplicativo WebSphere Application Server. Um valor * indica essa configuração como um servidor para todos os nomes de serviço que chegam no nome de registro atual.
requestservicenamel (entrada/saída)Um número inteiro contendo o comprimento do nome de serviço para iniciar ou 0 se o nome de serviço for terminado em nulo.
requestdatalen (saída)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits é retornado contendo o comprimento dos dados da solicitação recebidos. Este comprimento pode ser usado pelo responsável pela chamada para adquirir armazenamento antes de chamar a API Obter Dados para copiar nele. Quando async for configurado para 1, indicando que o responsável pela chamada quer o controle de volta imediatamente, isso poderá ser configurado para todos os 0xFFs se os dados da solicitação ainda não forem recebidos. Neste caso, a API deverá ser chamada novamente para recuperar um pedido de entrada.
async(0|1) (entrada)Um valor de número inteiro que quando configurado como 1 indica que o responsável pela chamada quer o controle de volta imediatamente, mesmo que o comprimento da solicitação ainda não seja conhecido. Quando async for configurado para 0, essa chamada aguarda por uma solicitação a partir do WebSphere Application Server a ser recebida.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Certifique-se de que uma chamada de registro com sucesso (API BBOA1REG) esteja concluída no espaço de endereço atual com um nome correspondente antes de usar esta API.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
10 | O identificador de conexão está em um estado liberado ou em um estado impróprio. | Certifique-se de que um identificador de conexões válido seja passado. | |
11 | Dados inválidos foram enviados do WebSphere Application Server | ||
16 | O comprimento do nome de serviço do pedido não é válido. | Corrija o programa e tente a chamada novamente. | |
19 | Falha de dados existentes de comunicação local | ||
21 | Falha de dados de visualização de comunicação local | ||
28 | O registro com o qual o identificador de conexão está associado não está mais ativo. | Chame o nome do registro novamente antes de chamar um pedido de obtenção de conexão ou de recebimento específico. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido está em um estado incorreto. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido não é válido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
76 | Uma tentativa de se comunicar com o servidor falhou porque o servidor não está mais em execução. | Inicie o servidor e tente a comunicação novamente. | |
78 | Ocorreu um erro interno que fez a conexão selecionar um pedido que não fazia parte da transação que está sendo processada por esta conexão. | Retorne a conexão ao conjunto de conexões. Se o problema persistir, entre em contato com o Suporte IBM. | |
80 | A transação que está ativa nesta conexão expirou e o estado da conexão não pôde ser configurado para que outro pedido seja processado. | Retorne a conexão ao conjunto de conexões. Se o problema persistir, entre em contato com o Suporte IBM. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
44 | Construção de CP inválida para a célula de serviço | ||
46 | Obtenção de CP inválida para a chamada de serviço | ||
48 | Liberação de CP inválida para a célula de serviço | ||
60 | Não é possível obter o bloqueio SRVQ | ||
62 | Não é possível desbloquear o bloqueio SRVQ | ||
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Comprimento da Resposta de Recebimento
O comprimento da resposta de recebimento é usado para recuperar o comprimento dos dados de resposta a partir de uma chamada de pedido de envio anterior.API | Sintaxe |
---|---|
BBOA1RCL ou BBGA1RCL | BBOA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) BBGA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexão de 12 bytes que deve ser usado para essa solicitação.
async (entrada)Um valor de número inteiro que quando configurado como 1 indica que o responsável pela chamada quer o controle de volta imediatamente, mesmo que o comprimento da resposta ainda não seja conhecido. Quando async é configurado para 0, essa chamada aguarda a resposta ser retornada a partir do WebSphere Application Server e fornece o comprimento da resposta no valor de parâmetro responsedatalen.
responsedatalen (saída)Um valor sem sinal de 32 bits no modo de 31 bits e um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados recebido é retornado. Este comprimento pode ser usado pelo responsável pela chamada para adquirir armazenamento antes de chamar a API Obter Dados para copiar nele. Se async for 1, isso pode ser retornado como todos os FFs se os dados de resposta ainda não forem recebidos.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar esta API.
- Assegure que uma chamada de Obtenção de Conexão bem-sucedida (API BBOA1CNG ou BBGA1CNG) seja concluída e que a manipulação seja fornecida como entrada nesta chamada.
- Assegure que uma chamada de Envio de Solicitação bem-sucedida (API BBOA1SRQ ou BBGA1SRQ) foi concluída antes de fazer esta chamada.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
11 | Dados inválidos foram enviados do WebSphere Application Server. | ||
19 | Falha de dados existentes de comunicação local | ||
21 | Falha de dados de visualização de comunicação local | ||
34 | O serviço de destino não foi localizado. | Certifique-se de que o aplicativo contendo o enterprise bean de destino esteja instalado e iniciado no WebSphere Application Server de destino. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido foi determinado como estando no estado errado. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido foi declarado inválido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Obter Dados da Mensagem
Esta API é usada para copiar os dados de mensagem recebidos. No retorno desta chamada, a mensagem é removida do cache de mensagem do adaptador.API | Sintaxe |
---|---|
BBOA1GET ou BBGA1GET | BBOA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) BBGA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) |
Parâmetros:
connectionhandle (entrada)Um identificador de conexão de 12 bytes que deve ser usado para essa solicitação.
msgdata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início da área de dados no qual copiar. O armazenamento para o qual isso se aponta deve estar em uma chave que seja gravável pelo responsável pela chamada.
msgdatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados a serem copiados.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
rv (saída)Um valor de retorno de número inteiro de 32 bits contendo o tamanho do buffer de contexto para essa solicitação.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar a API Enviar Solicitação.
- Assegure que uma chamada de obtenção de conexão bem-sucedida (API BBOA1CNG ou BBGA1CNG) seja concluída e a manipulação seja fornecida como entrada nesta chamada.
- Se o parâmetro msgdatalen de entrada do responsável pela chamada de API for maior que a resposta de mensagem real, o código de retorno contém um 0 e o comprimento de mensagem real é fornecido para o valor de retorno.
- Importante: Quando a chamada para obter os dados da mensagem retornar para o responsável pela chamada, os dados da mensagem não persistirão e a conexão voltará para um estado em que ela possa ser usada para outra chamada de pedido de envio ou de recebimento. Uma chamada subsequente para obter os dados de mensagem ou para receber o comprimento de resposta será retornado com um erro.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido foi determinado como estando no estado errado. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido foi declarado inválido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
48 | Ocorreu um erro no pedido de leitura de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
50 | A conexão com o WebSphere Application Server foi encerrada. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
72 | O parâmetro de entrada do comprimento de resposta não é grande o suficiente para conter a mensagem de resposta. | Apenas uma parte da mensagem será retornada. O restante será descartado. Consulte o valor de retorno para o tamanho da resposta de mensagem. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
98 | O início do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
100 | O término do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
102 | O início do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
104 | O término do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente novamente. |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server estejam iniciados e de que o suporte à conexão local esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Chamar
Essa API usa outras funções de API primitiva subjacentes para chamar um método em um WebSphere Application Server local. Ele foi designado para ser usado em situações em que o tamanho máximo da área de saída da resposta é conhecido previamente.API | Sintaxe |
---|---|
BBOA1INV ou BBGA1INV | BBOA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) BBGA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) |
Parâmetros:
registername (entrada)Uma variável de entrada ou uma constante de entrada contendo o nome a ser usado para localizar o conjunto de conexões para recuperar uma conexão para essa chamada. Este deve ser uma cadeia preenchida com espaços em branco com exatamente 12 caracteres.
requesttype (entrada)Um número inteiro contendo o tipo de solicitação que indica o tipo de solicitação de serviço a ser processado. Valores de tipo suportados: 1 = solicitações de serviço EJB locais, 2 = Solicitações de serviço EJB remotas.
requestservicename (entrada)Uma sequência de caracteres EBCDIC de até 256 bytes de comprimento contendo o nome do serviço a ser chamado. Para EJB Tipo=1, este é o nome de Início de JNDI para o destino.
requestservicenamel (entrada)Um número inteiro contendo o comprimento do nome de serviço para iniciar ou 0 se o nome de serviço for terminado em nulo.
requestdata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início dos dados da solicitação a serem enviados.
requestdatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados a serem enviados.
responsedata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início da área de dados de resposta na qual copiar. O armazenamento para o qual isso se aponta deve estar em uma chave que seja gravável pelo responsável pela chamada.
responsedatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento dos dados a serem enviados.
waittime (entrada)Um número inteiro contendo o número de segundos a ser aguardado pela conclusão da conexão antes de retornar um código de razão indisponível de conexão. Um valor 0 (zero) indica que não há nenhum tempo limite e que a API aguarda indefinidamente.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
rv (saída)Um valor de retorno de número inteiro de 32 bits contendo o tamanho dos dados de mensagem que foram recebidos e copiados para a área do responsável pela chamada.
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar a API Enviar Solicitação.
- Se o parâmetro responsedatalen de entrada do responsável pela chamada de API for maior que a resposta de mensagem real, o código de retorno contém um 0 (zero) e o comprimento de mensagem real é fornecido para o valor de retorno.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
10 | A conexão está indisponível. O tempo de espera expirou antes que a solicitação de conexão pudesse ser obtida. | O comportamento do aplicativo varia. Aguarde e tente novamente ou aceite esta chamada de API Chamar. Outra opção é aumentar a configuração do máximo de conexões na chamada de API Registro. | |
11 | Dados inválidos foram enviados do WebSphere Application Server. | ||
14 | Uma condição de falta de memória ocorreu ao salvar a mensagem. | Não há memória suficiente disponível para invocar o processamento da mensagem. O espaço de endereço atual está fora do armazenamento privado. | |
16 | O comprimento do nome de serviço do pedido não é válido. | Corrija o programa e tente a chamada novamente. | |
18 | A duração da resposta excede os limites do sistema. | O tamanho da mensagem é maior que o tamanho que o WebSphere Application Server pode suportar. Verifique se o tamanho é válido. Se o tamanho for válido, certifique-se de que o tamanho do WebSphere Application Server seja grande o suficiente para acomodar o tamanho de mensagem. | |
19 | Falha de dados existentes de comunicação local. | ||
21 | Falha de dados de visualização de comunicação local. | ||
24 | Depois de uma chamada de registro com sucesso, ocorreu um erro ao obter uma conexão a partir do conjunto. | Verifique se o servidor foi iniciado. Se ele não estiver funcionando, reinicie o servidor e tente a solicitação de API novamente. | |
26 | A transação global não pôde ser iniciada. | ||
28 | O registro foi localizado, mas está inativo. | ||
32 | O tipo de pedido na chamada da API não é válido. | O parâmetro do tipo de pedido não é válido. Corrija o programa e tente a chamada novamente. | |
34 | O serviço de destino não foi localizado. | Certifique-se de que o aplicativo contendo o enterprise bean de destino esteja instalado e iniciado no WebSphere Application Server de destino. | |
36 | O estado da conexão não é válido. | O identificador de conexão usado para este pedido foi determinado como estando no estado errado. Consulte a documentação da API para obter as regras sobre os estados de conexão. | |
38 | O identificador de conexão do cliente não é válido. | O identificador de conexão do cliente usado para este pedido foi declarado inválido. Consulte a documentação da API para obter informações sobre os identificadores de conexão do cliente. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
44 | Uma exceção ou condição inesperada ocorreu no enterprise bean de destino. | Consulte os logs do WebSphere Application Server para revisar os dados de exceção. | |
46 | Ocorreu um erro no pedido de envio de comunicação local. | Consulte os logs do WebSphere Application Server para determinar o erro. | |
48 | Ocorreu um erro no pedido de leitura de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
50 | A conexão com o WebSphere Application Server foi encerrada. | Verifique o WebSphere Application Server para determinar o erro. | |
72 | O parâmetro de entrada do comprimento de resposta não é grande o suficiente para conter a mensagem de resposta. | Apenas uma parte da mensagem será retornada. O restante será descartado. Consulte o valor de retorno para o tamanho da resposta de mensagem. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
98 | O início do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
100 | O término do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
102 | O início do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
104 | O término do buffer de resposta fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de resposta fornecido estejam corretos. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente a chamada novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | O identificador de conexão não é válido ou uma chamada de cancelamento de registro (API BBOA1URG) pode ter invalidado o conjunto de conexões. | |
24 | Depois de uma chamada de registro com sucesso, ocorreu um erro ao obter uma conexão a partir do conjunto de conexões. | Verifique se o servidor foi iniciado. Se ele não estiver iniciado, reinicie o servidor e tente a solicitação de API novamente. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
Serviço de Host
Serviço de Host para um WebSphere Application Server local. Essa API usa outras funções de API primitiva subjacentes para configurar um programa z/OS de idioma nativo como um servidor e um destino para chamadas do adaptador local otimizado de um WebSphere Application Server local. Ele foi designado para ser usado em situações em que o tamanho máximo da área de saída do pedido é conhecido previamente.API | Sintaxe |
---|---|
BBOA1SRV ou BBGA1SRV | BBOA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) BBGA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) |
Parâmetros:
registername (entrada)Uma variável de entrada ou uma constante de entrada contendo o nome a ser usado para localizar o conjunto de conexões a partir do qual uma conexão será recuperada para essa chamada. Este deve ser uma cadeia preenchida com espaços em branco com exatamente 12 caracteres.
requestservicename (entrada/saída)Uma cadeia de caracteres EBCDIC de até 256 bytes contendo o nome do serviço. Esse é o nome do serviço de destino especificado em InteractionSpec pelo aplicativo WebSphere Application Server. Um valor * indica essa configuração como um servidor para todos os nomes de serviço que chegam no nome de registro atual.
requestservicenamel (entrada/saída)Um número inteiro contendo o comprimento do nome de serviço para iniciar ou 0 se o nome de serviço for terminado em nulo.
requestdata (entrada)Um ponteiro de 31 bits ou 64 bits para o endereço do início dos dados da solicitação recebidos. O armazenamento para o qual isso se aponta deve estar em uma chave que seja gravável pelo responsável pela chamada.
requestdatalen (entrada)Um valor sem sinal de 32 bits no modo de 31 bits ou um valor sem sinal de 64 bits no modo de 64 bits contendo o comprimento da área de dados de dados na qual receber a mensagem.
connectionhandle (saída)Um identificador de conexão de 12 bytes que é retornado para o responsável pela chamada e usado para enviar uma resposta para este pedido.
waittime (entrada)Um número inteiro contendo o número de segundos a ser aguardado pela conclusão da conexão antes de retornar um código de razão indisponível de conexão. Um valor 0 (zero) indica que não há nenhum tempo limite e que a API aguarda indefinidamente.
rc (saída)Um código de retorno de número inteiro indicando sucesso ou falha desta chamada.
rsn (saída)Um código de razão de número inteiro que descreve a razão de uma falha nesta chamada.
rv (saída)Um valor de retorno de número inteiro de 32 bits contendo o tamanho dos dados do pedido de mensagem que foram recebidos e copiados para a área do responsável pela chamada.
Observações de Uso
- Certifique-se de que o servidor ou grupo de daemons do WebSphere Application Server para z/OS especificados nessa chamada estejam iniciados e o suporte para adaptadores locais esteja ativado.
- Assegure que uma chamada de registro bem-sucedida (API BBOA1REG ou BBGA1REG) foi concluída no espaço de endereço atual com um nome correspondente antes de usar esta API.
- Se o parâmetro requestdatalen de entrada do responsável pela chamada de API for maior que a resposta de mensagem real, o código de retorno conterá um 0 (zero) e o comprimento de mensagem real é fornecido para o valor de retorno.
- A manipulação de conexões retornada deve ser fornecida em qualquer resposta para esta chamada de Host usando a API BBOA1SRP ou BBGA1SRP. Uma chamada de BBOA1SRV ou BBGA1SRVAPI subsequente reutiliza a mesma manipulação de conexões. Caso positivo, a API assume que não há nenhuma resposta para a solicitação anterior.
- Importante: Quando a chamada Serviço de Host retornar para o responsável pela chamada, os dados da mensagem não persistirão e a conexão voltará para um estado em que ela possa ser usada para outro pedido de API.
Código de Retorno | Código de Razão | Descrição | Ação |
---|---|---|---|
0 | - | Êxito | |
4 | - | Aviso - consulte o código de razão | |
8 | - | Erro - consulte o código de razão | |
8 | O token do nome de registro já existe. | Certifique-se de que o nome do registro transmitido seja válido. | |
10 | O identificador de conexão está em um estado liberado. | Certifique-se de que um identificador de conexões correto seja transmitido. | |
12 | O identificador de conexão não está na conexão que está no nome de registro. | Corrija o programa e tente a chamada novamente. | |
16 | O comprimento do nome de serviço do pedido não é válido. | Corrija o programa e tente a chamada novamente. | |
18 | O comprimento da resposta excede os limites do sistema. | O tamanho da mensagem é maior que o tamanho que o WebSphere Application Server pode suportar. Verifique se o tamanho é válido. Se o tamanho for válido, certifique-se de que o tamanho do WebSphere Application Server seja grande o suficiente para acomodar o tamanho de mensagem. | |
40 | Ocorreu um erro de comunicação local. | Verifique o log do servidor WebSphere Application Server para conhecer quaisquer mensagens de erro de comunicação local. | |
46 | Ocorreu um erro na chamada de pedido de envio de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
48 | Ocorreu um erro no pedido de leitura de comunicação local. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
50 | A conexão com o WebSphere Application Server foi encerrada. | Verifique os logs do WebSphere Application Server para determinar o erro. | |
72 | O parâmetro de entrada do comprimento de resposta não é grande o suficiente para conter a mensagem de resposta. | Apenas uma parte da mensagem será retornada. O restante será descartado. Consulte o valor de retorno para o tamanho da resposta de mensagem. | |
76 | Uma tentativa de se comunicar com o servidor falhou porque o servidor não está mais em execução. | Inicie o servidor e tente a comunicação novamente. | |
96 | Essa API não pode ser direcionada durante a inicialização do IMS ou durante uma saída de pré-inicialização do IMS. | Chame essa API após a inicialização do IMS ser concluída. | |
98 | O início do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
100 | O término do buffer de solicitação fornecido não pôde ser acessado. | Assegure que o endereço e o comprimento do buffer de solicitação fornecidos estejam corretos. | |
12 | 10 | O servidor ou grupo de daemons do WebSphere Application Server não pode ser localizado. | Certifique-se de que o servidor e o daemon do WebSphere Application Server sejam iniciados e de que o suporte às conexões locais esteja ativo e tente novamente. |
14 | O vetor de chamada da API que usa o identificador de conexão fornecido não pode ser localizado ou verificado. | A manipulação de conexões não é válida ou uma chamada de cancelamento de registro (API BBOA1URG ou BBGA1URG) pode ter invalidado o conjunto de conexões. | |
34 | Um stub da API de 64 bits foi usado em um ambiente do IMS. | As APIs de 64 bits não são suportadas no IMS. | |
38 | Um stub de API de 64 bits foi usado em um ambiente CICS. | As APIs de 64 bits não são suportadas no CICS. | |
44 | Construção de CP inválida para a célula de serviço. | ||
46 | Obtenção de CP inválida para a célula de serviço. | ||
48 | Liberação de CP inválida para a célula de serviço. | ||
60 | Não é possível obter o bloqueio SRVQ. | ||
62 | Não é possível desbloquear o bloqueio SRVQ. | ||
86 | O BGVT principal do WebSphere Application Server para z/OS não pôde ser localizado | O WebSphere não foi iniciado ainda na imagem do sistema z/OS atual. Assegure que o daemon e um nó/servidor seja iniciado antes de iniciar quaisquer processos do cliente de adaptadores locais otimizados do WebSphere Application Server. | |
88 | A tabela de stub de cliente principal do WebSphere Application Server para z/OS não pôde ser localizada. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. | |
90 | O intervalo da tabela de stub de cliente principal dos adaptadores locais otimizados do WebSphere Application Server para z/OS não pôde ser localizado. | Um WebSphere Application Server foi iniciado na imagem do sistema z/OS atual, mas não está em execução no nível no qual a tabela de stub de cliente dos adaptadores locais otimizados é suportada. Possivelmente você está executando com uma interface de stub de adaptadores locais otimizados do WebSphere Application Server Versão 8.0.0.1 que não é compatível com o nível de manutenção do servidor de aplicativos. Para usar os stubs de adaptadores locais otimizados da V8.0.0.1, o servidor de aplicativos também deve estar em execução no nível do WebSphere Application Server Versão 8.0.0. Assegure que seu aplicativo esteja em execução com o nível dos stubs de adaptadores locais otimizados que são compatíveis com o WebSphere Application Server neste sistema z/OS. |
APIs do Adaptador JCA
- ConnectionSpec
- InteractionSpec
- E/S de Registro
A API ConnectionSpec é usada para indicar o nome do registro com o qual se comunicará. O nome do registro é criado quando a API de Registro for usada. Isso também identifica qual subsistema será conectado. Um subsistema pode ter mais de um nome de registro.
O nome do ID de transação do Link do Programa pode ser transmitido do WebSphere Application Server para o CICS, além de ser usado para executar a tarefa de chamada do Link do Programa. Ele deve ter 4 caracteres e ser definido na região CICS. Você deve configurá-lo com os mesmos atributos e o nome de programa como a transação BBO# (programa: BBOACLNK). Quando esse ID de transação é transmitido usando o método setLinkTaskTranid, ele substitui a API BBO# e qualquer ID de transação que foi especificado usando BBOC com o parâmetro LTX=xxx.
É possível usar o método setUseCICSContainer ou a interface JCA MappedRecord para enviar aplicativos ao CICS usando canais e contêineres.
- O método setUseCICSContainer é fornecido no ConnectionSpecImpl.
Quando ele for configurado como 1, o nome e tipo de um contêiner CICS de pedido de mensagem poderá ser transmitido para o CICS usando os métodos setLinkTaskReqContid()
e setLinkTaskReqContType(0|1), em que 0=CHAR e 1=BIT. Quando o contêiner do
CICS de solicitação de mensagem é passado ao
CICS, o programa de destino tem seus próprios dados de entrada no contêiner denominado, que é criado com o tipo selecionado de BIT ou CAR.
O nome e tipo de um contêiner CICS de resposta de mensagem pode ser transmitido para o CICS usando os métodos setLinkTaskRspContid() e setLinkTaskRspContType(bit|char). Quando isso é transmitido, a resposta do programa de destino deve vir do contêiner denominado com o tipo selecionado de BIT ou CAR.
- A interface JCA MappedRecord pode ser usada para passar um ou mais contêineres ao CICS. Ao usar a interface JCA MappedRecord, o canal denominado é usado para se comunicar com o programa de destino. Se você usar a interface MappedRecord, você deve configurar UseCICSContainer para 1 e o nome e o tipo de um canal CICS deve ser passado ao CICS usando os métodos
setLinkTaskChanID() e setLinkTaskChanType(bit|char).
Evitar Problemas: A interface JCA MappedRecord usada para passar contêineres ao CICS é obtida chamando o método recordFactory.createMappedRecord(), usando recordFactory obtido do objeto de conexão WOLA. Não use o método setLinkTaskReqContId(), setLinkTaskReqContType(), setLinkTaskRspContId() ou SetLinkTaskRspContType() com a interface JCA MappedRecord.gotcha
Para as transações de aplicativo IMS, use o método setOTMAMaxRecvSize(nnn) na Especificação de Conexão para configurar o Tamanho Máximo de Recebimento de Mensagem. Para configurar o valor do nível de conexão de Segmentos Máximos, use o método setOTMAMaxSegments(nnn) na Especificação de Conexão. Para obter mais informações sobre o uso de adaptadores locais otimizados com o IMS sobre OTMA, consulte o tópico Chamando Transações IMS Existentes com Adaptadores Locais Otimizados sobre OTMA.
InteractionSpec
A API InteractionSpec é usada para especificar qual serviço deve ser iniciado pelo destino. Isso depende de qual subsistema ou processo em lote é iniciado. O processo pode escolher receber os pedidos para um serviço específico ou para qualquer serviço. Para o CICS, o nome de serviço é o nome do programa a ser iniciado no CICS.
E/S de Registro
Os aplicativos podem enviar e receber dados do adaptador usando a interface de registro JCA. Esta API do adaptador sugere usar a interface de registro indexada para permitir que o responsável pela chamada transmita uma ou mais estruturas de dados, incluindo copybooks Cobol e estruturas C, para o espaço de endereço externo. Cada índice na lista é usada como um copybook separado e transmitido para o destino nessa ordem.
Quando usado para aceitar os parâmetros de retorno a partir de uma chamada de função, o IndexedRecordImpl poderá ser predefinido para aceitar um número determinado de parâmetros e os nomes de classes gerados pelas ferramentas de montagem para os copybooks e estruturas individuais podem ser fornecidos. O IndexedRecordImpl aumenta os copybooks e estruturas serializados e configura-os no IndexedRecordImpl, para que eles possam ser recuperados e usados sem lidar com as representações byte[] serializadas.
Para ter uma ideia geral de como essa API funciona, apenas os métodos selecionados são mostrados. Todos os métodos na interface são implementados.