Batch interface for the IMS Transaction Isolation Facility

There is also a batch interface that can be used to perform IMS Transaction Isolation functions. A sample of the batch interface is provided in hlq.SEQASAMP(EQAWTBCH).

The batch interface invokes the program EQANIPSB and passes parameters in the PARM= string on the EXEC JCL statement. The syntax and description of each request is as follows:
CHGLIBS
Set IMS reslib for interface to the target IMS system.
Read syntax diagramSkip visual syntax diagramCHGLIBSims-idims-reslib
CHGMASK
Set the transaction classes that are used for isolation.
Read syntax diagramSkip visual syntax diagramCHGMASKbitmapims-id
CHGPLEX
Set the target IMS system's IMSplex name.
Read syntax diagramSkip visual syntax diagramCHGPLEXims-idIMSplex-id
REGISTER
Registers a user for a given transaction.
Read syntax diagramSkip visual syntax diagramREGISTERtran-namepsb-nameims-systemuseridjob-name
DEREGISTER
Deregisters a user for a given transaction. This request can also be used to deregister all transactions for the given user ID.
Read syntax diagramSkip visual syntax diagramDEREGISTER tran-nameims-systemuseridALLims-systemuserid*
Note: The asterisk (*) is a wild card that matches any user ID. The transactions for all the users are deregistered if the asterisk (*) is used.
START
Register the specified transaction and start a private message region for the specified user. The message region is cloned from a message region that is designated to run the specified transaction.
Read syntax diagramSkip visual syntax diagramSTARTtran-namepsb-nameims-system useridjob-namejob-classprofDSN
STOP
Stops a private message region for the specified user. This request can also be used to stop all private message regions for the specified IMS system.
Read syntax diagramSkip visual syntax diagramSTOP region-nameims-systemuseridALLims-system
FORCE
Stops a private message region for the specified user, even if the region is busy debugging a transaction. The region is marked as stopped in the IMS Isolation table, and is also set to “not busy”.
Read syntax diagramSkip visual syntax diagramFORCEregion-nameims-system userid
QUERY
Dumps the contents of the in-memory IMS Transaction Isolation table. The classes reserved for IMS Transaction Isolation, the users that are assigned each class, and the transactions the users have registered for each class are displayed.
Read syntax diagramSkip visual syntax diagramQUERYims-system
TRACE
Dumps the contents of the in-memory IMS Transaction Isolation trace.
Read syntax diagramSkip visual syntax diagramTRACEims-system
UPDATE MSG
Updates message filtering settings for a transaction.
Read syntax diagramSkip visual syntax diagramUPDATE MSG tranms-idownerchmsguserpatternstartlength