Los servicios de estado permiten a los usuarios obtener los estados de las unidades y volúmenes. Por ejemplo, se puede usar un servicio de estado para obtener toda la información del volumen o conocer el estado del volumen y los estados de conexión o desconexión de las unidades. Estos servicios pueden obtener el resultado del servicio prácticamente al instante si se consulta la base de datos, de modo que los servicios de estado se implementan como una llamada síncrona. Cuando finaliza la operación, se devuelve el resultado de la operación.
Los siguientes dos servicios web son los servicios web de estado general para recuperar el estado del trabajo y el resultado del trabajo de cada ejecución de servicio de gestión asíncrona.
getJobResult(int jobId)
getJobStatus(int jobId)
Los servicios web getjobstatus y getJobResult son un ejemplo de servicios de emparejamiento asíncrono (gestión) con servicios síncronos (estado) para obtener los resultados de una ejecución.
Esta llamada síncrona recupera el resultado del trabajo para el ID de trabajo proporcionado introducido.
jobId
El ID del trabajo devuelto por una llamada de gestión y servicio web de archivo para indicar la ejecución del trabajo de servicio web.
ResultNotFoundException
En la lista que aparece a continuación se muestran excepciones de ejemplo que se devuelven:
JobResult no puede producirse al mismo tiempo que jobId1234
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" >
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="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:getJobResult>
<arg0>1212</arg0>
</ns2:getJobResult>
</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:getJobResultResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>
<callerIp>127.0.0.1</callerIp>
<jobCompletedOn>1399190120</jobCompletedOn>
<jobId>607</jobId>
<jobStatus>Success</jobStatus>
<jobUser>Admin</jobUser>
<serviceCalled>enterVolume</serviceCalled>
</return>
</ns2:getJobResultResponse>
</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>
<S:Fault xmlns:ns4="http://schemas.xmlsoap.org/soap/envelope/"
<S:Code>
<S:Value>S:Receiver</S:Value>
<S:Code>
<S:Reason>
<S:Text>The JobResult cannot be found with the jobId 607</S:Text>
<S:Reason>
<S:Detail>
<ns2:ResultNotFoundException xmlns:ns2="http://wsb.ejb.ws.mds.ltfsle.oracle/">
<message>The JobResult cannot be found with the jobId 607</message>
</ns2:ResultNotFoundException>
<S:Detail>
<S:Fault>
</S:Body>
</S:Envelope>
Esta llamada síncrona recupera el estado del trabajo para el ID de trabajo proporcionado. 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 del trabajo en el sistema).
getJobStatus(int jobId)
Cadena del servicio web de LTFS-LE que se debe llamar:
getJobStatus(jobId)
jobId
El ID de trabajo devuelto por una llamada de servicio web para indicar la ejecución del trabajo de servicio web.
<?xml version = '1.0' encoding = 'UTF-8'?
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-sece
xt-1.0.xsd" xmlns:ns2="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>
<ns2:getJobStatus>
<arg0>1212</arg0>
</ns2:getJobStatus>
</env:Body>
</env:Envelope>
Estas firmas de servicios recuperan los estados de volúmenes y unidades.
getAllDriveInfo()
getAllVolumeInfo()
getVolumeInfoByStatus (String status)
getVolumeInfoByVolser (String[] volsers)
Una llamada síncrona que recupera toda la información de la unidad de cinta de la biblioteca.
Las respuestas válidas de la unidad se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
Ninguna Si se presentan algunos errores al obtener la información de todas las unidades, el valor devuelto es una matriz de unidades vacía.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="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:getAllDriveInfo/>
</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:getAllDriveInfoResponse xmlns:ns2="http://ws.ltfsle.oracle/">
<return>
<acslsPath>0 ,0 ,12 ,5</acslsPath>
<availableStatus>Available</availableStatus>
<driveCompress>Compression Enabled</driveCompress>
<driveEncry>Encryption NO</driveEncry>
<driveFwRev>RF53</driveFwRev>
<driveGenDev>/dev/sg10</driveGenDev>
<driveLtfsCap>LTFS Capable</driveLtfsCap>
<drivePoolName>Default Drive Pool</drivePoolName>
<driveProdId>T10000C</driveProdId>
<driveSn>576001000421</driveSn>
<driveStatus>Assigned</driveStatus>
<driveStdDev>/dev/st3</driveStdDev>
<driveType>T1C</driveType>
<driveVendor>STK</driveVendor>
<onlineStatus>Online</onlineStatus>
</return>
</ns2:getAllDriveInfoResponse>
</S:Body>
</S:Envelope>
Esta función de solicitud es una llamada síncrona que recupera toda la información del volumen en LTFS-LE.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
Ninguna Si se presentan algunos errores al obtener la información de todos los volúmenes, el valor devuelto es una matriz de volúmenes vacía.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="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>
<ns2:getAllVolumeInfo/>
</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:getAllVolumeInfoResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>
<acslsPath>0, ,0 ,12 ,24 ,4</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>F50191</volser>
<volumeCreatedOn>1403014692</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</return>
<return>
<acslsPath>0, ,0 ,12 ,23 ,5</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>F50192</volser>
<volumeCreatedOn>1403014692</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</return>
<return>
</ns2:getAllVolumeInfoResponse>
</S:Body>
</S:Envelope>
Una llamada síncrona que recupera información del volumen por estado del volumen.
getVolumeInfoByStatus(String status)
Cadena del servicio web de LTFS-LE que se debe llamar:
getVolumeInfoByStatus(status)
Los estados válidos del volumen son: En línea, fuera de línea, asignado, no asignado, en uso, inactivo, disponible o no disponible.
No admite que se introduzcan varios estados, ni tampoco el estado pendiente.
Las respuestas válidas se muestran en el ejemplo de respuesta de SOAP. Consulte el glosario para conocer las definiciones.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1
="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2
="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>
<ns2:getVolumeInfoByStatus>
<arg0>online</arg0>
</ns2:getVolumeInfoByStatus>
</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:getVolumeInfoByStatusResponse xmlns:ns2="http://ws.ltfsle.oracle/">
<return>
<acslsPath>3 ,0 ,12 ,38 ,1</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>O50191</volser>
<volumeCreatedOn>1402933089</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</return>
<return>
<acslsPath>3 ,0 ,12 ,41 ,2</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>O50191</volser>
<volumeCreatedOn>1402933089</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</return>
</ns2:getVolumeInfoByStatusResponse>
</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>Status not found: [status]</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:StatusNotFoundException xmlns:ns2="http://ws.ltfsle.oracle/">
<message>Status not found: [status]</message>
</ns2:StatusNotFoundException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
Una llamada síncrona que recupera la información de volumen de uno o más volúmenes por número de serie de volumen.
getVolumeInfoByVolser (String[] volsers)
Servicio web de LTFS-LE que se debe llamar:
getVolumeInfoByVolser([volser1, volser2, ...])
Si no se encuentra ninguno de los números de serie de volumen, se devuelve a excepción VolumeNotFoundException.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1
="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2
="http://1.0.xsd" xmlns:ns2="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>
<ns2:getVolumeInfoByVolser>
<arg0>F52270</arg0>
<arg0>EL0010</arg0>
<arg0>F50331</arg0>
</ns2:getVolumeInfoByVolser>
</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:getVolumeInfoByVolserResponse xmlns:ns2="http://ws.ltfsle.oracle/">
<return>
<acslsPath>3 ,0 ,12 ,38 ,1</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>O50191</volser>
<volumeCreatedOn>1403015625</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</return>
<return>
<acslsPath>3 ,0 ,12 ,38 ,2</acslsPath>
<assignedStatus>Assigned</assignedStatus>
<availableStatus>Available</availableStatus>
<capacityAvailable>1453410222080</capacityAvailable>
<capacityUsed>24117248</capacityUsed>
<currentLocation>home</currentLocation>
<inuseStatus>In use</inuseStatus>
<ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
<onlineStatus>Online</onlineStatus>
<volser>O50191</volser>
<volumeCreatedOn>1403015625</volumeCreatedOn>
<volumePoolName>Default Volume Pool</volumePoolName>
<volumeType>LTO-1.5T</volumeType>
</ns2:getVolumeInfoByVolserResponse>
</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>Volume is not found: [volser]</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:VolumeNotFoundException xmlns:ns2="http://ws.ltfsle.oracle/">
<message>Volume is not found: [volser]</message>
</ns2:VolumeNotFoundException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>