SGE_GDI_TRM(3)

NAME

sge_gdi_host_attribute, sge_gdi_host_scaling,
sge_gdi_host_nslots, sge_gdi_myhost_attribute,
sge_gdi_myhost_scaling, sge_gdi_myhost_nslots
- xxQS_NAMExx/TRM GDI calls

SYNOPSIS
#include "sge_gdi_attributes.h"

char *sge_gdi_host_attribute(
    char *hostname,
    char *attr_name
);

double sge_gdi_host_scaling(
    char *hostname,
    char *attr_name
);

int sge_gdi_host_nslots(
    char *hostname,
    u_long32 jobid
);

char *sge_gdi_myhost_attribute(
    char *attr_name
);

double sge_gdi_myhost_scaling(
    char *attr_name
);

int sge_gdi_myhost_nslots(
    u_long32 jobid
);

DESCRIPTION
The Transparent Resource Manager (TRM) extension to the xxQS_NAMExx Database Interface (GDI) of xxQS_NAMExx simplifies integration of (parallel) applications with xxQS_NAMExx. Access is provided to information which describes the runtime environment of a xxQS_NAMExx job. In many cases this information can be used to optimize runtime of jobs/applications by adapting its behavior to runtime environment or load situation.

The following is a description of the basic functionality of all xxQS_NAMExx TRM GDI functions:

  sge_gdi_host_attribute
Returns value of the requested attribute at the host. Depending on the attribute this can be a load value, a statically configured value or a consumable resource. On error NULL is returned. Otherwise a pointer is returned which points to a static address. Please note that sge_gdi_host_attribute will fail if the xxQS_NAMExx GDI was not successfully initialized by use of

  sge_gdi_host_scaling
Returns the scaling factor which is used to scale the given load value from the host. The scaling values for a host can be modified using the command. If no scaling is active for the attribute a value of 1 is returned. On error -1 is returned. Please note that sge_gdi_host_scaling will fail if the xxQS_NAMExx GDI was not successfully initialized by use of

  sge_gdi_host_nslots
Returns the number of slots the job got from the xxQS_NAMExx scheduler for the given host. This number can be important in case of multithreaded parallel applications. If the jobid is 0 the value of the JOB_ID environment is used instead. On error 0 is returned. Please note that sge_gdi_host_nslots will fail if the xxQS_NAMExx GDI was not successfully initialized by use of

  sge_gdi_myhost_attribute
Returns the value of the requested attribute at the local host. Depending on the attribute this can be a load value, a statically configured value or a consumable resource. On error NULL is returned. Otherwise a pointer is returned which points to a static address. sge_gdi_host_attribute should be called without setting up the xxQS_NAMExx GDI since this is done inside of this function.

  sge_gdi_myhost_scaling
Returns the scaling factor which is used to scale the given load value from the local host. The scaling values for a host can be modified using the command. If no scaling is active for the attribute a value of 1 is returned. On error -1 is returned. sge_gdi_myhost_scaling should be called without setting up the xxQS_NAMExx GDI since this is done inside of this function.

  sge_gdi_myhost_nslots
Returns the number of slots the job got from the xxQS_NAMExx scheduler for the local host. This number can be important in case of multithreaded parallel applications. If the jobid is 0 the value of the JOB_ID environment is used instead. On error 0 is returned. sge_gdi_myhost_nslots should be called without setting up the xxQS_NAMExx GDI since this is done inside of this function.

SEE ALSO

COPYRIGHT
See for a full statement of rights and permissions.