The I/O files to transfer are specified by including the names of the input and output files in the environment variable of the user executing the qsub command. This section explains how to specify the environment variables to transfer I/O files.
I/O files are transferred by specifying the environment variables described below for the user executing the qsub command.
Up to 32 input files or 32 output files can be specified to be transferred for each job.
Each file name can be a maximum of 64 bytes in length.
Files in the current directory when qsub is executed can be sent and received. Files that require the full path to be specified cannot be transferred.
File transfer cannot be used in the job submission API (Mp_SubmitJob).
Environment variable name
Environment variable | Meaning |
|---|---|
MJ_INPUTFILES | Specify input files to be sent to the execution server. |
MJ_OUTPUTFILES | Specify output files to be received from the execution server. |
Format for specifying environment variables
Specify the name of the file to be transferred in the environment variable. The full path cannot be specified.
A maximum of 32 file names can be specified, each to be delimited with a comma.
Each file name can be a maximum of 64 bytes in length.
Other than characters specifically disallowed by the operating system file system, file names can not include spaces, or the following characters:
? * , \ " < > | : ( ) & =
Specify environment variables as follows:
file name 1, file name 2, file name 3,... |
Prepare the input file necessary to execute the applications on the execution server.
Input files must be put in the following directory:
Current directory at the time of execution of the qsub command |
Files that do not reside in the above directory cannot be transferred to the execution server.
Files specified in MJ_INPUTFILES will be transferred to the "job working directory" on the execution server.
When the job finishes, input files transferred to the "job working directory" on the execution server will be deleted.
If the files output by the executed application on the execution server are to be transferred to the schedule server, care must be taken to ensure that the applications output the files to the "job working directory".
Files that do not reside in the above directory cannot be transferred from the execution server to the schedule server.
Files specified in MJ_OUTPUTFILES will be transferred to the current directory of the relevant job when the qsub command is executed. Files will be overwritten if they already exist in this directory.
When the job finishes, output files output to the "job working directory" on the execution server will be deleted.
The -ofe option can specify if 0x40000008 is to be set as an error completion code when the output file specified by the MJ_OUTPUTFILES environment variable does not exist on the execution server. Refer to "7.20 qsub Job Submit Command" for details on the -ofe option.
The job working directory is set in the following environment variable set in the job process.
JC_TRANSFILEDIR |
The above environment variable does not need to be set if I/O file transfer is not to be performed.
