ppcadmin list luws

Purpose

Displays a list of the LUWs and their associated transaction identifiers for all transactions active at the gateway server.

Synopsis

ppcadmin list luws -server server_name

Arguments

-server server_name
Specifies the name of the gateway server. If the -server option is not specified, the default is the server defined by the environment variable CICS_PPC_GWY_SERVER.

Description

The ppcadmin list luws command displays a list of the Logical Units of Work (LUWs) for all transactions active at the gateway server. There is no guarantee that a transaction is still active after this command has completed.

An alternative command that lists an equivalent output is the ppcadmin list transactions command.

Examples

The following command lists all the LUWs and their associated transaction identifiers for the transactions active at the gateway server:

%  ppcadmin list luws
Command executed at: Fri Oct 22 12:31:08 1993

Total LUWs: 3

Logical Unit of Work Id: NETWORK1.LUALFRED:12bf45679abc:2a
   Transaction Id: 15
   Global tid: 0000000d0112010128afc9666352cdb274080009

Logical Unit of Work Id: NETWORK3.LUNANCY1:12bf45679abc:12
   Transaction Id: 32
   Global tid: 0000010d0244010135efc955246311b264070009

Logical Unit of Work Id: NETWORK5.LUDEBBY4:12bf45679abc:1
   Transaction Id: 35
   Global tid: 0000020b0145012135bcc955246311d264880009

Output

The following list describes the output of the ppcadmin list luws command:

  • Total LUWs lists the number of LUWs active at the gateway server.
  • Logical Unit of Work Id (LUWID) specifies the Systems Network Architecture (SNA) LUW. If any of the conversations exist to SNA mainframes, the transactions on those mainframes will have this LUW. The LUWID identifies the site that allocated the first conversation and the unit of work. It is the SNA equivalent of a global transaction identifier. The first component is the network-qualified Logical Unit (LU) name, the second component is the LUW instance identifier, and the third component is the LUW sequence number. Note that the LUW instance identifier and LUW sequence number are hexadecimal byte streams following mainframe conventions.
  • Transaction Id is the local transaction identifier, or tid. It identifies a transaction at this server.
  • Global tid is the global transaction identifier. It identifies a transaction uniquely at any participating server.

If there are no active LUWs at the gateway server, a message is displayed stating that the number of active LUWs is zero.