End Disk Management Session (QYASEDMS) 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 Session (QYASEDMS) API ends an active disk management session that was started previously by using the Start Disk Management Session (QYASSDMS) 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 returned on a preceding Start Disk Management Session (QYASSDMS) API. 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.
CPFBA24 E Operation in progress.
CPFBA25 E A general disk management error has occurred
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 ]