listobjects.1

.\"  $Id: listobjects.1,v 1.2 2001/12/06 16:02:01 eric Exp $
.\"
.\"  Man page for ListObjects.
.\"
.\"
.\"  $Log: listobjects.1,v $
.\"  Revision 1.2  2001/12/06 16:02:01  eric
.\"  Added reference to instantiate(1)
.\"
.\"  Revision 1.1  2001/11/27 22:07:48  eric
.\"  Initial revision.
.\"
.\"
.\"
.TH listobjects 1 "November 27, 2001" "ListObjects"
.SH "NAME"
listobjects \- List all objects instantiated by a JVM
.SH "SYNOPSIS"
.BI "listobjects [" options ]
.sp
Options:
.BI "[\-h " host ]
.BI "[\-s " service ]
.BI "[\-j " jvm\ number ]
.br
.SH DESCRIPTION
The program
.B listobjects
contacts a PJVM Manager, which contacts one or all of its registered JVMs and
requests from them a list of instantiated objects.  If a JVM is
specified with the
.B -j
option, then only the objects associated with that JVM are listed;
otherwise, the Manager iterates through its list of JVMs and queries
each in turn.
The list is returned in
the format:
.P
JVM [jvmnumber]
.br
[objectnumber] objectname
.SH OPTIONS
.TP
.BI "\-h " host
The host on which a PJVM Manager
is running.  If this is a remote
server, specify a hostname.  Default is
.BR "localhost" .
.TP
.BI "\-s " service
The port number or service name at which a PJVM Manager
can be contacted on the
.B hostname
specified.  Default is
.BR "pjvmmanager" .
.TP
.BI "\-j " jvm\ number
The internal identification number of a JVM registered with a PJVM
Manager.  A list of these identification numbers can be determined with
the use of
.BR "listjvm" .
.SH "SEE ALSO"
.BR pjvms (1),
.BR manager (1),
.BR requestjvm (1),
.BR listjvm (1),
.BR killjvm (1),
.BR loadclass (1),
.BR listconstructors (1),
.BR listmethods (1),
.BR instantiate (1)