cfgdmni

Purpose

     Deletes a minidisk.

Library

     Run-time Services Library (librts.a)

Syntax

     #include <cfg02.h>

     int cfgdmni (sysstname, fsstname)
     char *sysstname, *fsstname;

Description

     The  cfgdmni  subroutine  deletes  a  minidisk  from  the
     system.  The  necessary steps to accomplish  this include
     calling  the minidisk  manager,  executing the  vrmconfig
     command,   removing  the   minidisk   stanzas  from   the
     /etc/system and /etc/filesystems  files, and removing the
     coprocessor stanza references.

     The sysstname parameter  is a pointer to the  name of the
     stanza in  the /etc/system file that  describes the mini-
     disk that is to be deleted.

     The fsstname  parameter is a  pointer to the name  of the
     stanza in the /etc/filesystems file if the minidisk is an
     AIX minidisk.   If the minidisk  is not an  AIX minidisk,
     then the fsstname parameter must be NULL.

     After the cfgdmni  subroutine completes successfully, the
     minidisk  is deleted  from  the system  and the  minidisk
     stanza has  been deleted from the  /etc/system file, and,
     if appropriate,  from the  /etc/filesystems file  or from
     the /etc/ddi/cpmgr file.

Return Value

     Upon  successful   completion,  the  value   CFG_SUCC  is
     returned.  If  the cfgdmni subroutine fails,  then one of
     the following is returned:

     CFG_NSID    The  calling process's  effective user  ID is
                 not superuser.

     CFG_VRMF    The  vrmconfig command  could not  delete the
                 partition.

     CFG_APIE    One or more parameters are incorrect.

     CFG_CFEF    The VRM call to delete the partition failed.

     CFG_USZF    The stanza specified  by the sysstname param-
                 eter could  not be  found in  the /etc/system
                 file.

     CFG_UNRW    An   unrecoverable   read  or   write   error
                 occurred.

     CFG_FOPN    An error occurred while opening a file.

Files

     /etc/ddi/cpmgr
     /etc/filesystems
     /etc/system

Related Information

     In this book:  "attributes," "master," and "system."

     The vrmconfig  command in  AIX Operating  System Commands
     Reference.