showfiles

Displays information about file dependencies. A file dependency occurs when a job or job stream is dependent on the existence of one or more files before it can begin running.

The displayed information is updated only as long as HCL Workload Automation (batchman) is running. Whether batchman is up or down is confirmed on screen by the Batchman LIVES or Batchman down message when you issue the conman start command.

Syntax

{showfiles | sf} [[[folder/]workstation#]file]
     [;state[;...]]
     [;keys]
     [;offline]

{showfiles | sf} [[[folder/]workstation#]file]
     [;state[;...]]
     [;deps[;keys | info | logon]]
     [;offline]

Arguments

[folder/]workstation
Specifies the name of the workstation on which the file exists. The default is the workstation on which conman is running. Wildcard characters are permitted.
file
Specifies the name of the file. The name must be enclosed in quotes (") if it contains characters other than the following: alphanumerics, dashes (-), slashes (/), backslashes (\), and underscores (_). The default is to display all file dependencies. Wildcard characters are permitted.
state
Specifies the state of the file dependencies to be displayed. The default is to display file dependencies in all states. The states are as follows:
yes
File exists and is available.
no
File is unavailable, or does not exist.
?
Availability is being checked.
<blank>
The file has not yet been checked, or the file was available and used to satisfy a job or job stream dependency.
keys
Displays a single column list of the objects selected by the command.
deps
Displays information in the deps format. Use keys, info, or logon to modify the display.
offline
Sends the output of the command to the conman output device. For information about this device, see Offline output.

Results

The output of the command is produced in three formats: standard, keys, and deps. The arguments keys, info, and logon modify the deps display.

Examples

To display the status of a file dependency for d:\apps\mis\lib\data4, run the following command:
showfiles d:\apps\mis\lib\data4
To display offline the status of all file dependencies on all workstations stored in all folders in the deps format, run the following command:
sf /@/@#@;deps;offline
To display the status of all file dependencies on all workstations in the deps format, run the following command:
sf @#@;deps
A sample output is the following:
                                                    (Est) (Est)
Workstation Job Stream SchedTime  Job      State Pr Start Elapse ReturnCode Dependencies

MASTER#/test/^LFILEJOB^ Dependencies are: 
 MASTER     #LFILEJOB  0600 11/26 ******** READY 10
                                  LFILEJOB HOLD  10 (11/26)                 ^LFILEJOB^

MASTER#/usr/home/me10_99/`/usr/home/me10_99/bin/parms FILE_JS1` Dependencies are: 
 MASTER     #FILE_JS1  0600 11/26 ******** HOLD  10 (11/26)                 parms FILE_JS1`
                                  FILE_JS1 HOLD  10 (11/26)

MASTER#/usr/home/me10_99/`/usr/home/me10_99/bin/parms FILE_JOB1` Dependencies are:
 MASTER     #FILE_JOB1 0600 11/26 ******** READY 10
                                  FILE_JB1 HOLD  10 (11/26)                 parms FILE_JB1`

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the navigation bar at the top, click Monitoring and Reporting > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select File.
  4. From the Query drop-down list, select a task to monitor files.
  5. Click Run to run the monitoring task.