view release on metacpan or  search on metacpan

DataAccess.pod  view on Meta::CPAN

=item 2 $query_daemon

The LoadLeveler Daemon you want to query, permitted values are:

=over 4

=item * LL_STARTD

=item * LL_SCHEDD

=item * LL_CM (negotiator)

=item * LL_MASTER

=item * LL_STARTER

=item * LL_HISTORY_FILE

=back

=item 3 $host

Should be NULL unless you are querying LL_STARTD or LL_SCHEDD and want to query a machine other than the localhost. If you are querying LL_HISTORY_FILE then this should be the name of the history file.

=item 4 $number

The number of query objects returned.

=item 5 $error

If there is an error this is it. Possible values are:


=over 4

=item -1 query_element not valid

=item -2 query_daemon not valid

=item -3 Cannot resolve hostname

=item -4 Request type for specified daemon not valid

=item -5 System error

=item -6 No valid objects meet the request

=item -7 Configuration error

=item -9 Connection to daemon failed

=item -10 Error processing history file (LL_HISTORY_FILE query only)

=item -11 History file must be specified in the hostname argument (LL_HISTORY_FILE query only)

=item -12 Unable to access the history file (LL_HISTORY_FILE query only)

=item -13 DCE identity of calling program can not be established

=item -14 No DCE credentials

=item -15 DCE credentials within 300 secs of expiration

=item -16 64-bit API is not supported when DCE is enabled

=back

=back

=head2 ll_get_data

	$data=ll_get_data($element,$specification);

This call differs from the IBM documentation, the data you request is returned as the return value and not as a third parameter eg

	$lav=ll_get_data($machine,LL_MachineLoadAverage);	# Returns a double

	@msl=ll_get_data($machine,LL_MachineStepList);		# Returns an array of strings.

To know what you are getting you really need to know about the LoadLeveler Job Object Model.  All of this is in the I<IBM LoadLeveler for AIX 5L: Using and Administering> book and html. Sorry for not including it here, but there is an awful lot of it...


-head3 enum types

Returns from some query types may be, in C terms, enumerated types.  In perl these all return as SCALAR Integers.  Return values are shown below:

=over 4

=item LL_AdapterReqUsage

    SHARED, NOT_SHARED, SLICE_NOT_SHARED

=item LL_StepHoldType

    NO_HOLD, HOLDTYPE_USER, HOLDTYPE_SYSTEM, HOLDTYPE_USERSYS

=item LL_StepNodeUsage

    SHARED, NOT_SHARED, SLICE_NOT_SHARED

=item LL_StepState

    STATE_IDLE, STATE_PENDING, STATE_STARTING, STATE_RUNNING,
    STATE_COMPLETE_PENDING, STATE_REJECT_PENDING, STATE_REMOVE_PENDING,
    STATE_VACATE_PENDING, STATE_COMPLETED, STATE_REJECTED, STATE_REMOVED,
    STATE_VACATED, STATE_CANCELED, STATE_NOTRUN, STATE_TERMINATED,
    STATE_UNEXPANDED, STATE_SUBMISSION_ERR, STATE_HOLD, STATE_DEFERRED,
    STATE_NOTQUEUED, STATE_PREEMPTED, STATE_PREEMPT_PENDING, 
    STATE_RESUME_PENDING

=back

=head2 ll_next_obj

	$job=ll_next_obj($query);

This returns the next object from the query object.

=head2 ll_free_objs

	$return=ll_free_objs($query);