Locking your CICS resource

FM/CICS uses standard CICS services to update and change resources. FM/CICS is also capable of issuing CICS enqueues to help you coordinate access against resources as described below.
FM/CICS-generated CICS enqueue
When editing a temporary storage queue or transient data queue with FM/CICS, a CICS enqueue using the following resource naming convention is issued:
FMLOCK:xxsysidname
Where:
xx
TD or TS depending on the type of queue being edited.
sysid
The ID of the CICS system where the queue resides. A blank value indicates the queue resides on the local system.
name
The name of the queue.
This CICS enqueue is issued to prevent multiple FM/CICS sessions on the same region from concurrently editing the same queue.
User-specified CICS enqueue
You can specify a 1–36 character CICS enqueue resource name that is issued for the duration of the Edit session for a file, TS queue, or TD queue by:
  • Entering "/" in the Lock resource field
  • Specifying a valid 1–36 character CICS enqueue resource name in the corresponding Name field
This user-specified CICS enqueue can be used to provide additional coordination for CICS resources accessed by FM/CICS and other applications that issue similar CICS enqueues. This enqueue is issued in addition to the FM/CICS-generated CICS enqueue for TS and TD queues.

FM/CICS issues CICS enqueues on the local region only (the CICS region where FM/CICS is running). An enqueue resource length of 255 is used and all unused characters are padded with spaces.

If FM/CICS issues an enqueue but receives a "busy" response, this indicates that a similar CICS enqueue has already been issued by another application. FM/CICS then displays the message "CICS resource locked" and terminates the Edit. To display further information about the active CICS enqueue, press F1. You can also list and display further CICS attributes for CICS enqueues by using the FM/CICS List utility. For further information, see Working with CICS enqueues.