ステータスサービスを使用すると、ユーザーはドライブやボリュームのステータスを取得できます。たとえば、ステータスサービスを使用してすべてのボリューム情報を取得したり、ボリュームステータスやドライブのオンラインまたはオフラインステータスを取得したりします。これらのサービスではデータベースに問い合わせることでほぼ瞬時にサービス結果を取得できるため、ステータスサービスは同期呼び出しとして実装されます。操作が完了すると、その操作の結果が返されます。
次の 2 つの Web サービスは、それぞれの非同期管理サービス実行のジョブステータスとジョブ結果を取得するための一般的なステータス Web サービスです。
getJobResult
(int jobId
)
getJobStatus
(int jobId
)
getJobstatus
と getJobResult
の Web サービスは、非同期 (管理) サービスと同期 (ステータス) サービスをペアにして実行結果を取得している例です。
この同期呼び出しは、入力された特定のジョブ ID のジョブ結果を取得します。
ResultNotFoundException
次のリストは、スローされる例外の例を示しています。
The JobResult cannot be found with the jobId1234 (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>
この同期呼び出しは、指定されたジョブ ID のジョブステータスを取得します。その戻りコードは次のとおりです。
0 (ジョブ ID に関連付けられている Web サービス呼び出しは完了です。)
1 (ジョブ ID に関連付けられている Web サービス呼び出しはまだ進行中です。)
-1 (このようなジョブ ID を持つ 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>
これらのサービスシグネチャーは、ボリュームとドライブのステータスを取得します。
getAllDriveInfo
()
getAllVolumeInfo
()
getVolumeInfoByStatus
(String status
)
getVolumeInfoByVolser
(String[] volsers
)
すべてのライブラリテープドライブ情報を取得する同期呼び出し。
<?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>
このリクエスト関数は、LTFS-LE におけるすべてのボリューム情報を取得する同期呼び出しです。
<?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>
ボリュームステータス別にボリューム情報を取得する同期呼び出し。
有効なボリュームステータスは、「Online」、「Offline」、「Assigned」、「Unassigned」、「In Use」、「Idle」、「Available」、または「Unavailable」です。
複数のステータスの入力も、保留中のステータスもサポートされていません。
<?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>
ボリュームシリアル番号別に 1 つ以上のボリュームのボリューム情報を取得する同期呼び出し。
getVolumeInfoByVolser (String[] volsers)
呼び出す LTFS-LE Web サービス:
getVolumeInfoByVolser([volser1, volser2, ...])
<?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>