Los servicios de gestión son los servicios que permiten gestionar los recursos de almacenamiento. Por ejemplo, puede usar un servicio de gestión para introducir un volumen, expulsar un volumen y conectar o desconectar un volumen.
Estos servicios necesitan comunicarse con el componente mecánico de la solución, y el tiempo de respuesta depende del tipo de operación y de las latencias mecánicas. Los servicios de gestión se implementan como una llamada asíncrona. Un servicio de gestión es asíncrono dado que regresa antes de haber ejecutado el trabajo.
La finalización de la operación devuelve un programa o ID de trabajo al que el servicio de llamadas debe llamar para obtener los resultados cuando estén disponibles.
Cuando regresa el servicio asíncrono, proporciona un ID de trabajo como parte de la respuesta. Los códigos de retorno son:
0 (la llamada de servicio web asociada al ID de trabajo ha finalizado).
1 (la llamada de servicio web asociada al ID de trabajo todavía está en curso).
-1 (no se encontró una llamada de servicio web con el ID de trabajo en el sistema).
El programador que implementa el cliente de servicios web debe llamar periódicamente al servicio web getJobStatus pasándole el ID de trabajo para obtener el estado del trabajo.
Una vez que getJobStatus devuelve un "0", llame al servicio web getJobResult para obtener el resultado del servicio.
Cada uno de los servicios web asíncronos puede demorar un tiempo diferente en finalizar. Se produce un timeout de backend si se presenta una falla mecánica. En esta guía, se proporcionan pautas sobre el tiempo máximo recomendado de espera del cliente de servicios web de terceros antes de agotarse.
Consulte "Servicios de estado" para obtener información sobre getJobStatus y getJobResult.
Para gestionar volúmenes con LTFS-LE, debe asignar los volúmenes a la aplicación de LTFS-LE.
Cuando asigna un volumen a LTFS-LE, se pone automáticamente en línea y se agrega a la agrupación de volúmenes predeterminada. Cuando se asigna un volumen sin formato, el volumen se formatea automáticamente para usarlo con LTFS-LE.
assignVolume(String[] volsers)
Condiciones previas:
Compruebe que haya disponible una unidad compatible y que el volumen esté fuera de línea, no esté asignado, no pertenezca a una agrupación y que esté disponible antes de asignar el volumen. Los volúmenes deben estar en la biblioteca.
Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Asegúrese de que el volumen está en uno de los estados requeridos y, de ser necesario, tome la medida correctiva antes de continuar.
Servicio web de LTFS-LE que se debe llamar:
assignVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen se asigna ahora al software de LTFS-LE. Si el volumen no tiene el formato de LTFS, adquirirá este formato de manera automática.
volsers son los números de serie de volumen de los volúmenes que deben asignarse. Los parámetros de entrada son una matriz de cadenas y permiten la asignación de múltiples volúmenes.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no está fuera de línea, sin asignar y eliminado de la agrupación, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen SL0010 es "en uso".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:assignVolume>
<arg0>F50233</arg0>
<arg0>F50234</arg0>
</ns1:assignVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns2:assignVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1220</return>
</ns2:assignVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume SL0010’s assignedStatus is Assigned</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s assignedStatus is Assigned</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta función API expulsa uno o más volúmenes LTFS-LE de la biblioteca.
Si se tiene en cuenta el tamaño del mensaje, LTFS-LE solo admite la expulsión de hasta 30 volúmenes utilizando la ranura de correo (CAP). Las expulsiones se realizan de a cuatro, hasta que se hayan expulsado todos los volúmenes por completo. No hay timeout. Esta es una llamada asíncrona.
ejectVolume(String[] volsers,String acs,String lsm,String cap)
Condición previa:
Compruebe lo siguiente: los volúmenes finalizaron y están fuera de línea antes de la expulsión; hay un CAP disponible y el ACS es similar a la biblioteca configurada. Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Si el volumen está en línea y no se utiliza, finalice el volumen:
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Si el volumen está en línea, desconecte el volumen antes de ejecutar la llamada a la API de expulsión:
offlineVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Cadena del servicio web de LTFS-LE que se debe llamar:
ejectVolume([volser1,volser2,...],acs,lsm,cap) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen se expulsa de la biblioteca. El usuario debe dirigirse a la biblioteca y recuperar el volumen después de abrir la puerta de CAP.
volser es el número de serie de los volúmenes que se expulsarán.
acs es el identificador de ACS de la biblioteca.
lsm es el identificador de LSM de la biblioteca.
cap es el ID de CAP (ranura de correo) de la biblioteca utilizado para expulsar el volumen.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Se devuelve un parámetro nulo si un volser en la matriz de volser están vacíos, o si parte del identificador de CAP (acs, lsm, cap_id) falta o está en uso.
Si el volumen no está fuera de línea, sin asignar y eliminado de la agrupación, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "asignado".
El estado availableStatus del volumen SL0010 es "disponible".
El estado onlineStatus del volumen SL0010 es "en uso".
ACS 0 no es coherente con el acs 7 de la biblioteca.
Esto depende del tiempo necesario para extraer el volumen del CAP (ranura de correo).
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:ejectVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
<arg1>3</arg1>
<arg2>0</arg2>
<arg3>1</arg3>
</ns1:ejectVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401 -wss-wssecurity-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:ejectVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1213</return>
</ns2:ejectVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume SL0010’s onlineStatus is Online</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s onlineStatus is Online</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta es una llamada asíncrona que introduce uno o más volúmenes en la biblioteca utilizando el CAP (ranura de correo).
enterVolume(String acs,String lsm,String cap)
Condición previa:
No hay condición previa específica para introducir un volumen en el CAP. No obstante, el administrador o el servicio deben recopilar el identificador del CAP (acs, lsm y cap_id), y asegurarse de que haya un CAP disponible y que no esté en el medio de una operación (pendiente, expulsar, introducir o auditar) antes de ejecutar este comando.
Cadena del servicio web de LTFS-LE que se debe llamar:
enterVolume(acs,lsm,cap) getJobStatus(jobId) <poll each 10s until status is complete> getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen se introduce a la biblioteca.
acs es el identificador de ACS de la biblioteca.
lsm es el identificador de LSM de la biblioteca.
cap es el ID de CAP (ranura de correo) de la biblioteca utilizado para introducir el volumen.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException.
Si un parámetro está vacío, se devuelve una excepción de nulidad. A continuación se muestran excepciones de ejemplo que se devuelven:
ACS 4 no es coherente con el acs 7 de la biblioteca.
Número de ACS no válido.
Esto depende del tiempo que demora el administrador en introducir el volumen en el CAP.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:enterVolume>
<arg0>3</arg0>
<arg1>0</arg1>
<arg2>1</arg2>
</ns1:enterVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:enterVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1212</return>
</ns2:enterVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text> Invalid ACS number </ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>Invalid ACS number</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Utilice el comando finalizeVolume para ejecutar los cambios en el volumen. Comúnmente, esta acción se realiza antes de desconectar el volumen para expulsarlo de la biblioteca. Finalizar un volumen implica aplicar metadatos no escritos o eliminaciones de archivos no aplicadas al volumen. Esta acción garantiza que las acciones que se realizan en el espacio de nombre global se reflejen en el volumen físico. No finalizar un volumen antes de desconectarlo probablemente pueda demorar su desconexión.
finalizeVolume(String volser)
Condiciones previas:
Compruebe que haya disponible una unidad compatible y que el volumen esté en línea, en una agrupación, inactivo y disponible antes de finalizarlo. Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Asegúrese de que el volumen está en todos los estados requeridos y, de ser necesario, tome la medida correctiva antes de continuar.
Servicio web de LTFS-LE que se debe llamar:
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, las operaciones pendientes que deben aplicarse al volumen se han aplicado a este.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
volser es el número de serie del volumen que debe finalizarse.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no está fuera de línea, sin asignar y eliminado de la agrupación, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "fuera de línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen SL0010 es "en uso".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:finalizeVolume>
<arg0>F50233</arg0>
</ns1:finalizeVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:finalizeVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1219</return>
</ns2:finalizeVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume SL0010’s onlineStatus is Offline</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s onlineStatus is Offline</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Una llamada asíncrona que formatea el volumen para convertirlo en un volumen con formato LTFS. El servicio web de LTFS-LE no requiere la confirmación ni realiza la validación del volumen. Debe conocer el volumen que se formatea y asegurarse de que sea el correcto.
Cuando se formatea un volumen, se eliminan todos los datos previos en el volumen.
formatVolume(String volser)
Condición previa:
Compruebe que el volumen está fuera de línea y asignado, en una agrupación, y disponible antes de formatearlo. Compruebe que exista una unidad compatible disponible.
Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Asegúrese de que el volumen esté en el estado requerido por la condición previa.
Tome las medidas correctivas (de ser necesario) antes de continuar.
Cadena del servicio web de LTFS-LE que se debe llamar:
formatVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen tiene ahora el formato de LTFS-LE.
volser es el número de serie del volumen al que se le dará formato de LTFS.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
En la lista que aparece a continuación se muestran excepciones de ejemplo que se devuelven:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen EL0010 es "en línea".
El estado onlineStatus del volumen EL0010 es "no asignado".
El estado onlineStatus del volumen EL0010 es "no disponible".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:formatVolume>
<arg0>F50234</arg0>
</ns1:formatVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:formatVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1215</return>
</ns2:formatVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta llamada asíncrona formatea el volumen en formato LTFS y se utiliza cuando se debe formatear un volumen en una unidad específica. El volumen y la unidad deben ser compatibles.
formatVolumeWithDrive (String volser, String drivesn)
Condición previa:
Compruebe que el volumen esté fuera de línea y asignado, en una agrupación, y disponible antes de formatearlo. El volumen y la unidad deben estar en la biblioteca y deben ser compatibles. La unidad debe estar en un estado inactivo o disponible.
Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1,volser2,...])
Asegúrese de que el volumen esté en el estado requerido por la condición previa.
Tome las medidas correctivas (de ser necesario) antes de continuar.
Cadena del servicio web de LTFS-LE que se debe llamar:
formatVolumeWithDrive(volser,drivesn) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen tiene ahora el formato de LTFS-LE.
volser es el número de serie del volumen.
drivesn es el número de serie de la unidad que formatea el volumen.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
En la lista que aparece a continuación se muestran excepciones de ejemplo que se devuelven:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen EL0010 es "no asignado".
El estado onlineStatus del volumen EL0010 es "en línea".
El estado onlineStatus del volumen EL0010 es "no disponible".
No se encontró la unidad 123456 en la biblioteca LTFS.
El estado availableStatus de la unidad 123456 es "en uso".
El estado onlineStatus de la unidad 123456 es "fuera de línea".
El estado onlineStatus de la unidad 123456 es "no asignado".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:formatVolumeWithDrive>
<arg0>F50234</arg0>
<arg1>576001000421</arg1>
</ns1:formatVolumeWithDrive>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:formatVolumeWithDriveResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1215</return>
</ns2:formatVolumeWithDriveResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The Volume F50377's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The Volume F50377's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta llamada asíncrona encuentra la ruta del volumen en el espacio de nombre global.
volser es el número de serie del volumen que sirve para encontrar la ruta del volumen.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
El volumen debe existir en la biblioteca y debe estar asignado y disponible.
En la lista que aparece a continuación se muestran excepciones de ejemplo que se devuelven:
El estado onlineStatus del volumen EL0020 es "no asignado".
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen EL0010 es "no disponible".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:getVolumePath>
<arg0>F50233</arg0>
</ns1:getVolumePath>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2: getVolumePath xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1225</return>
</ns2: getVolumePath >
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010’s availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010’s availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta es una llamada asíncrona que coloca el volumen en un estado fuera de línea y permite expulsar, almacenar, formatear y asignar uno o más volúmenes, o anular su asignación.
offlineVolume(String[] volser)
Condiciones previas:
Compruebe que el volumen existe en la biblioteca y que está en línea, asignado y disponible, y también que haya finalizado antes de desconectarlo. Compruebe que exista una unidad compatible disponible.
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Finalice el volumen si el volumen está en un estado asignado en línea.
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Cadena del servicio web de LTFS-LE que se debe llamar:
offlineVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen ahora está fuera de línea.
volsers son los números de serie de los volúmenes que se desconectarán. Los parámetros de entrada son una matriz de cadenas; la llamada permite desconectar varios volúmenes.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, asignado, disponible y finalizado antes de desconectarlo, los estados disponibles devuelven excepciones de errores en la validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "fuera de línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:offlineVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
</ns1:offlineVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:offlineVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1218</return>
</ns2:offlineVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Una llamada asíncrona que coloca al volumen en un estado en línea, lo cual permite leer, escribir o finalizar el volumen.
onlineVolume(String[] volsers)
Condiciones previas:
Compruebe que el volumen exista en la biblioteca y que esté fuera de línea, asignado, en una agrupación, y disponible antes de conectarlo. Compruebe que exista una unidad compatible disponible.
getVolumeInfoByVolser([volser1, volser2, ...])
Servicio web de LTFS-LE que se debe llamar:
onlineVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen queda en línea.
volsers son los números de serie de volumen de los volúmenes que deben conectarse. Los parámetros de entrada son una matriz de cadenas; la llamada permite conectar varios volúmenes.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, no está asignado, no pertenece a una agrupación y no está disponible antes de conectarlo, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:onlineVolume>
<arg0>F40244</arg0>
<arg0>F43022</arg0>
</ns1:onlineVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:onlineVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1217</return>
</ns2:onlineVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume SL0010’s availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta llamada asíncrona mueve la carpeta del volumen de la carpeta /LTFSLE/LOST+FOUND+VOLUMES/ a la carpeta /LTFSLE/.
prepareVolume(volser)
Condiciones previas:
Compruebe que la carpeta del volumen esté en /LTFSLE/LOST+FOUND+VOLUMES y que el volumen exista en la biblioteca y esté fuera de línea, asignado y disponible antes de prepararlo. Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Obtenga la ubicación del volumen.
getVolumePath(volser)
Asegúrese de que el volumen esté en todos los estados requeridos y tome la medida correctiva (de ser necesario) antes de continuar.
Servicio web de LTFS-LE que se debe llamar:
prepareVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, se podrá ahora acceder a la carpeta del volumen desde la carpeta /LTFSLE.
volser es el número de serie del volumen que debe prepararse para que esté accesible mediante la ubicación /LTFSLE/.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, no asignado y no disponible antes de prepararlo, los estados disponibles devuelven excepciones de errores en la validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:prepareVolume>
<arg0>F50233</arg0>
</ns1:prepareVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:prepareVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1221</return>
</ns2:prepareVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Este comando anula la asignación de un volumen desde LTFS-LE.
unassignVolume(String[] volsers)
Condiciones previas:
Compruebe que el volumen exista en la biblioteca y que esté fuera de línea, asignado, en una agrupación, y disponible antes de anular la asignación del volumen. Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Asegúrese de que el volumen esté en todos los estados requeridos y tome la medida correctiva (de ser necesario) antes de continuar.
Servicio web de LTFS-LE que se debe llamar:
unassignVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, se anula la asignación del volumen a LTFS-LE.
volsers son los números de serie de volumen de los volúmenes cuya asignación debe anularse. Los parámetros de entrada son una matriz de cadenas y permiten la anulación de la asignación de múltiples volúmenes.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, no está asignado, no pertenece a una agrupación y no está disponible antes de anular la asignación del volumen, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:unassignVolume>
<arg0>F50233</arg0>
<arg0>F50234</arg0>
</ns1:unassignVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unassignVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1221</return>
</ns2:unassignVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta llamada asíncrona unformatVolume quita el formato LTFS del volumen. Cuando se quita el formato del volumen LTFS, se extraen del volumen los encabezados del formato LTFS (metadatos y particiones de datos), y el volumen se convierte en un volumen estándar, sin LTFS.
El servicio web de LTFS-LE no requiere la confirmación ni realiza la validación del volumen. Sin embargo, cuando se quita el formato de un volumen, se eliminan todos los datos previos en el volumen. Debe reconocer el volumen al que se le quitará el formato y asegurarse de que sea el correcto.
Condición previa:
Compruebe que el volumen esté fuera de línea y no asignado antes de quitar el formato del volumen. Compruebe que exista una unidad compatible disponible.
Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1, volser2, ...])
Asegúrese de que el volumen esté en el estado requerido por la condición previa.
Tome las medidas correctivas (de ser necesario) antes de continuar.
Cadena del servicio web de LTFS-LE que se debe llamar:
unformatVolume(volser)
getJobStatus(jobId) < poll each 10s until status is complete >
getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen ya no tiene el formato LTFS-LE, y el formato LTFS-LE se quita del volumen.
volser es el número de serie del volumen cuyo formato se quitará.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, no asignado y no disponible antes quitar el formato, los estados disponibles devuelven excepciones de errores en la validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:unformatVolume>
<arg0>F50344</arg0>
</ns1:unformatVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unformatVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1216</return>
</ns2:unformatVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta llamada asíncrona quita el formato LTFS del volumen. Cuando se quita el formato del volumen LTFS, se extraen del volumen los encabezados del formato LTFS (metadatos y particiones de datos), y el volumen se convierte en un volumen estándar, sin LTFS.
unformatVolumeWithDrive (String volser, String drivesn)
Condición previa:
El volumen y la unidad deben existir en la biblioteca. El volumen y la unidad deben ser compatibles. El volumen debe estar no asignado, fuera de línea y disponible. La unidad debe estar en un estado inactivo, en línea o disponible.
Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1,volser2,...])
Asegúrese de que el volumen esté en el estado requerido por la condición previa.
Tome las medidas correctivas (de ser necesario) antes de continuar.
Cadena del servicio web de LTFS-LE que se debe llamar:
unformatVolumeWithDrive(volser,drivesn) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen tiene ahora el formato de LTFS-LE.
volser es el número de serie del volumen cuyo formato se quitará.
drivesn es el número de serie de la unidad que constituye una cadena de caracteres y números.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está fuera de línea, no asignado, en uso y no disponible, o si la unidad no es compatible con el volumen o está en la biblioteca, los estados disponibles devuelven excepciones de errores en la validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
El tipo LTO-5 del volumen no es compatible con el tipo T1C de la unidad.
No se encontró la unidad HP23112 en la biblioteca LTFS.
El estado availableStatus de la unidad 123456 es "en uso".
El estado onlineStatus de la unidad 123456 es "fuera de línea".
El estado onlineStatus de la unidad 123456 es "no asignado".
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:unformatVolumeWithDrive>
<arg0>F50344</arg0>
<arg1>576001000421</arg1>
</ns1:unformatVolumeWithDrive>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unformatVolumeWithDriveResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1216</return>
</ns2:unformatVolumeWithDriveResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume's type LTO-5 is not compatible with drive's type T1C</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume's type LTO-5 is not compatible with drive's type T1C</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Esta función de API almacena uno o más volúmenes LTFS-LE presentes en la agrupación del volumen por defecto de LTFS-LE. Solo puede almacenar un volumen por vez.
Esta llamada asíncrona almacena hasta 30 volúmenes utilizando el CAP (ranura de correo). No hay espacio para cuatro volúmenes en la ranura de correo. Si el usuario almacena 30 volúmenes, los volúmenes se envían a la ranura de correo de a cuatro por vez hasta que se completen todas las expulsiones.
vaultVolume(String[] volsers,String acs,String lsm,String cap)
Condición previa:
Compruebe que hay un CAP disponible y que el volumen esté finalizado y fuera de línea antes de almacenarlo. La cantidad total de volúmenes debe ser inferior o igual a 30. Los volúmenes deben estar en la misma biblioteca configurada. Para hacerlo:
Obtenga el estado del volumen:
getVolumeInfoByVolser([volser1,volser2,...])
Si el volumen está en línea y asignado, finalice el volumen:
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Si el volumen está en línea, desconecte el volumen antes de ejecutar la llamada a la API vaultVolume:
offlineVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Cadena del servicio web de LTFS-LE que se debe llamar:
vaultVolume([volser1,volser2,...],acs,lsm,cap) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
Condición posterior:
Después de haber ejecutado las llamadas de servicios web, los resultados se incluyen en un documento XML. Debe convertirlos a códigos de retorno adecuados. Si las llamadas a la API se realizan correctamente, el volumen se introduce a la biblioteca. El usuario debe dirigirse a la biblioteca y recuperar el volumen después de abrir la puerta de CAP.
volsers son el número de serie de los volúmenes que se almacenarán.
acs es el identificador de ACS de la biblioteca.
lsm es el identificador de LSM de la biblioteca.
cap es el ID de CAP (ranura de correo) de la biblioteca utilizado para expulsar el volumen.
jobId es el ID de trabajo utilizado para recuperar el estado del trabajo y su resultado.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
ValidationFailedException
Es posible que se produzcan excepciones:
Si no se introducen números de serie volser, la excepción devuelta es: "The parameter volsers is null" (los volsers del parámetro son nulos).
Si el volumen no existe en la biblioteca y está en línea, no está asignado, no pertenece a una agrupación y no está disponible antes de almacenarlo, los estados disponibles devuelven excepciones de errores de validación de la siguiente manera: "volume [volume sn] status is []" ("El estado del volumen [volume sn] es []".).
Los ejemplos son:
No se encontró el volumen EL0010 en la biblioteca LTFS.
El estado onlineStatus del volumen SL0010 es "en línea".
El estado onlineStatus del volumen SL0010 es "no asignado".
El estado onlineStatus del volumen SL0010 es "no disponible".
El estado onlineStatus del volumen EL0010 es "en uso".
Esto depende del tiempo que demoró el administrador en extraer el volumen del CAP (ranura de correo).
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:UsernameToken>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:vaultVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
<arg1>3</arg1>
<arg2>0</arg2>
<arg3>1</arg3>
</ns1:vaultVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:vaultVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1214</return>
</ns2:vaultVolumeResponse>
</S:Body>
</S:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
<ns3:Code>
<ns3:Value>ns3:Receiver</ns3:Value>
</ns3:Code>
<ns3:Reason>
<ns3:Text>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>