3 ステータスサービス

ステータスサービスを使用すると、ユーザーはドライブやボリュームのステータスを取得できます。たとえば、ステータスサービスを使用してすべてのボリューム情報を取得したり、ボリュームステータスやドライブのオンラインまたはオフラインステータスを取得したりします。これらのサービスではデータベースに問い合わせることでほぼ瞬時にサービス結果を取得できるため、ステータスサービスは同期呼び出しとして実装されます。操作が完了すると、その操作の結果が返されます。

一般的なステータスサービス

次の 2 つの Web サービスは、それぞれの非同期管理サービス実行のジョブステータスとジョブ結果を取得するための一般的なステータス Web サービスです。

  • getJobResult(int jobId)

  • getJobStatus(int jobId)

getJobstatus と getJobResult の Web サービスは、非同期 (管理) サービスと同期 (ステータス) サービスをペアにして実行結果を取得している例です。

getJobResult

この同期呼び出しは、入力された特定のジョブ ID のジョブ結果を取得します。

形式

getJobResult(int jobId)

呼び出す LTFS-LE Web サービス:

getJobResult(jobId)

パラメータ

jobId

実行中の Web サービスジョブを示すために管理およびファイルの Web サービス呼び出しによって返されるジョブ ID。

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

ResultNotFoundException

次のリストは、スローされる例外の例を示しています。

  • The JobResult cannot be found with the jobId1234 (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 サービスジョブを示すために Web サービス呼び出しによって返されるジョブ ID。

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

なし

推奨されるタイムアウト

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 応答の例に有効なドライブ応答が示されています。定義については、用語集を参照してください。

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

なし。すべてのドライブ情報の取得中になんらかのエラーが発生した場合、戻りコードは空のドライブ配列になります。

推奨されるタイムアウト

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 応答の例に有効な応答が示されています。定義については、用語集を参照してください。

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

なし。すべてのボリューム情報の取得中にエラーが発生した場合、戻り値は空のボリューム配列になります。

推奨されるタイムアウト

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 応答の例に有効な応答が示されています。定義については、用語集を参照してください。

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

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

ボリュームシリアル番号別に 1 つ以上のボリュームのボリューム情報を取得する同期呼び出し。

形式

getVolumeInfoByVolser (String[] volsers)

呼び出す LTFS-LE Web サービス:

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

パラメータ

volser は、ボリュームシリアル番号です

ロール

「Admin」、「Monitor」、または「Service」

スローされる例外

ボリュームシリアル番号が 1 つも見つからない場合は、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>