1. drmaa2_jtemplate_create(3)
  2. DRMAA2
  3. drmaa2_jtemplate_create(3)

NAME

drmaa2_jtemplate_create - drmaa2_jtemplate_create, Creates a new job template object.

SYNOPSIS

#include "drmaa2.h"

/ DRMAA2 defined keys for resource limits dictionary / UGE complex names are also allowed / extern const char const DRMAA2_CORE_FILE_SIZE; extern const char const DRMAA2_CPU_TIME; extern const char const DRMAA2_DATA_SIZE; extern const char const DRMAA2_FILE_SIZE; extern const char const DRMAA2_OPEN_FILES; extern const char const DRMAA2_STACK_SIZE; extern const char const DRMAA2_VIRTUAL_MEMORY; extern const char const DRMAA2_WALLCLOCK_TIME;

define DRMAA2_UNSET_BOOL DRMAA2_FALSE

define DRMAA2_UNSET_STRING NULL

define DRMAA2_UNSET_NUM -1

define DRMAA2_UNSET_ENUM -1

define DRMAA2_UNSET_LIST NULL

define DRMAA2_UNSET_DICT NULL

define DRMAA2_UNSET_TIME ((time_t) -3)

define DRMAA2_UNSET_CALLBACK NULL

define DRMAA2_UNSET_JINFO NULL

define DRAMA2_UNSET_VERSION NULL

typedef struct { drmaa2_string remoteCommand; drmaa2_string_list args; drmaa2_bool submitAsHold; drmaa2_bool rerunnable; drmaa2_dict jobEnvironment; drmaa2_string workingDirectory; drmaa2_string jobCategory; drmaa2_string_list email; drmaa2_bool emailOnStarted; drmaa2_bool emailOnTerminated; drmaa2_string jobName; drmaa2_string inputPath; drmaa2_string outputPath; drmaa2_string errorPath; drmaa2_bool joinFiles; drmaa2_string reservationId; drmaa2_string queueName; long long minSlots; long long maxSlots; long long priority; drmaa2_string_list candidateMachines; long long minPhysMemory; drmaa2_os machineOS; drmaa2_cpu machineArch; time_t startTime; time_t deadlineTime; drmaa2_dict stageInFiles; drmaa2_dict stageOutFiles; drmaa2_dict resourceLimits; drmaa2_string accountingId; } drmaa2_jtemplate_s;

typedef drmaa2_jtemplate_s * drmaa2_jtemplate;

drmaa2_jtemplate drmaa2_jtemplate_create(void);

DESCRIPTION

Allocates memory for a job template object, UNSETs all values (DRMAA2_UNSET_STRING, DRMAA2_UNSET_LIST etc.), and returns the object. The object must be freed by the caller with drmaa2_jtemplate_free(3). This function is required for running a job with drmaa2_jsession_run_job(3) or drmaa2_jsession_run_bulk_jobs(3).

RETURN VALUES

Returns a newly allocated drmaa2_jtemplate object or NULL in case of an error (like out-of-memory).

SEE ALSO

drmaa2_jtemplate_free(3), drmaa2_jsession_run_job(3), drmaa2_jsession_run_bulk_jobs(3)

AUTHOR

Copyright Univa Corporation 2013

  1. Univa Corporation
  2. October 2013
  3. drmaa2_jtemplate_create(3)