Knowledge Base > Automation Engine and Target Systems > UNIX > Querying the Unix File System

Querying the Unix File System

An example will demonstrate how to use the AE utility UCXE???F to query the Unix file system.

The following files should be listed:

The creation, the forming up and the processing of a data sequenceAn internal listing of Console outputs or lines of Variable objects, etc. The lines of a data sequence can be accessed by using a PROCESS loop or the script element GET_PROCESS_LINE. The script elements PREP_PROCESS* generate data sequences. is a complex process in which scriptA particular Automation Engine object type. functions and statements as well as special objects cooperate closely. The following example shows the necessary definitions for the involved objects and the corresponding script statements and their references. The example is intentionally kept small and clear to show the principles.

The AE utility UCXE???F offers wider query possibilities compared to the traditional operating system command ls. It has to be installed on the hostComputer, target system.. The question marks in the program name are placeholders for System ID and Version of the Unix derivative.

 

Job: SC.PROCESS.UNIXFS

The script of the jobAn Automation Engine object type for a process that runs on a target system. calls the functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… PREP_PROCESS, which prepares the processing of the data sequence. The following parameters are passed:

The job SC.PROCESS.UNIXFS will then be started.

 

Job: EVENT.UNIXFS

This is the job EVENT.UNIXFS from client 0000. It is supplied by default.

It is important that the check box "Attribute dialog" is checked in its Notification tab That way the Include objectAn Automation Engine object type for a script that is frequently used in more than one object. ATTRDIA.BS2000 is read which normally causes the start of the Attribute Dialog.

 

Include: ATTRDIA.UNIX

All attributes listed in the script of the Include can be supplied. The script variableA placeholder for a value within a script. &UC_USERID receives the value AE. The Attribute Dialog is not displayed because the passing of the variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. contents is done internally.

 

Job: EVENT.UNIXFS

At the start of the job EVENT.UNIXFS, the script variables &PATH and &FSPAR are supplied with values. These values are defined in the parameters of the script function PREP_PROCESS of the job SC.PROCESS.UNIXFS. The AE utility is called with these specifications. It retrieves the requested information on the Unix file system. It is not necessary to replace the question marks in the program name. The utility can be called in this way after a correct installation.

The outfile is transferred to the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes. via file transferTransfers files from one computer to another. A particular Automation Engine object type (FileTransfer object). and is then available as a data sequence. The execution of the job EVENT.UNIXFS is then completed.

 

Job: SC.PROCESS.UNIXFS

The function PREP_PROCESS returns a value that is a handle for information on the data sequence that will be processed.

This value is passed to the statement :PROCESS as a start parameter, :PROCESS and :ENDPROCESS then form a processing loop which, in this case, will be cycled until the end of the data sequence is reached. During each iteration a new line of the data sequence is fetched from memory. The function GET_PROCESS_LINE can - by using the current value - retrieve the content of the current line.

In the example, the current console line is written to the activation protocol.

The :STOP statement interrupts the execution and displays this activation reportA report provides more detailed information about a task's execution or a component..

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH