Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_resize_release()

Releases part of the allocation of a running resizable job.

DESCRIPTION

Use lsb_resize_release() to release part of a running job allocation.

A running job can only have one pending request at any particular time. If one request is still pending, additional requests are rejected with a proper error code.

If a notification command is defined through job submission, application profile, or the lsb_resize_release() API, the notification command is invoked on the first execution host of the job allocation once allocation resize requests have been satisfied.

SYNOPSIS

#include <lsf/lsbatch.h> 
#define LSB_RESIZE_REL_NONE         0x0 
#define LSB_RESIZE_REL_ALL          0x01 
#define LSB_RESIZE_REL_CANCEL       0x02 
#define LSB_RESIZE_REL_NO_NOTIFY    0x04 
lsb_resize_release(struct job_resize_release *req); 
struct job_resize_release { 
     LS_LONG_INT jobId; 
     int         options; 
     int         nHosts; 
     char        **hosts; 
     int         *slots; 
     char        *notifyCmd; 
}; 

PARAMETERS

The job_resize_release struct contains the following fields:

options

options is constructed from the bitwise inclusive OR of zero or more of the following flags, as defined in lsbatch.h:

nHosts

number of hosts in the hosts list, if no hosts are to be specified this should be zero

hosts

specified hosts list, nHosts number of elements

slots

slots list, each element specifies the number of slots per corresponding host (0 implies all), nHosts number of elements

notifyCmd

name and location of notification command

jobId

LSF job ID

RETURN VALUES

On success, returns zero.

On failure, returns -1.

ERRORS

lsberrno is set to indicate the error.

SEE ALSO

Related APIs

lsb_resize_cancel() - Cancels a pending job resize allocation request

Equivalent line command

release [-c] [-rnc resize_notification_cmd | -rncn] released_host_specification job_ID

Files

none


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next