ISG343I

both

Explanation
This message was received in response to a DISPLAY
GRS command.
In the message text:  hh.mm.ss
The time in hours (00-23), minutes (00-59), and seconds (00-59)
or 00.00.00 if the time of day (TOD) clock is not working.
idr
A 3-digit identifier. It is used with the CONTROL C,D command
to cancel status displays.

In the message, text consists
of: text1

LIST        TYPE            QNAME        RNAME
list        type            qname        rname     flag

SYSTEM      STATE           SYSTEM       STATE
sysname     state           sysname      state
 [GRS STAR MODE INFORMATION]
  [LOCK STRUCTURE (ISGLOCK) CONTAINS lockentries LOCKS.]
  [THE CONTENTION NOTIFYING SYSTEM IS sysname]
  [SYNCHRES:  YES/NO/DIS]
  [ENQMAXU: value]
  [ENQMAXA: value]
  [GRSQ: CONTENTION/LOCAL/ALL]
  [AUTHQLVL: 1]
  [MONITOR:  YES/NO]

[GRS NONE MODE INFORMATION]
  [SYNCHRES:  YES/NO/DIS]
  [ENQMAXU: value]
  [ENQMAXA: value]
  [AUTHQLVL: 1]
  [MONITOR:  YES/NO]
 SYSTEM      STATE       COMM     SYSTEM       STATE    COMM
sysname     state       comm     sysname      state    comm

SYSTEM sysname MAY BE ATTEMPTING TO JOIN, BUT ALREADY
IN COMPLEX

LINK        STATUS      TARGET   LINK    STATUS   TARGET
dev         status      targsys  dev     status   targsys

S=scope     qname       rname    flag
 SYSNAME   JOBNAME  ASID   TCBADDR   EXC/SHR    OWN/WAIT
sysname   job      asid   tcbaddr   exc/shr    own/wait/use

qname      qname     qname  ...

[GLOBAL REQUESTS PENDING FOR ISGLOCK STRUCTURE:]
[NO REQUESTS PENDING FOR ISGLOCK STRUCTURE]

text2
 JOBNAME    ASID            QNAME              RNAME
jobname    asid            qname              rname

[error-condition]

text3

text4
 LATCH SET NAME: latch_set_name
CREATOR JOBNAME: creator_jobname  CREATOR ASID: creator_asid

[LATCH NUMBER: latch_num]
[LATCH ID: latch_id]
REQUESTOR         ASID      EXC/SHR       OWN/WAIT  WORKUNIT  TCB  ELAPSED  TIME
req_name          asid      req_status    req_type  hexaddr   Y/N  elapsed_time

The
operator entered a DISPLAY GRS command.  This message displays information
about the systems in the same global resource serialization complex
as this system. This DISPLAY GRS command does not display any systems
that have been purged from the global serialization complex even if
the command was entered on that system.
If HEX was specified
on a DISPLAY GRS command, each character is translated into two hexadecimal
digits vertically underneath the character.
The first line,
 with the time stamp, is always issued. The rest of the information
displayed varies with the command entered. Lines of information may
be repeated.
The following commands display global resource
serialization information: DISPLAY GRS,RNL
The message displays the contents of one or all the resource name
lists (RNL).
DISPLAY GRS,SYSTEM
The message displays information about other global resource serialization
systems. If this system is an active or inactive global resource serialization
system, information about the following systems is displayed: This system
All other global resource serialization systems in the global
resource serialization
All systems joining the global resource serialization complex
and in the same sysplex as this system
All responding systems joining the global resource serialization
complex with channel to channel (CTC) devices to this system

 If this system is a quiesced or restarting global resource
serialization system information about the following systems is displayed: This system
The other global resource serialization systems which are in the
same sysplex as this system
The other responding global resource serialization systems with
CTC links to this system
All global resource serialization systems in the global resource
serialization complex if there is an active or inactive responding
system in the same sysplex as this system, or if there is a functional
CTC link to this system.

DISPLAY GRS,LINK
The message displays the CTC status if global resource serialization
CTC links were defined in the GRSCNFxx parmlib member. parmlib member,
and the system is in a global resource serialization ring complex.
DISPLAY GRS,RES=(qname,rname)
The message displays resource information.
DISPLAY GRS,CONTENTION
This message displays information about tasks that are contending
for ownership of resources through one or more ENQ or Latch_Obtain
requests.
DISPLAY GRS,LATCH
When specified with the CONTENTION, JOBNAME, or ENQ operands,
or any combination of those three operands, this message displays
latch information.
DISPLAY GRS,RES=[*|qname]
The message displays major resource names specified.
DISPLAY GRS,ALL
The message displays: The contents of system inclusion, systems exclusion, and reserve
conversion resource name lists (RNL)
Resource contention information
System information
Communication links status, if the global resource serialization
ring complex is not equal to the sysplex
Information about the global resource serialization lock structure
if the system is in a star complex
Delay and suspend information if an RNL change is in progress
The value of AUTHQLVL returned from the SETGRS AUTHQLVL for the
number of authorized qname lists in effect for the system.

DISPLAY GRS
The message displays the system status.  If the global resource
serialization ring complex is not the same as the sysplex, it displays
the status of the communication links.
DISPLAY GRS,DELAY
This message displays information about the jobs that are delaying
a pending RNL change. The jobs listed hold resources affected by the
RNL change and must relinquish control of those resources before the
RNL change can complete. A maximum of 500 lines of output can appear
for this command.  The first line of the output is a one-line header,
which is followed by a maximum of 499 lines of resource information.
 Information for each resource is presented on one line, so information
can be displayed for a maximum of 499 resources.

DISPLAY GRS,DEV=dev
This message displays a list of non-converted RESERVE requests
for the specified device.
DISPLAY GRS,SUSPEND
This message displays information about jobs suspended by the
pending RNL change.  The jobs listed are requesting resources affected
by the RNL change.  The system does not permit these jobs access to
these resources, so they remain suspended until the RNL change completes. A
maximum of 500 lines of output can appear for this command.  The first
line of the output is a one-line header, which is followed by a maximum
of 499 lines of resource information.  Information for each resource
is presented on one line, so information can be displayed for a maximum
of 499 resources.

text1 is one of the following: DEVICE dev IS NOT A DIRECT ACCESS STORAGE DEVICE
The device specified in command D,GRS,DEV=dev was
not a direct access storage device. No output is formatted.
DEVICE dev CURRENTLY NOT DEFINED TO THE CONFIGURATION
There is no UCB defined for the device specified in command D,GRS,DEV=dev.
DEVICE dev DISPLAY COMMAND CANCELLED DUE TO
UCBLOOK RC=xx
The system encountered an unexpected return code from the UCBLOOK
service. Contact the IBM® Support
Service.
DEVICE dev VOLUME volser NOT
RESERVED BY SYSTEM sysname NO RESERVE RESOURCE
REQUEST EXISTS
No reserve request exists for the device number specified in command
D,GRS,DEV=dev for this system.
DEVICE dev VOLUME volser RESERVED
BY SYSTEM sysname
Device dev is reserved for this system.

In the following section, the information
that is displayed is character data: LIST        TYPE            QNAME        RNAME
list        type            qname        rname     flag
 list
Is one of the following: INCL
This RNL entry is contained in the system inclusion RNL.
EXCL
This RNL entry is contained in the systems exclusion RNL.
CON
This RNL entry is contained in the reserve conversion RNL.

type
The type of resource identified in the RNL entry. type is
one of the following: SPEC
The RNL entry identifies a specific resource name.
GEN
The RNL entry identifies a generic resource name.
PATT
The RNL entry identifies a resource name that contains a wildcard
character.

qname
The major name of the resource in the RNL requested. Any unprintable
characters appear as blanks.
rname
The minor name of the resource in the RNL requested. Any unprintable
characters appear as blanks.
flag
The value of flag indicates whether the rname was
truncated. Any rname exceeding 39 bytes is truncated. flag is
one of the following: T
The rname was truncated.
blank
rname was not truncated.

In this heading: DEVICE: dev VOLUME: vol  RESERVED BY SYSTEM sysname
 all
non-converted RESERVE macro requests that have been issued against
a particular device are displayed. By determining what program has
the RESERVE request, a deadly embrace situation can be resolved.
In
the following section: SYSTEM      STATE           SYSTEM             STATE
sysname     state           sysname            state
 sysname
The name of a system in the global resource serialization complex.
state
The state of a system in global resource serialization. ACTIVE
The system is a member of the global resource serialization ring.
INACTIVE
The system was an active global resource serialization system
when the global resource serialization ring was disrupted. The system's
status will change to quiesced as soon as it communicates with a global
resource serialization system that is already active. The system suspends
any tasks that try to obtain global resources.
QUIESCED
The system suspended its participation in the global resource
serialization ring, but a global resource serialization ring does
exist. The system suspends any tasks that try to obtain global resources.
JOINING
The system is processing the GRS=JOIN or TRYJOIN system parameter.
It is not yet a member of either the global resource serialization
ring or the global resource serialization complex.
RESTARTING
The system is trying to rejoin the global resource serialization
ring. It is already a member of the global resource serialization
complex, but it is not yet a member of the global resource serialization
ring.
ACTIVE + VARY
The system is an active global resource serialization system that
is processing a VARY command.
ACTIVE + WAIT
The system is an active global resource serialization system that
is waiting to process a global resource serialization VARY command.
CONNECTING
The system is processing the GRS=STAR system parameter.  It is
not yet a member of the global resource serialization star complex.
CONNECTED
The system is a member of the global resource serialization star
complex.
REBUILDING
The system is a member of the global resource serialization star
complex, but is currently rebuilding the global resource serialization
lock structure. The system suspends any tasks that try to obtain global
resources.
MIGRATING
The system is processing migration from a global resource serialization
ring complex to a star complex. The system suspends any tasks that
try to obtain global resources.

This heading: [GRS STAR MODE INFORMATION]
[LOCK STRUCTURE (ISGLOCK) CONTAINS lockentries LOCKS]
[THE CONTENTION NOTIFYING SYSTEM IS sysname/N/A]
[SYNCHRES:  YES/NO/DIS]
[GRSQ: grsq value/CONTENTION]
[ENQMAXU: value]
[ENQMAXA: value]
 indicates that global
resource serialization is operating in star mode. The global resource
serialization lock structure, ISGLOCK contains lockentries locks.
The contention notifying system is sysname or N/A when
no system in the complex that is capable of handling contention notification.
SYNCHRES indicates the current setting of the SYNCHRES parameter.
This only appears when global resource serialization is in star mode.
See the explanations for ENQMAXU, ENQMAXA, and GRSQ.
This heading: [GRS STAR MODE INFORMATION]
[LOCK STRUCTURE (ISGLOCK) CONTAINS lockentries LOCKS]
[THE CONTENTION NOTIFYING SYSTEM IS sysname/N/A]
[SYNCHRES:  YES/NO/DIS]
[GRSQ: CONTENTION|LOCAL|ALL]
[ENQMAXU: value]
[ENQMAXA: value]
 indicates that global
resource serialization is operating in star mode. The global resource
serialization lock structure, ISGLOCK contains lockentries locks.
The contention notifying system is sysname or N/A when
no system in the complex that is capable of handling contention notification.
SYNCHRES indicates the current setting of the SYNCHRES parameter.
This only appears when global resource serialization is in star mode.
See the explanations for ENQMAXU, ENQMAXA, and GRSQ.
This heading: [GRSQ: CONTENTION]
  [AUTHQLVL: value]
indicates the authorized
QNAME level value for global resource serialization that is set by
the GRSCNFxx parmlib member or SETGRS AUTHQLVL command or the GRSCNFxx
parmlib member where value is the decimal number
1 or 2.
This heading:   [AUTHQLVL: value]
  [MONITOR: YES/NO]
indicates whether GRS SMF 87 monitoring
is active.
This heading: [GRS NONE MODE INFORMATION]
  [SYNCHRES:  YES/NO/DIS]
  [ENQMAXU: value]
  [ENQMAXA: value]
indicates that global
resource serialization is not operating in ring or star mode.
This
heading:  [AUTHQLVL: value]
indicates
the authorized QNAME value for global resource serialization that
is set by the SETGRS AUTHQLVL command where value is
the decimal number 1 or 2.
This heading:   [AUTHQLVL: value]
  [MONITOR: YES/NO]
indicates whether GRS SMF 87 monitoring
is active.
The GRS NONE mode information is as follows: SYNCHRES: YES
The system default is to perform synchronous reserves for unconverted
RESERVEs. Note that RESERVEs requested through the ISGENQ service
may override this value via the SYNCHRES keyword option.
SYNCHRES: NO
The system default is not to perform synchronous reserves for
unconverted RESERVEs. Note that RESERVEs requested through the ISGENQ
service may override this value via the SYNCHRES keyword option
SYNCHRES: DIS
Synchronous reserves are not being performed due to a failure
in synchronous reserve processing. Message ISG348E was issued at the
time the error occurred. See message ISG348E for further information.
The system default and disabled state can be reset by issuing the
SETGRS SYNCHRES command.
ENQMAXU value
The system-wide maximum number of concurrent unauthorized ENQ
requests allowed for any given address space.
ENQMAXA value
The system-wide maximum number of concurrent authorized ENQ requests
allowed for any given address space.
GRSQ: CONTENTION|LOCAL|ALL
Indicates if ENQ resources are collected from the local system
or the entire global resource serialization complex.  GRSQ contains
one of the following values:CONTENTION causes GRSQ processing to collect all ENQ resources
on the local system and only collect information about global resources
in contention in the rest of the GRS complex. 
LOCAL causes GRSQ processing to collect all ENQ resources on the
local system only. This is NOT a recommended value and should only
be used as a circumvention. The GQSCAN that is issued does not collect
data from the other systems. 
ALL causes GRSQ processing to collect all ENQ resources from all
systems in the entire GRS complex. Specifying GRSQ(CONTENTION) adds
WAITCNT=1. 

In this heading: SYSTEM      STATE       COMM     SYSTEM       STATE    COMM
sysname     state       comm     sysname      state    comm
 sysname
The name of a system in the global resource serialization ring
complex.
state
The state of a system in global resource serialization. ACTIVE
The system is a member of the global resource serialization ring.
INACTIVE
The system was an active global resource serialization system
when the global resource serialization ring was disrupted. The system's
status will change to quiesced as soon as it communicates with a global
resource serialization system that is already active. The system suspends
any tasks that try to obtain global resources.
QUIESCED
The system suspended its participation in the global resource
serialization ring, but a global resource serialization ring does
exist. The system suspends any tasks that try to obtain global resources.
JOINING
The system is processing the GRS=JOIN or TRYJOIN system parameter.
It is not yet a member of either the global resource serialization
ring or the global resource serialization complex.
RESTARTING
The system is trying to rejoin the global resource serialization
ring. It is already a member of the global resource serialization
complex, but it is not yet a member of the global resource serialization
ring.
ACTIVE + VARY
The system is an active global resource serialization system that
is processing a VARY command.
ACTIVE + WAIT
The system is an active global resource serialization system that
is waiting to process a global resource serialization VARY command.

comm
The status of communication between this system and system sysname. YES
This system has a functional communication link to system sysname.
NO
This system does not have a functional communication link to system sysname.

In this section: SYSTEM sysname MAY BE ATTEMPTING TO JOIN, BUT ALREADY
IN COMPLEX
 indicates the system sysname is
attempting to join the complex, but a system with that name is already
defined to the complex.  Until the defined system is purged from the
complex, the new system will not be prevented from joining.
In
this section: LINK    STATUS    TARGET   LINK   STATUS   TARGET
dev     status    targsys  dev    status   targsys
 dev
The device number of a channel-to-channel (CTC) device belonging
to this system and assigned to global resource serialization.
status
The status of CTC dev is one of the following: IN-USE
Global resource serialization is using this CTC to send the ring-processing
system authority (RSA).
ALTERNATE
Global resource serialization is not using this CTC to send the
RSA, but it could do so. Global resource serialization might be using
this CTC for ring acceleration.
DISABLED
Global resource serialization does not use this CTC and ignores
any communications from it.
QUIET
Global resource serialization sent a message to the system on
the other end of device dev, but received no response.

targsys
The name of the system at the other end of this device. If blank,
no system has responded since this system joined the global resource
serialization complex.

In this section, the data is either character
or hexadecimal: S=scope qname      rname    flag
 scope
The scope requested for the resource is one of the following: STEP
SYSTEM
SYSTEMS

qname
The major name of the resource with the indicated scope. Any unprintable
characters appear as blanks.
rname
The minor name of the resource with the indicated scope. Any unprintable
characters appear as blanks. Any rname that exceeds
39 bytes is truncated.
flag
The value of flag indicates whether the rname was
truncated. flag is one of the following: T
rname was truncated.
blank
rname was not truncated.

In this section: SYSNAME    JOBNAME   ASID   TCBADDR   EXC/SHR  OWN/WAIT
sysname    job       asid   tcbaddr   exc/shr  own/wait/use

qname      qname     qname  ...
 sysname
The name of the system that requested the resource identified
on the DISPLAY GRS command.
jobname
The names of the jobs that requested the resources identified
on the DISPLAY GRS command. The jobname field
is in format jobname1/jobname2,  where jobname1 requested
the resource for jobname2.
 If jobname1 is
not processing a request for another job, the jobname2 and asid2 fields
will be blank. If the request originated on a different system or jobname1 did
not provide GRS with jobname2, the jobname2 value
will be *UNKNOWN and the asid2 value will
be X'0000'. If jobname1 provided GRS with
an invalid asid2 value, then the jobname2 value
will be UNKNOWN.

asid
The address space identifier (ASID), in hexadecimal, for the address
space that requested the resource. The asid field
is in format asid1/asid2, where asid1 is
the asid of jobname1 and asid2 is
the asid of jobname2.
 If jobname1 is
not processing a request for another job, the asid2 and jobname2 fields
will be blank. If the request originated on a different system, the jobname2 value
will be *unknown and the asid2 value will
be X'0000'

tcbaddr
The address of the task control block (TCB) that requested the
resource identified on the DISPLAY GRS command.
exc/shr
One of the following: EXCLUSIVE
The job requested exclusive use of the resource.
SHARE
The job requested shared use of the resource.

own/wait/use
One of the following: OWN
The job owns the resource.
WAIT
The job is waiting for the resource.
USE-MASID
The job has access to the resource via a matching task request.
WAIT-MASID
The job is waiting for access to the resource via a matching task
request.

qname
The major name of a resource.

This section: [GLOBAL REQUESTS PENDING FOR ISGLOCK STRUCTURE:]
[NO REQUESTS PENDING FOR ISGLOCK STRUCTURE]
 indicates
whether global requests are pending for the ISGLOCK structure. These
lines are returned for a DISPLAY GRS,C command only. If global requests
are pending for the ISGLOCK structure, the following information is
returned for each requestor: major
ENQ request major name (QNAME)
minor
ENQ request minor name
jobname
The name of the jobs that requested the ISGLOCK resource.
asid
The address space identifier (ASID), in hexadecimal, for the address
space that requested the ISGLOCK resource.
tcbaddr
The address of the task control block (TCB) that requested the
ISGLOCK resource.
request
One of the following: ENQ-EXCL
ENQ request for exclusive ownership
ENQ-SHR
ENQ request for shared ownership
DEQ
DEQ request
SYNC
Address space synchronization

mm/dd/yyyy
The date on which the request for the ISGLOCK resource was made
in month/day/year format.
hh:mm:ss
The time at which the request for the ISGLOCK resource was made
in hour/minute/second format.
THIS REQUEST IS DELAYED MORE THAN 2 SECONDS
This line is displayed if the request is delayed for at least
two seconds. If the request is not delayed, this line is not displayed.
PENDING PREVIOUS LOCK REQUEST
This line is displayed for each request waiting for the lock request
to complete.
DISPLAY TRUNCATED
This line is displayed if the system cannot display all of the
outstanding requests.

If global requests are not pending for the
ISGLOCK structure, the following line is returned: NO REQUESTS PENDING FOR ISGLOCK STRUCTURE

text2 is
one of the following: JOBS BEING SUSPENDED DUE TO RNL CHANGE ON SYSTEM sysname
The jobs displayed requested resources that are affected by the
pending RNL change. The jobs remain suspended until the RNL change
completes.
JOBS FROM SYSTEM sysname DELAYING RNL CHANGE
Jobs running on system sysname hold resources
that are suspending an RNL change.

In this section: JOBNAME    ASID            QNAME              RNAME
jobname    asid            qname              rname
 jobname
The names of the jobs that requested the resources identified
on the DISPLAY GRS command. The jobname field
is in format jobname1/jobname2.  jobname1 requested
the resource for jobname2.
 If jobname1 is
not processing a request for another job, the jobname2 and asid2 fields
will be blank. If the request originated on a different system, the jobname2 value
will be *unknown and the asid2 value will
be X'0000'.

asid
The address space identifier (ASID), in hexadecimal, for the address
space that requested the resource. The asid field
is in format asid1/asid2. asid1is
the asid of jobname1 and asid2 is
the asid of jobname2.
 If jobname1 is
not processing a request for another job, the asid2 and jobname2 fields
will be blank. If the request originated on a different system, the jobname2 value
will be *unknown and the asid2 value will
be X'0000'.

qname
The major name of a resource affected by the RNL change requested.
Any unprintable characters appear as blanks.
rname
The minor name of the resource affected by the RNL change requested.
Any unprintable characters appear as blanks. If the RNAME is truncated,
the character t will appear at the end of the line.

This section is displayed if an error occurred: [error-condition]
 and
one of the following appears in the message text: AN INVALID QEL HAS BEEN DETECTED. NO SYSTEM WILL BE ABLE TO JOIN
OR RESTART INTO THE GLOBAL RESOURCE SERIALIZATION COMPLEX UNTIL THE
PROBLEM IS CORRECTED.
Global resource serialization queue scanning services detected
an invalid queue element (QEL) in the resource queues. Each QEL represents
a requestor of a resource. Global resource serialization prevents
other systems from restarting global resource serialization or joining
a complex.
FUNCTION INOPERATIVE - NO STATUS
This system cannot process the DISPLAY GRS command for one of
the  following reasons: This system is still processing the GRS START, JOIN, or TRYJOIN
system parameter.
The global resource serialization command processor failed.

NO ENTRIES EXIST IN THE RESERVE CONVERSION RNL
This system has an empty RESERVE conversion resource name list.
NO ENTRIES EXIST IN THE SYSTEM EXCLUSION RNL
This system has an empty SYSTEMS exclusion resource name list.
NO ENTRIES EXIST IN THE SYSTEM INCLUSION RNL
This system has an empty SYSTEM inclusion resource name list (RNL).
NO REQUESTORS FOR RESOURCE qname,rname
No system has requested the resources specified by the DISPLAY
GRS,RES command. qname is the major name of the
resource specified. rname is the minor name of
the resource specified.
NO REQUESTORS FOR RESOURCE WITH QNAME qname
No system requested any resource with the qname specified
in the DISPLAY GRS,RES command. qname is the major
name of the resource specified.
NO RESOURCE CONTENTION EXISTS
Global resource serialization determined that no resource contention
existed when the command was entered.
NOT ENOUGH STORAGE TO COMPLETE THE REQUEST
There was a large amount of data resulting from this request and
although GRS was able to gather the information, it could not all
fit into the buffer used in GRS display processing. If a D GRS,RES=
type of request was specified, try narrowing down the search by applying
additional filtering. For example, a search of D GRS,RES=(SYSDSN,SYS1*)
has a higher likelihood of completing successfully than a search of
D GRS,RES=(SYSDSN,*).
REQUEST NOT COMPLETED - UNRECOVERABLE ERROR IN GQSCAN
The system was unable to retrieve all the resources for the display
request due to an error in the GQSCAN service.
REQUEST NOT COMPLETED - UNABLE TO OBTAIN  GLOBAL DATA FROM ALL
SYSTEMS IN THE SYSPLEX
The system was unable to retrieve all the resources for the display
request because not all the systems in the sysplex responded to the
request.
REQUEST NOT COMPLETED - MIGRATION TO STAR MODE IN PROGRESS
The system was unable to complete the request because the complex
is migrating from ring mode to star mode.
GRSRNL=EXCLUDE IS IN EFFECT. ALL ENQ/DEQ REQUESTS EXCEPT THOSE
SPECIFYING SCOPE=SYSTEMS, RNL=NO ARE BEING TREATED AS LOCAL REQUESTS.
RNLs are not in use.  ENQ and DEQ requests for SCOPE=SYSTEMS,
RNL=NO are treated as global, SCOPE=SYSTEMS requests. All other global
requests (SCOPE=SYSTEMS,RNL=YES) are being treated as if they were
local requests.
LINK STATUS NOT APPLICABLE - GRS IS IN STAR MODE.
A link status display was requested, but global resource serialization
is currently running in STAR mode.

text3 is one of the following: RNLS ARE NOT IN EFFECT
Resource name lists (RNL) are not being used because global resource
serialization is not active.
DISPLAYED STATUS IS ttt SECONDS OLD
This system was processing either a GRS VARY command or a previously
entered GRS DISPLAY when the operator entered this DISPLAY GRS command. This
line shows how old the status displayed in this message was at the
time the command was entered. ttt is the age of
the state in seconds.
 To display current status, enter the
DISPLAY GRS command.

GRS IS USING XCF COMMUNICATION FACILITIES
This system is in a multisystem sysplex.
>>SYSTEM sysname MAY BE ATTEMPTING TO JOIN,
BUT ALREADY IN COMPLEX<<
There is more than one system with the same name. This can mean
that a system is trying to join the complex with a name already in
use in the complex.
NO ACTIVE SYSTEMS RESPONDED, SOME SYSTEMS MAY NOT BE DISPLAYED
All systems are quiesced or inactive.
THERE ARE NO JOBS SUSPENDED ON SYSTEM sysname 
DUE TO RNL CHANGE.
System sysname has no jobs suspended by an
RNL change.
 THERE IS NO RNL CHANGE IN PROGRESS.
No RNL changes were in progress when the operator entered the
DISPLAY command.
THERE ARE NO DELAY REASONS ON SYSTEM sysname
System sysname shows no delays due to an  RNL
change.
REPORT EXCEEDS 500 LINES AND HAS BEEN TRUNCATED
The DISPLAY GRS,SUSPEND or DELAY command can only display 500
resource requests. Additional information is truncated.

text4 is one of the following: NO [ENQ RESOURCE|LATCH] CONTENTION EXISTS
One of the following commands was entered: DISPLAY GRS,ENQ,CONTENTION
DISPLAY GRS,LATCH,CONTENTION
DISPLAY GRS,CONTENTION
DISPLAY GRS,ALL

 No contention exists for the specified serialization service.
If DISPLAY GRS,CONTENTION was entered, the system displays both forms
of this message to indicate that no contention exists for both latches
and ENQs.

PARTIAL LATCH INFORMATION AVAILABLE
The system did not display all the available latch contention
information because there was too much data to display, the system
took too long to gather the information, or the information was changing
when the system tried to gather it.
LATCH DISPLAY FOR JOB jobname
[NO LATCHES OWNED OR WAITED UPON]
A DISPLAY GRS,LATCH,JOB=jobname command was
entered. If the specified job currently owns a latch or has a pending
request to obtain a latch, the system displays information about those
latches.  Otherwise, the system displays NO LATCHES OWNED OR WAITED
UPON to indicate that no latches are owned or waited on by the
specified job.

In this section: LATCH SET NAME: latch_set_name
CREATOR JOBNAME: creator_jobname  CREATOR ASID: creator_asid
LATCH NUMBER: latch_num

REQUESTOR   ASID      EXC/SHR       OWN/WAIT  WORKUNIT  TCB  ELAPSED TIME
req_name    asid      req_status    req_type  hexaddr   Y/N  elapsed_time
 the
system displays the following fields for each latch in the latch set
that meets the selection criteria (contention, jobname, or both). latch_set_name
The name of the latch set that is currently displayed. If the
HEX option is specified on the DISPLAY GRS command, the system displays
the latch set name in EBCDIC and hexadecimal.  The hexadecimal characters
are displayed vertically under each EBCDIC character.
creator_jobname
The name of the job associated with the primary address space
when the latch set was created.
creator_asid
The hexadecimal identifier for the primary address space when
an application called the Latch_Create service to create latch set latch_set_name.
latch_num
The decimal number of the latch for which information is displayed.
The latch is a member of latch set latch_set_name. If the CONTENTION
operand was specified on the DISPLAY GRS command, the latch has contention.
 If the JOBNAME operand was specified on the DISPLAY GRS command,
the specified job either owns the latch or has a pending request to
obtain the latch.
latch_id
The requested latch number and identity. For compatibility reasons,
the message displays the latch id format only when LATCHID is specified
on the command. If LATCHID is specified but no latch identity is provided
by the latch creator, the message displays the latch number followed
by "(ID NOT SPECIFIED)". If LATCHID is specified and an available
latch identity with a printable string exists, the message displays
the identity string in one or more lines truncated after 255 characters.
If truncation occurs, the character “T” follows the string, separated
by a space.
req_name
The eight character name of the job associated with the home address
space when a task or SRB routine called the Latch_Obtain service to
obtain the specified latch.
asid
The hexadecimal identifier for the primary address space when
a task or SRB routine called the Latch_Obtain service to obtain the
specified latch.
req_status
One of the following: EXCLUSIVE
The task or SRB routine associated with the specified job name
requested exclusive ownership of the latch.
SHARE
The specified task or SRB routine requested shared ownership of
the latch.

req_type
One of the following: OWN
The named task or SRB routine owns the latch.
WAIT
The named task or SRB routine is waiting (for example, has a pending
request) to obtain ownership of the latch.

hexaddr
The hexadecimal address of the requesting TCB or SRB.
Y/N
The Y indicates that the request for the latch was made by a TCB.
The N indicates that the request was made by an SRB.
elapsed_time
The elapsed_time shows how much time has elapsed
between the time the request entered this state and the issuance of
this message in hh:mm:ss.ddd format. No rounding is done. If
the elapsed time is greater than 24 hours, the following text
is displayed: -over 24 hrs.

Example:ISG343I 09.59.16 GRS STATUS       FRAME  1     F      E   SYS=S1    
LATCH SET NAME:  LAR25SET1                                           
CREATOR JOBNAME: GRJLAR25  CREATOR ASID: 0028                        
 LATCH NUMBER:  0                                                    
  REQUESTOR  ASID  EXC/SHR    OWN/WAIT  WORKUNIT  TCB  ELAPSED TIME  
  GRJLAR25   0028  EXCLUSIVE  OWN       006E6CF0   Y   00:00:07.438  
  GRJLAR25   0028  SHARED     WAIT      006E6B58   Y   00:00:06.416  
 LATCH NUMBER:  1                                                    
  REQUESTOR  ASID  EXC/SHR    OWN/WAIT  WORKUNIT  TCB  ELAPSED TIME  
  GRJLAR25   0028  EXCLUSIVE  OWN       006E6CF0   Y   -over 24 hrs  
  GRJLAR25   0028  SHARED     WAIT      006E6B58   Y   00:00:06.416

System action
The system continues processing.

Operator response
None.

System programmer response
None.

Problem determination
The TCB or SRB and elapsed time information
can be used to resolve long standing latch contention that might be
in error.

Source
Global resource serialization

Module
ISGCDSP, ISGCDDS, ISGCLDM

Routing code
None.

Descriptor code
5,8,9