Using and Administering

ll_get_nodes Subroutine

Purpose

This subroutine, available to any user, returns information about all of nodes known by the negotiator daemon.

Library

LoadLeveler API library libllapi.a

Syntax

  #include "llapi.h"
 
  int ll_get_nodes(LL_get_nodes_info *ptr);

Parameters

ptr

Specifies the pointer to the LL_get_nodes_info structure that was allocated by the caller. The LL_get_nodes_info members are:

int version_num

Represents the version number of the LL_start_job_info structure.

int numNodes

Represents the number of entries in the NodeList array.

LL_node **NodeList

Represents the pointer to an array of LL_node structures. The LL_node structure is defined in llapi.h.

Description

The LL_get_node_info structure contains an array of LL_job structures indicating each node in the LoadLeveler system.

Return Values

This subroutines returns a value of zero when successful. Otherwise, it returns an integer value defined in the llapi.h file.

Error Values

-1

There is an error in the input parameter.

-2

The API cannot connect to the central manager.

-3

The API cannot allocate memory.

-4

A configuration error occurred.

Examples

Makefiles and examples which use this subroutine are located in the samples/llsch subdirectory of the release directory.

Related Information

Subroutines: ll_free_jobs, ll_free_nodes, ll_get_jobs.