Using and Administering

ll_query Subroutine

Purpose

The ll_query subroutine initializes the query object and defines the type of query you want to perform. The LL_element created and the corresponding data returned by this function is determined by the query_type you select.

Library

LoadLeveler API library libllapi.a

Syntax

#include "llapi.h"
 
LL_element * ll_query(enum QueryType query_type);

Parameters

query_type

Can be JOBS (to query job information) or MACHINES (to query machine information, or CLUSTER (to query cluster information).

Description

query_type is the input field for this subroutine.

This subroutine is used in conjunction with other data access subroutines to query information about job and machine objects. You must call ll_query prior to using the other data access subroutines.

Return Values

This subroutine returns a pointer to an LL_element object. The pointer is used by subsequent data access subroutine calls.

Error Values

NULL

The subroutine was unable to create the appropriate pointer.

Related Information

Subroutines: ll_get_data, ll_set_request, ll_reset_request, ll_get_objs, ll_free_objs, ll_next_obj, ll_deallocate.