General Information

The DO SYSREQ=ENQINFO execution call sets the following AutoEdit system variables:

%%$SYSRC
Completion code: 0 for successful completion
All other return codes indicate an internal error and should be reported to BMC Customer Support.
%%$SYSLINES
Number of lines selected in the ENQ request. A value of 0 means that no ENQ entry matches the selection criteria.
%%$SYSLINEn
Information about a specific ENQ entry, contained in line number n.
A %%$SYSLINEn is saved for each ENQ entry. However, lines that did not match the selection criteria, such as OWNER lines, when only WAITER lines were specified, are not included in the %%$SYSLINES AutoEdit variable that contains the count of ENQ entries that matched the selection criteria.

Data in the %%$SYSLINEn variables can be extracted as a whole string, or the data string can be broken up into words, using the %%$PARSE function with templates. For more information, see %%$PARSE. A built-in template, %%$EITEMPLATE, is provided, to assist in writing the rule and reduce the amount of code in the rules. The layout of the %%$SYSLINEn and %%$EITEMPLATE AutoEdit variables corresponding to the DO SYSREQ=ENQINFO option is detailed below.

Table 143 Layout of AutoEdit Variable %%SYSLINEn

Characters	Variable	Description
01 through 08	JOBNAME	Name of the job that issued the ENQ.
09 through 12	ASID	Address space ID.
13 through 20	SYSNAME	System name.
21 through 28	QNAME	Resource major name or mask.
29 through 29	RANGE	Range of the ENQ request. Valid values are: L – Local G – Global
30 through 36	SCOPE	Scope of the ENQ request.
37 through 44		Reserved.
45 through 48	FOI	First owner index. If this job is waiting for resources, the %%$SYSLINEn AutoEdit variable (where n = FOI) contains information about the first job in the chain that owns the resource.
49 through 52	NWI	Next waiter index. If this job is waiting for resources, the %%$SYSLINEn AutoEdit variable (where n = NWI) contains information about the next job in the chain that waits for the resource.
53 through 56	NOI	Next owner index. If this job owns a resource, the %%$SYSLINEn AutoEdit variable (where n = NOI) contains information about the next job in the chain that requires the same resource.
57 through 58	STAT1	Status of the job. Valid values are: O – Job owns the resource. W – Job is waiting for the resource. An R (RESERVE) character appearing next to the status, indicates a RESERVE condition on the disk.
59 through 59	STAT2	Resource type. Valid values are: E – Exclusive S – Shared
92 through 94	RNAMEL	Length of the resource name.
95 through xx	RNAME	Resource name.

Table 144 Layout of AutoEdit Variable %%$EITEMPLATE

Character	Variable	Value
01	EIJOBN	+8
09	EIASID	+4
13	EISYSN	+8
21	EIQNAM	+8
29	EISCP1	+1
30	EISCP2	+7
37	EIWTIM	+8
45	EIFOI	+4
49	EINWI	+4
53	EINOI	+4
57	EISTA1	+2
59	EISTA2	+1
92	EIRLEN	+3
95	EIRNAM

The variables listed in the template layout above contain, after parsing, the value of the various fields described in the layout of the %%$SYSLINEn variable. These variables can be accessed by prefixing them with %%.

Parent Topic

DO SYSREQ: Automated Console Action Parameter