Option 2.3

An enqueue is an operation that places items in a queue to control the access to resources. You can use option 2.3 to display Operating System (OS) or Subsystem Function Facility (SFF) enqueue information on the selected started task. In addition, line command F is available to enable you to free selected SFF enqueues. This section explains the following:

1. How to display SFF enqueue information
2. How to free an SFF enqueue (line command F)
3. How to display OS enqueue information

1. Displaying SFF enqueue info

To view SFF enqueue information, do the following:

1. In the "Service Manager Selection Menu", select option 2.3. The "ENQ Processing" panel comes up:

   PEB4ENQ -----------------------------------------------------------------------
   Command ===> _________________________________________________________________
   
   ENQ Processing Subsys-ID - S93P
   Sysname - BETA
   
   Environment ===> SFF (S)FF, (O)S
   
   Prefix ===> ___ (B)QL, (A)RC, (T)CP, (V)DF
   
   Resource ===> *__________________________________________________________
   
   
   
   
   
   
   
   
   
   
   Press the ENTER key to display the selected information.
   Press the END key to return to the previous menu.
   

2. Accept the default SFF in the Environment field.
3. In the Prefix field, select a special group of SFF enqueues, or leave the field blank.
4. In the Resource field, enter a major name as a search criterion, e.g. BETA.

   The "Display SFF ENQ Information" panel is called:

   PEB4DI05 ------------------------------------------------------ Row 1 of 1
   Command ===> _____________________________________________ Scroll ===> CSR
   
   Display SFF ENQ Information Subsys-ID - B09W
   Sysname - BETA
   F - Free Resource
   
   S Holder User System Status Function Resource
   Name Name Name
   BETA09W PMUST BETA SHR 12290418 VDF_PMUST1 ISP B09
   ******************************** BOTTOM OF DATA ********************************
   
   
   
   
   
   
   
   
   
   
   
   
   

2. Freeing SFF enqueues

To free a resource in an SFF queue, enter F in front of that resource. After pressing ENTER you will be asked to confirm that you really want to free the resource.

Note

• The Free Resource function (line command F) is only available for a limited group of archive enqueues.
• Use this function only when you are advised to do so by a Beta Systems support employee.

3. Displaying OS enqueue info

This function displays enqueues that have been created by Beta Systems products only.

1. In the "Service Manager Selection Menu", select option 2.3. The "ENQ Processing" panel comes up (see above).
2. Specify OS in the Environment field.
3. In the Prefix field, select a special group, e.g. BQL.
4. In the Resource field, enter a major name as a search criterion, e.g. BETA. Specify a complete string or a substring beginning with the first character of a major name.

   The "Display OS ENQ Information" panel is called:

   PEB4DI06 ------------------------------------------------------ Row 1 of 90
   Command ===> Scroll ===> CSR
   
   Display OS ENQ Information Subsys-ID - S93P
   Sysname - BETA
   Holder System Status Resource
   Name Major Minor
   BETA02P BETA EXCL BETASFM B02P
   BETA04AP BETA EXCL BETASFM B04B
   BETA07P BETA EXCL BETASFM B07P
   BETA07W BETA EXCL BETASFM B07W
   BETA09BA BETA EXCL BETASFM S09P
   BETA09P BETA EXCL BETASFM B09P
   BETA09SE BETA EXCL BETASFM GB09
   BETA098 BETA EXCL BETASFM B098
   BETA15P BETA EXCL BETASFM B15P
   BETA28C BETA EXCL BETASFM B28C
   BETA28GB BETA EXCL BETASFM U28K
   BETA28I BETA EXCL BETASFM B28I
   BETA28P BETA EXCL BETASFM B28P
   BETA48D BETA EXCL BETASFM B48D
   BETA48FR BETA EXCL BETASFM FR48
   BETA48IT BETA EXCL BETASFM B48I
   BETA55H BETA EXCL BETASFM B55H

ENQ processing fields

Field	Description
Environment	Select the environment SFF (Subsystem Function Facility) or OS (Operating System).
Prefix	Select BQL, ARC, TCP or VDF (VTAM Dialog Facility) to limit the selection: BQL enqueues from BQL ARC enqueues from archive requests used for archiving, reloading or tape view TCP enqueues from TCP/IP requests when users log on to the system, or when ports are (de)activated for add-ons, for example BWE VDF enqueues from users logged on to VDF When a prefix is selected, the enqueue name is composed of the prefix and the resource name: prefix_resource name.
Resource	Enter a resource name, masks are allowed.

Line commands

F	Free a resource ("Display SFF ENQ Information" only).

Columns

Column	Description
Holder	Name of the holder (a holder is a started task or a job name).
User	Name of the user who is the owner of the resource (SFF enqueues only)
System Name	Name of the system where the resource request has been started and where the connected enqueue is located.
Status	Status of the OS enqueue: EXCL exclusive access to one resource at a time. SHR more than one user can access the resource at the same time
Function Name	Internal name of the function (SFF enqueues only).
Resource Name	Name of the resource (SFF enqueues only).
Resource Major	Major name of the resource (OS enqueues only).
Resource Minor	Minor name of the resource (OS enqueues only).