ORSYP Forum Tutorials Dollar Universe Batch Job environment

ORSYP Forum Tutorials: Dollar Universe – Batch Job environment variables January 2011 © Copyright ORSYP 2011

Jobs and their environment variables § When a job is submitted in Dollar Universe, it benefits from a number of environment variables which are automatically set and are made available in the job script § 3 different categories of environment variables can be considered § Variables set for all jobs § Variables corresponding to the Uproc variables § Variables corresponding to the parameters transmitted from the father job in a Session § To list all environment variables for a job, use the appropriate OS command in the job script § env on Unix, set on Windows, show logical / show symbol on VMS, etc. © Copyright ORSYP - 2011 1

Variables set for all jobs (1/2) § They are automatically set by Dollar Universe ü They allow to identify elements which come from Dollar Universe in the batch job ü They can be used to target the job data (e. g. : Processing Date) § The most useful are: § § § § § S_APPLI Dollar Universe application S_CODAUTEUR Author code of the submission account S_CODPROF Profile of the submission account S_CODUG Management Unit against which the job is executing S_DATRAIT Processing date (in format YYYYMMDD) S_DOMAINE Dollar Universe domain S_ESPEXE Area against which the job is executing S_EXECFORCE Set to O if job was launched with by-pass condition check, to N otherwise S_FORCEFINPER Set to O if job was launched with forced launch at end of launch window, to N otherwise S_NOEUD Dollar Universe Node S_NODENAME Dollar Universe Node S_NUMJALON Job current step S_NUMLANC Dollar Universe launch number (unique for a launch) S_NUMPROC Dollar Universe Uproc execution number (not unique for a launch, in case of relaunch, multiple condition check…) S_PROCEXE Uproc name S_REPRISE Set to O if the job is a relaunch of an aborted or refused job, to N otherwise S_SOCIETE Dollar Universe Company © Copyright ORSYP - 2011 2

Variables set for all jobs (2/2) § The most useful are: § § § § § S_USERNAME Dollar Universe submission account S_U_LANGUE User Interface language S_CODSESS Session name S_NUMSESS Dollar Universe Session execution number S_STAT_AVG Average elapsed time for a job (if U_GET_STAT_AVG set to Y in the DU Company environment) UXAEX Dollar Universe directory for customized actions (Area X), as of V 5. 3 UXDEX Dollar Universe directory for data files (Area X) UXDIR_ROOT Dollar Universe root directory (UXROOT on VMS) UXEXE Dollar Universe directory for binaries UXLEX Dollar Universe directory for log files (Area X) UXLOG Dollar Universe directory for general log (universe. log) UXMGR Dollar Universe directory for Company management UXPEX Dollar Universe directory for internal scripts of Uprocs (Area X) U_FMT_DATE Dollar Universe date format for UI U_LOG_FILE Dollar Universe general log full path U_LOG_TRANS Set to Y when Dollar Universe audit trail activated, to N otherwise U_TMP_PATH Dollar Universe temporary directory U_TREF Indicates if displayed time is MU time or System time (when MU Time activated) © Copyright ORSYP - 2011 3

Variables corresponding to Uproc variables § They are automatically set by Dollar Universe ü They correspond to the Uproc variables as defined in the Uproc settings and their name is the name of the variable ü Up to 80 variables can be defined per Uproc ü The variable $TOWN is available in the job ($TOWN on Unix, %TOWN% on Windows, etc. ) ü The job log displays: TOWN=MANCHESTER (env or set command) © Copyright ORSYP - 2011 4

Variables related to Uproc parameters § They are automatically set by Dollar Universe ü They correspond to the parameters transmitted by the father Uproc in a Session through the command uxset parm ü Up to 30 parameters can be transmitted between father and son, so a maximum of 30 variables of this type can be defined in a Uproc ü In PARMF: set param_reg="WEST MIDLANDS" uxset parm %param_reg%, "0" ü In PARMS, 2 variables are defined: S_P 1=WEST MIDLANDS S_P 2=0 © Copyright ORSYP - 2011 5