End Disk Management Operation (QYASEDMO) API


  Required Parameter Group:

1 Session handle Input Char(8)
2 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes

The End Disk Management Operation (QYASEDMO) API attempts to cancel an active operation of an active disk management session that was previously started by using the Start Disk Management Operation (QYASSDMO) API.


Authorities and Locks

To use this API, you must have *SERVICE special authority or must be authorized to the Service Disk Units function of the IBM® i operating system through System i™ Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_QYAS_SERVICE_DISKMGMT, also can be used to change the list of users who are allowed to work with disk units.


Required Parameter Group

Session handle
INPUT; CHAR(8)

The 8-byte field containing a unique ID that was used on a preceding Start Disk Management Operation (QYASDMO) API for the operation that is to be ended. The session handle contains arbitrary binary data and should not be interpreted as character data.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF2277 E User &1 not allowed to use function &2.
CPFBA20 E Session handle not valid.
CPFBA25 E A general disk management error has occurred.
CPFBA45 E Cannot end operation.
CPFBA46 E No operation in progress.
CPFBA47 E Session not active.
CPFBA48 E Operation failed with unrecognized return code, &1.
CPFBA53 E Unexpected authority validation error has occurred.
CPF3C36 E Number of parameters, &1, entered for this API was not valid.
CPF3CF1 E Error code parameter not valid.


API introduced: V4R5

[ Back to top | Configuration APIs | APIs by category ]