Specifying the value for the allow STO REG n CANCEL command and ESS wait limit parameters
You use the Allow STO REG n CANCEL command parameter to specify whether BMC Application Director for IMS can issue the following commands to terminate the connections for jobs that are waiting on IMS ESS calls so that the jobs can be suspended and resumed.
- STO REG nnnn ABDUMP
- STO REG nnnn CANCEL
Use the table to determine the value to specify and the requirements.
Task you want to perform | Value to specify | Additional requirements or information |
|---|---|---|
Specify that Application Director can issue the commands | Y | If you specify Y, you must also:
|
Specify that Application Director cannot issue the commands | N (default) | If you specify N, the value for ESS Wait Limit is ignored. The limit is ignored because you specified that you do not want the command to be issued. |
Use the ESS Wait Limit parameter to specify the amount of time that Application Director must wait for an IMS ESS call to complete before it terminates the IMS BMP, DLI, or DBB batch job’s connection with the IMS ESS.
- If you do not want Application Director to suspend and resume a job until the ESS responds, specify 0.
- Otherwise, specify a value from 1 to 999
The default is 000.
When you specify Y for the Allow STO REG n CANCEL Command parameter and an ESS Wait Limit greater than 0, Application Director takes these actions for jobs waiting on IMS ESS calls:
- When the wait limit that you also specified is exceeded, Application Director issues a STO REG nnnn ABDUMP command for the application program.
- If the command is unsuccessful, Application Director issues a STO REG nnnn CANCEL command for the application program.
- Application Director then issues STA PGM xxxxxxxx and STA TRAN xxxxxxxx command (if needed).
- Application Director suspends and resumes the job.
- Application Director repositions the IMS databases.
- If the job was waiting on a return from an IMS ESS call when it was terminated, Application Director reissues the last call.
- Your application program must then be ready to re-establish its connection with the IMS ESS.