Skip to Content
Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops SYSPROG Services 6.3.

QUEUE

The QUEUE (QUE) service displays current enqueue conflicts or requested system enqueue information.

Several filter options are provided, including the ability to filter by using a job name.

Warning

Note

The QUEUE service functionally replaces the ENQUEUE service, while providing new features. The ENQUEUE service is still available, but BMC recommends the use of the QUEUE service over the ENQUEUE service.

A conflict exists when one or more requesters are waiting for a resource. If this occurs frequently for a given resource, you can cause that resource to be omitted from the display by adding it to BBPARM member $$XENQ. See XENQ.

The QUEUE service permits the use of several parameters, the defaults of which have been designed to simplify the use of the service. For example, you can display current enqueue conflicts by omitting all parameters, or display enqueue information for a specific data set name by specifying only the data set name. You can also display enqueue information for multiple data sets whose names match the pattern you have entered.

Syntax

GUID-D65E388F-2A40-4FE7-B434-C0E6A558E361-low.pngThe parameters are defined as follows:

Parameter

Description

RNAME=rname

RNAME for the search

Specify a 1- to 64-character literal value (see the explanation of literal value in the section Definitions). Optionally, the keyword RNAME can be omitted if you enter the RNAME value in the first parameter position.

The literal value can contain up to 64 characters and can contain pattern characters. See the description of pattern characters in the section Definitions.

QNAME=qname

identifies the QNAME value for the search

Specify a one- to eight-character literal value (see the explanation of literal value in the section Definitions). Optionally, the keyword QNAME= can be omitted if you enter the QNAME value in the second parameter position. If omitted, QNAME='SYSDSN' is assumed unless JOBNAME= or TASK= is specified, in which case the default is QNAME=*.

The QNAME value can contain pattern characters. See the description of pattern characters in the section Definitions.

JOBNAME=jobname

( optional ) when specified, limits the returned information to the specified address space

Optionally, the keyword JOBNAME= can be omitted if you enter the JOBNAME value in the third parameter position. See the explanation of asi in the section Identifying-address-spaces for the various forms that can be used to identify the address space.

The JOBNAME parameter is mutually exclusive with the TASK= parameter.

SCOPE=keyword

defines the SCOPE of the resources that are to be returned

The following values are allowed: ANY, SYSTEM, SYSTEMS, and SYSPLEX. The default is ANY.

TASK=symbolName

(optional) specifies a symbol that identifies the desired task that was created by the TCB or PSTORAGE service

The TASK parameter is mutually exclusive with the JOB parameter.

RTOKEN

(optional) indicates that the 32-byte resource token is to be displayed for each listed resource

You can specify NO or YES. The default is NO

RTOKEN=YES is supported only on IBM z/OS 1.9 and later.

Warning

Note

  • All keyword parameters can be abbreviated to their first two letters. For example, you can specify QNAME= or QN=.
  • RNAME and QNAME values are displayed in hexadecimal if they contain nonprintable characters.
  • RTOKEN values are displayed in hexadecimal.

Definitions

Literal values

Within the context of the QNAME and RNAME parameters of the QUEUE service, you can enter a literal value in the following ways:

Example

Explanation

abcd

The value is not enclosed within quotation marks so it is converted to uppercase. The result is 'ABC'.

‘abcd’

The value is enclosed in quotation marks so it is assumed to be a character value and is not converted to uppercase. Therefore, the result is 'abcd'.

C’abcd’

The value is enclosed in quotation marks so it is assumed to be a character value and is not converted to uppercase. Therefore, the result is 'abcd'.

X’abcd’

The value begins with an X followed by a quotation mark and ends with a quotation mark; therefore, it is considered to be a two-byte hexadecimal value. The case is ignored.

abcd(64)

The suffix (64) indicates that the preceding abcd is an expression that, when evaluated, is the address of the value in storage. The decimal number enclosed within parentheses is the length of the value.

Therefore, if symbol ABCD has been previously defined, then the value of that symbol (and its address space attribute), when evaluated, determines the start of the value within storage. In this example, the expression ABCD could also be the hexadecimal address X’ABCD’. If the symbol ABCD does not exist, it is assumed to be an address. If the first term in the expression is not a defined symbol and contains nonhexadecimal characters, it is considered invalid.

The length of this value can be up to 255 bytes. See Expressions for additional information.

Pattern characters

You can use the ? and * pattern characters within the QNAME and RNAME parameters.

  • ? indicates that any character can appear in that position.
  • * indicates that any number of characters (including zero) can appear in that position.

All other characters must match for the enqueue to be selected for display. For example, a pattern of ABC*DEF would match on any of the following values:

  • ABCDEF
  • ABC123DEF
  • ABC.DEF

Example 1

To list all enqueue information for data sets beginning with SYS2.BB, type

QUE,SYS2.BB*

AMTQU1I Your search located 21 resources                                  

AMTQU2I Scope=SYSTEM  Owners= 3  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBX.BBLINK                                                 
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       XCFAS    0006  6FF890  Owns  Shr  22:16:41 5/22/2012   
AMTQU6I SJSD       LLA      001B  6FF890  Owns  Shr  22:16:42 5/22/2012   
AMTQU6I SJSD       DC$DSTR  007F  6FF890  Owns  Shr  22:20:01 5/22/2012   

AMTQU2I Scope=SYSTEM  Owners= 8  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBPROD.BBPARM                                              
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       DC$BBID  0021  6FF890  Owns  Shr  22:19:04 5/22/2012   
AMTQU6I SJSD       DC$CAS   002C  6FF890  Owns  Shr  22:19:07 5/22/2012   
AMTQU6I SJSD       DC$PAS   002D  6FF890  Owns  Shr  22:19:07 5/22/2012   
AMTQU6I SJSD       DC$TOM   004E  6FF890  Owns  Shr  22:19:42 5/22/2012   
AMTQU6I SJSD       DC$RES   007B  6FF890  Owns  Shr  22:20:02 5/22/2012   
AMTQU6I SJSD       DC$DSTR  007F  6FF890  Owns  Shr  22:20:01 5/22/2012   
AMTQU6I SJSD       DC$TDCAS 00E3  6FF890  Owns  Shr  22:30:09 5/22/2012   
AMTQU6I SJSD       DC$TDPAS 00E4  6FF890  Owns  Shr  22:30:09 5/22/2012   

AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBPLEX01.CFRM02                                            
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       XCFAS    0006  6FF890  Owns  Shr  22:16:43 5/22/2012   

AMTQU2I Scope=SYSTEM  Owners= 3  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBPROD.BBLOAD                                              
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       BMVDWP3  013F  6FF890  Owns  Shr  8:33:38 5/23/2012    
AMTQU6I SJSD       BMVDWP4  0140  6FF890  Owns  Shr  8:34:00 5/23/2012    
AMTQU6I SJSD       BMVDWP5  0141  6FF890  Owns  Shr  8:34:23 5/23/2012    

AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBPLEX01.ARMCDS02                                          
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       XCFAS    0006  6FF890  Owns  Shr  22:16:43 5/22/2012   

AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                               
AMTQU3I Q=SYSDSN                                                          
AMTQU4I R=SYS2.BBPLEX01.OMVS.CDS03                                        
AMTQU7I D9E2C3E301000000000000480021CD6000C99BD8621DB0DA8C000000012A0006  
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                 
AMTQU6I SJSD       XCFAS    0006  6FF890  Owns  Shr  22:16:38 5/22/2012   

AMTQU2I Scope=SYSTEM  Owners= 17  No Waiters                              
AMTQU3I Q=SYSDSN                                                          
***


Example 2

To display enqueue information for a specific data set, including the resource token, type

QUE,VAM3.GEN.LOAD

AMTQU1I Your search located 1 resource                                 

AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                            
AMTQU3I Q=SYSDSN                                                       
AMTQU4I R=VAM3.GEN.LOAD                                                
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time              
AMTQU6I SJSD       BMVDWP4  0140  6FF890  Owns  Shr  11:26:41 5/23/2012
Warning

Note

In this example, R= was omitted because it is optional when specified in the first parameter position.


Example 3

The TCB service assigns a symbolic name to each task which may be used to identify a task to the QUEUE service. Also, the QUEUE service uses these symbolic names in preference to the actual TCB address when they are present.

To display all enqueues held by a specified task, type

QUE,TASK=@TCB2

AMTQU1I Your search located 152 resources                         

 AMTQU2I Scope=SYSTEM  Owners= 2  No Waiters                              
 AMTQU3I Q=SYSDSN                                                         
 AMTQU4I R=RXA36.VAM3.BBPLIB                                              
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                
 AMTQU6I SJSD       BMVDWP4  0140  @TCB2   Owns  Shr  8:34:00 5/23/2012   

 AMTQU2I Scope=SYSTEM  Owners= 3  No Waiters                               
 AMTQU3I Q=SYSDSN                                                          
 AMTQU4I R=SYSO.CPWFILGA.V8R0M0.ISPMLIB                                  
 AMTQU7I D9E2C3E3010000000000004800934BF800C99C624B66E8984C00000001300006
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time               
 AMTQU6I SJSD       BMVDWP4  0140  @TCB2   Owns  Shr  8:34:00 5/23/2012  

 AMTQU2I Scope=SYSTEM  Owners= 9  No Waiters                             
 AMTQU3I Q=SYSDSN                                                             
 AMTQU4I R=SYSI.IBMREX.SYS.SFANSKL                                            
 AMTQU7I D9E2C3E301000000000000480071D2E000C99C26A39D9F12C400000001260006     
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                    
 AMTQU6I SJSD       BMVDWP4  0140  @TCB2   Owns  Shr  8:34:00 5/23/2012       

 AMTQU2I Scope=SYSTEM  Owners= 15  No Waiters                                 
 AMTQU3I Q=SYSDSN                                                             
 AMTQU4I R=EOY.PREP.SEOYPENU                                                  
 AMTQU7I D9E2C3E3010000000000004800763E0800C99C2DC1BD9ABB2200000001250006     
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                    
 AMTQU6I SJSD       BMVDWP4  0140  @TCB2   Owns  Shr  8:34:00 5/23/2012       

 AMTQU2I Scope=SYSTEM  Owners= 20  No Waiters                                 
 AMTQU3I Q=SYSDSN                                                             
 AMTQU4I R=SYS1.SBLSPNL0                                                      
 AMTQU7I D9E2C3E30100000000000048006E4AC000C99BE66732F8BF2400000001270006     
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time                    
 AMTQU6I SJSD       BMVDWP4  0140  @TCB2   Owns  Shr  8:34:00 5/23/2012
AMTQU1I Your search located 2 resources                                 

 AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                             
 AMTQU3I Q=SYSZJES2                                                      
 AMTQU4I R=SJB.1A245728                                                  
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time               
 AMTQU6I SJSD       VAM3ENQ    62  @TCB003 Owns  Exc  15:02:56 4/22/YYYY

 AMTQU2I Scope=SYSTEM  Owners= 1  No Waiters                             
 AMTQU3I Q=SYSDSN                                                        
 AMTQU4I R=VAM3.GEN.LOAD                                                 
 AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ  Time               
 AMTQU6I SJSD       VAM3ENQ    62  @TCB003 Owns  Shr  15:02:56 4/22/YYYY
Warning

Note

The TCB service was used to assign symbolic names to the address space's tasks.


Example 4

To display ENQ conflicts, type

QUE

AMTQU1I Your search located 5 resources                 

AMTQU2I Scope=SYSTEM  Owners= 1  Waiting for: Excl= 1   
AMTQU3I Q=SYSDSN                                        
AMTQU4I R=BCVM.CICS.BCVCS66D.DFHINTRA                   
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ     
AMTQU6I SJSD       BCVCS66D 011B  6FF890  Owns  Exc     
AMTQU6I SJSD       BCVCS66D 011C  6FF890  Wait  Exc     

AMTQU2I Scope=SYSTEM  Owners= 1  Waiting for: Excl= 1   
AMTQU3I Q=SYSDSN                                        
AMTQU4I R=BCVM.CICS.BCVCS66D.DFHGCD                     
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ     
AMTQU6I SJSD       BCVCS66D 011B  6FF890  Owns  Exc     
AMTQU6I SJSD       BCVCS66D 011C  6FF890  Wait  Exc     

AMTQU2I Scope=SYSTEM  Owners= 1  Waiting for: Excl= 1   
AMTQU3I Q=SYSDSN                                        
AMTQU4I R=BCVM.CICS.BCVCS66D.DFHLCD                     
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ     
AMTQU6I SJSD       BCVCS66D 011B  6FF890  Owns  Exc     
AMTQU6I SJSD       BCVCS66D 011C  6FF890  Wait  Exc     

AMTQU2I Scope=SYSTEM  Owners= 1  Waiting for: Excl= 1   
AMTQU3I Q=SYSDSN                                        
AMTQU4I R=BCVM.CICS.BCVCS66D.DFHLRQ                     
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ     
AMTQU6I SJSD       BCVCS66D 011B  6FF890  Owns  Exc     
AMTQU6I SJSD       BCVCS66D 011C  6FF890  Wait  Exc     

AMTQU2I Scope=SYSTEM  Owners= 1  Waiting for: Excl= 1   
AMTQU3I Q=SYSDSN                                        
AMTQU4I R=BCVM.CICS.BCVCS66D.DFHTEMP                    
AMTQU5I SYSID      Jobname  ASID  TCB     Stat  Typ     
AMTQU6I SJSD       BCVCS66D 011B  6FF890  Owns  Exc     
AMTQU6I SJSD       BCVCS66D 011C  6FF890  Wait  Exc

Related topic

Services

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView SYSPROG Services 6.2