Schedule use of a resource by a task (dequeue).
DEQ >>-DEQ--RESOURCE(data-area)--+--------------------+-------------> '-LENGTH(data-value)-' .-UOW---------------. >--+-------------------+--------------------------------------->< +-MAXLIFETIME(cvda)-+ '-TASK--------------'
Conditions: INVREQ, LENGERR
This command is threadsafe if it is defined as LOCAL. It is non-threadsafe if it is defined as GLOBAL.
Note for dynamic transaction routing: Using this command could create inter-transaction affinities that adversely affect the use of dynamic transaction routing, unless the name specified in RESOURCE matches the name specified in an installed ENQMODEL resource definition, that has sysplex-wide scope. See Affinity for more information about transaction affinities.
DEQ causes a resource currently enqueued on by the task to be released for use by other tasks.
If a task enqueues on, but does not dequeue from, a resource, CICS automatically releases the resource during syncpoint processing or when the task is terminated. A resource in the context of this command is any string of 1–255 bytes, established by in-house standards, to protect against conflicting actions between tasks, or to cause single-threading within a program.
When issuing the DEQ command, the resource to be dequeued from must be identified by the method used when enqueuing on the resource. If no enqueue has been issued for the resource, the dequeue is ignored.
If more than one ENQ command is issued for a resource by a task, that resource remains owned by the task until the task issues a matching number of DEQ commands.
When an EXEC CICS DEQ (or ENQ) command is issued for a resource whose name matches that of an installed ENQMODEL resource definition, CICS checks the value of the ENQSCOPE attribute to determine whether the scope is local or sysplex-wide. If the ENQSCOPE attribute is left blank (the default value), CICS treats the DEQ as local to the issuing CICS region. If no ENQMODEL matches the resource name, the scope of the DEQ command is local. See the CICS Resource Definition Guide for more information about the ENQMODEL resource definition.
Default action: terminate the task abnormally.
Default action: terminate the task abnormally.
EXEC CICS DEQ
RESOURCE(RESNAME)
EXEC CICS DEQ
RESOURCE(SOCSECNO)
LENGTH(9)