9974I

9974I

9974I <s> LIST BASED ON TRANSACTIONS.

9974I GROUP group name, ACTIVE FUNCTION 'tr-id' status[,extension]

9974I [*] user terminal fcb-id program (STATUS=flag) status text [,extension]

9974I GROUP group name, NUMBER OF FUNCTIONS: n (ACT=n/PND-CLN=n/LFF=n/NOP=n)

9974I GROUP group name, TERMINATION ERRORS: nn (ACT=n/PND-SVC=n/IGN=n/ERR=n)

Written to:

SYSLOG, JESMSGLG.

Explanation:

(A): Message 9974I consists of a block of messages that start with "VDF9974I SESSION LIST BASED ON TRANSACTIONS" and are sorted by user groups.

(B): Each user group starts with information on the transaction that is currently active:

  • group name - the name of the group in format USERnnnn
  • tr-id - transaction number
  • status - current condition or cleanup problem of the transaction:
    • RUNNING - session is currently active
    • RECOVERED - session was recovered following an error or abend and is currently active.
    • TERMINATES - the end of a session has been initiated, e.g. by logoff.
    • CLEANUP PENDING - the currently active session has been marked for termination.
    • LOST - the transaction of the last active session has been lost due to an error in the VDF started task.
    • cleanup problem - cleanup problems can be DETACH REJECTED, CLEANUP LOST, SESSION BUSY, etc.

    Note on status: Conditions RECOVERED, TERMINATES and CLEANUP PENDING and cleanup problems were previously not visible in the SYSLOG or could only be indirectly referenced. When a status of this type is present, an attempt is made to determine the cause.

  • extension - provides information on the cause of the given status, for example, a cleanup or other problem.

    extension can be one of the following:

    CLEANUP REASON: reason - The message was caused by a cleanup problem, where reason indicates the reason that made session cleanup necessary.

    REASON: reason - The message was caused by the indicated problem:

    • CANCEL - cancel initiated by operator.
    • TIMEOUT - user was inactive for longer than specified in the LST parameter B09_USER_TIMEOUT
    • DISCONNECT - a VTAM disconnect took place, for example, the screen was switched off.
    • VTAM ERROR - a VTAM error occurred.
    • ABEND - a user abend occurred.
    • UNKNOWN - the cause could not be determined.

Examples:

  • The master FCB is waiting for a request from any user session in the specified group:

    VDF9974I GROUP USER0002, ACTIVE FUNCTION 'USER0002' (MASTER FCB)

  • A session with transaction number 00800010 was recovered following an abend and is currently active:

    VDF9974I GROUP USER0002, ACTIVE FUNCTION '00800010' RECOVERED, REASON: ABEND

  • A user has turned off the terminal screen, but session 00900011 could not be terminated during several cleanup cycles due to intensive activities:

    VDF9974I GROUP USER0004, ACTIVE FUNCTION '00900011' SESSION BUSY, CLEANUP REASON: DISCONNECT

(C): All known sessions are listed one after the other below every group:

VDF9974I [*] user terminal fcb-id program (STATUS=flag) Status text [,extension]

A type (C) message is written for every user session in the group. Parameters are:

  • * indicates that a session is marked for shutdown, blank is used for other sessions.
  • user - user ID
  • terminal - terminal ID (VTAM LU name or CICS terminal ID).
  • fcb-id - transaction number.
  • flag - internal status (for analysis purposes)
  • status text - condition of the transaction or session cleanup problem. See (B) for a description.
  • extension - cause of the termination of the session
    REASON: reason or CLEANUP REASON: reason

(D): This summary breaks down the number of transactions according to status:

VDF9974I GROUP group name, NUMBER OF FUNCTIONS: nn (ACT=n/ PND-CLN=n/ LFF=n/ NOP=n)

ACT

In session

PND-CLN

Cleanup pending

LFF

Termination running

NOP

No operation

(E): This summary breaks down the number of transactions according to problem. This message is output only for groups where at least one "pending Cleanup session" with cleanup problem has been detected. nn indicates the total number of cleanup problems in the group.

VDF9974I GROUP group name, TERMINATION ERRORS: nn (ACT=n/ PND-SVC=n/ IGN=n/ ERR=n)

ACT

Number of sessions still active at the time of checking after several cleanup attempts; also includes long-running sessions in LOCK mode (potential loop)

PND-SVC

Number of cleanups refused because of "pending Transactions" (REJECT)

IGN

Number of sessions still active after shutdown request (shutdown ignored or transaction waits)

ERR

Number of sessions whose cleanup request has not been processed (LOST), whose shutdown flag has been lost (ERROR), and others

System Action:

Internal VDF activities depending on the status of a session. In the case of CLEANUP PENDING, VDF attempts to end the session concerned in the next CLEANUP cycle.

Operator Response:

Please save all the SYSLOG messages associated with VDF9974I and contact support. Include the save messages in your problem report.