HCL Workload Automation, Version 9.4

Conman commands

This section lists the commands you can run from the conman program.

This is how you access to the conman command line:

conman [connection_parameters] ["command[&[command]...] [&]"]

where connection_parameters, if they are not supplied in the localopts or useropts files, are the following:

[-file filename]
[-host hostname]
[-port port_name]
[-protocol protocol_name]
[-proxy proxy_name]
[-proxyport proxy_port_number]
[-password user_password]
[-timeout seconds]
[-username user_name]

For more details, see Setting up options for using the user interfaces.

This is how you select jobs in commands:

[workstation#] 
{jobstreamname(hhmm[ date]) job|jobnumber}
[{+|~}jobqualifier[...]]

or:

[workstation#]
jobstream_id.
job 
[{+|~]jobqualifier[...]]
;schedid

This is how you select job streams in commands:

[workstation#]
jobstreamname(hhmm[ date]) 
[{+|~}jobstreamqualifier[...]]

or:

[workstation#]
jobstream_id
 ;schedid

You can run these commands from different types of workstations. In this table:

F: stands for domain managers and fault-tolerant agents.
S: stands for standard agents.

For each command you find the name, the syntax, the type of workstations from where you can issue the command, and the needed authorization, if any.

Table 1. Commands that can be run from conman
Command	Syntax	Workstation types	User Authorization
adddep job	{adddep job \| adj} jobselect ;dependency[;...] [;noask]	F	adddep - (use when using prompts and needs)
adddep sched	{adddep sched \| ads} jstreamselect ;dependency[;...] [;noask]	F	adddep - (use when using prompts and needs)
altpass	altpass [workstation#] username [;"password"]	F	altpass
altpri	{altpri \| ap} jobselect \| jstreamselect [;pri] [;noask]	F	altpri
bulk_discovery	{bulk_discovery \| bulk}	F	display
cancel job	{cancel job \| cj} jobselect [;pend] [;noask]	F	cancel
cancel sched	{cancel sched \| cs} jstreamselect [;pend] [;noask]	F	cancel
checkhealthstatus	{checkhealthstatus \| chs} [workstation]	M,F,S
confirm	{confirm \| conf} jobselect ;{succ \| abend} [;IF 'output_condition_name[, output_condition_name] [, ...]'] [;noask]	F	confirm
console	{console \| cons} [sess \| sys] [;level=msglevel]	F-S	console
continue	{continue \| cont}	F-S
deldep job	{deldep job \| ddj} jobselect ;dependency[;...] [;noask]	F	deldep
deldep sched	{deldep sched \| dds} jstreamselect ;dependency[;...] [;noask]	F	deldep
deployconf	{deployconf \| deploy} [domain!]workstation	F,S	Permission to start actions on cpu objects
display	{display file \| df} filename [;offline] {display job \| dj} jobselect [;offline] {display sched \| ds} jstreamselect [valid {at date \| in date date} [;offline]	F-S¹	display
exit	{exit \| e}	F-S
fence	{fence \| f} workstation ;pri [;noask]	F	fence
help (UNIX only)	{help \| h} {command\|keyword}	F-S
kill	{kill \| k} jobselect [;noask]	F	kill
limit cpu	{limit cpu \| lc } workstation ;limit [;noask]	F	limit
limit sched	{limit sched \| ls } jstreamselect ;limit [;noask]	F	limit
link	{link \| lk} [domain!]workstation [;noask]	F-S	link
listsym	{listsym \| lis} [trial \| forecast] [;offline]	F
recall	{recall \| rc} [workstation] [;offline]	F	display
redo	{redo \| red}	F-S
release job	{release job \| rj} jobselect [;dependency[;...]] [;noask]	F	release
release sched	{release sched \| rs} jstreamselect [;dependency[;...]] [;noask]	F	release
reply	{reply \| rep} { promptname \| [workstation#]msgnum} ;reply [;noask]	F	reply
rerun	{rerun \| rr} jobselect [;from=[wkstat#]job [;at=time] [;pri=pri]] [;sameworkstation=] [;step=step] [;streamlogon\|logon=new_logon] [;docommand="new_command"\|;script="new_script"] [;noask]	F	rerun
resource	{resource \| reso} [workstation#] resource;num [;noask]	F	resource
setsym	{setsym \| set} [trial \| forecast] [filenum]	F
showcpus	{showcpus \| sc} [[domain!]workstation] [;info\|;link] [;offline]	F-S	list²
showdomain	{showdomain \| showdom \| sd} [domain] [;info] [;offline]	F-S	list²
showfiles	{showfiles \| sf} [[workstation#]file] [;state[;...]] [;keys] [;offline] {showfiles \| sf} [[workstation#]file] [;state[;...]] [;deps[;keys \| info \| logon]] [;offline]	F
showjobs	{showjobs \| sj} [jobselect] [;deps[;keys \| info \| logon]] [;short \| single] [;offline] [;showid] [;props] {showjobs \| sj} [jobselect \| [workstation#]jobnumber.hhmm] [;stdlist[;keys]] [;short \| single] [;offline] [;showid] [;props]	F	list²
showprompts	{showprompts \| sp} [promptselect] [;keys] [;offline] {showprompts \| sp} [promptselect] [;deps[;keys \| info \| logon]][;offline]	F	list²
showresources	{showresources \| sr} [[workstation#]resourcename] [;keys] [;offline] {showresources \| sr} [[workstation#]resourcename] [;deps[;keys \| info \| logon]] [;offline]	F	list²
showschedules	{showscheds \| ss} [jstreamselect] [;keys] [;offline] [;showid] {showscheds \| ss} [jstreamselect] [;deps[;keys \| info \| logon]] [;offline] [;showid]	F	list²
shutdown	{shutdown \| shut} [;wait]	F-S	shutdown
start	start [domain!]workstation [;mgr] [;noask] [;demgr]	F-S	start
startappserver	startappserver [domain!]workstation [;wait]	F-S	Permission to start actions on cpu objects
startevtp	{starteventprocessor \| startevtp} [domain!]workstation	M⁴	Permission to start actions on cpu objects
startmon	{startmon \| startm} [domain!]workstation [;noask]	F-S	Permission to start actions on cpu objects
status	{status \| stat}	F-S	appserver
stop	stop [domain!]workstation [;wait] [;noask]	F-S	stop
stop ;progressive	stop ;progressive		stop
stopappserver	{stopappserver \| stopapps} [domain!]workstation [;wait]	F-S	Permission to stop actions on cpu objects
stopevtp	{stopeventprocessor \| stopevtp} [domain!][workstation]	M⁴	Permission to stop actions on cpu objects
stopmon	{stopmon \| stopm} [domain!]workstation [;wait] [;noask]	F-S	Permission to stop actions on cpu objects
submit docommand	{submit docommand \| sbd} [workstation#]"cmd" [;alias[=name]] [;into=[workstation#] {jobstream_id;schedid \|jobstreamname ([hhmm[date]])}] [;joboption[;...]]	F-S	submit - (use when using prompts and needs)
submit file	{submit file \| sbf} "filename" [;alias[=name]] [;into=[workstation#]{jobstream_id ;schedid \|jobstreamname([hhmm[ date]])}] [;joboption[;...]] [;noask]	F-S	submit - (use when using prompts and needs)
submit job	{submit job \| sbj} [workstation#]jobname [;alias[=name]] [;into=[workstation#]{jobstream_id ;schedid \| jobstreamname([hhmm[date]])}] [;joboption[;...]] [;vartable=tablename] [;noask]	F-S³	submit - (use when using prompts and needs)
submit sched	{submit sched \| sbs} [workstation#]jstreamname [;alias[=name]] [;jstreamoption[;...]] [;vartable=tablename] [;noask]	F-S³	submit - (use when using prompts and needs)
switchevtp	{switcheventprocessor \| switchevtp} workstation	M⁴	Permission to start and stop actions on cpu objects
switchmgr	{switchmgr \| switchm} domain;newmgr	F	start stop
system	[: \| !] system-command	F-S
tellop	{tellop \| to} [text]	F-S
unlink	unlink [domain!]workstation [;noask]	F-S	unlink
version	{version \| v}	F-S

where:

(1): Indicates that you can only display files on a standard agent.
(2): You must have list access to the object being shown if the enListSecChk option was set to yes on the master domain manager when the production plan was created or extended.
(3): Indicates that you can use submit job (sbj) and submit sched (sbs) on a standard agent by using the connection parameters or specifying the settings in the useropts file when invoking the conman command line.
(4): You can use this command on master domain managers and backup masters as well as on workstations installed as backup masters but used as ordinary fault-tolerant agents.