BLSAPCQE — Map the contention queue element (CQE) create service parameter list

Description

BLSAPCQE maps the contention queue element (CQE) create service parameter list. Use this parameter list when calling the CQE create service from within an installation-written interactive problem control system (IPCS) exit routine to create CQE entries in the dump directory.

See z/OS MVS IPCS Customization for information about the CQE create service. See z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/ for a mapping of the BLSAPCQE data area.

Environment

Because BLSAPCQE is not an executable macro, there are no specific environment requirements.

Programming requirements

None.

Restrictions

None.

Register information

Because BLSAPCQE is not an executable macro, there is no need to save and restore register contents.

Performance implications

None.

Syntax

The standard form of the BLSAPCQE macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede BLSAPCQE.

BLSAPCQE

␢	One or more blanks must follow BLSAPCQE.

DSECT=YES	Default: DSECT=YES
DSECT=NO

Note: Users must supply a label (name), and start it in column 1 of the BLSAPCQE macro. When the BLSAPCQE macro is processed, the label becomes the record name and the prefix to the name of each field in the record.

Parameters

The parameters are explained as follows:

DSECT=YES

DSECT=NO

A contention queue element (CQE) create parameter list (PCQE) is mapped with a DSECT (DSECT=YES) or a PCQE is mapped, but no DSECT is generated (DSECT=NO). IPCS initializes the PCQE as follows:

The PCQE control block identifier is filled in.
Pointer and length fields are set to 0.
The OWNER/WAITER identifier field is set to "O " to indicate an owner CQE.
Character fields not specifically mentioned are set to blanks.
The data description of the control block which represents the owner or waiter for the resource is set as follows:
- Address space type code is set to indicate a virtual address (CV). This is the only address space type code allowed.
- The processor field is set to X'FFFFFFFF'. This is done to avoid specifying processor 0 accidentally.
- The ASID is set to 1 for the MASTER address space. The ASID field needs to get set to the ASID for the owner or waiter for the resource. If the ASID is not known and the control block is in common storage, use ASID 1 as the default.
- The data type is set to "M" to indicate that the specified name is a STRUCTURE. This is the only data type allowed for this release.

Example

Code the following to map the contention queue element (CQE) create service parameter list, but not as a DSECT. All fields will appear with the prefix PCQE.

PCQE   BLSAPCQE DSECT=NO