showschedules

You can use the showschedules command to display the information about job streams.

Overview

The information about to job streams is displayed in three formats: standard, keys, and deps. You can use the keys, info and logon options to further modify the results for deps display. You can use wildcards to filter job streams and the folders in which they are defined. For more information, see Special characters as wildcards and delimiters.

Syntax and command line options

The options that you can use with the command are as follows:
ocli plan showscheds | ss jstreamselect [;keys] [;showid]
or
ocli plan showscheds | ss jstreamselect [;deps [;keys | ;info | ;logon]][;showid]

If you do not specify any options the results are displayed in standard format. The details that are required with each parameters are as follows:

jstreamselect

You can specify the job stream that contains the jobs which you want to view.

keys

If you use this option, the results are displayed with only the job stream ID per line.

deps
If you use the option, the results are displayed with job streams that are used in follows dependencies. You can use the keys, info, and logon options to further filter the results. The jobs and job streams are listed in the Standard format and standard showschedules format respectively.
  • deps;keys

    If you use the keys parameter with deps option, the job streams that are used in the follows dependencies are displayed with only the job stream ID per line.

  • deps;info

    The jobs in the results are displayed in showjobs;info format and the job streams are displayed in the standard showschedules format.

  • deps;logon

    The jobs in the results are displayed in showjobs;logon format and the job streams are displayed in the standard showschedules format.

showid

When you add this option, the results will display a unique identifier that identifies the job stream. In plan, the job streams are not only identified by the name but also the folder in which it is defined. The name of the job stream and the location of the folder where it is defined is linked to a unique identifier.

standard format
If you do not specify any options with the showsched command, the results are displayed in standard format. The format contains the following information:
  • Workstation

    The name of the workstation the job stream runs on.

  • Job stream

    The job stream name.

  • SchedTime

    The scheduled time and date of the job stream to start the run. The date is displayed in the mm/dd format.

  • State
    Specifies the current status of the job stream. The different states are as follows:
    • ABEND

      A malfunction has ended the job stream.

    • CANCELP

      The job stream cancellation is pending. The job stream is cancelled when all the dependencies are resolved.

    • EXEC

      The job stream is in progress.

    • HOLD

      The job stream is waiting for dependencies to resolve.

    • READY

      All dependencies of the job stream are resolved and the jobs are ready to start.

    • STUCK

      The job stream run is interrupted. The jobs in the job stream cannot start without the user intervention.

    • SUCC

      The job stream finished successfully.

    • SUPPR

      The job stream is suppressed because the related conditional dependencies are not resolved.

  • Pr

    The priority of the job stream.

  • (Est)Start

    The start time of the job or job stream. The (Est) element indicates the expected start time. If the start time is before or after 24 hours, the date instead of time is displayed, for example, mm/dd/yy or mm/dd.

  • (Est)Elapse
    The run time of the job or job stream. The (Est) element indicates the expected start time.
  • Jobs #

    The number of jobs in the job stream.

  • Jobs OK

    The number of jobs that have completed successfully.

  • Sch Lim

    The limit of job stream.

Notes:

dependencies

Dependencies associated with jobs are displayed and any combination of the following information can be listed.
  • The job stream or job name is displayed for the follows dependency. The name is followed by [P], if it is a pending predecessor.
  • For conditional dependencies the name of the predecessor job or job stream is followed by the output conditions in this format, IF <condition name>. The <condition name> can be the final status of the predecessor job, the job stream status or condition based on the predecessor job output. When you have multiple conditions, they are separated by the vertical bar (|).
  • For an until time, the time is preceded by an angle bracket (<).
  • Cancelled job streams are labelled with this message [Cancelled].
  • The Job streams that are cancelled with the ;pend option are labeled [Cancel Pend].
  • For a deadline time, the time displayed is preceded by an angle bracket (<).
  • The job streams with the carryforward keyword are labelled [Carry].
  • The initial name and date of job streams are displayed in brackets that are carried forward form the previous production plan.
  • When the results are displayed for the showschedules command, the time dependencies are shown in the start column as described below:
    • Only the time hh:mm, if the date on which the command is run matches with the date set on the job stream.
    • Only the date dd/mm, if the date on which the command is run does not matches with the date set on the job stream.

Examples

  1. Run the following command to display the status for the JS1 job stream defined on the WS_AGT_1 workstation in the root folder with the job stream identifier.
    ocli plan ss /WS_AGT_1#JS1 showid
    The sample output is given below:
                                                           (Est)  (Est)    Jobs  Sch
    Workstation      Job Stream        SchedTime  State Pr Start  Elapse   #  OK Lim
    WS_AGT_1        #JS1               0000 03/16 SUCC  10 09:18  00:00    1   1          {81b4f5e6-2853-4f2d-86c8-e6b1aca192d8}
    
  2. Run the following command to display the status of all job streams defined in all folders in the HOLD state on the workstation on which you are running Orchestration CLI:
    ocli plan ss /@/@+state=HOLD
    The sample output is given below:
                                                            (Est)  (Est)    Jobs  Sch
    Workstation      Job Stream        SchedTime  State Pr Start  Elapse   #  OK Lim
    WS_AGT_0        #JOB_STREAM_151736…1316 03/15 HOLD  10(13:16)          1   0
    WS_AGT_0        #JOB_STREAM_153149…1329 03/15 HOLD  10                 1   0          [Cancelled]
    WS_AGT_0        #JOB_STREAM_153542…1333 03/15 HOLD  10                 1   0          [Cancelled]
    WS_AGT_0        #JOB_STREAM_153542…1334 03/15 HOLD  10(13:34)          1   0          WS_AGT_0#JOB_STREAM_PRED_153542026(0000 03/15/23).@
    WS_AGT_0        #JOB_STREAM_153754…1335 03/15 HOLD  10                 1   0          [Cancelled]
    WS_AGT_0        #JOB_STREAM_153932…1337 03/15 HOLD  10                 1   0          WS_AGT_0#JOB_STREAM_PRED_153932096(0000 03/15/23).@
    WS_AGT_0        #JOB_STREAM_154221…1340 03/15 HOLD  10                 1   0          WS_AGT_0#JOB_STREAM_PRED_154221947(0000 03/15/23).@
    
  3. Run the following command to display the status of all job streams with the name beginning with JOB_STREAM_PRED on the WS_AGT_0 workstation in the ;deps;info format:
    ocli plan ss WS_AGT_0#JOB_STREAM_PRED@;deps;info
    The sample output is given below:
      -------- Restart ---------
      Workstation      Job Stream       SchedTime  Job                                    JobFile                  Opt  Job            Prompt
    
    WS_AGT_0#/JOB_STREAM_PRED_152439416[(2300 03/14),(5fce9706-0042-40fd-af5f-258cae0b1aeb)] represents a dependency for:
    
      WS_AGT_0        #JOB_STREAM_1524391322 03/15
                                                   JOB_DEFINITION_152439416                 netstat -an
    
    WS_AGT_0#/JOB_STREAM_PRED_152732126[(2300 03/14),(ea6ab877-de10-4dce-8670-382d977e0bca)] represents a dependency for:
    
      WS_AGT_0        #JOB_STREAM_1527321325 03/15
                                                   JOB_DEFINITION_152732126                 netstat -an
    
    WS_AGT_0#/JOB_STREAM_PRED_153149897[(2300 03/14),(fe5060dd-bf4e-483a-b873-6856f621011d)] represents a dependency for:
    
      WS_AGT_0        #JOB_STREAM_1531491329 03/15
                                                   JOB_DEFINITION_153149897                 netstat -an
    
  4. Run the following command to display the status of all job streams defined in all folder and on all workstations defined in all folders:
    ocli plan ss /@/@#/@/@
    The sample output is given below:
                                                           (Est)  (Est)    Jobs  Sch
    Workstation      Job Stream        SchedTime  State Pr Start  Elapse   #  OK Lim
    CLOUD           #JOB_PLUGIN_151126…1511 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151153…1511 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151208…1512 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151219…1512 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151230…1512 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151246…1512 03/14 ABEND 10 03/14  00:00    1   0
    CLOUD           #JOB_PLUGIN_151257…1513 03/14 ABEND 10 03/14  00:00    1   0