Maximo Java API · psdi.mbo

MboSetRemote psdi.mbo.MboSetRemote

MboSetRemote is a Maximo interface. It is in every release from 8.5 to 9.3, with 216 public and protected methods and 3 fields.

Using this class in Jython

Obtain from a relationship or server

The collection interface used when a relationship or server lookup returns a set. Iterate records without calling count() for every loop condition.

first = mbo.getMboSet("ASSET").getMbo(0)

Signature and hierarchy

public interface MboSetRemote extends Remote, MboAccessInterface, Transactable

Extends: java.rmi.Remote, psdi.mbo.MboAccessInterface, psdi.txn.Transactable.

787 direct implementors in IBM's code.

Where Maximo uses it

No object, attribute, screen, service or cron task names MboSetRemote directly. No internal method callers can be inferred from these registrations.

Upgrading

Nothing on MboSetRemote was removed or moved between 8.5 and 9.3. No recorded removal is not a runtime compatibility guarantee; compare the exact source and target signatures.

Method context

getMbo

Get a record at a zero-based position in the set. Returns None when that position has no record; fetching may load data. record = records.getMbo(0)

moveFirst

Move the set cursor to its first record. Returns None for an empty set. record = records.moveFirst()

moveNext

Advance the set cursor and return the next record. Returns None after the final record; use this to terminate a loop. record = records.moveNext()

setWhere

Set the SQL condition for a collection query. A condition is not a full SELECT. Format dynamic values, then reset before reading. records.setWhere(where.format())

reset

Reset the collection so subsequent reads use the current query. Use on your query set before reading; avoid discarding pending edits on a shared set. records.reset()

setOrderBy

Set the query sort expression. Apply before reset and fetching records. records.setOrderBy("assetnum")

isEmpty

Ask whether the collection contains a record. Use for an existence check when the exact count is unnecessary. records.isEmpty()

count

Get the number of records matching the set. Counting can issue SQL. Reuse the value rather than counting on every iteration. total = records.count()

add

Create a new record in the collection. Populate required attributes; creation is part of the transaction until saved. record = records.add()

save

Save pending collection changes through Maximo. Use at the boundary of a transaction you own. Do not nest a save inside a launch point save. records.save()

cleanup

Release collection resources and transaction associations. Use finally for standalone sets that your script opened. records.cleanup()

close

Close collection database resources. Close independently opened sets when finished. Leave framework-owned related sets to their owner. records.close()

Methods

Signatures across captured releases. Use Browse to filter to one version.

From automation scripts

The collection interface used when a relationship or server lookup returns a set.

Follow a relationship and walk its records

Action launch point · WORKORDER · WPMATERIAL relationship configured · Jython

lines = mbo.getMboSet("WPMATERIAL")
line = lines.moveFirst()
total = 0.0
while line is not None:
    total += line.getDouble("LINECOST")
    line = lines.moveNext()
service.log("Planned material total: %s" % total)
# Leave this related set to the parent transaction.

Query an independent set with typed values

Action launch point · WORKORDER with ASSETNUM and SITEID · Jython

from psdi.server import MXServer
from psdi.mbo import SqlFormat

where = SqlFormat("assetnum = :1 and siteid = :2")
where.setObject(1, "ASSET", "ASSETNUM", mbo.getString("ASSETNUM"))
where.setObject(2, "ASSET", "SITEID", mbo.getString("SITEID"))
assets = MXServer.getMXServer().getMboSet("ASSET", mbo.getUserInfo())
try:
    assets.setWhere(where.format())
    assets.reset()
    asset = assets.getMbo(0)
    if asset is not None:
        service.log(asset.getString("DESCRIPTION"))
finally:
    try:
        assets.cleanup()
    finally:
        assets.close()

For IBM's description of each method, see IBM's Javadoc for Maximo and Manage.