Home
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Commands
Teracloud® Streams provides a number of commands you use to perform tasks.
spl-app-info command
The spl-app-info command reports information about an application bundle file.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Learn about different Teracloud Streams tools and features to write, compile, run, and test streams applications.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
- APIs
  Application programming interfaces (APIs) provide functions that simplify applications development.
- Job configuration overlays
  You can specify or change configuration parameters when you use the submitjob or updateoperators operations. The settings control submission constraints, host constraints and locations, and operator status. Parameters are captured and updated in the configuration JSON file. When you change the values in the job configuration overlay file, the changes override any previously set values.
- Commands
  Teracloud® Streams provides a number of commands you use to perform tasks.
  - streamtool
    Streamtool is the Streams command-line interface.
  - Reading syntax diagrams in the documentation
    There is a syntax convention for how parameters and values are represented in the command syntax diagrams in the Teracloud® Streams documentation.
  - sc command
    The sc command compiles SPL applications.
  - spl-app-info command
    The spl-app-info command reports information about an application bundle file.
  - spl-make-doc command
    The spl-make-doc command generates documentation for your toolkits.
  - spl-make-operator command
    The spl-make-operator command creates code generator modules from template files. The command can also create skeleton code generator templates and a default operator model if they do not exist.
  - spl-make-toolkit command
    The spl-make-toolkit command indexes a toolkit and makes the functions and operators it contains ready for use by SPL programs.
  - spl-schema-from-xml command
    The spl-schema-from-xml command creates an SPL tuple declaration from an XML document.
  - spl-transport-stats command
    The spl-transport-stats command creates a transport statistics model by running a transport performance test.
- Metrics
  Teracloud® Streams provides metrics to help evaluate the health of Teracloud Streams services, to aid in diagnosing performance issues, and to analyze throughput of requests. You can use the streamtool checkinstancemetrics, streamtool checkdomainmetrics, streamtool getdomainmetrics, and streamtool checkresourcemetrics commands to view the metrics data.
- Operator model
  An operator model is an XML document that describes the basic properties of a primitive operator.
- Streams Processing Language (SPL)
  Streams Processing Language (SPL) is a distributed data flow composition language that is used in Teracloud® Streams. SPL has primitive types, program structures, and definitions that are tailored for streaming data.
- SPL Compiler
  The SPL compiler is an incremental compiler that generates artifacts needed to run your stream application. These artifacts include, for example, C++ code for several entities in your SPL program and an application bundle file.
- Toolkits
  A toolkit is a set of SPL artifacts, which are organized into a package. Toolkits make SPL or native functions and primitive or composite operators reusable across different applications.
- SPLDOC markup
  You can use SPLDOC markup in the descriptions associated with the SPL artifacts in a toolkit. The spl-make-doc command generates HTML documentation from the marked up artifacts.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

spl-app-info

The spl-app-info command reports information about an application bundle file.

Usage

Figure 1. spl-app-info

spl-app-info [--build-id] 
[--build-date] [-h, --help] [--toolkits]
[--files] [--unbundle <dir>]
[--xml <outFile>] <sabFile>

Authority

You do not need any authority to run this command.

Description

You can use this command to retrieve information such as the build date, build identifier, list of files, or list of toolkits in an application bundle file.

You can run the command with the --unbundle option to unbundle the application bundle file. You might use this option, for example, if you wanted to debug the stream application.

Options and arguments

--build-date: Reports the date that the application bundle file was built. The date is output in a format that is appropriate for your locale.
--build-id: Reports the build identifier for the application bundle file.
--files: Reports a list of all of the files in the application bundle file.
sabFile: Specifies the application bundle file.
--toolkits: Reports a list of toolkits that are used in the application bundle file, and the version of each toolkit.
--unbundle path: Extracts the contents of the application bundle file into the specified directory, which can be an absolute or relative path.
--xml filename: Reports all of the information in an XML file, which is machine readable.

Examples

The following command lists the files in one of the application bundle files for the Commodity Purchasing sample application:

spl-app-info --files sample.CommodityPurchasing.AutomatedBuyer.sab
Toolkit: spl  Version: 1.2.0
   opt/icons/jcp16.gif
   opt/icons/notify16.gif
   opt/icons/jcp32.gif
   opt/icons/notify32.gif
   lib/commons-math-2.2.jar
   lib/JSON4J.jar
   lib/log4j-1.2.17.jar
   lib/com.ibm.streams.operator.jar
   lib/apache-log4j-extras-1.2.17.jar
   impl/bin/JavaOp_vmpath.sh
   impl/lib/libstreams-stdtk-javaop.so.0
   impl/lib/com.ibm.streams.control.internal.jar
   impl/lib/com.ibm.streams.operator.internal.javaop.jar
   impl/lib/libstreams-stdtk-runtime.so.0
   toolkit.xml
Toolkit: CommodityPurchasing  Version: 1.0.0
   toolkit.xml

To unbundle the application bundle file, run the following command:

spl-app-info --unbundle /home/user1/temp sample.CommodityPurchasing.AutomatedBuyer.sab