dsmUpdateObjEx

Editar on-line

A chamada de função dsmUpdateObjEx atualiza as meta informações associadas a um objeto de backup ou de archive ativo que está no servidor. Os dados de bit do aplicativo não serão afetados. Para atualizar um objeto, você deve especificar um nome sem curinga ou especificar o ID de objeto para atualizar um objeto arquivado específico. Não é possível utilizar caracteres curinga ao especificar o nome. Para atualizar um objeto de backup, configure o parâmetro dsmSendType para stBackup. Para atualizar um objeto arquivado, configure o parâmetro dsmSendType para stArchive.

A chamada dsmUpdateObjEx pode ser iniciada apenas no estado de sessão; ela não pode ser chamada dentro de uma transação porque desempenha sua própria transação. É possível atualizar apenas um objeto por vez.

Restrição: Em um sistema operacional UNIX ou Linux® , se você alterar o campo proprietário, não será possível consultar ou restaurar o objeto, a menos que você seja o usuário root. Apenas a versão ativa atual de um objeto de backup pode ser atualizada.

Sintaxe

dsInt16_t  dsmUpdateObjEx
   (dsmUpdateObjExIn_t   *dsmUpdateObjExInP,
    dsmUpdateObjExOut_t  *dsmUpdateObjExOutP);

Parâmetros

dsmUpdateObjExIn_t *dsmUpdateObjExInP

Essa estrutura contém os seguintes parâmetros de entrada:

dsUint16_t stVersion (I)

A versão atual da estrutura que é utilizada.

dsUint32_t dsmHandle (I)

A alça que associa esta chamada com uma chamada anterior dsmInitEx .

dsmSendType sendType (I)

O tipo de envio que está sendo desempenhado. O valor pode ser:

stBackup: Um objeto de backup que é enviado ao servidor.
stArchive: Um objeto de archive que é enviado ao servidor.

dsmObjName *objNameP (I)

Um ponteiro para a estrutura que contém o nome do espaço no arquivo, o nome do objeto de alto nível, o nome do objeto de nível inferior e o tipo de objeto. Você não pode utilizar um curinga.

ObjAttr *objAttrPtr (I)

Transmite atributos do objeto ao aplicativo. Os valores que são atualizados dependem dos sinalizadores no campo objUpdAct. O atributo objCompressed é ignorado para esta chamada.

Os atributos são:

owner altera o proprietário se um novo nome for digitado.
sizeEstimate é a quantidade real de dados enviados em bytes. O valor é armazenado nos metadados IBM® Storage Protect para uso futuro.
objCompressed é um valor booleano que indica se os dados do objeto já foram compactados ou não.
objInfo é um atributo que contém as novas informações a serem colocadas no campo objInfo. Configure objInfoLength para o comprimento do novo objInfo.
mcNameP contém o nome de uma classe de gerência que substitui a classe de gerência que é obtida a partir de dsmBindMC.

dsUint32_t objUpdAct

Especifica as máscaras de bits e as ações para objUpdAct:

DSM_BACKUPD_MC: Atualiza a classe de gerenciamento para o objeto.
DSM_BACKUPD_OBJINFO: Atualiza o objeto de informações (objInfo), o comprimento do objeto de informações (objInfoLength) e a quantidade de dados enviados (sizeEstimate) para o objeto de backup.
DSM_BACKUPD_OWNER: Atualiza o proprietário para o objeto de backup.
DSM_ARCHUPD_DESCR: Atualiza o campo Description para o objeto de arquivo. Digite o valor para a nova descrição através do parâmetro sendBuff.
DSM_ARCHUPD_OBJINFO: Atualiza o objeto de informações (objInfo), o comprimento do objeto de informações (objInfoLength) e a quantidade de dados enviados (sizeEstimate) para o objeto de archive.
DSM_ARCHUPD_OWNER: Atualiza o proprietário do objeto de archive.

ObjID archObjId

Especifica o ID de objeto exclusivo para um objeto de archive específico. Como vários objetos de archive podem ter o mesmo nome, este parâmetro identifica um específico. O ID de objeto pode ser obtido utilizando-se uma chamada de archive de consulta.

dsmUpdateObjExOut_t *dsmUpdateObjExOutP

Esta estrutura contém o parâmetro de saída:

dsUint16_t stVersion (I): A versão atual da estrutura que é utilizada.

Códigos de retorno

Os números do código de retorno são fornecidos entre parênteses ( ) na tabela a seguir.

Tabela 1. Códigos de Retorno para dsmUpdateObjEx
Código de retorno	Explicação
DSM_RC_INVALID_ACTION (2012)	Ação inválida.
DSM_RC_FS_NOT_REGISTERED (2061)	O espaço no arquivo não está registrado.
DSM_RC_BAD_CALL_SEQUENCE (2041)	A sequência de chamadas é inválida.
DSM_RC_WILDCHAR_NOTALLOWED (2050)	caracteres curingas não são permitidos.
DSM_RC_ABORT_NO_MATCH (2)	A consulta anterior não corresponde.