COMM STATUS shows a task waiting on LOGPR. What is this and how do I resolve the wait?
search cancel

COMM STATUS shows a task waiting on LOGPR. What is this and how do I resolve the wait?

book

Article ID: 11535

calendar_today

Updated On:

Products

Datacom Datacom/DB

Issue/Introduction

When doing a COMM STATUS command it shows that a task is waiting on a LOGPR command. 

What is this command used for and how do I resolve the wait? 

Environment

Release: All Releases
Component: CA Datacom/DB

Resolution

The LOGPR command is used internally by CA Datacom during the two-phase commit processing which is controlled by Resource Recovery Services (RRS). RRS is invoked when a transaction updates multiple database systems (e.g. Datacom and DB2). During phase 1 of the two-phase commit process a LOGPR command is issued to indicate Datacom is waiting on another resource manager to confirm the transaction can be committed. 

If the task is waiting a long time in LOGPR it indicates something went wrong in the two-phase commit process.

For CICS tasks, if CICS is down, do a normal CICS start.

Datacom CICS Services has code to perform resynchronisation and will detect units of work that have not been committed and notify the MUF. This will then cause the waiting task in the MUF to be cleared. It needs to be a normal CICS start not a COLD START. Doing a COLD START you will cause a loss of synchronization data so no resynchronisation is possible.

If CICS is already up, perform the following:

  • Find the number of the MUF in question by issuing a DBEC I,MUF(??),SYSID(*) 
  • Issue a DBEC PERFORM,IMMEDIATE,MUF(nn) this will terminate the connection to the MUF and then automatically reconnect. A DBOC SHUTDOWN followed by a DBOC STARTUP will also have the same effect. 

Depending on the status the LOGPR task may not clear up automatically after it reconnects, in this case you need to commit or rollback the LOGPR task using REQCOMIT or REQROLBK commands. 

Doing a CICS CEMT SET TASK FORCEPURGE of the task involved in the two-phase commit can cause problems with resynchronisation and cause the MUF task to remain in LOGPR wait status, in this case a CICS restart may be the only option. 

For a batch job, you need to investigate what happened to the job then determine if you need to commit or rollback the LOGPR task using REQCOMIT or REQROLBK commands. 

REQCOMIT and REQROLBK are  Datacom console commands. The format is:

REQCOMIT nnnnn

REQROLBK nnnnn

Where nnnnn is the sequence number of the request to be committed or rolled back.

Additional Information

See CA Datacom documentation in TechDocs sections Two-Phase Commit and RRS, REQCOMIT and REQROLBK.

Article 55758 - Resource Recovery Services (RRS)