Knowledge Center Contents Previous Next |
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:
- LSB_RESIZE_REL_ALL means release all slots-In this case, nHosts, hosts and slots indicate the slots that are not released
- LSB_RESIZE_REL_CANCEL means cancel any pending resize request
- LSB_RESIZE_REL_NO_NOTIFY means execute no resize notification command
- LSB_RESIZE_REL_NONE means release no slots
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 |