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

cpwg

Copy a workgroup.

The cpwg command is used to copy a workgroup file to new workgroup file name.

General Format

cpwg from_workgroup_name to_workgroup_name [-options]

Alternate

copy -workgroup from_workgroup_name to_workgroup_name

option summary

general options:

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

Examples

#1 

 
 
Schedule> cpwg sch_test_wg sch_test2_wg

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.

lswg

Display the contents of the workgroup directory.

The lswg command displays the contents of the workgroup directory . The workgroup directory command only applies in the /syscontrol/workgroups directory. All other directories are not valid Workgroup directories.

General Format

lswg [-options] workgroup_name

Alternate

directory -workgroup [-options] workgroup_name

option summary

general options:

-[no]log
-[no]confirm
-hostname = target_node
Workgroup options:

-comments=comment
-type=database_type
-mode=execution_mode
-state=status
-owner=owner
-protection=protection
-members=workgroup_members
-env [= prefix_string,format](prefix default = sw)(format default = "$ %s = \" " %s \" "")

Examples

#1 

 
 
 
Schedule> lswg /syscontrol/workgroup/workgroup -full 
/syscontrol/workgroups/workgroup1 
    Comments                  = 
    Type                      = Distributed_Database 
    Mode                      = None_Executable 
    State                     = Running 
    Job Limit                 = 0 
    Owner                     = {Mossberg} 
    Protection                = -rwxrw---- 
    Members                   = center+1#30%1,alpha+1#30%1,boot+1#30%1 
 
Total of 1 Workgroup

Options

-comment

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

-confirm

-noconfirm

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

-node=node_name

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

-log

-nolog

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

-members

The MEMBERS qualifier sets the nodes that are in the Workgroup and the Power rating, job limit and Quorum Votes that the node will have. The MEMBERS string is formulated as: 


node_name+power_rating#job_limit%quorum_votes

where:
Members Description
node_name Name of the node to be added to the Workgroup
power_rating Rated power level of the node in the Workgroup
job_limit Number of jobs that will be allowed to run on that node at one time
quorum_votes Number of votes that the node will have in case other nodes fail

-mode

The MODE qualifier determines how the workgroups will execute job submissions. The possible modes are:
Mode Description
all Run on ALL nodes in the Workgroup
roundrobin Run in the nodes in a round-robin fashion
failover Run on the first accessible node on the workgroup
least Run on the least busy node in the workgroup
none No jobs can run in the workgroup

-owner

The OWNER option displays the owner user id and group id code for the workgroup.

-protection

The PROTECTION field modifies the read, write and execute permissions of specified workgroups.
who specifies whether permissions are being defined for user(u), group(g) or all others(o).
permission specifies the permissions being defined. Read permission(r) allows reading. Write permission (w) allows the ability to write out a new version. Execute permission(x) allows execution of jobs and calendars, search of directories.

-state

The STATE qualifier determines whether the database is running jobs or paused. The states are:
State Description
not All jobs are PAUSED or waiting to run
run All jobs are allowed to RUN

-env[=prefix_string] or [=(prefix_string,format)]

The environmental variable option requests that all workgroup information be output to a file containing a list of enviroment variables. Every field in the control 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 SW 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. 


 
    SW_MODE = "Do not run"

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

-type

The TYPE qualifier determines how the database will be distributed throughout the Workgroup, whether it be through clustering or replication. The types are:
Type Description
limited The database is shared using a limited cluster system
full The database is shared using a fully clustered system
distributed The database is distributed between nodes
replicated The database is distributed and replicated among nodes

mkwg

Create a new workgroup.

The mkwg command will add a new workgroup to the database. Create workgroups in the /syscontrol/workgroups directory. All other directories are not valid Workgroup directories and you will not be allowed to create the Workgroup.

General Format

mkwg [-options] workgroup_name

Alternate

create -workgroup [-options] workgroup_name

option summary

general options:

-[no]log
-[no]confirm
-hostname = target_node
Workgroup options:

-comments=comment
-type=database_type
-mode=execution_mode
-state=status
-owner=owner
-protection=protection
-members=workgroup_members

Examples

#1 

 
 
 
 Schedule> mkwg /syscontrol/workgroup/new_wg 
 created /syscontrol/workgroup/new_wg/

Options

-comment:"any text string"

The COMMENT field is any useful description that you may want to add. This is an 80 character option.

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

-members=member_string

The MEMBERS qualifier sets the nodes that are in the Workgroup and the Power rating, job limit and Quorum Votes that the node will have. The MEMBERS string is formulated as: 


node_name+power_rating#job_limit%quorum_votes

where:
Members Description
node_name Name of the node to be added to the Workgroup
power_rating Rated power level of the node in the Workgroup
job_limit Number of jobs that will be allowed to run on that node at one time
quorum_votes Number of votes that the node will have in case other nodes fail

-mode=execution_mode

The MODE qualifier determines how the workgroups will execute job submissions. The possible modes are:
Mode Description
all Run on ALL nodes in the Workgroup
roundrobin Run in the nodes in a round-robin fashion
failover Run on the first accessible node on the workgroup
least Run on the least busy node in the workgroup
none No jobs can run in the workgroup

-owner:uic

The OWNER field indicates the owner user id and group id code for the workgroup.

-protection:[who]-permission

The PROTECTION field modifies the read, write and execute permissions of specified workgroup.
who specifies whether permissions are being defined for user(u), group(g) or all others(o).
permission specifies the permissions being defined. Read permission(r) allows reading. Write permission (w) allows the ability to write out a new version. Execute permission(x) allows execution of jobs and calendars, search of directories.

-state=execution_state

The STATE qualifier determines whether the database is running jobs or paused. The states are:
State Description
not All jobs are PAUSED or waiting to run
run All jobs are allowed to RUN

-type=execution_type

The TYPE qualifier determines how the database will be distributed throughout the Workgroup, whether it be through clustering or replication. The types are:
Type Description
limited The database is shared using a limited cluster system
full The database is shared using a fully clustered system
distributed The database is distributed between nodes
replicated The database is distributed and replicated among nodes

mvwg

Rename a workgroup.

The mvwg command is used to rename a workgroup file to new workgroup file name.

General Format

mvwg from_workgroup_name to_workgroup_name [-options]

Alternate

rename -workgroup from_workgroup_name to_workgroup_name

option summary

general options:

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

Examples

#1 

 
 
Schedule> mvwg sch_test_wg sch_test2_wg

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.

rmwg

Delete a workgroup.

The rmwg command is used to delete a workgroup file.

General Format

rmwg workgroup_name [-options]

Alternate

delete -workgroup workgroup_name

option summary

general options:

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

Examples

#1 

 
 
Schedule> rmwg sch_test_wg

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.

12.3 Layout file commands

Layout files are used in the MOTIF display to determine the way a layout looks, where job windows appear and the location of all jobs and interdependecy lines. The following commands are used to work with these files.

catlay or morelay

Display the contents of a layout definition.

The catlay command displays the contents of an entire layout definition. morelay displays the contents of a layout definition one page at a time.

General Format

catlay layout_name [-options]

Alternate

type -layout layout_name
type -layout -page layout_name

option summary

general options:

-node=target_node
-noheading
-notrailing
-output=output_file
-senv

Examples

#1 

 
 
Schedule> morelay -page sch_test_lay 
 
 
 
PANEL_POSITION = 29 36 
MONITOR_BEGIN 
  POSITION = 533 403 
  SIZE = 650 300 
  TITLE = Job Monitor for All Queues, All Jobs 
 
  
  JOB_SPEC = */*/* 
  BASE_NODE_DIR_NAME = boot/test/ 
 
 
  JOB_SET_ID = 0 
  CURRENT_STATUS = 0 
  ALL_USERS = 0 
  QUEUE_MASK = fffffff 
MONITOR_END 
GROUP_BEGIN 
  POSITION = 535 33 
  SIZE = 561 338 
  ORIENTATION = HORIZ 
  ZOOM = OUT 
  JOBS_BEGIN 
 
 
    boot/test/test1  46  62 
    boot/test/junk1/rob2  112  175 
    boot/rob/zzz  285  54 
 
 
  JOBS_END 
GROUP_END

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.

-output=output_file

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

-env[=prefix_string] or [=(prefix_string,format)]

The environmental variable option requests that all job information be output to a file containing a list of enviroment variables. Every field in the control 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 SC 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. 


 
   SC_ACCOUNT = "DEVELOPM"

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

Previous Next Contents Index