imtkmake command

Parameters:

-defmap

Create a service interface using default mappings based on the COBOL program specified in the src= parameter.

-generate

Generate deployment files based on the parameters set, and generate a COBOL archive (.car) file containing the generated files for deployment to the enterprise server.

-query

List the enterprise servers available for deployment.

-queryAppServerList

List the available J2EE 1.7 application servers by default. Specify the j2eeversion parameter to see application servers supported for other J2EE versions.

-queryEJBDefaults

Lists all the default EJB generation options.

-deploy

Deploy the .car file created with -generate parameter to the enterprise server. Execute imtkmake with the -deploy parameter from the servicename.deploy directory.

-showlog

Display the contents of the deployment log (deploylog.txt file).

-genclient

Generate a client from the service interface, according to the specified type, such as EJB or Web Services.

-genclientwsdl

Generate a COBOL client from WSDL.

-genclientjson

Generate a COBOL client from JSON Schema or OpenAPI (Swagger).

-validate

Validate the service interface.

-help

Display information about imtkmake functions and parameters.

allowcredentials={yes|no}

Specifies whether or not a response can be exposed when user credentials are included in the request.

allowedorigin=uri

URI allowed to access the returned resource.

archivename=arch-name

The full filename of the output archive file, which can be a .jar, .war, or .ear file.

appdir=directory-name

The path to the application files for the application running on the enterprise server.

appserver=J2EE-application-server-name

This is the name and version of the J2EE application server for which an EJB is generated and to which an EJB is deployed. This defines the deployment descriptors that are generated.

This is mandatory when generating EJBs and EJB clients. In other words, mandatory when using the -generate or -genclient functions with type set to EJB. The values must be within quotes since they contain spaces. For example:

• "JBoss EAP 7.2"
• "WebSphere 9.0"

Note that this parameter must come after the other parameters.

See -queryAppServerList for how to list the available servers.

basePath=base-path

For REST services, the base path used in the URI of the service.

bean=bean-name

For EJB generation, the name of the bean to generate. Defaults to service-name.

bitmode={32|64}

The bit mode of the generated client.

carname=car-filename

The path to and name of the .car file to deploy. By default, this file is named servicename.car and is in the servicename.deploy directory. carname= is not required when you generate and deploy on the same command line.

charset={asci|ebcdic}

The character set of the generated client.

classpath=java-class-path

The full path to the J2EE implementation classes on the J2EE application server, which is different for each J2EE application server and is the path to the following .jar files respectively:

• JBoss jboss-ejb-api*.jar, jboss-connector-api*.jar, and jboss-servlet-api*.jar
  Note: The names of these files might vary depending on the version of JBoss you are using.
• Tomcat servlet-api.jar
• WebSphere j2ee.jar
• WebLogic weblogic.jar

Notes:

• java-class-path is case sensitive.
• The CLASSPATH property points application servers to their required J2EE implementation class files. For a list of application servers and their required J2EE implementation class files, see Application Server J2EE Implementation Classes.

clientdir=directory-name

The directory in which to generate the client program. With the -genclientwsdl or -genclientjson function, defaults to the WSDL or JSON Schema or OpenAPI (Swagger) file directory; otherwise defaults to the servicename.deploy directory.

clientjson=json-filename

For REST services, the name of the JSON Schema or OpenAPI (Swagger) file from which to generate the client program.

clientwsdl=wsdl-filename

The name of the WSDL file from which to generate the client program.

defaultarraysize=array-size

The default array size to use for unbounded arrays.

defaultstringsize=string-size

The default string size to use for unbounded strings.

deploydir=deployment-address

The URL of the deploylog.txt file. This URL is displayed by the -deploy function.

directives=Compiler-directives

The directives required for the program to compile correctly. Use a comma between directives.

ejbInterfaceType={remote|local}

The type of server on which the EJB runs - local or remote.

ejbname=ejb-name

For EJB generation, the name of the EJB to generate. Defaults to service-nameEJB.

ejbversion=3

Enable EJB version 3 support.

esruntime=esruntime-filename

The name of a file containing the run-time configuration settings to be applied when the deployed service is run. The file extension must be .rtc.

exithandler=program-name

For Web Services generation, the name of a user exit program to handle the exit points in the MFRHSOAP request handler.

exposedheaders=header [,header[…]]

Custom headers that the browser is allowed to access.

@filelistname

The name of a file containing a list of additional files that need to be included in a .car file. Each file name must be on a new line.

filename

An additional file that needs to be included in a .car file. You can specify multiple additional files.

inlineoccurslimit=limit-size

A numerical value representing the minimum minimum array size at which Visual COBOL generates separate data structures for dynamic allocation. For a full explanation on how Visual COBOL generates variable arrays, see Handling Variable Arrays in WSDL and JSON.

j2eeVersion={1.7|7}

The J2EE version. Paired options inside brackets ({}) are equivalent.

jarname=jar-filename

For EJB generation, the name of the .jar file to create. Defaults to service-name.jar.

javacpath=java-dir

The path to the javac.exe file.

namespace=service-namespace

For Web Services generation, EJB generation and client generation, the service namespace. Web Services generation and client generation defaults to http://tempuri.org/service-name. EJB generation defaults to service-name .

operations=index[,index[…]]

One numerical value or a list of comma-delimited numerical values, where the number represents a 1-based index for an operation contained in the WSDL or JSON file. The index number is assigned according to the order in which the operations are defined in the file. The default is 1, or the first defined operation.

package=package-name

For EJB generation, the name of the package of Java classes to contain the bean. This is case-sensitive. Defaults to com.mypackage.service-name.

password=secure-password

The password to enable a service interface to be deployed to a secure server. This is required only when MFDS is configured to require it.

sepsession={stateless|stateful}

The setting for the associated SEP (Service Execution Process) attribute. SEP attributes are only meaningful when transactional=yes.

server=server-name,deployer-name

The destination of the deployment files. server-name is the enterprise server to which you want to deploy the service, and deployer-name is the name of a deployment service on that enterprise server. If you do not supply this parameter, the function lists the servers available for deployment and prompts you to choose one.

serverHost=host-name

For J2SE Java bean services, the name of the host machine that is running the enterprise server.

serverPort=port-number

For J2SE Java bean services, the port number of the enterprise server listener.

service=service-name

The name of the service for mapping or generation.

session={stateless|stateful}

For EJB generation, the type of EJB to generate. Defaults to stateless.

settings=properties-filename

The name of a file containing the set properties for this service interface.

src=program-name

The program used for creating default mappings.

style={doclit | rpcenc}

The style to use for WSDL generation. The default is doclit.

transaction={application|container}

Specifies whether the service is application-managed or transaction-managed. The default is application.

transactional={yes|no}

For EJB generation, whether or not the EJB service executes in a transactional context. When set to yes, session=stateful by default.

transactionAttribute=attribute

Transaction attribute used for EJB default mapping. Can be one of the following:

• notSupported
• mandatory
• never
• required
• requiresNew

type=service-type

The type of mapping to perform or type of client to generate (see defmap, genclient and generate above), where service-type can be one of the following:

• EJB
• J2SEbean
• WebService

url=ip-address

For Web Services and client generation, the IP address of the service.

username=secure-username

The username that enables a service interface to be deployed to a secure server. This is required only when MFDS is configured to require it.

wsdlportindex=index

One numerical value that represents the service port for which you want to generate the client. This is a 1-based index for a service port defined in the WSDL or JSON file. The index number is assigned according to the order in which the ports are defined in the file. The default is 1, or the first defined port.

wsdlserviceindex=index

One numerical value that represents the service for which you want to generate the client. This is a 1-based index for a service defined in the WSDL or JSON file. The index number is assigned according to the order in which the services are defined in the file. The default is 1, or the first defined service.