TWS Documents
TWS Documents
Add
• Adds scheduling objects
• To add the jobs from the file myjobs, run the following command:
add myjobs
• To add the job streams from the file mysked, run the following
command:
a mysked
Build
• Builds or rebuilds a IBM Tivoli Workload Scheduler file. Builds or rebuilds scheduler
database files. You must have build access to the file.
build filename
database file name Specifies one of the following file names:
• calendars The file that contains calendar definitions.
• cpudata The file that contains workstation, workstation class, and domain
definitions.
• jobs The file that contains job definitions.
• mastsked The file that contains job stream definitions.
• parms The file that contains parameter definitions.
• prompts The file that contains prompt definitions.
• resources The file that contains resource definitions.
• userdata The file that contains user definitions.
If a file does not exist, one is created. If the file exists, it is rebuilt. Rebuilding a database
file can be useful when the database becomes fragmented from numerous additions
and deletions. The rebuild will remove unused records and optimize the keys.
Continue
Ignores the next error
• This command is useful when multiple commands are entered on the
command line or redirected from a file. It instructs Composer to continue
executing commands even if the next command, following continue, results
in an error. This command is not needed when you enter commands
interactively because Composer will not quit on an error.
• If you want the Composer to continue with the print command if the delete
command results in an error, run the following command:
composer "continue&delete cpu=site4&print cpu=@"
• To delete all workstations with names starting with ux, run the following
command:
de cpu=ux@
• To delete all job streams with names starting with test on all workstations,
run the following command:
de sched=@#test@
Create
• Creates a file for editing.
• create filename from calendars | parms | prompts | resources | cpu={wkstation |
wkstationclass | domain} | jobs=[wkstation#]jobname | sched=[wkstation#]jstream |
users=[wkstation#]username
• calendars Copies all calendars into the file.
• parms Copies all parameters into the file.
• prompts Copies all prompts into the file.
• resources Copies all resources into the file.
• cpu Copies a workstation, workstation class, or domain into the file. wkstation The
workstation name. Wildcard characters are permitted. wkstationclass The workstation
class name. Wildcard characters are permitted. domain The domain name. Wildcard
characters are permitted.
• jobs Copies jobs into the file. wkstation The name of the workstation or workstation
class on which the job runs. Wildcards are permitted. The default is the workstation on
which Composer is running. jobname The job name. Wildcards are permitted.
• sched Copies job streams into the file. wkstation The name of the workstation or
workstation class on which the job stream runs. Wildcard characters are permitted. The
default is the workstation on which Composer is running. jstream The job stream name.
Wildcard characters are permitted.
• users Copies users into the file. The password field is not copied for security reasons.
wkstation The name of the workstation on which the user is defined. Wildcard characters
are permitted. The default is the workstation on which Composer is running.
Delete
• Deletes scheduling objects.
• delete Deletes object definitions from the database. You must have delete access to
the objects being deleted. Synopsis
delete cpu={wkstation | wkstationclass | domain} | jobs=[wkstation#]jobname |
sched=[wkstation#]jstream | users=[wkstation#]username username Arguments
• cpu Deletes workstations, workstation classes, or domains. wkstation The
workstation name. Wildcards are permitted. wkstationclass The workstation class
name. Wildcards are permitted. domain The domain name. Wildcards are permitted.
• jobs Deletes jobs. wkstation The name of the workstation or workstation class on
which the job runs. Wildcards are permitted. The default is the workstation on which
Composer is running. jobname The job name. Wildcards are permitted.
• sched Deletes job streams. wkstation The name of the workstation or workstation
class on which the job stream runs. Wildcards are permitted. The default is the
workstation on which Composer is running. jstream The job stream name. Wildcards
are permitted.
• users Deletes users. wkstation The name of the workstation on which the user is
defined. Wildcards are permitted. The default is the workstation on which Composer
is running. username The user name. Wildcards are permitted.
• To delete job3 that is launched on workstation site3, run the following command:
delete jobs=site3#job3
Display
• Displays scheduling objects.
• display, list, print Displays, lists, or prints object definitions. For display and print, you must
have display access to the object. Display actually displays the contents of the database
object, while list and print display on the name and attributes of the database object.
Synopsis display | list | print calendars | parms | prompts | resources | cpu={wkstation | wkstationclass | domain} |
jobs=[wkstation#]jobname | sched=[wkstation#]jstream | users=[wkstation#]username Arguments
• calendars Displays all calendars.
• parms Displays all parameters.
• prompts Displays all prompts.
• resources Displays all resources.
• cpu Displays a workstation, workstation class, or domain. wkstation The workstation name. Wildcards are
permitted. wkstationclass The workstation class name. Wildcards are permitted. domain The domain name.
Wildcards are permitted.
• jobs Displays a job. wkstation The name of the workstation or workstation class on which the job runs.
Wildcards are permitted. The default is the workstation on which Composer is running. jobname The job
name. Wildcards are permitted.
• sched Displays a job stream. wkstation The name of the workstation or workstation class on which the job
stream runs. Wildcards are permitted. The default is the workstation on which Composer is running.
jstream The job stream name. Wildcards are permitted.
• users Displays a user. (The password field is not copied for security reasons.) wkstation The name of the
workstation on which the user is defined. Wildcards are permitted. The default is the workstation on which
Composer is running.
Edit
• edit filename
• To open the file mytemp for editing, run the following command: edit mytemp To
open the file resfile for editing, run the following command: ed resfile
Exit
• When you are running the Composer command line program in help mode, this
command returns Composer to command input mode.
• To exit the Composer command line program, run the following command: exit or: e
Chapter
Modify
• modify calendars | parms | prompts | resources | cpu={wkstation | wkstationclass | domain} |
jobs=[wkstation#]jobname | sched=[wkstation#]jstream | users=[wkstation#]username
•
calendars Modifies all calendars.
• parms Modifies all parameters.
• prompts Modifies all prompts.
• resources Modifies all resources.
• cpu Modifies a workstation, workstation class, or domain. wkstation The workstation
name. Wildcards are permitted. wkstationclass The workstation class name. Wildcards
are permitted. domain The domain name. Wildcards are permitted.
• jobs Modifies a job. wkstation The name of the workstation or workstation class on
which the job runs. Wildcards are permitted. The default is the workstation on which
Composer is running. jobname The job name. Wildcards are permitted.
• sched Modifies a job stream. wkstation The name of the workstation or workstation
class on which the job stream runs. Wildcards are permitted. The default is the
workstation on which Composer is running. jstream The job stream name. Wildcards
are permitted.
• users Modifies a user. wkstation The name of the workstation on which the user is
defined. Wildcards are permitted. The default is the workstation on which Composer
is running. username The user name. Wildcards are permitted.
Modify
• The modify command copies the definition or object list into a
temporary file, edits the file, and then adds the contents of the file
to the appropriate database file. This is equivalent to the following
sequence of commands:
• create file from object-specification edit file add file
• If the add operation is successful, the edit file is purged. For more
information, refer to the descriptions of the create, edit, and add
commands in this chapter.
• For user definitions, if a password field remains empty when you
exit the editor, the old password is retained. To specify a null
password use two consecutive double quotes (“”).
• Examples To modify all calendars, run the following command:
modify calendars To modify job stream sked9 that is launched on
workstation site1, run the following command:
• m sched=site1#sked9
New
• Adds a new scheduling object. You must have add
access for new objects on the workstation. For existing
objects, you must have modify access to the object or
the affected database file.
Redo
• Edits and reruns the previous command.
• When you run the redo command, Composer displays the previous command, so
that it can be edited and rerun. Use the spacebar to move the cursor under the
character to be modified, and enter the following directives.
• Directives d[dir] Deletes the character above the d. This can be followed by other
directives. itext Inserts text before the character above the i. rtext Replaces one or
more characters with text, beginning with the character above the r. Replace is
implied if no other directive is entered. >text Appends text to the end of the line.
>d[dir | text] Deletes characters at the end of the line. This can be followed by
another directive or text. >rtext Replaces characters at the end of the line with text.
• Directive Examples
• ddd Deletes the three characters above the ds.
• iabc Inserts abc before the character above the i.
• rabc Replaces the three characters, starting with the one above the r, with abc. abc
Replaces the three characters above abc with abc.
• d diabc Deletes the character above the first d, skips one character, deletes the
character above the second d, and inserts abc in its place.
• >abc Appends abc to the end of the line.
• >ddabc Deletes the last two characters in the line, and inserts abc in their place.
• >rabc Replaces the last three characters in the line with abc.
Redo
redo
dislay site1#sa@
ip
display site1#sa@
redo
display site1#sa@
r2
display site2#sa@
Replace
• Replaces scheduling objects. You must have modify access to the objects
or the affected database file.
• The replace command is similar to the add command, except that there is
no prompt to replace existing objects. For more information, refer to “add”
on page 60.
Examples
• To replace the jobs from the file myjobs, run the following command:
replace myjobs
• To replace the job streams from the file mysked, run the following
command: rep mysked
• To replace all resources with those contained in the file myres, run the
following command: rep myres
System command
• Runs a system command.
• Synopsis [: | !] sys-command
• Arguments sys-command Specifies any valid system command. The prefix of colon
(:) or exclamation mark (!) is required only when the command is spelled the same
as a Composer command.
Examples
• To run a ps command on UNIX, run the following command: ps -ef
• To run a dir command on Windows, run the following command: dir \bin
Validate
• validate filename[;syntax]
• Arguments
• filename Specifies the name of a file that contains calendars, workstations,
workstation classes, domains, jobs, parameters, prompts, resources, or job streams.
Enter prodsked to validate the production schedule file created during pre-
production day processing.
• syntax Checks the file for syntax error.
• To check the syntax of a file containing workstation definitions, run the following
command:
validate mycpus;syntax
• To revalidate all job streams, run the following command: create allskeds from
sched=@#@ validate allskeds
Version
• Displays the Composer’s command line program banner.
• To display the Composer’s command line program banner, run the following
command: version or: v