Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Visibility: Public
  • Change Control: Stable
  • Details: The following warning message will be logged if direct write was requested but the path(s) are not usecp-able from the primary execution host.
  • "Cannot write stdout/err files directly as the $final_destination_directory is not usecp-able from $mom_hostname"
  • Same message will be logged into job's stderr file as well.


Examples:

  • qsub -koed 

Means direct write both the job's output and error files to the Output_path and Error_path if host:path is usecp-able from the primary exec host.  If they are not, issue a warning in mom log and stderr file then do normal spooling and staging.

  • qsub -kod 

Means direct write the job's output file to the Output_path if host:path is usecp-able from the primary exec host.  If it is not, issue a warning in mom log and stderr file then do normal spooling and staging of the output file.  The job's error file will be spooled in $PBS_HOME/spool and staged to Error_path per existing behavior since nothing concerning it was specified.

  • qsub -ked 

Means direct write the job's error file to the Error_path if host:path is usecp-able from the primary exec host.  If it is not, issue a warning in mom log and stderr file then do normal spooling and staging of the error file.  The job's output file will be spooled and staged per existing behavior since nothing concerning it was specified.

  • qsub -Roe -koe

Means direct write both files to user's local home directory (does not matter if it is usecp-able in this case, this is existing -koe functionality), then remove both files upon successful job completion.

  • qsub -koed -Roe

Means direct write both the job's output and error files to the Output_path and Error_path if host:path is usecp-able from the primary exec host.  If they are not, issue a warning in mom log and stderr file then do normal spooling. When the job completes successfully, remove the output and error files either from their directly written location or from $PBS_HOME/spool.  If the job is unsuccessful, leave the files in place or stage them to Output_path and Error_path if they were spooled.

  • qsub -keo -Re

Means write both files to user's local home directory (does not matter if it is usecp-able in this case, this is existing -koe functionality), then remove only the error file upon successful job completion.

  • qsub -koed -Re

 Means both output and error files are directly written to the Output_path and Error_path if host:path is usecp-able from the primary exec host.  The error file will be removed upon successful job completion, the output file is retained.

  • qsub -Wsandbox=PRIVATE -koed

Means the output files will be written to sandbox and will be staged into submission directory. The staged files will not get deleted. Direct output is not used when sandbox is used. (similar to existing -k behavior with sandbox)

  • qsub -Wsandbox=PRIVATE -koed -Roe

Means the output files will be written to sandbox and will get deleted.

  • When used with -j option: If the user specifies -joe then both the stdout and stderr get streamed to the .o file and -ke is specified, this error will be silently ignored.



Community discussion