HPlogo System Debug Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4 System Debug Command Specifications

T (translate)

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Privileged Mode: TCA, TCS

Translates the specified CM address to a virtual address.

Syntax

   TA    offset                    ABS - Bank0 

   TD    dst.off                   Data segment 

   TDB   offset                    DB relative

   TS    offset                    S relative

   TQ    offset                    Q relative



   TC    cmlogaddr               Program file 

   TCG   cmlogaddr               Group library 

   TCP   cmlogaddr               Account library

   TCLG  cmlogaddr               Logon group library

   TCLP  cmlogaddr               Logon account library

   TCS   cmlogaddr               System library 

 

   TCA   cmabsaddr               Absolute CST

   TCAX  cmabsaddr               Absolute CSTX

Parameters

offset

TA, TDB, TQ, TS only. The CM word offset that specifies the relative CM address to be translated.

dseg.off

TC, TD only. The data segment and word offset to be translated.

cmlogaddr

TC, TCG, TCP, TCLG, TCLP, TCS only. A full logical code address (LCPTR) specifies three necessary items:

  • The CM logical code file (PROG, GRP, SYS, and so on).

  • The CM logical segment number.

  • The CM word offset within the code segment.

Logical code addresses can be specified in various levels of detail:

  • As a full logical code pointer (LCPTR):

    TC procname+20

    Procedure name lookups return LCPTRs.

    TC pw+4

    Predefined ENV variables of type LCPTR.

    TC SYS(2.200)

    Explicit coercion to a LCPTR type.

  • As a long pointer (LPTR):

    TC 23.2644

    seg.offset

    The logical file is determined based on the command suffix. For example:

    • TC implies PROG.

    • TCG implies GRP.

    • TCS implies SYS, and so on.

  • As a short pointer (SPTR):

    TC 1024

    offset only

    The currently executing logical segment number and the currently executing logical file are used to build a LCPTR.

The search path used for procedure name lookups is based on the command suffix letter:

TC

Full search path:

CM: PROG, GRP, PUB, LGRP, LPUB, SYS.

TCG

Search GRP, the group library.

TCP

Search PUB, the account library.

TCLG

Search LGRP, the logon group library.

TCLP

Search LPUB, the logon account library.

TCS

Search SYS, the system library.

TCU

Search USER, the user library.

For a full description of logical code addresses, refer to the section "Logical Code Addresses", in chapter 2.

cmabsaddr

TCA, TCAX only. A full CM absolute code address specifies three necessary items:

  • Either the CST or the CSTX.

  • The absolute code segment number.

  • The CM word offset within the code segment.

Absolute code addresses can be specified in two ways:

  • As a long pointer (LPTR):

    TCA 23.2644

    Implicit CST 23.2644

    TCAX 5.3204

    Implicit CSTX 5.3204

  • As a full absolute code pointer (ACPTR):

    TCA CST(2.200)

    Explicit CST coercion.

    TCAX CSTX(2.200)

    Explicit CSTX coercion.

    TCAX logtoabs(prog(1.20))

    Explicit absolute conversion.

The search path used for procedure name lookups is based on the command suffix letter:

TCA

GRP, PUB, LGRP, LPUB, SYS

TCAX

PROG

Examples

   %cmdebug > td 1.100

   % DST 1.100      VIRT $b.40011630

Translate data segment 1.100 to a virtual address.

   %cmdebug > ta 2000   

   % ABS+2000     VIRT $a.80000800

Translate ABS+2000 to a virtual address.

   $nmdebug > tcs %22.%5007

   SYS %  22.5007    =  CST %  23.5007    =  VIRT $21.6ed0e

   FOPEN+%13  (XLSEG11)

   start: %4774   entry: %5000   proclen: %626   seglen: %31454

   Translator Node Addresses:

   CM prev: SYS %22.5006      NM prev: TRANS $21.6afd5c

   CM next: SYS %22.5010      NM next: TRANS $21.6afd74

Translate CM logical address SYS %22.5007.

   %cmdebug > tc fgetkeyinfo+1146

   SYS %  32.2031    =  CST %  33.2031    =  VIRT $21.a4c32

   FGETKEYINFO+%1146  (KSAMSEG1)

   start: %663   entry: %702   proclen: %2145   seglen: %37204

   Translator Node Addresses:

   CM prev: SYS %32.2030      NM prev: TRANS $21.7da7a0

   CM next: SYS %32.2034      NM next: TRANS $21.7da7c4

Translate CM logical address fgetkeyinfo+1146.

Refer to appendix C for a discussion of CM object code translation, node points, and breakpoints in translated CM code.

Limitations, Restrictions

All information that is displayed in a TC (translate code) display can be obtained programmatically, except for the CM segment length.

There is no way to obtain the virtual address of ABS relative addresses programmatically.

CAUTION: The output format of all System Debug commands is subject to change without notice. Programs that are developed to postprocess System Debug output should not depend on the exact format (spacing, alignment, number of lines, uppercase or lowercase, or spelling) of any System Debug command output.
Feedback to webmaster