TAA Tools
RTVSYSPTN       RETRIEVE SYSTEM PARTITION              TAASYTJ

The   Retrieve  System   Partition   command  information   about   the
partitions  on a  system and  the current  partition.   The  command is
useful when dealing with LPAR systems.

A typical series of commands would be:

             DCL           &CURPTN *DEC LEN(5 0)
              .
             RTVSYSPTN     CURPTN(&CURPTN)

RTVSYSPTN escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

RTVSYSPTN Command parameters                          *CMD
----------------------------

   TOTPTN2       The   total  number   of  partitions.     The  TOTPTN2
                 parameter should  be used  instead of  TOTPTN if  V7R1
                 or  later is installed.   This  is an  optional return
                 variable  that  if  used  must  be  specified  as *DEC
                 LEN(5 0).

   CURPTN2       The current partition number.   The CURPTN2  parameter
                 should be used  instead of CURPTN if V7R1  or later is
                 installed.   This is an  optional return variable that
                 if used must be specified as *DEC LEN(5 0).

   PRIPTN2       The primary partition number.   The PRIPTN2  parameter
                 should be used instead  of PRIPTN if V7R1 or  later is
                 installed.   This is an optional  return variable that
                 if used must be specified as *DEC LEN(5 0).

   SVCPTN2       The  service partition number.   The SVCPTN2 parameter
                 should be used instead  of SVCPTN if V7R1 or  later is
                 installed.   This is an optional  return variable that
                 if used must be specified as *DEC LEN(5 0).

   FMWLVL        The  firmware level  as a  hex value.   This indicates
                 the partition licensed internal  code level.  This  is
                 an  optional return  variable  that  if used  must  be
                 specified as *CHAR LEN(2).

   LGLSRLNBR     The  logical serial  number provides a  unique machine
                 identifier for  the current  partition.   This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *CHAR LEN(10).

   SHRPHYPRC     Whether the  partition is sharing  physical processors
                 on  the current IPL  of this partition.   A 'Y' or 'N'
                 is returned.    This is  an optional  return  variable
                 that if used must be specified as *CHAR LEN(1).

   CPCCPD        Whether  the partition's  capacity is  capped.   A 'Y'
                 or  'N' will be returned.   This is an optional return
                 variable that  if  used  must be  specified  as  *CHAR
                 LEN(1).

   DONCPCSHR     Whether  the  partition can  donate  unused  processor
                 time  to the  physical shared processor  pool.   A 'Y'
                 or 'N' will be returned.   This is an optional  return
                 variable  that if  used  must  be specified  as  *CHAR
                 LEN(1).

   MINVRTPRC     The  minimum  number of  the  virtual processors  that
                 are   always  available  to   the  partition  for  the
                 current IPL of  this partition.   This is an  optional
                 return  variable that  if  used must  be specified  as
                 *DEC LEN(3 0).

   MAXVRTPRC     The  maximum  number of  the  virtual  processors that
                 will be  available  to  this partition  at  any  given
                 point  for  the current  IPL.    This is  an  optional
                 return  variable  that if  used must  be  specified as
                 *DEC LEN(3 0).

   CURVRTPRC     The number of  virtual processors  that are  currently
                 enabled in  the partition's current  IPL.  This  is an
                 optional  return   variable  that  if   used  must  be
                 specified as *DEC LEN(3 0).

   MINCFGMEM     The  minimum amount of configured  memory in MB of the
                 physical machine  memory allocated  to this  partition
                 for the  current IPL  of this partition.   This  is an
                 optional   return  variable  that   if  used  must  be
                 specified as *DEC LEN(11 0).

   MAXCFGMEM     The maximum amount of configured  memory in MB of  the
                 physical  machine  memory  that can  be  allocated  to
                 this   partition   for  the   current   IPL   of  this
                 partition.  This is  an optional return variable  that
                 if used must be specified as *DEC LEN(11 0).

   CURMEM        The current  amount of physical  machine memory  in MB
                 that is  currently allocated to this  partition.  This
                 is  an optional return  variable that if  used must be
                 specified as *DEC LEN(11 0).

   MININTCPC1    The  minimum interactive  capacity  1  percentage  for
                 this  partition - DST  display.   This is  an optional
                 return  variable  that if  used must  be  specified as
                 *DEC LEN(3 0).

   MAXINTCPC1    The maximum  interactive  capacity  1  percentage  for
                 this partition  - DST  display.   This is an  optional
                 return  variable  that if  used must  be  specified as
                 *DEC LEN(3 0).

   CURINTCPC1    The current  interactive  capacity  1  percentage  for
                 this partition  - DST  display.   This is an  optional
                 return  variable that  if  used must  be  specified as
                 *DEC LEN(3 0).

   MININTCPC2    The  minimum  interactive  capacity  2  percentage for
                 this partition  - LPAR  configuration  display.   This
                 is an  optional return variable  that if used  must be
                 specified as *DEC LEN(5 2).

   MAXINTCPC2    The  maximum  interactive  capacity  2 percentage  for
                 this partition  - LPAR  configuration display.    This
                 is an  optional return variable  that if used  must be
                 specified as *DEC LEN(5 2).

   CURINTCPC2    The  current  interactive  capacity  2 percentage  for
                 this partition  - LPAR  configuration display.    This
                 is an  optional return variable  that if used  must be
                 specified as *DEC LEN(5 2).

   HISPLNKCN     Whether  the partition is  configured to connect  to a
                 high  speed link network.   A 'Y'  or 'N' is returned.
                 This  is an  optional  return  variable that  if  used
                 must be specified as *CHAR LEN(1).

   INTHSLCN      Whether  the partition  is  configured  to connect  to
                 the  machine's internal high speed  connection.  A 'Y'
                 or 'N'  is  returned.    This is  an  optional  return
                 variable  that if  used  must  be specified  as  *CHAR
                 LEN(1).

   MINPRCCPC     The  minimum  processing capacity  of  the partition's
                 current IPL.   If  using  shared processors,  this  is
                 the  equivalent   physical  processors.     If   using
                 dedicated   processors,   this   is  the   number   of
                 dedicated  processors.    This is  an  optional return
                 variable  that if  used  must  be  specified  as  *DEC
                 LEN(11 2).

   MAXPRCCPC     The  maximum processing  capacity  of the  partition's
                 current  IPL.   If  using shared  processors,  this is
                 the  equivalent   physical  processors.     If   using
                 dedicated   processors,   this  is   the   number   of
                 dedicated  processors.   This  is  an  optional return
                 variable that  if  used  must  be  specified  as  *DEC
                 LEN(11 2).

   CURPRCCPC     The  partition's  current  processing  capacity.    If
                 sharing  physical  processors, this  is  the share  of
                 the  physical processors in the  pool it is executing.
                 If using dedicated  processors, this is the  number of
                 virtual   processors    currently   active    in   the
                 partition.   This is an  optional return variable that
                 if used must be specified as *DEC LEN(11 2).

   CURAVLSHR     The  available  processing  capacity  of  the   shared
                 processor pool  in which  the partition  is executing.
                 This  is the  processing  capacity not  being utilized
                 by the  shared  processor.    If  the  partition  uses
                 dedicated processors,  this value  is 0.   This is  an
                 optional  return   variable  that  if   used  must  be
                 specified as *DEC LEN(11 2).

   PHYSHRPRC     The  number  of physical  machine processors  that are
                 allocated to the  shared pool  in which the  partition
                 is  executing.   This is  less  than or  equal to  the
                 number  of  processors of  the physical  machine.   If
                 the partition  uses dedicated  processors, this  value
                 is 0.   This  is an optional  return variable  that if
                 used must be specified as *DEC LEN(5 2).

   MCHHMEMMB     The amount  of the physical machine  memory in MB that
                 is  currently  allocated  to  the  hypervisor.    This
                 memory is unavailable for  any other use.  A  value of
                 zeros  indicates   that  the  system   has  no  memory
                 allocated.   This is an  optional return variable that
                 if used must be specified as *DEC LEN(11 0).

   VARPRCCPW     The partition's  relative  share of  available  shared
                 pool  processing.   If the  physical machine  firmware
                 level  is X'10', this  is the  usable uncapped weight.
                 If the  physical  machine  firmware  level  is  X'00',
                 this is  the configured uncapped  weight.  This  is an
                 optional   return  variable  that  if   used  must  be
                 specified as *DEC LEN(3 0).

   TOTPTN        The total  number of  partitions on  the system.    If
                 you  do not  have  an LPAR  system,  a 1  is  returned
                 meaning  a  single partition.    This  is an  optional
                 return  variable  that if  used  must be  specified as
                 *DEC LEN(5 0).

                 See also TOTPTN2.

   CURPTN        The current partition  on the system.   If you do  not
                 have an LPAR  system, a 0 is returned  meaning you are
                 not  in  a  partition.   This  is  an  optional return
                 variable that  if  used  must  be  specified  as  *DEC
                 LEN(5 0).

                 See also CURPTN2.

   PRIPTN        The  primary  partition  ID  (legacy).    This  is  an
                 optional   return  variable  that  if   used  must  be
                 specified as *DEC LEN(3 0).

                 See also PRIPTN2.

   SVCPTN        The  service  partition  ID  (legacy).    This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *DEC LEN(3 0).

                 See also SVCPTN2.


Restrictions
------------

Because RTVSYSPTN  returns variables, the  command may only  be used in
a CL program.

Prerequisites
-------------

None.

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVSYSPTN     *CMD                   TAASYTJ       QATTCMD
   TAASYTJC      *PGM       CLP         TAASYTJC      QATTCL
   TAASYTJR      *PGM       RPGLE       TAASYTJR      QATTRPG
					

Added to TAA Productivity tools August 15, 2003


Home Page Up to Top