Run a map (-TRANSFORM) command

Edit online

The -TRANSFORM (-TFM) command runs a map on the Standards Processing Engine (SPE) and returns a response from SPE in XML format. The -TRANSFORM command can run a IBM Sterling Transformation Extender map, a Sterling B2B Integrator map, or an XSLT map.

The XML response file contains information about the documents after SPE processing. The metadata schema of the XML response is defined by the wtx_install_dir\Response.xsd file.

A Sterling B2B Integrator map or an XSLT map has a single input card and a single output card. The document data from a file, from memory, or from a map overrides the input card. The -TRANSFORM command overrides the output card with the final document after the transformation completes.

IBM Sterling Transformation Extender maps can have multiple input cards and multiple output cards. The document data from a file, from memory, or from a map overrides the first input card. The -TRANSFORM command overrides the last output card of a IBM Sterling Transformation Extender map and returns the final document after the transformation completes.

A IBM Sterling Transformation Extender map, XSLT map, or Sterling B2B Integrator map can run from the local file system or from the SPE database.

-TRANSFORM command syntax

>>-+- -DBURL-+--+-db_URL------+--+---------------------+-------->
   '- -DURL--'  '-db_cfg_file-'  +- -DBUSER--user_name-+   
                                 '- -U--user_name------'   

>--+--------------------+-- -DBDRIVER--driver_name-------------->
   +- -DBPSWD--password-+                            
   '- -P--password------'                            

>--+-------------------------+---------------------------------->
   '- -DBSCHEMA--schema_name-'   

>--+- -MAP-+-+-map_name_in_database-+--------------------------->
   '- -M---' '-map_file_URL---------'   

>--+---------------------+--+- -TRANSFORM-+--+--------+--------->
   +- -URL--file_URL-----+  '- -TFM-------'  '- -KEEP-'   
   '-+- -DOCID-+--doc_ID-'                                
     '- -ID----'                                          

>--+-----------+--+----------------+---------------------------><
   '- -ALLDOCS-'  '- data_from_map-'

-DBURL

-DURL: Identifies the SPE database by either the database URL or the file URL of a configuration file that contains the database connection information. If you specify a configuration file, the SPE adapter uses only the database connection information in the configuration file. The adapter ignores any -DBDRIVER, -DBUSER, -DBPSWD, or -DBSCHEMA keywords on the adapter command line. The -DBURL keyword is required.

-DBUSER

-U: Specifies the SPE database user name. The -DBUSER keyword is required only for certain types of databases.

-DBPSWD

-P: Specifies the SPE database password. The keyword -DBPSWD is required only for certain types of databases.

-DBDRIVER: Specifies the name of the JDBC driver that connects to the SPE database. The -DBDRIVER keyword is required for all database types.

-DBSCHEMA: Specifies the name of the SPE database schema. The -DBSCHEMA keyword is required only for certain types of databases.

-MAP

-M: Specifies the name of the map in the SPE database or, for IBM Sterling Transformation Extender maps only, the file URL of the map on the local file system. The -MAP keyword is required.

-URL: Specifies the URL of a file that is to override the first input card of the map. The -URL keyword is optional, but you must specify one of the -URL, -DOCID, or data_from_map options.

-DOCID

-ID: Specifies the document ID of the document in memory that overrides the first input card of the map. The adapter passes the document data to the -TRANSFORM command as the PrimaryDocument. The -DOCID keyword is optional, but you must specify one of the -URL, -DOCID, or data_from_map options.

-KEEP: Retains the documents that are returned in the SPE response by storing the documents in the local file system with the document ID as the file name. The -KEEP keyword is optional. If you omit it, the SPE adapter does not save documents after the map or card transaction completes.

-ALLDOCS: Specifies that SPE is to return all documents in the XML response file, including type=INTERMEDIATE documents. The -ALLDOCS keyword is optional. If you omit it, SPE returns only type=FINAL documents in the XML response file.

data_from_map: Specifies the data bytes that are passed from a map that are to override the first input card of the map. The data_from_map is optional, but you must specify one of the -URL, -DOCID, or data_from_map options.