SCHEDULE
Automated Job Submission System
Guide and Reference Manual
Previous Contents Index

monque

MONITOR a queue.

The MONITOR command will display all scheduling queue transistions as they happen.

General Format

monque [-options] [queue,queue...]

where queue letters are A through S and W or "*" The default list of queues is B,E,F,G,H,I,K,L,M,W.
Queue Letter Description
A Compute next start
B Wait for next start time
C Initiate with no set id.
D Workgroup Manager.
E Wait for local prerequisite
F Request remote prerequisite
G Wait for remote prerequisite
H Wait for a required file
I Wait for disk space requirements
J Ready to submit
K Submitted for execution
L Execution Started
M Job Completed
N Initiate Descendent jobs
O Send initiate request to a remote node
P Holding previous completions
Q Event messages
R Job completion messages
S Remote completion messages
W Variables being processed

Alternate

monitor/queue [-qualifiers] [queue,queue...]

option summary

-all
-current
-set_id = number
-job = name
-node = source_node

Examples

#1 

 
 
 
 Schedule> monque 
 
 
 
 
 
 E  Wtfr prereq 110. /b/start_tree (1361) 
 H  Wtfr file   110. /b/start_tree (1361) Waiting for file TEST.DAT 
 I  Wtfr disk   110. /b/start_tree (1361) Waiting for 100 blocks 
 K  Submitted   110. /b/start_tree (1361)       
 L  Started     110. /b/start_tree (1361)       
 M  Completed   110. /b/start_tree (1361) Completed on Nov. 21, 16:59 
 B  Wtfr start  141. /b/branch_2 (1361) 
 B  Wtfr start  400. /b/branch_1 (1361) 
 E  Wtfr prereq 141. /b/branch_2 (1361) 
 E  Wtfr prereq 400. /b/branch_1 (1361) 
 K  Submitted   141. /b/branch_2 (1361)   Execution queue entry 281 
 K  Submitted   400. /b/branch_1 (1361) 
 L  Started     141. /b/branch_2 (1361)   Execution queue entry 281 
 L  Started     400. /b/branch_1 (1361) 
 M  Completed   141. /b/branch_2 (1361)   Completed on Nov. 21, 17:00 
 M  Completed   400. /b/branch_1 (1361)   Completed on Nov. 21, 17:00 
 I  Wtfr disk   105. /b/job_1 (1361)      Waiting for 100 blocks 
 K  Submitted   403. /b/job_4 (1361)    
 L  Started     113. /b/job_6 (1361)    
 K  Submitted    94. /b/job_3 (1361)    
 L  Started      92. /b/job_5 (1361)    
 K  Submitted    90. /b/job_2 (1361)    
 K  Submitted   105. /b/job_1 (1361)    
 L  Started     403. /b/job_4 (1361)    
 M  Completed   113. /b/job_6 (1361)      Completed on Nov. 21, 17:01 
 L  Started      94. /b/job_3 (1361)    
 L  Started      90. /b/job_2 (1361)    
 M  Completed    92. /b/job_5 (1361)      Completed on Nov. 21, 17:01 
 L  Started     105. /b/job_1 (1361)    
 M  Completed   403. /b/job_4 (1361)      Completed on Nov. 21, 17:02 
 M  Completed    94. /b/job_3 (1361)      Completed on Nov. 21, 17:02 
 M  Completed    90. /b/job_2 (1361)      Completed on Nov. 21, 17:02 
 M  Completed   105. /b/job_1 (1361)      Completed on Nov. 21, 17:02

Options

-all

The ALL option tracks all users.

-current

The CURRENT option will start the display with the most current statistics.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-set_id=number

The SET_ID option points to a designated job set. If no number is specified the default implies all job sets.

-job=name

The JOB option displays only jobs matching the specification. The name can contain wildcards.

rmque

Delete a queue entry.

The rmque command removes a job entry from a scheduling queue. Consequently, this job does not proceed to any subsequent queues. This has no effect on the execution of a job that has already been submitted to the batch queue. Queue entries for prerequisite conditions can be deleted, resulting in the job that was waiting for these conditions proceeding to the next queue.

General Format

rmque [-options] -entry=number

Alternate

delete -queue [-options] -entry=number

option summary

-log
-confirm
-node = target_node
-entry = entry_number

Examples

#1 

 
 
 
 Schedule> rmque -entry=93

Options

-confirm

-noconfirm

CONFIRM requests that the user be prompted prior to any operation to verify that the selected job is the correct one.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-entry=number

The ENTRY option selects a particular entry in a scheduling queue.

-log

-nolog

The LOG option causes each completed operation to issue a note to the user.

Chapter 11
VARIABLE commands

These commands all perform operations on variables. The commands are as follows:
Command Description
chvar Modify the variable
cpvar Copy the variable to another variable
lsvar Display the variable(s)
mkvar Create a new variable
mvvar Rename the variable
rmvar Delete the variable

11.1 Variable commands

Variables are part of enhanced job scheduling which introduces programmatic tools into the job flow. Job flow can be suppressed, delayed or redirected based on the values contained in variables.

chvar

Modify a variable.

The chvar command is used to modify a variable.

General Format

chvar variable [-options]

Alternate

modify -variable variable

option summary

general options:

-comment=comment
-[no]log
-[no]confirm
-host=host_name
-type=var_type
-value=var_value

Examples

#1 

 
 
Schedule> chvar sch_test_var -value=on

Options

-comment

The COMMENT option is the comment that is associated with a variable.

-confirm

-noconfirm

CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-log

-nolog

The LOG qualifier causes each completed operation to issue a note to the user.

-type=var_type

The type option modifies the type of the variable. The two types are "string" for a string variable and "expression" for a variable expression.

-value

The VALUE option is used to display the contents of the variable. This value can be any alphanumeric characters up to 256 characters long.

cpvar

Copy a variable to another variable.

The cpvar command is used to copy a variable to a new variable.

General Format

cpvar from_variable to_variable [-options]

Alternate

copy -variable from_variable to_variable

option summary

general options:

-[no]log
-[no]confirm
-hostname = target_node

Examples

#1 

 
 
Schedule> cpvar sch_test_var sch_test2_var

Options

-confirm

-noconfirm

CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-log

-nolog

The LOG qualifier causes each completed operation to issue a note to the user.

lsvar

Display a directory of variables.

The lsvar command is used to display the directory of variables and to display the value of the variables. The evaluated result of a variable expression can also be displayed using the qualifier.

General Format

lsvar variable [-options]

Alternate

directory -variable variable

option summary

general options:

-columns
-comment
-host
-noheading
-notrailing
-now=projected_time
-result
-output=output_file
-env
-type
-value

Examples

#1 

 
 
Schedule> lsvar sch_test_var

#2 

 
 
Schedule> lsvar -full tommorrow 
 
/vars/tommorrow/ 
 
    Comment                   = 
    Type                      = Expression 
    Value                     = ""TODAY" + 1 DAY" 
    Result                    = "August 11, 2006,  0:00"

Options

-check

Workgroup Jobs Only. The CHECK option displays the designated object's status on the nodes in the current workgroup. Any differences are displayed as: 


 
 
 
  
node_name: different

Adding the -log qualifier displays the specific differences between the object(s) on specific nodes. Ex: 


 
\least_busy_4\job_job1.hdr 
    CWG: okay 
    DWG: different 
                Prv_Owner (215)= /0xc000000e/ 
                    Owner (015)= /0xc000000d/ 
    AWG: okay

-columns=number

The COLUMNS option specifies how many columns to use when listing just the item name. The default is four columns.

-comment

The COMMENT option is the comment that is associated with a variable.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-full

The FULL option displays any comments, a variable's value and its type. In the case of a variable expression, it displays the resulting value when the expression is evaluated.

-noheading

The NOHEADING removes the heading information from the directory listing.

-notrailing

The NOTRAILING removes the trailing information from the directory listing.

-now=projected_time

The NOW option displays the resulting value of the variable if the evaluation takes place in the time designated.

-output=output_file

The OUTPUT option sends all output to a text file. Output can be printed or displayed as needed.

-result

The RESULT option is used to display the current value of a variable expression.

-env[=prefix_string,format]

The environmental variable option requests that all information be output to a file containing a list of enviroment variables. Each field of the variable record is listed in the file as an environment variable. The environment variable name is constructed by prefixing the field name with the provide string. If none is provided a default value of SV is used.

The format defines the way that environmental variables are output. The default output specification is: "$export %s=\" %s\" "" (ksh), "$setenv %s=\" %s\" "" (csh) which produces the following format style. 


 
   SV_TYPE = "String"

Alternate output styles may be created by changing the format field.

-template=/schedule_library/template_db.schedule

The template option formats the directory output as it is defined in the template file /schedule_library/template_db.schedule . This output can be used for a variety of reasons and can be output to a file using the OUTPUT option . The supplied template file extracts all database information into a format suitable for insertion if desired.

-type

The type option is the type of the variable. The two types are "string" for a string variable and "expression" for a variable expression.

-value

The VALUE option is used to display the contents of the variable. This value can be any alphanumeric characters up to 256 characters long.

mkvar

Create a variable.

The mkvar command is used to create a variable.

General Format

mkvar variable [-options]

Alternate

create -variable variable

option summary

general options:

-comment=comment
-[no]log
-[no]confirm
-host=host_name
-type=var_type
-value=var_value

Examples

#1 

 
 
Schedule> mkvar sch_test_var -value=on

Options

-comment

The COMMENT option is the comment that is associated with a variable.

-confirm

-noconfirm

CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.

-node=target_node

The hostname option specifies what hostname (either local or remote) you want the operation performed on. -hostname may be substituted for -node.

-log

-nolog

The LOG qualifier causes each completed operation to issue a note to the user.

-type=var_type

The type option modifies the type of the variable. The two types are "string" for a string variable and "expression" for a variable expression.

-value

The VALUE option is used to display the contents of the variable. This value can be any alphanumeric characters up to 256 characters long.

Previous Next Contents Index