End PM eServer iSeries (Q1PENDPM) API


  Required Parameter Group:

1 End type Input Char(10)
2 Delay time Input Binary(4)
3 Error Code I/O Char(*)

 Default Public Authority: *EXCLUDE

 Threadsafe: No

The End PM eServer iSeries(TM) (Q1PENDPM) API ends IBM Performance Management for eServer iSeries jobs. PM eServer iSeries jobs will not run again until the Start API (Q1PSTRPM) is issued or the product is configured using the CFGPM400 command.


Authorities and Locks

Public Authority
*EXCLUDE
Special authorities
You must have *JOBCTL special authority to use this API.

Required Parameter Group

End type
Input; Char(10)

The PM eServer iSeries(TM) jobs to have controlled endings or the jobs that are to be ended immediately. The possible values are:

*CNTRLD The PM eServer iSeries jobs end in a controlled manner.
*IMMED The PM eServer iSeries jobs end immediately. The programs that are running do not get time to perform cleanup. This option may cause undesirable results if data has been partially updated. Therefore, this option should be used only if a controlled end was unsuccessful.
Delay time
Input; Binary(4)

The delay time when "End type" is *CNTRLD. This parameter is ignored if "End type" is *IMMED. The possible values are:

-1 The PM eServer iSeries jobs continue processing until the activity processing currently is complete.
Delay time (seconds) The PM eServer iSeries jobs end immediately after the delay time.
Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.


Error Messages

Message ID Error Message Text
CPFB03A E Range of parameter &2 does not include &4.
CPFB03D E PM eServer iSeries not active.
CPFB03E E PM eServer iSeries already ending with *IMMED option.
CPFB03F E PM eServer iSeries already ending with *CNTRLD option.
CPF24B4 E Severe error addressing parameter list.
CPF3C1E E Required parameter &1 omitted.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.


API introduced: V5R1
Top | Performance Management APIs | APIs by category