Explanation
In the message,
text is:
ARM RESTARTS ARE status
-------------- ELEMENT STATE SUMMARY -------------- -TOTAL- -MAX-
STARTING AVAILABLE FAILED RESTARTING RECOVERING
numstart numavail numfailed numrestart numrecov totalelem maxelem
RESTART GROUP:restartgroup PACING :pacing FREECSA:csabelow
csaabove
ELEMENT NAME STATE CURR INIT JOBNAME ASID LEVEL
SYS SYS
elementname state currsys initsys job asid level
ELEMENT NAME :elementname JOBNAME :job STATE :state
CURR SYS :currsys JOBTYPE :jobtype ASID :asid
INIT SYS :initsys JESGROUP:jesgrp TERMTYPE:termtype
EVENTEXIT:exitname ELEMTYPE:elementtyp LEVEL :level
TOTAL RESTARTS :totrestart INITIAL START:regdate regtime
RESTART THRESH : thresh FIRST RESTART:frstdate [frsttime]
RESTART TIMEOUT:restimeint LAST RESTART:lrstdate lrsttime
assocelemtext assocelemname
[NO ARM ELEMENTS MATCH THE SPECIFIED CRITERIA]
[NO ARM ELEMENTS ARE DEFINED]
A DISPLAY XCF,ARMSTATUS
command was entered to display information about jobs or started tasks
registered as batch elements of the automatic restart manager. The
system repeats the message text to report on each requested element
along with some general information about automatic restart management.
For
elements currently in the FAILED or RESTARTING state, the ASID and
JOBNAME fields will contain N/A.
For elements currently in the
FAILED state, the CURR SYS contains the system where the element recently
was running, even though the system may have been removed from the
sysplex.
If no elements are displayed, then one of the trailer
messages shown above will be displayed instead to explain the absence
of elements.
In the message text:
- hh.mm.ss
- The time in hours (00-23), minutes (00-59), and seconds (00-59)
when the DISPLAY XCF command was entered.
- status
- One of the following:
- ENABLED
- Automatic restart manager restarts are enabled in the sysplex.
A SETXCF START command has been issued to enable automatic restart
manager restarts.
- NOT ENABLED
- Automatic restart manager restarts are not enabled in the sysplex.
Either a SETXCF STOP command has been issued or a SETXCF START command
was never issued.
- numstart
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager that meet the
DISPLAY filtering and are in STARTING state
- numavail
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager that meet the
DISPLAY filtering, and are in AVAILABLE state. This also includes
elements listed in AVAILABLE-TO state.
- numfailed
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager that meet the
DISPLAY filtering, and are in FAILED state.
- numrestart
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager that meet the
DISPLAY filtering and are in RESTARTING state.
- numrecov
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager that meet the
DISPLAY filtering and are in RECOVERING state.
- totalelem
- The total number of batch jobs and started tasks that are currently
registered as elements of automatic restart manager and meet the DISPLAY
filtering.
- maxelem
- The maximum number of elements that can register. This information
is determined by the TOTELEM value when the ARM couple data set was
formatted.
- restartgroup
- The name of the restart group to which the elements listed belong,
based on the active policy. If restarts are not enabled or the automatic
restart manager's default policy parameters are active, then the restart
group's name is DEFAULT.
- pacing
- The restart pacing interval used between the restart of each element
in the restart group. The pacing interval is determined by the RESTART_PACING
parameter of the automatic restart management policy.
- csabelow
- The number of kilobytes (KB) of CSA that must be available on
a target system for this restart group to be restarted. The number
of kilobytes is determined by the FREE_CSA parameter of the automatic
restart management policy.
- csaabove
- The number of kilobytes (KB) of ECSA that must be available on
a target system for this restart group to be restarted. The number
of kilobytes is determined by the FREE_CSA parameter of the automatic
restart management policy.
- elementname
- The name that the element specified when the element issued the
IXCARM macro to register.
- state
- One of the following:
- STARTING
- The element issued the IXCARM macro to register but is not ready
to accept work.
- AVAILABLE
- The element is ready to accept work. The element issued the IXCARM
macro to indicate it is ready to accept work.
- AVAILABLE-TO
- The element is ready to accept work. The automatic restart manager
placed the element in AVAILABLE state when the element did not issue
the IXCARM macro to make itself ready within the ready timeout interval.
The ready timeout interval is determined by the READY_TIMEOUT parameter
of the automatic restart manager policy.
- FAILED
- The element has ended abnormally, or the system on which the element
was running is leaving the sysplex, and MVS™ has
not yet restarted the element.
- RESTARTING
- The element has been restarted but has not yet issued the IXCARM
macro to reregister.
- RECOVERING
- The element has been restarted and has reregistered but is not
yet ready to accept work.
- currsys
- The system on which the element is running or, for a failed element,
the system where the element most recently was running.
- initsys
- The system on which the element initially registered by issuing
the IXCARM macro. Initial registration is either the first registration,
or the first registration after the element deregistered itself or
was deregistered by MVS.
- job
- The name of the job or started task associated with this element.
N/A appears if the element is in FAILED or RESTARTING state.
- asid
- The address space identifier for the address space in which the
element is currently running. N/A appears if the element is in FAILED
or RESTARTING state.
- level
- The level of the element used to determine the order in which
elements are restarted. The level is determined by the element type
and LEVEL parameter of the automatic restart management policy.
- jobtype
- Either JOB or STC, which indicate whether the element is a batch
job or a started task.
- jesgrp
- The name of the JES XCF group to which the element is associated.
- termtype
- One of the following:
- ELEMTERM
- Specifies that the element should be restarted only if the element
itself unexpectedly fails. It should not be restarted if the system
on which it is running unexpectedly fails.
- ALLTERM
- Specifies that the element should be restarted if the element
unexpectedly fails or if the system on which it is running unexpectedly
fails.
- exitname
- The name of the element's event exit, which was specified when
the element issued the IXCARM macro to register. If no event exit
was specified on the register request, *NONE* appears.
- elementtype
- The element type specified when the element issued the IXCARM
macro to register. If no element type was specified on the register
request, *NONE* appears.
- totrestart
- The total number of restarts for the specified element.
- regdate
- The date of the initial registration request. The date appears
as mm/dd/yyyy, where mm is the month (01-12), dd is the day (01-31),
and yyyy is the year.
- regtime
- The time of the initial registration request. The time appears
as hh.mm.ss, where hh is hours (00-23), mm is minutes (00-59), and
ss is seconds (00-59).
- thresh
- The restart threshold value. The restart threshold value appears
as n OF m, where n is the number of restarts that have occurred within
a given time interval and m is the maximum number of restarts allowed
within that time interval. The maximum number of restarts and the
time interval are determined by the RESTART_ATTEMPTS parameter of
the automatic restart manager policy. When automatic restart manager
restarts are not enabled, N/A appears
- frstdate
- The date when the first restart of this element occurred. The
date appears as mm/dd/yyyy, where mm is the month (01-12), dd is the
day (01-31), and yyyy is the year. If there have been no restarts
of this element, *NONE* appears.
- frsttime
- The time when the first restart of this element occurred. The
time appears as hh.mm.ss, where hh is hours (00-23), mm is minutes
(00-59), and ss is seconds (00-59). If there have been no restarts
of this element, blanks appear.
- restimeint
- The restart timeout interval. The maximum amount of time, in seconds,
that the element is expected to take to reregister with the automatic
restart manager after being restarted. The interval is determined
by the RESTART_TIMEOUT parameter in the automatic restart manager
policy or by the RESTARTTIMEOUT parameter on the IXCARM macro. When
automatic restart manager restarts are not enabled, N/A appears.
- lrstdate
- The date when the most recent restart of this element occurred.
The date appears as mm/dd/yyyy, where mm is the month (01-12), dd
is the day (01-31), and yyyy is the year. If there have been no restarts
of this element, *NONE* appears.
- lrsttime
- The time when the most recent restart of this element occurred.
The time appears as hh.mm.ss, where hh is hours (00-23), mm is minutes
(00-59), and ss is seconds (00-59). If there have been no restarts
of this element, blanks appear.
- assocelemtext
- One of the following:
- ELEM BACKED BY :
- The element assocelemname identified elementname as
its backup by issuing the IXCARM macro with the ASSOCIATE,TELEMENT=elementname.
- ELEM BACKING :
- The element elementname identified assocelemname as
its backup by issuing the IXCARM macro with the ASSOCIATE,TELEMENT=assocelemname.
- assocelemname
- The name that the element elementname specified
as its backup, or associated, element when it issued the IXCARM macro.
System action
The system continues processing.
Operator response
System programmer response
Source
Cross System Coupling Facility (SCXCF)
Module
Routing code
Descriptor code