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

edjob

Edit a list.

The edjob command will allow any one of the lists that can be specified to be modified.

General Format

edjob [-options] job_name

Alternate

edit -job [-options] job_name

option summary

general option:

-[no]log
-[no]confirm
-nocheck
-node = target_node

section identifiers:

-commands (default)
-prerequisites
-initiates
-distribution
-notices
-holds_up
-activated_by
-endactions
-resources

editors:

-edt
-tpu

Examples

#1 

 
 
 
 Schedule> edjob monthly_run

Options

-activated_by

The "ACTIVATED_BY list" is the list of jobs that activate the job being edited.

-commands

The COMMANDS option is the list of script commands that will be submitted in the form of a command file.

-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.

-distribution

The "DISTRIBUTION list" is a list of PRINT commands to be issued. The idea is to provide a central mechanism for maintaining the how many, where to, and what printer information in a common location separate from the job command stream.

endactions

The ENDACTIONS listing is a list of resource adjustments that are to be run upon completion of the job.

-holds_up

The "HOLDS_UP list" is a list of jobs that are held up by the job being edited.

-initiates

The "INITIATES list" is the list of other jobs to start up when this one completes successfully.

-log

-nolog

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

-nocheck

The NOCHECK option disables the CHECK whether or not a provided prerequisite or initiate list makes references to any non-existent jobs.

-notices

The "NOTICES list" is a free format text entry that is used by the NOTIFICATION procedure to augment the various messages that it sends.

-prerequisites

The "PREREQUISITES list" is the list of other jobs that must be successfully completed before this one is started.

-resources [-check, -expanded, -full]

Displays a list of generalized resources. The resource list is where the bulk of advanced job programming occurs. Here IF-THEN or SET statements are processed that can check or alter the value of a variable, supress a job run or cause a wait to occur.

The CHECK qualifier performs a syntax check on the resource list to ensure the correct IF-THEN and set statements can take effect. The EXPANDED qualifier used in conjunction with CHECK will display expanded information about the current status of the resource list. The FULL qualifier will give a complete listing of resource information

extjob

Extract a list into a text file.

The extjob command will extract a list from the database and write it into a file.

General Format

extjob [-options] job_name output_file_name

Alternate

extract -job [-options] job_name output_file_name

option summary

general qualifiers:

-[no]log
-[no]confirm
-nocheck
-node = target_node

section identifiers:

-commands (default)
-prerequisites
-initiates
-distribution
-notices
-holds_up
-activated_by
-endactions
-resources

Examples

#1 

 
 
 
 Schedule> extjob incremental -commands comfile.com

Options

-activated_by

The "ACTIVATED_BY list" is the list of jobs that activate the job being edited.

-commands

The COMMANDS option is the list of script commands that will be submitted in the form of a command file.

-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.

-distribution

The "DISTRIBUTION list" is a list of PRINT commands to be issued. The idea is to provide a central mechanism for maintaining the how many, where to, and what printer information in a common location separate from the job command stream.

endactions

The ENDACTIONS listing is a list of resource adjustments that are to be run upon completion of the job.

-holds_up

The "HOLDS_UP list" is a list of jobs that are held up by the job being edited.

-initiates

The "INITIATES list" is the list of other jobs to start up when this one completes successfully.

-log

-nolog

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

-notices

The "NOTICES list" is a free format text entry that is used by the NOTIFICATION procedure to augment the various messages that it sends.

-prerequisites

The "PREREQUISITES list" is the list of other jobs that must be successfully completed before this one is started.

-resources [-check, -expanded, -full]

Displays a list of generalized resources. The resource list is where the bulk of advanced job programming occurs. Here IF-THEN or SET statements are processed that can check or alter the value of a variable, supress a job run or cause a wait to occur.

The CHECK qualifier performs a syntax check on the resource list to ensure the correct IF-THEN and set statements can take effect. The EXPANDED qualifier used in conjunction with CHECK will display expanded information about the current status of the resource list. The FULL qualifier will give a complete listing of resource information

incjob

Advance the start time one cycle.

The incjob command will advance the start date by one cycle. All the conditions and constraints are applied in this process. For example, if the definition calls out for skipping weekends, then the increment command will also skip weekends. This command only applies to jobs that have a rescheduling method specified.

General Format

incjob [-options] job_name

Alternate

increment -job [-options] job_name

option summary

general options:

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

Examples

#1 

 
 
 
 Schedule> incjob daily_backup

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.

insjob

Insert a list , environmental variables or an input stream into a job. Environmental variables and input stream are all inserted into the COMMAND list by default and therefore do not require the /JOB qualifier.

The insjob command will read a supplied file and replace an existing list inside the SCHEDULE database.

General Format

insjob job_name [-qualifiers] input_file_name

Alternate

insert /job [/options] job_name input_file_name or
KEYSTROKES or
SYMBOLS or
sys$input | stdin | *

The inserted list can come from the following sources:

option summary

general qualifiers:

-[no]log
-[no]confirm
-nocheck
-node = target_node

section identifiers:

-commands (default)
-prerequisites
-initiates
-distribution
-notices
-holds_up
-activated_by
-endactions
-resources

Examples

#1 

 
 Schedule> insjob incremental -commands script.sh

#2 

 
        Schedule> insert newjob stdin 
 > ls 
        >

Options

-activated_by

The "ACTIVATED_BY list" is the list of jobs that activate the job being edited.

-commands

The COMMANDS option is the list of script commands that will be submitted in the form of a command file.

-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.

-distribution

The "DISTRIBUTION list" is a list of PRINT commands to be issued. The idea is to provide a central mechanism for maintaining the how many, where to, and what printer information in a common location separate from the job command stream.

endactions

The ENDACTIONS listing is a list of resource adjustments that are to be run upon completion of the job.

-holds_up

The "HOLDS_UP list" is a list of jobs that are held up by the job being edited.

-initiates

The "INITIATES list" is the list of other jobs to start up when this one completes successfully.

-log

-nolog

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

-notices

The "NOTICES list" is a free format text entry that is used by the NOTIFICATION procedure to augment the various messages that it sends.

-prerequisites

The "PREREQUISITES list" is the list of other jobs that must be successfully completed before this one is started.

-resources [-check, -expanded, -full]

Displays a list of generalized resources. The resource list is where the bulk of advanced job programming occurs. Here IF-THEN or SET statements are processed that can check or alter the value of a variable, supress a job run or cause a wait to occur.

The CHECK qualifier performs a syntax check on the resource list to ensure the correct IF-THEN and set statements can take effect. The EXPANDED qualifier used in conjunction with CHECK will display expanded information about the current status of the resource list. The FULL qualifier will give a complete listing of resource information

-env

Inserts the contents of the designated environmental variable into the command list of the job. The environmental variable is created using the more -env command.

ls (or lsjob)

Display on-line information.

The ls command will display all or just selected portions of the scheduling database.

There are three modes of operation for this command.

  1. Line mode: select columns of information are requested.
  2. Full mode: the -full (=all includes all lists) qualifier requests a complete listing of all the information about the job.
  3. Environment variable mode: This option requests a complete itemization of the job to be listed in a file for the creation of environment variables.
  4. Environment variable mode combined with full mode: By using the -env -full=all options, all of the control fields are output to a file listing environment variables prefixed by SC and all lists (COMMANDS, PREREQUISITES, INITIATES, DISTRIBUTION, NOTICES, HOLDS_UP, and ACTIVATED_BY) are output to a group of environment variables (prefixed by SD, SP, SI, ST, SN, SH, and SA respectively).

General Format

ls [-options] job_name

Alternate

directory -job [-options] job_name

option summary

-output = file_spec
-node = target_node
-noheading
-notrailing
-columns = number
-env [= prefix_string,format](Prefix default = sc)(Format default = "export %s = \" " %s \" "" (ksh) "setenv %s = \" " %s \" "" (csh)
-full [= list_name or (name,name,...)] names are all, notices, initiates prerequisites, commands, distribution, holds_up, activated_by
-resources=
disk_space
file
measured
estimated
-notify=
submitted
started
delayed
completed
failed

-process=

node
cputime
flags
log_file
versions_of_log
name
parameter
variable

-general=

comment
next_submit
last_start
last_submit
last_completed
restart_count
up_count
down_count
user
owner
protection
status
job_tag
pre_com_file
post_com_file
execute_window
startup_window

-check
-rescheduling
-template=/schedule_library/template_db.schedule

Examples

#1 

 
 
 
 Schedule> ls -full /demo/a/start 
 
  /demo/a/start 
 
 
 
 
 
 
 
 
 
 General 
     Comment                   = Starts first job run 
     Next submit               = November 13, 1997, 16:21 
     Last submit               = November 13, 1997, 12:22 
     Last start                = November 13, 1997, 12:22 
     Last completed            = November 13, 1997, 12:24 
     Up count                  = 402 
     Down count                = infinite 
     Restart count             = 3 
     Status                    = %x00030001 
     Flags                     = History 
     Job tag                   = 
     Pre COM file              = 
     Post COM file             = 
     Startup window            = 0-00:15:00.00 
     Execute window            = 0-12:00:00.00 
     Owner                     = [SYSTEM] 
     Protection                = -rwxrw---- 
 
 Rescheduling 
     Interval                  = 0-04:00:00.00 
     Calendar                  = WORKDAYS 
 
 Job 
         User                      = pjones 
         Shell                     = /bin/csh 
         Node                      = osfws1 
         Flags                     = Delete,Keep 
         Log file                  = 
         Name                      = 
         Parameter                 = "","","","","","","","" 
     Job variables: 
      Newvalue              = 543 
  Username       = Plaindrome 
         Resident set size         = 0 
         CPU time limit            = Not set 
 
 Resources 
     Disk space                = ,0 
     File                      = 
     Measured                  = 3,133,249,397 
     Estimated                 = 0,0,0 
 
 Notify 
     Submitted                 = 
     Started                   = 
     Completed                 = 
     Failed                    = SYSTEM,Mail 
     Delayed                   = SYSTEM,Mail 
     After delayed             = 0-00:10:00.00

#2 

 
 
 
 
 Schedule> ls /demo/a/* -reso=measure -gen=status 
 
 Job directory /demo/a/ 
 
 
 
 
 
    FAILED              5,145,297,4                   %x00030001  
    FINISHED            3,132,246,356                 %x00030001  
    REPORT_1            4,138,248,390                 %x00030001  
    REPORT_2            4,133,250,376                 %x00030001  
    REPORT_3            4,136,248,371                 %x00030001  
    START               3,133,249,397                 %x00030001  
    SUMMARY_A           8,149,253,386                 %x00030001  
    SUMMARY_B           15,164,252,387                %x00030001  
    UPDATE_A            4,143,245,393                 %x00030001  
    UPDATE_A_FAILED     0,0,0,0                       %x18788BBC  
    UPDATE_B            7,147,259,466                 %x00030001  
    UPDATE_C            15,161,253,386                %x00030001  
 
 Total of 12 jobs

#3 

 
 
 
 
 Schedule> ls -env /demo/a/start -out=t.txt 
 $ type t.txt 
 
 
 
 
 
   SC_ACCOUNT = "DEVELOPM" 
   SC_AFTER_DELAYED = "0-00:10:00.00" 
   SC_CALENDAR = "WORKDAYS" 
   SC_CHARACTERISTICS = "" 
   SC_COMMENT = "" 
   SC_COMPLETED = "" 
   SC_CPUTIME = "0-00:00:00.00" 
   SC_DELAYED = "SYSTEM,MAIL" 
   SC_DISK_SPACE = ",0" 
   SC_DOWN_COUNT = "INFINITE" 
   SC_ESTIMATED = "0,0,0" 
   SC_EXECUTE_WINDOW = "NOT SET" 
   SC_FAILED = "SYSTEM,MAIL" 
   SC_FILE = "" 
   SC_FLAGS = "DELETE,NOHOLD,KEEP,NOPRINT,NORESTART" 
   SC_INTERVAL = "0-04:00:00.00" 
   SC_JOB_TAG = "" 
   SC_LAST_COMPLETED = "13-NOV-1997 12:24:25.12" 
   SC_LAST_START = "13-NOV-1997 12:22:16.44" 
   SC_LAST_SUBMIT = "13-NOV-1997 12:22:04.32" 
   SC_LOG_FILE = "" 
          SC_VERSIONS_OF_LOG = "12" 
   SC_MEASURED = "3,133,249,397" 
   SC_METHOD = "INTERVAL" 
   SC_NAME = "" 
   SC_NEXT_SUBMIT = "13-NOV-1997 16:21:46.81" 
   SC_NODE = "" 
   SC_OWNER = "[SYSTEM]" 
   SC_PARAMETER = ""00:02:00","","","","","","",""" 
   SC_POST_COM_FILE = "" 
   SC_PRE_COM_FILE = "" 
   SC_PRINTER = "SYS$PRINT" 
   SC_PRIORITY = "0" 
   SC_PROTECTION = "-rwxrw----" 
   SC_QUEUE = "ANY$BATCH" 
   SC_RESTART_COUNT = "3" 
   SC_STARTED = "" 
   SC_STARTUP_WINDOW = "NOT SET" 
   SC_STATUS = "%X00030001" 
   SC_SUBMITTED = "" 
   SC_UP_COUNT = "402" 
   SC_USER = "SYSTEM"

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.

-node=node_name

The NODE option specifies what node (either local or remote) you want the operation performed on.

-noheading

The NOHEADING removes the heading information from the directory listing.

-notrailing

The NOTRAILING removes the trailing information from the directory listing.

-full [= list_name or (name,name,...)]

The FULL option requests that all the known attributes of a file be displayed. An optional list name(s) can be specified with this option . If a list is specified then that information is displayed after all the other attributes of the job have been displayed. When the FULL option is used together with the SYMBOL option the lists are put into environment variables.

-general=comment

The COMMENT option displays any useful description that you may have added.

-general=down_count

The DOWN_COUNT option displays the remaining number of times a job is to be executed. This is automatically updated.

-general=execute_window

The EXECUTE_WINDOW displays the interval in which a job is allowed to have both all requirements met and execute. This is the time it takes a job to move from scheduling queue C or D to M. Any job that exceeds this interval will be have none of it's initiates activated. This interval is designed to prevent a run away catch up mode from happening if the system is down for a long period.

-general=flags

The HISTORY flag indicates whether or not history data is to be recorded for this job. A job that runs very frequently generates a lot of history data. To reduce the growth of this history file specify the NOHISTORY flag.

Previous Next Contents Index