Terminal accounting record layout

The following table describes the record format for the terminal (LTERM) accounting record (LAR):

Element label

Element name and description

Format

Length

Offset

DEC

HEX

TLRECLEN

RECORD DESCRIPTOR WORD (RDW)

Length of the record

Note

Depending on the access method used to read the LAR record, the RDW field might not be present. If it is not present, subtract 4 (RDW length) from the field offsets listed below

Binary

4

000

000

TLRECID

RECORD IDENTIFICATION

Code identifying record as a terminal accounting record (value L)

Display

1

004

004

--

RESERVED

Display

1

005

005

TLRECVER

RECORD VERSION

MainView for IMS IRUF record version code:

  • X'01'=MainView for IMS version 3.2.00 or earlier

  • X'02'=MainView for IMS version 3.3.00 or later

Display

2

006

006

TLLID

TRANSACTION IDENTIFICATION

Group

32

008

008

TLCUST

CUSTOMER ID

User-specified code that correlates this terminal with its customer identity

This field is built by the user exit routine provided in the log file edit process.

Display

18

008

008

TLHOGH

HI VALUES

Reserved area; filled with a value of X'FFFFFFFFFFFFFFFF'

Display

9

026

01A

TLSYSID

SYSTEM IDENTIFICATION

Identification code for the computing system to which this terminal was connected

Display

1

035

023

TLIMSLVL

IMS LEVEL

IMS release level under which this transaction was processed

Display

4

036

024

TLTERMCTERMINAL CHARACTERISTICS AREAGroup24040028

TLLTERM

LOGICAL TERMINAL NAME

Name assigned to this logical terminal for this connect session

Display

8

040

028

--

RESERVED

Display

11

048

030

TLRECTYP

RECORD TYPE

Status of this record:

  • D=Detail level data

  • S=Summary level data

Display

1

059

03B

TLTERMT

TERM TYPE

Type of terminal connect in use:

  • L=Leased line

  • D=Dial-up line

  • V=VTAM

  • U=Unknown

Display

1

060

03C

TLSKPFLG

TLSKPFLG

If set to Y, skip this terminal session

Binary

1

061

03D

--

RESERVED

Display

2

062

03E

TLTIMESTTIME STAMPS AREAGroup32064040

TLLDATE

LOGON DATE

Julian date (yyyyddd) when this logical terminal was logged on to the system

Binary

4

064

040

TLLTIME

LOGON TIME

Time of day, in hundredths of seconds, when this logical terminal was logged on to the system

Binary

4

068

044

TLRDATE1

TLRDATE1

Duplicate copy of the logon date and time is stored in this field

Display

4

072

048

--

RESERVED

Binary

4

076

04C

TLRDATE2

TLRDATE2

Duplicate copy of the logoff date and time is stored in this field

Display

4

080

050

--

RESERVED

Binary

4

084

054

TLLEDATE

LOGOFF DATE

Julian date (yyyyddd) when this logical terminal was logged off of the system

Binary

4

088

058

TLLETIME

LOGOFF TIME

Time of day, in hundredths of seconds, when this logical terminal was logged off the system

Binary

4

092

05C

TLSECRIDTERMINAL SECURITY IDGroup68096060

TLUSERID

USER ID

User identification supplied by the security system (from the last transaction processed from this logical terminal)

Display

8

096

060

--

RESERVED

Display

37

104

068

TLOSCODE

OS CODE

Operating system code under which this transaction was processed

Display

3

141

08D

TLUSERAR

USER AREA

Field that can be modified by the user

Display

20

144

90

TLSUMRYSUMMARY DATA AREAGroup681640A4

TLNOSES

NO SESSIONS

Number of terminal sessions encountered in the accounted span of time

For an ETO terminal, this figure represents the number of signon/signoff pairs. For a leased terminal it represents the number of IMS sessions. For a dial-up terminal, it represents the number of actual dial-up connect sessions.

Binary

4

164

0A4

TLLOGTM

TERMINAL CONNECT TIME

Amount of time, in hundredths of seconds, during which this logical terminal was logged on to the system for this session

Binary

4

168

0A8

TLNOTRNS

NUMBER OF TRANSACTIONS SUBMITTED

Number of transactions submitted through this terminal during this logon session

Binary

4

172

0AC

TLCHARIN

NUMBER CHARACTERS INPUT

Number of characters input from this terminal for message processing

Binary

8

176

0B0

TLCHAROT

NUMBER CHARACTERS OUTPUT

Number of characters output to this terminal for message processing

Binary

8

184

0B8

TLCHIOTH

NO CHARS OTHER IN

Number of input characters transmitted by transactions submitted through this terminal that were directed to sources other than this LTERM

Binary

8

192

0C0

TLCHOOTH

NO CHARS OTHER OUT

Number of output characters transmitted by transactions submitted through this terminal that were directed to sources other than this LTERM

Binary

8

200

0C8

TLMSGGU

MSG GU COUNT

Number of MESSAGE GET UNIQUEs issued to this LTERM for this terminal session

Binary

4

208

0D0

TLMSGGN

MSG GN COUNT

Number of MESSAGE GET NEXTs issued to this LTERM for this terminal session

Binary

4

212

0D4

TLMSGIN

MSG IN COUNT

Number of message inserts issued by transactions from this LTERM for this terminal session

This count also includes message purges.

Binary

4

216

0D8

TLMSGPUR

MSG PURGE COUNT

Number of message purges issued by transactions from this LTERM for this terminal session

Binary

4

220

0DC

TLMSGOTH

MSG OTHER COUNT

Number of other message calls (checkpoint, statistics, system service, and others) issued by transactions submitted from this LTERM

Binary

4

224

0E0

TLTOTRES

TOTAL RESPONSE

Total of the queue times and elapsed times for all transactions processed

By dividing this value by the number of transactions, an average response time for this terminal can be derived. This time is expressed in seconds and hundredths of seconds.

Binary

4

228

0E4

TLTTRRSP

TLTTRRSP

Accumulated transaction response time

Binary

4

232

0E8

TLTTRMSG

TLTTRMSG

Accumulated message sent count

Binary

4

236

0EC

--

RESERVED

Display

216

240

0F0




This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments