HCL Workload Automation, Version 9.4

display

Displays a job file or a job stream definition.

If you specify a file by name, you must have read access to the file. For job files and job stream definitions, you must have display access to the job or job stream.

Syntax

{display file | df} filename [;offline]

{display job | dj} jobselect [;offline]

{display sched | ds} jstreamselect
[valid {at date | in date date}
[;offline]

Arguments

filename: Specifies the name of the file, usually a job script file. The name must be enclosed in quotes (") if it contains characters other than the following: alphanumeric characters, dashes (-), slashes (/), backslashes (\), and underscores (_). Wildcard characters are permitted. The file must be accessible from your login workstation. Use this option is you want to show only the content of the job script file.
jobselect: The job whose job file is displayed. See Selecting jobs in commands. The job file must be accessible from your login workstation. This keyword applies only to path and filename of the script file of jobs defined with the scriptname option.
jstreamselect: The job stream whose definition is displayed. See Selecting job streams in commands.
valid: Specifies the day or the interval of days during which the job stream instances to be displayed must be active. This means that the validity interval of those job stream instances must contain the time frame specified in valid argument. The format used for date depends on the value assigned to the date format variable specified in the localopts file. If not specified the selected instance is the one valid today.
offline: Sends the output of the command to the conman output device. For information about this device, see Offline output.

Examples

To display the file c:\maestro\jclfiles\arjob3, run the following command:

df c:\apps\maestro\jclfiles\arjob3

To display the script file for job createpostreports in job stream FINALPOSTREPORTS offline, run the following command:

dj FINALPOSTREPORTS(2359 02/14/13).CREATEPOSTREPORTS

This is a sample output of this command:

M235062_99#FINALPOSTREPORTS(2359 02/14/13).CREATEPOSTREPORTS /opt/TWA/TWS/
                                                         CreatePostReports
   #!/bin/sh
  ####################################################################
  # Licensed Materials - Property of IBM* and HCL**
  # 5698-WSH
  # (C) Copyright IBM Corp. 1998, 2016 All rights reserved.
  # (C) Copyright HCL Technologies Ltd. 2016 All rights reserved
  # * Trademark of International Business Machines
  # ** Trademark of HCL Technologies Limited
  ###################################################################
  #@(#) $Id: CreatePostReports.sh,v 1.0

  ##
  ## CreatePostReports message catalog definitions.
  ##

  ##
  ## message set id
  ##
  MAE_CREATEPOSTREPORTS_SET=226
  MAE_COPYRIGHT_SET=234

  ##
  ....
  ...
  ....
  #
  # End
  #

To display the job stream definition for job stream mod, run the following command:

ds mod

This is a sample output of this command:

Job Stream Name   Workstation       Valid From  Updated On  Locked By
 ----------------  ----------------  ----------  ----------  ----------------
MOD               M235062_99        06/30/2007  03/04/2006  -

SCHEDULE M235062_99#MOD VALIDFROM 06/30/2007
ON RUNCYCLE SCHED1_PREDSIMPLE VALIDFROM 07/18/2007 "FREQ=DAILY;INTERVAL=1"
( AT 1111 )
CARRYFORWARD
FOLLOWS M235062_99#SCHED_FIRST1.@
FOLLOWS M235062_99#SCHED_FIRST.JOB_FTA
PRIORITY 66
:
M235062_99#JOBMDM
 SCRIPTNAME "/usr/acct/scripts/gl1" STREAMLOGON root
 DESCRIPTION "general ledger job1"
 TASKTYPE UNIX
 RECOVERY STOP
 PRIORITY 30
NEEDS 16 M235062_99#JOBSLOTS
PROMPT PRMT3

B236153_00#JOB_FTA
FOLLOWS M235062_99#SCHED_FIRST1.@
FOLLOWS M235062_99#SCHED_FIRST.JOB_FTA
PRIORITY 66
:
M235062_99#JOBMDM
 SCRIPTNAME "/usr/acct/scripts/gl1" STREAMLOGON root
 DESCRIPTION "general ledger job1"
 TASKTYPE UNIX
 RECOVERY STOP
 PRIORITY 30
NEEDS 16 M235062_99#JOBSLOTS
PROMPT PRMT3

B236153_00#JOB_FTA
 DOCOMMAND "echo pippo" STREAMLOGON root
 DESCRIPTION "general ledger job1"
 TASKTYPE UNIX
 RECOVERY STOP
 FOLLOWS JOBMDM
END

display

Syntax

Arguments

Examples

See also