Enabling or disabling an Energizer for IMS Connect exclusive port

To implement port-level security, you can enable a port to exclusively issue Energizer commands and messages. The exclusive port is disabled by default.

When you enable an exclusive port:

Energizer communications are allowed on the exclusive port but restricted on all other ports.
OTMA messages (for example, transactions) are restricted on the exclusive port but allowed on all other ports.

When you disable the exclusive port, Energizer and OTMA messages are processed on all available ports.

The enabled exclusive port is used for the IPRCMDS0 exit only. Other exits (for example, HWSJAVA0, HWSSMPL0, and HWSSMPL1) use one of the non-exclusive ports. All non-exclusive ports process transactions from external systems.

For more information, see the online Help panel.

Before you begin

If you have configured Energizer views in your BMC AMI Ops IMS environment, make sure that the port you are about to make exclusive is the first port in the IMS Connect PROCLIB Configuration member.

Example

The following is a sample PROCLIB Configuration member in Energizer with BMC AMI Ops IMS environment, where port number 11731 can be made an exclusive port:

TCPIP (HOSTNAME=TCPIP,RACFID=userID,
ECB=Y,MAXSOC=2000,TIMEOUT=8888,NODELAY=Y,
PORTID=(11731,11732,11733,LOCAL),
IDLETO=18000,
EXIT=(HWSJAVA0,HWSSOAP1,HWSCSLO0,HWSCSLO1,HWSSMPL0))

To enable a port as exclusive

Navigate to the IMS Connect Options panel.
In the Port number field on the IMS Connect Options panel, type the port number:
IPRPOCN0                  IMS Connect Options
                                                           More:     +
Type Connect options. Scroll down for more options.

  Started task name. . : ________

  Description . . . . . _________________________________________

  Group name . . . . . . ________ +(Use Prompt for list)
  Router options name . ________ +
  Exit options name . . ________ +
  ODBM options name . . ________ +
  Execute cmds member . ________ (in PROCLIB)
  Auto cancel clients . ________ (in PROCLIB)
  Host name . . . . . . _________________________________________
  Port number . . . . . _____ (1 to 65535) _ Enable exclusive port


Command ===> ________________________________________________________
Type a forward slash (/) before the Enable exclusive port option and save the options.
The port with the specified number becomes exclusive for Energizer commands and messages.
Reload the IMS Connect option by using the RELOAD command.
You must reload the IMS Connect options by using the exclusive port number that is currently active. For more information, see Reloading-IMS-Connect-configurations.
Warning
Note
You can skip the reload if you are recycling the IMS Connect started task.

To disable an exclusive port

Navigate to the IMS Connect Options panel.
In the Port number field, delete the forward slash (/) before the Enable exclusive port option and save the options.
The port becomes non-exclusive for Energizer commands and messages.
Reload the IMS Connect options by using the RELOAD command.
You must reload the IMS Connect options by using the exclusive port number that is currently active. For more information, see Reloading-IMS-Connect-configurations.

Errors messages related to the exclusive port feature

If you encounter problems while using the exclusive port, see the following error messages:

If you have enabled an exclusive port and issue an Energizer command on a non-exclusive port, the command is rejected and the following error message is displayed:
RSM received: Return code=4, reason code=231. Warning or error from exit

If you have enabled an exclusive port and issue an OTMA message on the exclusive port, the message is rejected and the following error message is displayed:
RSM received: Return code=4, reason code=232. Warning or error from exit