cfgamni

Purpose

     Adds a minidisk.

Library

     Run-time Services Library (librts.a)

Syntax

     #include <cfg02.h>

     int cfgamni (sysstanza, fsstanza, use, loc)
     char *sysstanza, *fsstanza;
     int use, loc;

Description

     The cfgamni subroutine  creates minidisks.  The necessary
     steps to  accomplish this  include adding stanzas  to the
     /etc/system  and  the  /etc/filesystems  files,  updating
     coprocessor stanzas,  executing the vrmconfig  command to
     define the minidisk, and  issuing AIX subroutine calls to
     make the  file system  usable.  The calling  process must
     have an effective ID of superuser.

     The sysstanza  and fsstanza  parameters point  to buffers
     that  contain the  text of  attribute file  stanzas.  The
     sysstanza parameter  points to a minidisk  stanza that is
     to be added to the /etc/system file.  The fsstanza param-
     eter points to  a minidisk stanza that is to  be added to
     the /etc/filesystems file.

     The  use parameter  specifies how  the minidisk  is used.
     The values allowed for this parameter are:

     PARTUNIX    AIX file system partition
     PARTCOPR    Coprocessor partition
     PARTOTHR    A partition for some other use.

     The loc  parameter specifies the approximate  location on
     the physical disk where  the minidisk should reside.  The
     values allowed for this parameter are:

     PARTLOCH    At the high end of the fixed disk
     PARTLOCM    Near the center of the fixed disk
     PARTLOCL    Near the beginning of the fixed disk.

     After the cfgamni  subroutine completes successfully, the
     /etc/system file contains a  stanza for the new minidisk,
     and the minidisk has been added to the system.

Return Value

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

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

     CFG_USZF    The format of a stanza is incorrect.

     CFG_MAXP    The maximum  number of minidisks  are already
                 defined.

     CFG_VRMF    The  vrmconfig command  could not  define the
                 partition.

     CFG_APIE    One or more parameters are incorrect.

     CFG_CFEF    The VRM call to create the partition failed.

     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.