pseudo-op .tc

Objectif

Assemble des expressions dans une entrée de table des matières.

Syntaxe

Article	Descriptif
.tc	[Nom][TC], Expression[, Expression, ...]

Remarque: Les crochets en gras contenant TC font partie de la syntaxe et ne spécifient pas de paramètres facultatifs.

Description

La pseudo-opération .tc assemble les expressions en une entrée TOC qui contient l'adresse d'une routine, l'adresse d'un descripteur de fonction ou l'adresse d'une variable externe. Une instruction .tc ne peut apparaître que dans la portée d'une pseudo-opération .toc . Une entrée de table des matières peut être déplacée en tant que corps. Les instructions d'entrée de table des matières peuvent avoir des libellés locaux, qui seront relatifs au début de l'intégralité de la table des matières, comme déclaré par la première instruction .toc . Les adresses contenues dans l'entrée de table des matières sont accessibles à l'aide de ces libellés locaux et du registre de table des matières GPR 2.

Les entrées de table des matières qui ne contiennent qu'une seule adresse sont susceptibles d'être combinées par le classeur. Cela peut se produire si les entrées de la table des matières portent le même nom et font référence à la même section de contrôle (csect) (symbole). Soyez prudent lorsque vous codez des entrées de table des matières qui font référence à des décalages différents de zéro dans une secte. Pour éviter une combinaison non intentionnelle des entrées de table des matières, des noms uniques doivent être affectés aux entrées de table des matières qui font référence à des décalages différents au sein d'une csect.

Paramètres

Article	Descriptif
nom	Indique le nom de l'entrée de table des matières créée. La StorageMappingClass est TC pour les entités TOC. Nom[TC] peut être utilisé pour faire référence à l'entrée de table des matières le cas échéant.
Expression	Indique le symbole ou l'expression entrant dans l'entrée de table des matières.

Exemples

L'exemple suivant illustre l'utilisation de la pseudo-op .tc :


.toc
# Create three TOC entries, the first
# with the name proga, the second
# with the name progb, and the last
# unnamed.
T.proga:        .tc proga[TC],progr[RW],dataA
T.progb:        .tc progb[TC],proga[PR],progb[PR]
T.progax:       .tc  proga[TC],dataB
                .tc       [TC],dataB
                .csect proga[PR]
# A .csect should precede any statements following a
# .toc/.tc section which do not belong in the TOC.
                l 5,T.proga(2)   # The address of progr[RW]
                                 # is loaded into GPR 5.
                l 5,T.progax(2)  # The address of progr[RW]
                                 # is loaded into GPR 5.
                l 5,T.progb+4(2) # The address of progb[PR]
                                 # is loaded into GPR 5.