3 状态服务

通过状态服务，用户可以获取磁带机和卷的状态。例如，使用状态服务获取所有卷信息、获取卷状态或者获取磁带机的联机或脱机状态。这些服务通过查询数据库几乎可以即时获取服务结果，因此状态服务作为同步调用实现。操作完成后会返回操作的结果。

常规状态服务

以下两个 Web 服务是用于检索每次执行异步管理服务的作业状态和作业结果的常规状态 Web 服务。

  • getJobResult(int jobId)

  • getJobStatus(int jobId)

getjobstatus 和 getJobResult Web 服务是将异步（管理）服务与同步（状态）服务进行配对以获取执行结果的示例。

getJobResult

该同步调用用于检索输入的给定作业 ID 的作业结果。

格式

getJobResult(int jobId)

要调用的 LTFS-LE Web 服务：

getJobResult(jobId)

参数

jobId

管理和文件 Web 服务调用所返回的作业 ID，指明正在运行的 Web 服务作业。

角色

管理员、监视员或服务人员

抛出的异常

ResultNotFoundException

以下列表显示了抛出的异常示例：

  • The JobResult cannot be found with the jobId1234

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?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>

SOAP 故障

<?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>

getJobStatus

该同步调用用于检索给定作业 ID 的作业状态。返回码为：

  • 0（与作业 ID 关联的 Web 服务调用已完成。）

  • 1（与作业 ID 关联的 Web 服务调用仍在进行中。）

  • -1（在系统中未找到使用该作业 ID 的此类 Web 服务调用。）

格式

getJobStatus(int jobId)

要调用的 LTFS-LE Web 服务链：

getJobStatus(jobId)

参数

jobId

Web 服务调用返回的作业 ID，指明正在运行的 Web 服务作业。

角色

管理员、监视员或服务人员

抛出的异常

无

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getJobStatusResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
         <return>0</return>
      </ns2:getJobStatusResponse>
   </S:Body>
</S:Envelope>

SOAP 故障

无

卷和磁带机状态服务

以下服务签名用于检索卷和磁带机的状态。

  • getAllDriveInfo()

  • getAllVolumeInfo()

  • getVolumeInfoByStatus (String status)

  • getVolumeInfoByVolser (String[] volsers)

getAllDriveInfo

该同步调用用于检索所有磁带库磁带机信息。

格式

getAllDriveInfo()

输入类型

无

响应

SOAP 响应示例中显示了有效的磁带机响应。请参阅“词汇表”了解相关定义。

角色

管理员、监视员或服务人员

抛出的异常

无。如果在获取所有磁带机信息时出现错误，则返回值为一个空的磁带机数组。

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?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>

SOAP 故障

无。如果在该 Web 服务调用过程中出现任何错误，响应将返回空磁带机。

getAllVolumeInfo

该请求函数是用于在 LTFS-LE 中检索所有卷信息的同步调用。

格式

getAllVolumeInfo()

响应

SOAP 响应示例中显示了有效的响应。请参阅“词汇表”了解相关定义。

角色

管理员、监视员或服务人员

抛出的异常

无。如果在获取所有卷信息时出现错误，则返回值为一个空的卷数组。

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?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>

SOAP 故障

无。如果在该 Web 服务调用过程中出现任何错误，响应将返回空卷。

getVolumeInfoByStatus

该同步调用用于按卷状态检索卷信息。

格式

getVolumeInfoByStatus(String status)

要调用的 LTFS-LE Web 服务链：

getVolumeInfoByStatus(status)

输入类型

有效卷状态为：Online、Offline、Assigned、Unassigned、In Use、Idle、Available 或 Unavailable。

不支持输入多个状态，也不支持暂挂状态。

响应

SOAP 响应示例中显示了有效的响应。请参阅“词汇表”了解相关定义。

角色

管理员、监视员或服务人员

抛出的异常

StatusNotFoundException

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?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>

SOAP 故障

<?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>

getVolumeInfoByVolser

该同步调用用于按卷序列号检索一个或多个卷的卷信息。

格式

getVolumeInfoByVolser (String[] volsers)

要调用的 LTFS-LE Web 服务：

getVolumeInfoByVolser([volser1, volser2, ...])

参数

volser 是卷序列号。

角色

管理员、监视员或服务人员

抛出的异常

如果未找到任何卷序列号，则抛出 VolumeNotFoundException 异常。

建议的超时

600 秒

SOAP 请求

<?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>

SOAP 响应

<?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>

SOAP 故障

<?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>