UNIX/Linux Configuration Environment Variables

Document ID : KB000053603
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

This doc describes important workload environment variables.

Solution:

CAISCHD0009
Specifies the name of the default Unicenter NSM JM Option calendar. The default name is base. Set this variable in the file $CAIGLBL0000/sche/scripts/envset file. For C shell users, set in the $CAIGLBL0000/sche/scripts/envusrcsh file.

CAISCHD0011 and CAISCHD0012
Sets the time of day for the new-day autoscan and the interval between autoscans for the current workday. You can set these environment variables to different values if you want to change the default time of the new-day autoscan (default is 1 for 01:00 or the default autoscan interval (default is every 3 hours). Valid values for CAISCHD0012 are 0, 1, 2, 3, 4, 6, 8 and 12.

CAISCHD0014
Controls the effect of the cancel command on successor jobs. The default setting is Y. When set to Y (yes), the Unicenter NSM JM Option posts on cancel, which allows successor jobs to run because the predecessor requirement is satisfied by the predecessor having been removed (by the cancel command) from the current day's workload.
If the variable is set to N (no), successor jobs dependent on the prior completion of a canceled job are not posted. Because the predecessor requirement is not satisfied, successor jobs remain in a WPRED (waiting for predecessors) status.
Set this variable in the $CAIGLBL0000/sche/scripts/envset file by adding the following statements to $CAIGLBL0000/sche/scripts/envset:
CAISCHD0014=No
export CAISCHD0014
Then shut down and restart the Unicenter NSM JM Option using these commands:
unishutdown sche
unistart sche

Note: Running the unicntrl stop sche or unishutdown sche command stops job submission and disables display of the status tracking information for jobsets and jobs. These processes resume when you run the unicntrl start sche or unistart sche command. There is no loss of tracking data for jobs that complete or abnormally terminate while the Unicenter NSM JM Option is stopped. The Job Event Logger continues to run and track completion of scheduled processes, even while the Unicenter NSM JM Option is stopped.

CAISCHD0530
Specifies a comma-delimited list of authorized remote manager nodes allowed to submit jobs. The default (blank) is to allow all job managers to submit jobs to the job agent.

CAISCHD0540
Controls how the number of cyclic job iterations are calculated when cyclic jobs are demanded after their early start time.

Environment Variables On Win for Job Execution
When the Unicenter NSM JM Option submits a job for execution as a Windows process, several environmental variables are set with information you may find useful. The programs or .BAT files executed as part of a job's submission can reference these variables, but the variables cannot be altered.

JOBSET
Specifies the name of the Unicenter NSM JM Option jobset.

JOBNAME
Specifies the name of the job within the identified jobset.

JOBJNO
Specifies the job number associated with the identified jobset and job.

JOBSTATION
Specifies the Unicenter NSM JM Option station to which the job was submitted.

JOBQUAL
Specifies the Unicenter NSM JM Option job qualifier.

JOBNODE
Specifies the computer name (node ID) associated with the job.

JOBNUMBER
Specifies the unique job identifier assigned by the Unicenter NSM JM Option for internal use.

JOBSUBFILE
Specifies the command string the Unicenter NSM JM Option submitted to start this job.

JOBUSER
Specifies the user ID for which the job was submitted.
The following sample BAT file references settings within the following submitted job definition:
define jobset id=Trees
define job id=(Trees,Oak,01) station=AMERICA autosel=yes
define jobparm id=(Trees,Oak,01)subfile=Oak.bat

The OAK.BAT file contains the following:
@echo Off
set ID=%JOBSTATION%: Job(%JOBSET%,%JOBNAME%,%JOBJNO%) Qual(%JOBQUAL%)
cawto %ID% Phase 1 has ended
cawto %ID% Phase 2 has ended

If job Oak is selected or demanded, the following messages are sent to the Event Console Log:
AMERICA: Job(Trees,Oak,01) Qual(3001) Phase 1 has ended
AMERICA: Job(Trees,Oak,01) Qual(3001) Phase 2 has ended