Configura o uso da Fila usando a infra estrutura da AWS SQS para mantê-la e permite a configuração dos parâmetros de temporização de tratamento e de manutenção das mensagens.
Obs. Esta funcionalidade só está disponível em Linux, pra Windows use TQueueSvc:Setup
nRet := oTQLS:SetupSQS(cRegiao, cCred, cCredKey [, nMsgRetPeriod] [, nVisibTimeOut]) |
Nome | Tipo | Descrição | Obrigatório | Default | Referência | Observações |
---|---|---|---|---|---|---|
cRegiao | caractere | Define a região onde a fila será criada | X | Ex. SA-EAST-1 (South America (Sao Paulo)) http://docs.aws.amazon.com/pt_br/general/latest/gr/rande.html | ||
cCred | caractere | Credencial para acessar os serviços de Fila | X | |||
cCredKey | caractere | Chave da credencial de acesso à Fila | X | |||
nMsgRetPeriod | numérico | Tempo de retenção de uma mensagem na Lista em segundos (Tempo de armazenamento de Mensagem não tratada) | 1209600 (14 dias) | Se uma mensagem não retirada da fila ficar mais que este tempo, ela será descartada. Mínimo permitido 60 segundos, máximo permitido 14 dias (1209600 segundos). | ||
nVisibTimeOut | numérico | Tempo de espera de tratamento de mensagem em segundos (Tempo de tratamento da Mensagem) | 45 | Se a mensagem retirada na Fila não for tratada e removida até este tempo, ela será colocada na Fila novamente para tratamento. Mínimo permitido 5 segundos, máximo permitido 12 horas (43200 segundos). |
Nome | Tipo | Descrição | Observações |
---|---|---|---|
nRet | numérico | Contém a indicação do erro ou 0 (zero) se OK |
Abaixo listado alguns erros no nRet.
Retorno | Descrição |
---|---|
-2 | Parâmetros inválidos. |
-3 | Objeto não criado / Erro de setup. |
-8 | Atributos de mensagem inválidos. |
-9 | Erro ao obter atributos da fila. |
-10 | Erro ao atualizar atributos da fila. |
-16 | Mensagem vazia, sem corpo. |
-18 | Falha ao deletar uma mensagem da fila. |
-19 | Falha ao remover uma fila. |
-21 | Falha na execução do setup. |
-100 | Não existe mensagens na fila. |
nMsgRetPeriod
não for informado (Nil
) ou se tiver valor igual a 0
(zero), nMsgRetPeriod
usará o valor default, todavia se nMsgRetPeriod
for passado como -1
, a fila irá recuperar o valor de nMsgRetPeriod
de uma fila previamente criada, não alterando assim o valor já registrado nesta fila. nVisibTimeOut
não for informado (Nil
) ou se tiver valor igual a 0 (zero), nVisibTimeOut
usará o valor default, todavia se nVisibTimeOut
for passado como -1
, irá recuperar o valor de nVisibTimeOut
de uma fila previamente criada, não alterando assim o valor já registrado nesta fila. nMsgRetPeriod
e/ou nVisibTimeOut
forem passado como -1
, os valores recuperados serão os valores padrão para criação de Filas da SQS.
|