T (translate)

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

   %cmdebug > ta 2000
   % ABS+2000     VIRT $a.80000800

   $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

   %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

Limitations, Restrictions