SHELL Batch Command and ICON_CONTROL PORT Control Option

The format of this command is

SHELL SYSTEM=target,COMMAND='command'

If target is set to the name of an IMS Connect instance then the command is treated as an IMS Connect command, as in this example:

SHELL SYSTEM=HWSOPPS1,COMMAND='STOPIP PLXDH'

If target is set to a datastore name then the command is treated as an IMS Type-1 command:

SHELL SYSTEM=IMSD,COMMAND='/SWITCH OLDS'

The following example shows a series of batch commands to first connect to IMS Connect and then use the SHELL command to query and update a datastore.

CONNECT DNSNAME=LOCALHOST,PORT=4100,HWSID=HWSOPGS1,USERID=BCD1
SHELL SYSTEM=HWSOPGS1,COMMAND='VIEWDS IMSA'
SHELL SYSTEM=IMSA,COMMAND='/SWITCH OLDS'
SHELL SYSTEM=HWSOPGS1,                                             +
     COMMAND='UPDATE DATASTORE NAME(IMSA) STOP(COMM)'    

ICON_CONTROL PORT control option

The command shell connects to an available IMS Connect message port to submit IMS Type-1 commands to a datastore via message exit HWSJAVA0. A dedicated port is needed if you use a TCP/IP routing device such as sysplex distributor, to prevent commands being routed to a different IMS Connect system.

Use the ICON_CONTROL PORT control option to specify a dedicated IMS Connect port which is to be used for routing IMS Type-1 commands that are issued from IMS Connect Extensions. The syntax is:

ICON_CONTROL PORT=nnnnn

Where nnnnn is an OTMA port that is defined in HWSCFG. Ensure that the port is not subject to TCP/IP routing.

Note: If all of the datastores for an IMS system are stopped then there will be no pathway for executing IMS Type-1 commands.

Requirements

To use this command with IMS Connect Extensions V2R3 you must apply the fix for APAR PM77360 and restart IMS Connect.

Related information

For information about specifying control input data set options, see the Reference section in the IMS Connect Extensions User’s Guide.

For sample JCL and other information about using the batch command utility, see the ‘Utilities and API reference’ section in the IMS Connect Extensions User’s Guide.