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
|
