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.
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.
![Start of change](./delta.gif)
This heading:
[AUTHQLVL: value]
[MONITOR: YES/NO]
indicates whether GRS SMF 87 monitoring
is active.
![End of change](./deltaend.gif)
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.
![Start of change](./delta.gif)
This heading:
[AUTHQLVL: value]
[MONITOR: YES/NO]
indicates whether GRS SMF 87 monitoring
is active.
![End of change](./deltaend.gif)
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:
- 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