LKEQU - Generate DLM-specific layouts

General

Application area:	Distributed Lock Manager (DLM); see "Distributed Lock Manager (DLM)"
Macro type:	Definition macro, see "Types of macro"

Macro description

The LKEQU generates the DLM-specific layouts and values for the event type codes and the global return codes, which are set by the different macros of the DLM.

The LKEQU macro may only be called with MF = D.

Macro formats and description of operands

LKEQU

MF=D

,PARAM=<var: pointer> / (reg: pointer>)

,PREFIX=N / p

,MACID=LDQ / mac

Description of operands

MF=

For a general description of the MF operand, its operand values and any subsequent operands (e.g. PREFIX, MACID, and PARAM), see "S-type macros". The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.

Layout of the data area for LKEQU MF = D

           LKEQU MF=D
1          MFTST MF=D,PREFIX=N,MACID=LDQ,ALIGN=F,                        C
1                DMACID=LDQ,SUPPORT=(D),DNAME=LDQMDL
2 NLDQMDL  DSECT ,
2                *,##### PREFIX=N, MACID=LDQ #####
1 NLDQNMM# EQU   48                        maximum length of a lock name
1 *                                        including the name space id
1 *                                        which always must be the
1 *                                        first part of the lock name
1 *                                        string
1 *
1 NLDQNMP# EQU   48                        reserved
1 *
1 NLDQNSP# EQU   8                         length ot the name space id
1 *
1 NLDQTIMI EQU   -1                        value for infinite wait- or
1 *                                        holdtime
1 *
1 NLDQTIMS EQU   -2                        value for system defined
1 *                                        holdtime
1 *
1 NLDQUNIT EQU   247                       DLM unit number in standard
1 *                                        header
1 *
1 *   layout of the event data for asynchronous calls
1 *
1 NLDQREG3 DS    0XL4                      word 1 or register 3 of event
1 *                                        data
1 NLDQETC  DS    FL1                       unit which issued the event
1 *                                        (here always the event type
1 *                                        code of DLM)
1 *   event type code for event notification
1 NLDQVENT EQU   22                        DLM event
1 *
1 NLDQEVNT DS    FL1                       notified event
1 *   type of the event that occurred
1 NLDQGRT  EQU   1                         grant event after LKENQ or
1 *                                        LKCVT call
1 NLDQWTOT EQU   2                         waittimeout event after LKENQ
1 *                                        or LKCVT call
1 NLDQREL  EQU   3                         release event
1 NLDQHTOT EQU   4                         holdtimeout event
1 NLDQERGT EQU   5                         error event after failing
1 *                                        LKENQ or LKCVT call
1 NLDQCANC EQU   6                         cancelled event after LKENQ
1 *                                        or LKCVT call when a LKCAN

1 *                                        was issued meanwhile
1 NLDQLSBR EQU   7                         general error event when lock
1 *                                        state block was not
1 *                                        accessible
1 NLDQOKDQ EQU   8                         dequeue event after LKDEQ
1 *                                        call
1 NLDQERDQ EQU   9                         error event after failing
1 *                                        LKDEQ call
1 NLDQOKCN EQU   10                        cancel done event after LKCAN
1 *                                        call
1 NLDQERCN EQU   11                        error event after failing
1 *                                        LKCAN call
1 *
1 NLDQBMOD DS    X                         lock mode of the lock request
1 *                                        which is blocked by the own
1 *                                        granted lock request
1 NLDQFILL DS    X                         reserved
1 *
1 *
1 NLDQREG4 DS    0XL4                      word 2 or register 4 of event
1 *                                        data
1 NLDQUPAR DS    F                         last given value of user
1 *                                        parameter
1 *
1 NLDQEQUATES# EQU  *-NLDQETC