Syntax

ingadapter.sh function suffix option

function

This can be one of the following:

start|START

This starts the automation adapter. The default is start.

stop|STOP (deprecated)

This stops the automation adapter.

This stop option is deprecated and remains for compatibility purpose only. Please use MVS stop command instead: P jobname,A=asid.

generateSampleKeys

This creates and stores sample keystore and truststore files in the automation adapter SSL directory. Both java and keytool must be found in the UNIX PATH environment variable if you want to use this function.

Note: Use the sample keys for test purposes only.

IBMSupport

This produces a zip file in the data directory of all the necessary log and trace files that IBM® Support might need.

suffix

The suffix is optional. It might be used for a shared zFS. The meaning of suffix depends on a hyphen "-" as 1st character.

1. Suffix that starts WITHOUT a hyphen "-".

   The suffix now supports shared zFS environments in a better way.

2. Suffix that starts WITH a hypen "-".

   In order to support the meaning of the suffix of older releases add a hyphen "-' in front of the suffix.

Suffix starts WITHOUT a hyphen "-".

We refer to output such as end-to-end automation adapter log files, PID file, stdout, stdin or the adapter release info file. If you want output to be written into a subdirectory depending on the system name or depending on any other system differentiator then use a suffix without a hyphen. This might be useful for shared zFS. It is treated as the user specified name of the subdirectory inserted into the data directory path used for output data. Where suffix can be any differentiator for the current system.

For example,

ingadapter START SYSA

causes the end-to-end automation adapter to write info into the following output directory

/custom-root/adapter/data/SYSA/eez/log

if we assume E2E_CUSTOM_ROOT = /custom-root/adapter/ was set within configuration file ingadapter.properties.

Note, suffix is defined in the JCL parameter and the JCL defines the location of stderr and stdout. See example ING.SINGSAMP(INGXADPT).

Suffix starts WITH a hyphen "-".

In this case the suffix (whereby hyphen is removed) is used as middle qualifier for the master configuration file, for example,

ing.adapter.suffix.properties

Normally this is no longer needed and should not be used any more. This function is only supported for compatibility reasons. Example of the corresponding master configuration files name with suffix SYSA ing.adapter.SYSA.properties.

option

The parameter option may be used for debugging purposes in order to trace the shell script or debug the end-to-end automation adapter.

-T, -t

switches on the shell script trace.

-D, -d

switches on the end-to-end automation adapter logger.