====== TWSd (IBM Tivoli) ======

===== Conman Showjobs =====
\\ 
==== Syntaxe ====
<code bash>
$ conman {showjobs | sj} [jobselect]
     [;keys | info | step | logon | crit | keys retcod]
     [;short | single]
     [;offline]
     [;showid]

$ conman {showjobs | sj} [jobselect]
     [;deps[;keys | info | logon]]
     [;short | single]
     [;offline]
     [;showid]
     [|<;props>|]

$ conman {showjobs | sj} [jobselect | [workstation#]jobnumber.hhmm]
     [;stdlist[;keys]]
     [;short | single]
     [;offline]
     [;showid]
     [|<;props>|]
</code>
 
^Arguments ^Description ^
|jobselect |See [[https://www.ibm.com/docs/en/SSGSPN_8.6.0/com.ibm.tivoli.itws.doc_8.6/awsrgselectjobcmd.htm#selectjobcmd|Selecting jobs in commands]]. |
|hhmm |The time the job started. Use this, together with the stdlist and single arguments, to display a specific instance of the job. |
|jobnumber |The job number. |
|workstation |The name of the workstation on which the job runs. Wildcard characters are permitted. |
^ ^^
|**crit** |Displays information in the crit format. |
|**deps** |Displays information in the deps format; that is, the jobs used in follows dependencies are listed followed by the dependent jobs and job streams. Jobs are listed in the basic showjobs format. Job streams are listed in the basic showschedules format. Use "keys", "info", or "logon" to modify the "deps" display. |
|**info** |Displays information in the info format. |
|**keys** |Displays a single column list of the objects selected by the command. |
|**logon** |Displays information in the logon format. |
|**offline** |Sends the output of the command to the conman output device. |
|**%%|%%<props>%%|%%** |Displays the following information about the specified job instance, you must have display access to the props of the specified job instance being shown: |
|**retcod** |Displays the return code for the job. This argument must be used in conjunction with the keys argument. |
|**short** |Shortens the display for every and rerun jobs to include only the following:\\ - The first iteration\\ - Jobs in different states\\ - Exactly matched jobs |
|**showid** |Displays for each job stream the job stream identifier. |
|**single** |Selects only the parent job in a chain that can include reruns, repetitions, and recovery jobs. |
|**stdlist** |Displays information in the stdlist format. Use the keys argument to modify the display. |
|**step** |Displays information in the step format. |
\\ 
==== Exemples ====
  * Affichage des Jobsets et Jobs "**TEST**"
<konsole>$ <color #00a2e8>conman sj</color> @#@TEST@
<nowiki>
Workstation   Job Stream     SchedTime  Job                            State Pr Start  Elapse ReturnCode Dependencies
SRV1       #JSTTEST01 1350 07/12 ****************************** SUCC  10 07/12  00:01 {07/11/22}
                                        STEPAAAA          SUCC  10 07/12  00:01   0 #J15721
                                        STEPXZZZ          READY                 [Cancelled]
                                        STEPZZZZ          READY 10              [Cancelled]
                                        
SRV1       #JSTTEST02 1300 07/12 ****************************** SUCC  10 07/12  00:01   {07/11/22}
                                        STEPAAAA          SUCC  10 07/12  00:01   0 #J55715
                                        STEPXZZZ          READY 10              [Cancelled]
                                        STEPZZZZ          READY 10              [Cancelled]
...</nowiki></konsole>
  * On peut également n'afficher que les Jobsets
<konsole>$ <color #00a2e8>conman sj</color> @#@TEST@ | <color #99d9ea>grep</color> '\*\*\*' | <color #99d9ea>awk</color> '{print $1$2 "\(" $3 " " $4 "\) " $6}'
<nowiki>
  SRV1#JSTTEST01(0600 01/13) STUCK
  SRV1#JSTTEST02(0600 01/13) HOLD
  SRV1#JSTTEST03(0601 01/13) HOLD
</nowiki></konsole>

  * Afficher les Jobs avec un état particulier
<konsole>$ <color #00a2e8>conman sj</color> SRV1#@ <color #00a2e8>+state exec</color>
<nowiki>
Workstation  Job Stream   SchedTime  Job                         State Pr Start Elapse ReturnCode Dependencies

SRV1  #JSTTEST01 0601 01/14 *************************** EXEC  10 09:34 (03:05)
                                     STEPAAAA       EXEC +10 09:34 (03:03) #J9176034

SRV1  #JSTTEST02 1800 01/13 *************************** EXEC  10 01/13 (18:27)
                                     STEPAAAA       EXEC +10 01/13 (18:25) #J30409116

SRV1  #JSTTEST03 1800 01/13 *************************** EXEC  10 01/13 (13:15)
                                     STEPAAAA       EXEC +10 01/13 (13:13) #J41222586
</nowiki></konsole>\\ 
Valeurs possible de l'argument **+state** :
^ABEND |The job ended with a nonzero exit code. |
^ABENP |An abend confirmation was received, but the job has not completed. |
^ADD |The job is being submitted. |
^DONE |The job completed in an unknown state. |
^ERROR |For internetwork dependencies only, an error occurred while checking for the remote status. |
^EXEC |The job is running. The + flag written beside the EXEC status means that the job is managed by the local batchman process. |
^EXTRN|For internetwork dependencies only, the status is unknown. An error occurred, a rerun action was just performed on the job in the EXTERNAL job stream, or the remote job or job stream does not exist. |
^FAIL |Unable to launch the job. |
^FENCE |The job's priority value is below the fence. |
^HOLD |The job is awaiting dependency resolution. |
^INTRO |The job is introduced for launching by the system. The + flag written beside the INTRO status means that the job is managed by the local batchman process. |
^PEND |The job completed, and is awaiting confirmation. |
^READY |The job is ready to launch, and all dependencies are resolved. |
^SCHED |The job's at time has not arrived. |
^SUCC |The job completed with an exit code of zero. |
^SUCCP |A succ confirmation was received, but the job has not completed. |
^WAIT |The job is in the WAIT state (extended agent only). |
\\