|
|
|
The DIRECTORY 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.
Windows/OpenVMS Format:
DIRECTORY/WORKGROUP workgroup_name [/qualifiers]
UNIX/Linux Format:
lswg workgroup_name [-qualifiers]
/[no]log or -[no]log
/[no]confirm or -[no]confirm
/node or -node = target_node
Workgroup qualifiers:
/comments or -comments
/type or -type
/mode or -mode
/state or -state
/owner or -owner
/protection or -protection
/members or -members
Windows/OpenVMS:
Schedule> directory/workgroup \syscontrol\workgroups\workgroup1 /full \syscontrol\workgroups\workgroup1 Comments =
Type = Distributed_Database
Mode = None_Executable
State = Running
Job Limit = 0
Owner = {STEELO}
Protection = -rwxrw-----
Members = center+1#30%1*centerside,alpha+1#30%1*alphaside Total of 1 Workgroup OpenVMS:
Schedule> directory/workgroup [syscontrol.workgroups]workgroup1 /full
[syscontrol.workgroups]workgroup1
Comments =
Type = Distributed_Database
Mode = None_Executable
State = Running
Job Limit = 0
Owner = {STEELO}
Protection = -rwxrw-----
Members = center+1#30%1*centerside,alpha+1#30%1*alphaside
Total of 1 Workgroup
UNIX/Linux:
Schedule> lswg /syscontrol/workgroups/workgroup1 -full
/syscontrol/workgroups/workgroup1
Comments =
Type = Distributed_Database
Mode = None_Executable
State = Running
Job Limit = 0
Owner = {STEELO}
Protection = -rwxrw-----
Members = center+1#30%1*centerside,alpha+1#30%1*alphaside
Total of 1 Workgroup
/comment or -comment
The COMMENT option displays any useful description that you may have added.
/[no]confirm or -[no]confirm
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/node or -node
The NODE qualifier specifies what node (either local or remote) you want the operation performed on.
/[no]log or -[no]log
The LOG qualifier causes each completed operation to issue a note to the user.
/members or -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*batch_queue
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 |
batch_queue |
Batch queue that all jobs in the Workgroup will be submitted to |
/mode or -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 or -owner
The OWNER field indicates the owner UIC code for the workgroup.
/protection or -protection
The PROTECTION field specifies the UIC based access rights for the workgroup.
/state or -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 |
/symbol or -symbol[=prefix_string] or [=(prefix string,format)]
The SYMBOL requests that all directory information be output to a group of environmental variables. Every field in the control record is loaded into a single environmental variable. The symbol 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 symbols are output. The default output specification is: "$ %s=\" %s\" "" which produces the following format style.
SW_MODE = "Do not run"
Alternate output styles may be created by changing the format field.
/type or -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 |